Setup

Connect Base MCP to Claude Desktop, Claude.ai, ChatGPT, Claude Code, Cursor, VS Code, Windsurf, Zed, JetBrains, Le Chat, Warp, and more

Base MCP lives at https://mcp.base.org. Add it to your AI assistant once and your wallet tools are available in every conversation.

Authentication

Connecting mcp.base.org requires a Coinbase account with a Base Account (smart wallet). When you first use a transactional tool (send, swap, sign), your assistant will return an approvalUrl — open it at keys.coinbase.com to authorize your Base Account and approve the transaction.

Every individual transaction requires approval at keys.coinbase.com. Your assistant never has unilateral access to your funds.

Platform setup

Claude Desktop

Click the button above to open the connector settings directly, paste https://mcp.base.org, and save.

Or edit the config file manually:

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

Restart Claude Desktop. The wallet MCP will show as connected in the toolbar.

---

ChatGPT

1. Enable Developer Mode if prompted (under Advanced)
2. Click Add custom connector
3. Enter https://mcp.base.org as the server URL
4. Save

On first use, ChatGPT will prompt you to authorize your Coinbase account.

---

Claude Code

Terminal

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

This writes to your project’s .claude/settings.json. To add globally (all projects):

Terminal

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

Verify the connection:

Terminal

claude mcp list

---

Codex

Terminal

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

Or add to codex.toml:

codex.toml

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

---

Cursor

Or add manually to ~/.cursor/mcp.json:

~/.cursor/mcp.json

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

---

VS Code

Or add to your VS Code MCP settings:

settings.json

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

---

Windsurf

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

mcp_config.json

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

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

---

Zed

Add to your Zed settings.json (~/.config/zed/settings.json on macOS/Linux, %APPDATA%\Zed\settings.json on Windows):

settings.json

{
  "context_servers": {
    "base-account": {
      "source": "custom",
      "command": {
        "path": "npx",
        "args": ["-y", "mcp-remote", "https://mcp.base.org"]
      }
    }
  }
}

Zed does not yet support native remote HTTP MCP servers. The snippet above uses mcp-remote as a local proxy bridge — no pre-install needed. See Zed MCP docs for the latest config format.

---

JetBrains AI Assistant

1. Open your JetBrains IDE (IntelliJ, WebStorm, PyCharm, etc.)
2. Go to Settings → AI Assistant → Model Context Protocol (MCP)
3. Click Add and select HTTP as the transport
4. Enter https://mcp.base.org as the server URL
5. Apply and restart the IDE

See JetBrains AI Assistant MCP docs for full configuration options.

---

Le Chat (Mistral)

1. Open mistral.ai and sign in
2. Go to Settings → Connectors
3. Click Add custom connector
4. Enter https://mcp.base.org as the server URL
5. Save and return to a chat

See Le Chat MCP connector docs for full details.

---

Warp

1. Open Warp terminal
2. Go to Settings → AI → MCP Servers
3. Click Add server
4. Select SSE as the transport and enter https://mcp.base.org as the URL
5. Save — the server starts automatically with Warp

See Warp MCP docs for CLI-based setup.

---

Approval mode

All write operations (send, swap, sign, send_calls) work in approval mode:

1. Your assistant calls the tool

   You ask your assistant to send funds, swap tokens, or sign a message.

2. You receive an approval link

   Your assistant returns an approvalUrl (at keys.coinbase.com) and a requestId.

3. You approve

   Open the link, review the transaction details, and confirm. Nothing is signed until you do.

4. Transaction completes

   Your assistant polls get_request_status with the requestId and confirms completion once you’ve approved.

Next steps

Guides

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

Plugins

Add Morpho for lending and vault operations on Base.