Quickstart

Connect Base MCP to your AI assistant in under 2 minutes

Connect mcp.base.org to your AI assistant, then send your first prompt.

Demo

Step 1 — Connect

Claude

Paste https://mcp.base.org as the server URL and save. Works in Claude.ai (web, iOS, Android) and Claude Desktop.

Remote MCP integrations require a Claude Pro, Max, Team, or Enterprise plan.

Claude Desktop config file — if you prefer to configure manually, open Settings → Developer → Edit Config and add:

Platform	Config path
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

claude_desktop_config.json

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

Save and restart Claude Desktop. A wallet icon will appear in the toolbar when connected.

ChatGPT

Then:

1. Enable Developer Mode if prompted (under Advanced)
2. Click Add custom connector
3. Enter the server URL:

https://mcp.base.org

4. Save. ChatGPT will prompt you to authorize when you first use a wallet tool.

MCP connectors require a ChatGPT Plus or Pro plan.

Claude Code

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

Terminal

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

To install globally (available across all your projects):

Terminal

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

Verify it connected:

Terminal

claude mcp list

The base-account 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-account --url https://mcp.base.org/

Or add to your codex.toml:

codex.toml

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

Cursor

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

mcp.json

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

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

VS Code

Or add manually to .vscode/mcp.json (workspace) or your user MCP settings:

.vscode/mcp.json

{
  "servers": {
    "base-account": {
      "type": "http",
      "url": "https://mcp.base.org"
    }
  }
}

Open Copilot Chat in agent mode and confirm the wallet tools appear in the tool picker.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

mcp_config.json

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

Restart Windsurf. Open Cascade — the MCP tools will be available once connected.

You can also add MCP servers from the UI: open Cascade → click the hammer icon → Add MCP Server.

Other clients — Any MCP client that supports remote HTTP (Streamable HTTP) servers works with https://mcp.base.org. See the setup guide for Zed, JetBrains, Le Chat (Mistral), Warp, and others. On mobile, the Claude connector above works in the iOS and Android apps.

Step 2 — Authorize

The first time you use a wallet tool, your assistant will redirect you to keys.coinbase.com to connect your Base Account. You’ll need a Coinbase account. Once authorized, all transactions still require individual approval at that same URL.

Step 3 — Try it

Ask your assistant:

Show me my wallets

What's my USDC balance on Base?

Send 1 USDC to vitalik.base.eth

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

---

Add a plugin — Morpho lending

Morpho lets your assistant query vaults, check APYs, and execute lending operations on Base — then sign them through your Base Account.

Add both MCPs to your config:

Claude

claude_desktop_config.json

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

Claude Code

Terminal

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

Cursor / VS Code / Windsurf / Codex

Add a second entry alongside base-account:

"morpho": { "url": "https://mcp.morpho.org/" }

Then try:

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

Morpho prepares the transaction; your Base Account signs it. See Morpho plugin →

Next steps

Guides

Step-by-step guides for sending, swapping, checking balance, and more.

Morpho plugin

Query vaults, check APYs, and execute lending operations on Base.

Setup guide

Detailed platform setup, auth flow, and approval mode explained.

Skills

Install the base-mcp skill for your coding assistant.