Skip to main content

​
Installing Base MCP

Canonical source: https://docs.base.org/ai-agents/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://mcp.base.org

​
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%2Fmcp.base.org
Or manually:
  1. Open Customize → Connectors → Add custom connector
  2. Fill in:
    • Name: Base MCP
    • Remote MCP server URL: https://mcp.base.org
  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://mcp.base.org
    • 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://mcp.base.org
Install globally across all projects: 
claude mcp add --transport http --scope user base-mcp https://mcp.base.org
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://mcp.base.org/
Or in codex.toml: 
[mcp_servers.base-mcp]
url = "https://mcp.base.org/"

​
Cursor

Deep link install: 
cursor://anysphere.cursor-deeplink/mcp/install?name=base-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5iYXNlLm9yZyJ9
Or manually in ~/.cursor/mcp.json (global) or .cursor/mcp.json (project): 
{
  "mcpServers": {
    "base-mcp": {
      "url": "https://mcp.base.org"
    }
  }
}
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.base.org/ai-agents/quickstart
Manual install — edit ~/.hermes/config.yaml: 
mcp_servers:
  base-mcp:
    url: "https://mcp.base.org"
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

SymptomTry
No browser tab for sign-inOpen https://mcp.base.org directly, sign in, then re-add the server.
”Integration not found” / “Tool not available”Restart the app — the server may not have finished loading.
Integrations / Connectors tab missingApp version is too old — update to the latest.
web_request rejects a hostnameThe hostname isn’t in the allowlist. For native HTTP plugins, use the harness HTTP tool if one is available; for custom plugins see custom-plugins.md. CLI-only plugins do not use web_request.
Anything elseSend the user to https://docs.base.org/ai-agents/quickstart.