How to add Coinbase AgentKit MCP Extension to Claude Desktop

Coinbase's AgentKit MCP extension for onchain actions: transfers, swaps, and contract calls. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 15, 2026 · 900★ · stdio · apikey · official

Claude Desktop config for Coinbase AgentKit MCP Extension

npm install @coinbase/agentkit @coinbase/agentkit-model-context-protocol @modelcontextprotocol/sdk

{
  "mcpServers": {
    "coinbase-agentkit-mcp-extension": {
      "command": "node",
      "args": [
        "/absolute/path/to/your-agentkit-mcp-server.js"
      ],
      "env": {
        "CDP_API_KEY_NAME": "<your-cdp-api-key-name>",
        "CDP_API_KEY_PRIVATE_KEY": "<your-cdp-api-private-key>"
      }
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Coinbase AgentKit MCP Extension config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Coinbase AgentKit MCP Extension's tools appear under the 🔌 tools menu.

Before you start

Node.js 18 or higher
A CDP (Coinbase Developer Platform) API key — create one at portal.cdp.coinbase.com/access/api (used as cdpApiKeyId / cdpApiKeySecret)
Install `@coinbase/agentkit-model-context-protocol`, `@coinbase/agentkit`, and `@modelcontextprotocol/sdk`
A wallet/wallet provider configured in AgentKit (testnet recommended to start)

What Coinbase AgentKit MCP Extension can do in Claude Desktop

get_wallet_details

Return the connected wallet's address and details (default WalletActionProvider)

get_balance

Get the native asset balance of the wallet (default)

native_transfer

Transfer the native asset between addresses (default)

erc20 actions

Get token balance, transfer, approve, and check allowance for ERC-20 tokens (ERC20 action provider)

erc721 actions

Get NFT balance, mint, and transfer ERC-721 tokens (ERC721 action provider)

request_faucet_funds

Request testnet funds via the CDP faucet (CDP action provider)

swap / trade actions

Token swaps via DEX/aggregator providers (e.g. ZeroX, Jupiter, Sushi) when those providers are enabled

DeFi protocol actions

Supply/borrow/earn via providers such as Morpho, Compound, Moonwell, and Superfluid

Security

Configured with a CDP-managed wallet it can sign and broadcast onchain transactions that move real assets; use a CDP wallet funded with minimal value while testing. Keep CDP_API_KEY_NAME and CDP_API_KEY_PRIVATE_KEY out of source control.

Coinbase AgentKit MCP Extension + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Coinbase AgentKit MCP Extension config there under the "mcpServers" key and restart the client.

Is Coinbase AgentKit MCP Extension safe to use with Claude Desktop?

Is this a ready-to-run server or a library?

It's an adapter/library. You write a short stdio MCP server that calls `getMcpTools(agentKit)`; the AgentKit repo includes an example (model-context-protocol-smart-wallet-server) you can copy.

What tools does it expose?

Whatever AgentKit action providers you enable. The default WalletActionProvider gives get_wallet_details, get_balance, and native_transfer; adding providers unlocks 50+ actions across ERC20/721, DeFi, swaps, and price feeds.

Can it move real funds?

Yes — with a funded mainnet wallet, configured actions can send tokens and call contracts. Use testnets, limited wallets, and spend caps while developing.

View repo Full Coinbase AgentKit MCP Extension page