> ## Documentation Index > Fetch the complete documentation index at: https://docs.cdp.coinbase.com/llms.txt > Use this file to discover all available pages before exploring further. # Wallet MCP > Connect an AI agent to Coinbase Wallet, complete common wallet tasks, and extend it with plugins. export const TruncatedPrompt = ({description, children}) => { const extractText = node => { if (node == null || typeof node === "boolean") return ""; if (typeof node === "string" || typeof node === "number") return String(node); if (Array.isArray(node)) return node.map(extractText).join(""); if (typeof node === "object" && node.props) { const inner = extractText(node.props.children); if (node.type === "code") return "`" + inner + "`"; return inner; } return ""; }; const text = extractText(children).replace(/\s+/g, " ").trim(); const [expanded, setExpanded] = useState(false); const [copied, setCopied] = useState(false); const timeoutRef = useRef(null); useEffect(() => () => { if (timeoutRef.current) clearTimeout(timeoutRef.current); }, []); const handleCopy = () => { navigator.clipboard.writeText(text).then(() => { setCopied(true); if (timeoutRef.current) clearTimeout(timeoutRef.current); timeoutRef.current = setTimeout(() => setCopied(false), 1500); }).catch(() => {}); }; const mono = "ui-monospace,'SF Mono','Cascadia Code',Menlo,Monaco,Consolas,monospace"; const sans = "ui-sans-serif,system-ui,-apple-system,'Segoe UI',Roboto,sans-serif"; return

{description &&

{description}

}

 setExpanded(e => !e)} style={{
    flex: 1,
    minWidth: 0,
    fontFamily: mono,
    fontSize: 13,
    lineHeight: 1.55,
    cursor: "pointer",
    whiteSpace: expanded ? "pre-wrap" : "nowrap",
    overflow: expanded ? "visible" : "hidden",
    textOverflow: expanded ? "clip" : "ellipsis",
    wordBreak: expanded ? "break-word" : "normal"
  }}>
          {text}

; }; Wallet MCP gives your AI assistant direct access to your [Coinbase Wallet](/coinbase-wallet/overview) (formerly known as Base App). Connect once and your assistant can interact with DeFi protocols, check balances, send funds, swap tokens, sign messages, execute contract calls, and pay x402-enabled APIs across multiple networks. Every write action requires your approval. If you're looking for the canonical machine-readable docs index, fetch the uppercase `AGENTS.md` at [https://docs.base.org/AGENTS.md](https://docs.base.org/AGENTS.md) — note the uppercase filename (`AGENTS.md`, not `agents.md`). It's a compact, directory-grouped index of the entire Base documentation, built for agents to navigate before generating code. ## Demo ## How It Works ```mermaid Approval Flow lines wrap expandable theme={null} sequenceDiagram participant User participant AI as AI Assistant participant MCP as Wallet MCP participant Account as Coinbase Wallet User->>AI: "Send 10 USDC to alice.base.eth" AI->>MCP: send(recipient, amount, asset, chain) MCP->>Account: Request user approval Account-->>MCP: approvalUrl + requestId MCP-->>AI: { approvalUrl, requestId } AI-->>User: "Please approve: [link]" User->>Account: Opens link, reviews, approves AI->>MCP: get_request_status(requestId) MCP-->>AI: confirmed AI-->>User: "Done — 10 USDC sent" ``` ## Explore Wallet MCP Connect Wallet MCP to your AI assistant and install the skill. Check balances, send and swap tokens, sign messages, execute calls, and make x402 payments. Use supported protocols for trading, lending, commerce, token launches, and other onchain actions. Add a protocol with an HTTP transaction builder, CLI, SDK, or MCP server. ## Quickstart ### Steps

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**: `Wallet MCP` * **Remote MCP server URL**: `https://mcp.base.org` 4. Click **Add** 5. Next hit **Connect**, then approve the connection in Coinbase Wallet. Click **Allow** once to authorize:

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**: `Wallet 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 Coinbase Wallet. Click **Allow** once to authorize.

Click the button above, or open [**Connectors**](https://www.perplexity.ai/computer/connectors) manually. Then: 1. Search for `Base` to find the **Base by Coinbase** connector 2. Click to add it 3. Approve the connection in Coinbase Wallet. Click **Allow** once to authorize. Run this in your terminal to add the server to the current project: ```bash Terminal theme={null} claude mcp add --transport http base-mcp https://mcp.base.org ``` To install globally (available across all your projects): ```bash Terminal theme={null} claude mcp add --transport http --scope user base-mcp https://mcp.base.org ``` Verify it connected: ```bash Terminal theme={null} 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. ```bash Terminal theme={null} codex mcp add base-mcp --url https://mcp.base.org/ ``` Or add to your `codex.toml`: ```toml codex.toml theme={null} [mcp_servers.base-mcp] url = "https://mcp.base.org/" ```

