KeeperHub

A Web3 workflow automation platform (forked from vercel-labs/workflow-builder-template) that enables users and Agents to create, manage, and execute blockchain automation workflows and tasks. Supports smart contract monitoring, token transfers, DeFi operations, and integrations with Discord, SendGrid, webhooks and more.

Core Value

Users and Agents can build and deploy Web3 automation workflows through a visual builder or with KeeperHub MCP without writing code.

Add KeeperHub to your Agent

1. Install the plugin

/plugin marketplace add techops-services/claude-plugins
/plugin install keeperhub@techops-plugins

You can view the plugin source code here https://github.com/techops-services/claude-plugins/tree/main/plugins/keeperhub

2. Run setup

/keeperhub:login

This walks you through:

• Creating an organization API key (kh_ prefix) at app.keeperhub.com
• Auto-installing the keeperhub-mcp server
• Saving config to ~/.claude/keeperhub/config.json

3. Restart Claude Code for the MCP tools to become available.

That's it. Try asking Claude to "create a workflow that monitors a wallet" or run /keeperhub:status to verify.

What KeeperHub Does

• Visual Workflow Builder: Drag-and-drop interface for building blockchain automations
• Smart Contract Interactions: Read and write to smart contracts without writing code
• Multi-Chain Support: Ethereum Mainnet, Sepolia, Base, Arbitrum, and more
• Secure Wallet Management: Para-integrated MPC wallets with no private key exposure
• Notifications: Email, Discord, Slack, and webhook integrations
• Scheduling: Cron-based, event-driven, webhook, or manual triggers
• AI-Assisted Building: Describe automations in plain language

Key Features

Triggers

• Scheduled: Run at intervals (every 5 minutes, hourly, daily, custom cron)
• Webhook: Execute when external services call your workflow URL
• Event: React to blockchain events (token transfers, contract state changes)
• Manual: On-demand execution via UI or API

Actions

• Web3: Check Balance, Read Contract, Write Contract, Transfer Funds, Transfer Tokens
• Notifications: Send Email, Discord Message, Slack Message, Telegram Message
• Integrations: Send Webhook, custom HTTP requests

Conditions

• Low balance detection
• Value comparisons
• Custom logic with AND/OR operators

Development Setup

Prerequisites

• Node.js 18+
• PostgreSQL database
• pnpm package manager

Environment Variables

Create a .env.local file:

# Database
DATABASE_URL=postgresql://user:password@localhost:5432/keeperhub

# Authentication
BETTER_AUTH_SECRET=your-secret-key
BETTER_AUTH_URL=http://localhost:3000

# AI (choose one)
OPENAI_API_KEY=your-openai-api-key
AI_MODEL=gpt-4o

# Para Wallet
PARA_API_KEY=your-para-api-key
PARA_ENVIRONMENT=beta

# Encryption
WALLET_ENCRYPTION_KEY=your-wallet-encryption-key
INTEGRATION_ENCRYPTION_KEY=your-integration-encryption-key

Installation

pnpm install
pnpm db:push
pnpm dev

Visit http://localhost:3000 to get started.

Running Modes

Local Development (Simplest)

For UI/API development without Docker:

pnpm install
pnpm db:push
pnpm dev

Dev Mode with Docker

Full development stack with scheduled workflow execution:

make dev-setup    # First time (starts services + migrations)
make dev-up       # Subsequent starts
make dev-logs     # View logs
make dev-down     # Stop services

Services: PostgreSQL (5433), LocalStack SQS (4566), KeeperHub App (3000), Schedule Dispatcher, Schedule Executor

Hybrid Mode with K8s Jobs

For testing workflow execution in isolated K8s Job containers:

make hybrid-setup     # Full setup
make hybrid-status    # View status
make hybrid-down      # Teardown

Common Commands

# Development
pnpm dev              # Start dev server
pnpm build            # Production build
pnpm type-check       # TypeScript check
pnpm check            # Run linter
pnpm fix              # Fix linting issues

# Database
pnpm db:push          # Push schema changes
pnpm db:studio        # Open Drizzle Studio
pnpm db:seed          # Seed chain data

# Plugins
pnpm discover-plugins # Scan and register plugins
pnpm create-plugin    # Create new plugin

# Testing
pnpm test             # Run all tests
pnpm test:e2e         # E2E tests

Architecture

Core Services

• KeeperHub App: Next.js application with workflow builder UI and API
• Schedule Dispatcher: Evaluates cron schedules, queues workflows to SQS
• Schedule Executor: Polls SQS, executes workflows via API

Tech Stack

• Framework: Next.js 16 (App Router) with React 19
• Language: TypeScript 5
• UI: shadcn/ui, Radix UI, Tailwind CSS 4
• Database: PostgreSQL with Drizzle ORM
• Workflow Engine: Workflow DevKit
• Authentication: Better Auth
• AI: Vercel AI SDK (OpenAI/Anthropic)
• Wallets: Para MPC integration

Plugin System

Plugins extend workflow capabilities. Located in keeperhub/plugins/:

• web3 - Blockchain operations (balance, transfers, contract calls)
• discord - Discord notifications
• sendgrid - Email via SendGrid
• webhook - HTTP integrations
• telegram - Telegram notifications

API

Base URL: https://app.keeperhub.com/api

Endpoints

Resource	Description
/api/workflows	CRUD for workflows
/api/workflows/{id}/execute	Execute a workflow
/api/workflows/{id}/executions	Execution history
/api/integrations	Manage connections
/api/chains	Supported networks

See API Documentation for full reference.

Observability

Prometheus metrics exposed at /api/metrics:

• Workflow execution performance
• API latency
• Plugin action metrics
• User and organization stats

See Metrics Reference for details.

Documentation

Full documentation available at docs.keeperhub.com or in the docs/ directory:

• Quick Start Guide
• Core Concepts
• Workflow Examples
• API Reference
• Security Best Practices

License

Apache 2.0