Coinbase AgentKit MCP Server

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

| Category | Tools | |----------|-------| | Wallet | get_wallet_details, native_transfer | | Tokens (ERC-20) | get_balance, transfer, approve, get_allowance | | NFTs (ERC-721) | mint, transfer, get_balance | | WETH | wrap_eth, unwrap_eth | | Swaps & routing | get_swap_price, swap, route (mainnet) | | Basenames | register_basename | | Compound | supply, withdraw, borrow, repay, get_portfolio | | Morpho | deposit, withdraw | | Superfluid | streams, pools, super tokens, wrapping | | DeFiLlama | find_protocol, get_protocol, get_token_prices | | Pyth | fetch_price_feed, fetch_price | | CDP | request_faucet_funds (testnet), get_swap_price, swap |

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

---

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

| Topic | Doc | |-------|-----| | CDP credentials and env vars | docs/configuration.md | | Running locally and development | docs/development.md | | Docker, Portainer, and GitOps deployment | docs/deployment.md | | Web UI and activity log | docs/web-ui.md | | Wallet management and testnet vs mainnet | docs/wallet.md |

---

Built on Coinbase AgentKit · Model Context Protocol