Get Started with Base MCP - Base Documentation

Demo

Steps

Connect the MCP

Works in Claude.ai and Claude Apps (Desktop, iOS, Android). Click the button above, or:

Open Customize → Connectors → Add custom connector
The Add custom connector modal opens
Fill in:
- Name: Base MCP
- Remote MCP server URL: https://mcp.base.org
Click Add
Next hit Connect, then approve the connection in Base Account. Click Allow once to authorize:

Click the button above, or open Settings → Connectors manually. Then:

Enable Developer Mode if prompted (under Advanced)
Click Create to open the New App modal
Fill in:
- Name: Base MCP
- Description (optional): Wallet and onchain tools for Base
- MCP Server URL: https://mcp.base.org
- Authentication: OAuth
Check I understand and want to continue on the risk warning
Click Create
You will be automatically redirected to Base Account. Click Allow once to authorize.

Run this in your terminal to add the server to the current project:

Terminal

claude mcp add --transport http base-mcp https://mcp.base.org

To install globally (available across all your projects):

Terminal

claude mcp add --transport http --scope user base-mcp https://mcp.base.org

Verify it connected:

Terminal

claude mcp list

The base-mcp server will show with a tool count once active. You can also run /mcp inside a Claude Code session to see server status.

Terminal

codex mcp add base-mcp --url https://mcp.base.org/

Or add to your codex.toml:

codex.toml

[mcp_servers.base-mcp]
url = "https://mcp.base.org/"

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

mcp.json

{
  "mcpServers": {
    "base-mcp": {
      "url": "https://mcp.base.org"
    }
  }
}

Restart Cursor, then open Settings → MCP to confirm base-mcp shows as active.

Hand the agent this quickstart and let it install itself:

Prompt

Install the Base MCP server from https://docs.base.org/ai-agents/quickstart

Hermes will fetch the page, write the entry to ~/.hermes/config.yaml, and reload — no manual editing needed.Manual install — if you’d rather edit the config yourself:

~/.hermes/config.yaml

mcp_servers:
  base-mcp:
    url: "https://mcp.base.org"

Then start a Hermes chat (or run /reload-mcp inside an existing session) and Hermes will discover the tools automatically.

Install the skill

The base-mcp skill extends your assistant with pre-built prompts and workflows for wallet operations, token transfers, and DeFi interactions on Base.

Pick one of the options below — don’t do both. Running the prompt while a persistent skill is also installed can confuse the assistant about which onboarding to follow.

Option 1: Paste this prompt into a new conversation

Onboard via the SKILL.md

Nothing to install — Claude reads the skill on the fly and fetches each reference or plugin file only when it needs one.Option 2: Install as a persistent skill

Click the button above to download base-mcp.zip, then:

In Claude Desktop or Claude.ai, open Customize → Skills
Click Upload skill and select the downloaded base-mcp.zip
Toggle the skill on

Claude activates the skill automatically when relevant to your prompt. See Use skills in Claude for details.

Pick one of the options below — don’t do both. Running the prompt while a persistent skill is also installed can confuse the assistant about which onboarding to follow.

Option 1: Paste this prompt into a new conversation

Onboard via the SKILL.md

Nothing to install — ChatGPT reads the skill on the fly and fetches each reference or plugin file only when it needs one. Works on any ChatGPT plan.Option 2: Install as a persistent skill (Business, Enterprise, Edu, Teachers, Healthcare plans)

Click the button above to download base-mcp.zip, then:

In ChatGPT, open Settings → Skills
Click Add skill and upload the downloaded base-mcp.zip
Enable the skill for the conversations where you want it active

See Skills in ChatGPT for details.

Terminal

npx skills add base/skills --skill base-mcp -a claude-code

Installs to ~/.claude/skills/base-mcp/. The skill loads on your next session — Claude Code will use it automatically when wallet questions come up.

Terminal

npx skills add base/skills --skill base-mcp -a codex

Installs to ~/.codex/skills/base-mcp/. Codex picks it up automatically on the next run.

Terminal

npx skills add base/skills --skill base-mcp -a cursor

Installs to ~/.cursor/skills/base-mcp/. Cursor picks it up automatically — invoke it in agent chat for any wallet workflow.

Terminal

hermes skills install github:base/skills/base-mcp

Installs to ~/.hermes/skills/base-mcp/. Run /reload-skills inside Hermes (or restart the session) and it’s available immediately.

Try it

Ask your assistant:

Show me my wallets

What's my USDC balance on Base?

Send 1 USDC to jesse.base.eth

Find the best USDC vault on Base by APY and deposit 100 USDC

Every send, swap, or sign operation will give you an approval link. Open it, review the action in Base Account, and confirm.

Documentation Index

​Demo

​Steps

Demo

Steps