How to add Coinbase AgentKit MCP Extension to Windsurf

Coinbase's AgentKit MCP extension for onchain actions: transfers, swaps, and contract calls. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

Windsurf 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 Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Coinbase AgentKit MCP Extension config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Coinbase AgentKit MCP Extension's tools become available to Cascade.

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 Windsurf

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

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_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 Windsurf?

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