Quickstart

Install

Homebrew (macOS/Linux):


brew install keeperhub/tap/kh

Go install:


go install github.com/keeperhub/cli/cmd/kh@latest

Binary download: Download from GitHub Releases and add to your PATH.


kh auth login

This opens a browser window to authenticate. Your token is stored in the OS keyring.

To authenticate non-interactively (CI/CD), set KH_API_KEY instead.

List workflows:


kh workflow list

Run a workflow and wait for completion:


kh workflow run <workflow-id> --wait

Check a run’s status:


kh run status <run-id>

View run logs:


kh run logs <run-id>

Execute a contract call:


kh execute contract-call --protocol aave --action supply --args '{"amount":"1000000"}'

List available protocols:


kh protocol list

KeeperHub exposes its actions as tools to AI assistants via the Model Context Protocol .

Recommended: remote HTTP endpoint (no local server required):


claude mcp add --transport http keeperhub https://app.keeperhub.com/mcp

Add to Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):


{ "mcpServers": { "keeperhub": { "type": "http", "url": "https://app.keeperhub.com/mcp" } } }

Restart Claude Desktop. KeeperHub tools will appear in the tool list.

Legacy: local stdio server (deprecated):

kh serve --mcp starts a local MCP stdio server. This mode is deprecated. Prefer the remote HTTP endpoint above.