Coinbase (Base) MCP Server

Base MCP was a Model Context Protocol server published by the Base team (Coinbase) that exposed onchain tools to LLM clients like Claude Desktop and Cursor. It wrapped AgentKit ActionProviders to let an AI agent read wallet state, transfer funds, deploy and call smart contracts, manage ERC20 tokens and NFTs, query Morpho vaults, generate Coinbase onramp URLs, check address reputation, and buy OpenRouter credits with USDC on the Base network.

The project was designed to be extensible: tools lived in src/tools/<tool-name> directories and were registered as AgentKit ActionProviders, so third parties could add their own protocols, data sources, and onchain actions. Authentication required a Coinbase Developer Platform API key, a wallet seed phrase, an Alchemy API key, and other provider keys (Pinata, OpenRouter) depending on the tools used.

Status: As of May 13, 2026, the base/base-mcp repository is archived and the base-mcp npm package is deprecated. Base now directs developers to its AI Agents documentation at docs.base.org/ai-agents, including dedicated quickstarts for payments (x402) and trading agents. Use that documentation for new integrations.

Tools

Deprecation notice: The base/base-mcp repo is archived and the base-mcp npm package is deprecated as of May 13, 2026. New integrations should follow the Base AI Agents docs and the payments and trading quickstarts instead. The instructions below describe the final published version (v1.0.13-final) for historical reference.

Prerequisites

• Coinbase Developer Platform API key (COINBASE_API_KEY_NAME, COINBASE_API_PRIVATE_KEY)
• A wallet seed phrase (SEED_PHRASE) the server will use to sign transactions
• A Coinbase Developer Platform project ID (COINBASE_PROJECT_ID)
• Alchemy API key (ALCHEMY_API_KEY)
• Optional: PINATA_JWT, OPENROUTER_API_KEY, CHAIN_ID (for Base Sepolia testnet)

Claude Desktop / Cursor config

{
  "mcpServers": {
    "base-mcp": {
      "command": "npx",
      "args": ["-y", "base-mcp@latest"],
      "env": {
        "COINBASE_API_KEY_NAME": "your_api_key_name",
        "COINBASE_API_PRIVATE_KEY": "your_private_key",
        "SEED_PHRASE": "your seed phrase here",
        "COINBASE_PROJECT_ID": "your_project_id",
        "ALCHEMY_API_KEY": "your_alchemy_api_key",
        "PINATA_JWT": "your_pinata_jwt",
        "OPENROUTER_API_KEY": "your_openrouter_api_key",
        "CHAIN_ID": "optional_for_base_sepolia_testnet"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

From source

git clone https://github.com/base/base-mcp.git
cd base-mcp
npm install
npm run build

Then point your MCP client at the built dist/index.js entrypoint using a node command instead of npx.

Security

The seed phrase grants full control over the wallet. Use a dedicated agent wallet with limited funds, and never share the config file.

• Let an AI agent hold and spend funds on Base, transferring ETH or ERC20 tokens to counterparties from chat.
• Generate Coinbase onramp links inside an agent flow so users can fund the wallet with fiat without leaving the conversation.
• Deploy and interact with smart contracts on Base directly from a prompt for rapid prototyping.
• Allocate USDC into Morpho vaults by querying available vaults and routing deposits through call_contract.
• Auto-purchase OpenRouter credits with USDC to keep an agent's own LLM budget topped up.

• "What is my Base wallet address and what tokens am I holding?"
• "Send 5 USDC on Base to 0xabc...123 and confirm the tx hash."
• "Generate a Coinbase onramp URL so I can buy 50 USD of USDC on Base."
• "List the Morpho vaults available for USDC and tell me which has the best APY."
• "Transfer NFT token ID 42 from contract 0x... to 0xrecipient... using the ERC721 standard."

• Built by the Base team at Coinbase, with first-party access to Coinbase Developer Platform, AgentKit, and onramp APIs.
• Broad onchain toolset covering wallet, ERC20, NFT, contract deployment, and DeFi (Morpho) actions out of the box.
• Extensible architecture based on AgentKit ActionProviders, making it straightforward to add custom protocols.

• Repository is archived and the npm package is deprecated as of May 13, 2026. No further updates or security fixes.
• Requires storing a raw seed phrase in the MCP client config, which is a significant security risk if the config file leaks.
• Needs multiple third-party API keys (Coinbase CDP, Alchemy, optionally Pinata and OpenRouter) before most tools become useful.

• Coinbase AgentKit with its MCP extension, the actively maintained successor for building onchain agents.
• Base AI Agents quickstarts for x402 payments and trading agents, the path Base itself now recommends.
• Community EVM MCP servers (for example wallet or viem-based MCPs) for generic Ethereum and L2 onchain access.