Coinbase AgentKit MCP Server

A Model Context Protocol server that gives AI assistants direct access to your Coinbase wallet — check balances, transfer funds, trade assets, interact with DeFi protocols, and query on-chain data, all through natural language.

You → Claude / VS Code → This MCP Server → Coinbase AgentKit → Base Blockchain

Available Tools

See CLAUDE.md for the full tool list per provider.

Related MCP server: Base MCP Server

Connecting via HTTP (LAN / remote)

The server exposes a Streamable HTTP MCP endpoint at /mcp. Add to mcp.json:

{
  "mcpServers": {
    "coinbase": {
      "url": "http://<server-ip>:3002/mcp"
    }
  }
}

Replace <server-ip> with your Docker host's IP (e.g. 192.168.1.100).

Connecting via stdio (Claude Desktop / local Docker)

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "coinbase": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "CDP_API_KEY_ID",
        "-e", "CDP_API_KEY_SECRET",
        "-e", "CDP_WALLET_SECRET",
        "-e", "NETWORK_ID",
        "-p", "3002:3002",
        "-v", "coinbase_wallet_data:/app/data",
        "ghcr.io/schmalvis/coinbase-mcp-server:latest"
      ],
      "env": {
        "CDP_API_KEY_ID": "your-key-id",
        "CDP_API_KEY_SECRET": "your-api-secret",
        "CDP_WALLET_SECRET": "your-wallet-secret",
        "NETWORK_ID": "base-sepolia"
      }
    }
  }
}

Restart Claude Desktop. Ask: "What Coinbase tools do you have available?" to confirm.

Quick Start (Docker Compose)

cp .env.example .env   # fill in your CDP credentials
docker compose up -d

Web UI available at http://localhost:3002.

Multi-Network

Set NETWORK_ID to a comma-separated list to enable multiple networks:

NETWORK_ID=base-sepolia,base-mainnet

Each tool gains a network parameter — the AI specifies which network per request.

Web UI

When running, a monitoring dashboard is available at http://localhost:3002 (or your server's IP for remote deployments). Shows all available tools and a live rolling activity log.

Further Documentation

Built on Coinbase AgentKit · Model Context Protocol