@clawbank/mcp-server

MCP (Model Context Protocol) server for ClawBank — programmable AI agent wallets on Solana.

Works with Claude Desktop, Cursor, OpenAI Codex CLI, and any other MCP-compatible client.

Gives your AI three tools:

| Tool | Description | |------|-------------| | check_balance | Get your agent wallet's SOL balance | | send_sol | Send SOL to any Solana address | | health_check | Check if the ClawBank service is operational |

Step 1 — Create an agent

Sign up at clawbank.vercel.app, create an agent from the dashboard, and copy your API key (cb_...).

Step 2 — Add to your AI client

Claude Desktop

Config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "clawbank": {
      "command": "npx",
      "args": ["-y", "@clawbank/mcp-server"],
      "env": {
        "CLAWBANK_API_KEY": "cb_your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop. ClawBank tools appear in the tool picker.

Cursor

Config file:

• Global: ~/.cursor/mcp.json
• Project-only: .cursor/mcp.json (in repo root)

{
  "mcpServers": {
    "clawbank": {
      "command": "npx",
      "args": ["-y", "@clawbank/mcp-server"],
      "env": {
        "CLAWBANK_API_KEY": "cb_your_api_key_here"
      }
    }
  }
}

Or via Cursor settings: Settings → MCP → Add new MCP server and paste the block above.

OpenAI Codex CLI

Config file: ~/.codex/config.toml

[mcp_servers.clawbank]
command = "npx"
args   = ["-y", "@clawbank/mcp-server"]

[mcp_servers.clawbank.env]
CLAWBANK_API_KEY = "cb_your_api_key_here"

Step 3 — Use it

Ask your AI:

• "What's my ClawBank balance?"
• "Send 0.01 SOL to <address> with memo 'invoice 42'"
• "Is ClawBank healthy?"

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | CLAWBANK_API_KEY | Yes | — | Your agent API key from the dashboard | | CLAWBANK_API_URL | No | https://clawbank.vercel.app | Override the API base URL (self-hosted) |

How it works

Each API call uses your agent's API key (Authorization: Bearer <key>). ClawBank verifies it against the stored hash, then executes the action on the agent's dedicated Solana wallet.

Transactions are:

• Simulated before broadcast (catches insufficient balance)
• Rate-limited by your daily / per-tx spend limits set in the dashboard
• Logged — full history available in the ClawBank dashboard

License

MIT