/wallet-mcp

Installing Wallet 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=Wallet%20MCP&connectorUrl=https%3A%2F%2Fwallet-mcp.coinbase.com

Or manually:

1. Open Customize → Connectors → Add custom connector
2. Fill in:
   • Name: Wallet 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 your Coinbase Wallet Account.

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: Wallet MCP
   • Description (optional): Wallet and onchain tools across supported chains
   • 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 wallet-mcp https://wallet-mcp.coinbase.com

Install globally across all projects:

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

Verify:

claude mcp list

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

Codex

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

Or in codex.toml:

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

Cursor

Deep link install:

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

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

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

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

Hermes

Hand the agent the quickstart and let it install itself:

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

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

mcp_servers:
  wallet-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 Coinbase Wallet 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