Setting the file. One moment.
Subchapter 2.4
references/install.mdMarkdown4 KBView on GitHub
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
One-click add:
https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Base%20MCP&connectorUrl=https%3A%2F%2Fmcp.base.orgOr manually:
Base MCPhttps://mcp.base.orgA browser tab opens to authorize on first use — sign in with Base.
Open https://chatgpt.com/#settings/Connectors (opens in a new tab) (or Settings → Connectors), then:
Base MCPWallet and onchain tools for Basehttps://mcp.base.orgOAuthChatGPT prompts for authorization the first time a wallet tool is called.
Add to the current project:
claude mcp add --transport http base-mcp https://mcp.base.orgInstall globally across all projects:
claude mcp add --transport http --scope user base-mcp https://mcp.base.orgVerify:
claude mcp listThe base-mcp server shows with a tool count once active. Inside a session, /mcp also shows server status.
codex mcp add base-mcp --url https://mcp.base.org/Or in codex.toml:
[mcp_servers.base-mcp]
url = "https://mcp.base.org/"Deep link install:
cursor://anysphere.cursor-deeplink/mcp/install?name=base-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5iYXNlLm9yZyJ9Or 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.
Hand the agent the quickstart and let it install itself:
Install the Base MCP server from https://docs.base.org/ai-agents/quickstartManual 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).
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.
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.
| Symptom | Try |
|---|---|
| No browser tab for sign-in | Open 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 missing | App version is too old — update to the latest. |
web_request rejects a hostname | The 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 else | Send the user to https://docs.base.org/ai-agents/quickstart (opens in a new tab). |