How to add Coinbase AgentKit MCP Extension to Cursor

Coinbase's AgentKit MCP extension for onchain actions: transfers, swaps, and contract calls. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the Coinbase AgentKit MCP Extension config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of Coinbase AgentKit MCP Extension's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.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 Cursor?

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