Or add manually to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project): ```json mcp.json theme={null} { "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: ```text Prompt theme={null} Install the Wallet MCP server from /ai-agents/coinbase-for-agents/wallet-mcp#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: ```yaml ~/.hermes/config.yaml theme={null} 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. 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** I'd like to use Wallet MCP. For setup notes, please open `https://docs.cdp.coinbase.com/coinbase-for-agents/wallet-mcp/skill.md` as your reference. If your built-in browser can't reach the page, the Wallet MCP also exposes a `web_request` tool that can fetch it. If a section points to a related file under `references/` or `plugins/`, open that one too when it's relevant to what I'm asking. 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**](https://claude.ai/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](https://support.claude.com/en/articles/12512180-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** I'd like to use Wallet MCP. For setup notes, please open `https://docs.cdp.coinbase.com/coinbase-for-agents/wallet-mcp/skill.md` as your reference. If your built-in browser can't reach the page, the Wallet MCP also exposes a `web_request` tool that can fetch it. If a section points to a related file under `references/` or `plugins/`, open that one too when it's relevant to what I'm asking. 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**](https://chatgpt.com/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](https://help.openai.com/en/articles/20001066-skills-in-chatgpt) for details.

&... API-->>AI: { to, value, data, chainId } AI->>BA: send_calls(chain, calls=[...]) BA-->>AI: { approvalUrl, requestId } AI-->>User: "Please approve: [link]" User-->>AI: approved AI->>BA: get_request_status(requestId) BA-->>AI: confirmed ``` ### Build It #### 1. Pick a Response Shape Your prepare endpoint should return a single object with the fields `send_calls` needs. Two common shapes: **Envelope** (Avantis-style): ```json Envelope Response lines wrap expandable theme={null} { "ok": true, "data": { "to": "0x...", "value": "0x0", "data": "0x...", "chainId": 8453 } } ``` **Ordered batch** (Moonwell-style) — for when approval, enter-market, and the action are separate calls: ```json Ordered Batch Response theme={null} { "transactions": [ { "step": "approve", "to": "0x...", "data": "0x...", "value": "0x0", "chainId": 8453 }, { "step": "action", "to": "0x...", "data": "0x...", "value": "0x0", "chainId": 8453 } ] } ``` Either works. The batch shape is preferable when allowance or registration steps must run before the action — `send_calls` executes them atomically in one approval. #### 2. Write the Plugin Spec Use this template as `plugins/my-protocol.md` in your skill, or as an `.mdx` page if you're publishing docs. ````markdown plugins/my-protocol.md lines wrap expandable theme={null} # My Protocol Plugin > [!IMPORTANT] > ## STOP — COMPLETE ONBOARDING BEFORE USING THIS PLUGIN > > Before calling any My Protocol endpoint, you MUST complete the Wallet MCP onboarding flow: > 1. Call `get_wallets` (Detection) > 2. Present wallet status and disclaimer (Onboarding) > > The user's wallet address — required by every prepare call — is only confirmed during Detection. My Protocol is a . Fetch unsigned calldata from the My Protocol API, then execute via Wallet MCP's `send_calls`. **Fetching calldata:** the My Protocol API is not on the Wallet MCP `web_request` allowlist. Construct the prepare URL as a GET with all parameters in the query string. If `web_request` rejects it, fetch through whatever capability the harness exposes, or ask the user to paste the response into the chat. Then continue with `send_calls`. **Supported chain:** Base mainnet (`8453` / `0x2105`). --- ## Read endpoints ``` GET https://api.myprotocol.xyz/v1/state/

``` ## Prepare endpoint ``` GET https://api.myprotocol.xyz/v1/prepare/?from=

&amount= ``` Response: ```json { "transactions": [ { "step": "approve", "to": "0x...", "data": "0x...", "value": "0x0", "chainId": 8453 }, { "step": "action", "to": "0x...", "data": "0x...", "value": "0x0", "chainId": 8453 } ] } ``` ## send_calls mapping Pass every `transactions[*]` to `send_calls`: ```json { "chain": "base", "calls": [ { "to": "", "value": "", "data": "" } ] } ``` ## Orchestration pattern ``` 1. get_wallets -> address 2. Fetch GET /state/

-> validate balances/preconditions 3. Fetch GET /prepare/?from=