/base-mcp

Installing Base MCP

Canonical source: https://docs.cdp.coinbase.com/ai-agents/coinbase-for-agents/wallet-mcp#quickstart. That page is kept up to date with the latest one-click install links, deep-links, and connector flows for each surface. Send the user there first; the instructions below are a backup so the agent can still walk a user through install without leaving the chat.

The MCP server URL is the same everywhere: https://wallet-mcp.coinbase.com (the previous URL, https://mcp.base.org, still works for existing connections)

Claude (Claude.ai web, Claude Desktop, iOS, Android)

One-click add:

https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Base%20MCP&connectorUrl=https%3A%2F%2Fwallet-mcp.coinbase.com

Or manually:

1. Open Customize → Connectors → Add custom connector
2. Fill in:
   • Name: Base MCP
   • Remote MCP server URL: https://wallet-mcp.coinbase.com
3. Click Add

A browser tab opens to authorize on first use — sign in with Base.

ChatGPT

Open https://chatgpt.com/#settings/Connectors (or Settings → Connectors), then:

1. Enable Developer Mode if prompted (under Advanced)
2. Click Create → New App modal opens
3. Fill in:
   • Name: Base MCP
   • Description (optional): Wallet and onchain tools for Base
   • MCP Server URL: https://wallet-mcp.coinbase.com
   • Authentication: OAuth
4. Check I understand and want to continue on the risk warning
5. Click Create

ChatGPT prompts for authorization the first time a wallet tool is called.

Claude Code

Add to the current project:

claude mcp add --transport http base-mcp https://wallet-mcp.coinbase.com

Install globally across all projects:

claude mcp add --transport http --scope user base-mcp https://wallet-mcp.coinbase.com

Verify:

claude mcp list

The base-mcp server shows with a tool count once active. Inside a session, /mcp also shows server status.

Codex

codex mcp add base-mcp --url https://wallet-mcp.coinbase.com/

Or in codex.toml:

[mcp_servers.base-mcp]
url = "https://wallet-mcp.coinbase.com/"

Cursor

Deep link install:

cursor://anysphere.cursor-deeplink/mcp/install?name=base-mcp&config=eyJ1cmwiOiJodHRwczovL3dhbGxldC1tY3AuY29pbmJhc2UuY29tIn0=

Or manually in ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "base-mcp": {
      "url": "https://wallet-mcp.coinbase.com"
    }
  }
}

Restart Cursor, then Settings → MCP to confirm base-mcp is active.

Hermes

Hand the agent the quickstart and let it install itself:

Install the Base MCP server from https://docs.cdp.coinbase.com/ai-agents/coinbase-for-agents/wallet-mcp#quickstart

Manual install — edit ~/.hermes/config.yaml:

mcp_servers:
  base-mcp:
    url: "https://wallet-mcp.coinbase.com"

Then start a new chat (or /reload-mcp in an existing one).

Authorization (first use)

The first time a wallet tool is called, an auth modal opens for the user to authorize the Base Account. Click Allow once. (See the live demo on the quickstart page.) After that, write operations still require per-transaction approval — see approval-mode.md.

Did it work?

Ask the assistant:

Show me my wallets

If it replies with a wallet address, the MCP is connected. If it says it doesn't have wallet tools, the MCP isn't loaded — retry the install steps or fall back to the quickstart link.

Troubleshooting