Get Started with Base MCP

Connect Base MCP to your agent in under 5 minutes

Demo

Steps

1. Connect the MCP

   Claude

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

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

   ChatGPT

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

   1. Enable Developer Mode if prompted (under Advanced)
   2. Click Create to open the New App modal
   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
   6. You will be automatically redirected to Base Account. Click Allow once to authorize.

   Claude Code

   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.

   Codex

   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/"
   

   Cursor

   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.

   Hermes

   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.

2. 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.

   Claude

   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

   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:

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

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

   ChatGPT

   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

   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:

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

   See Skills in ChatGPT for details.

   Claude Code

   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.

   Codex

   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.

   Cursor

   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.

   Hermes

   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.

3. 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.