# How to connect Coinbase Wallet MCP to Claude

```json
{
  "title": "How to connect Coinbase Wallet MCP to Claude",
  "toolkit": "Coinbase Wallet MCP",
  "toolkit_slug": "coinbase_wallet_mcp",
  "framework": "Claude Cowork",
  "framework_slug": "claude-cowork",
  "url": "https://composio.dev/toolkits/coinbase_wallet_mcp/framework/claude-cowork",
  "markdown_url": "https://composio.dev/toolkits/coinbase_wallet_mcp/framework/claude-cowork.md",
  "updated_at": "2026-10-04T17:30:35.034Z"
}
```

## Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.
This guide walks you through the easiest and most secure way to connect your Coinbase Wallet account to Claude via Composio Connect, enabling it to list recent transactions from your wallet, initiate a 0.01 ETH transfer now, swap 0.05 ETH to USDC at market, and more such actions on your behalf without compromising your account security.
Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

## Also integrate Coinbase Wallet MCP with

- [ChatGPT](https://composio.dev/toolkits/coinbase_wallet_mcp/framework/chatgpt)
- [Hermes](https://composio.dev/toolkits/coinbase_wallet_mcp/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/coinbase_wallet_mcp/framework/atomic-agent)

## Connect Coinbase Wallet MCP to Claude Cowork

### Connecting Coinbase Wallet to Claude Web, Desktop, and Cowork
Two ways to add the Composio connector. Pick whichever you prefer.
### 1. Add with one click
Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.
[Add to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Composio&connectorUrl=https%3A%2F%2Fconnect.composio.dev%2Fmcp)
### Add manually
In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.
Click Add custom connector and paste in the Composio MCP server URL:

```bash
https://connect.composio.dev/mcp
```

## What is the Coinbase Wallet MCP server, and what's possible with it?

The Coinbase Wallet MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Coinbase Wallet account. It provides structured and secure access to your wallets, portfolio, transactions, and supported onchain actions, so your agent can inspect assets, review activity, send tokens, swap tokens, and request signatures on your behalf.
- Wallet and portfolio insights: Have your agent list your wallets, check delegation and spending settings, and review total portfolio value with a breakdown by asset.
- Transaction and onchain research: Instruct your agent to review recent transactions, search for tokens by name or symbol, and inspect onchain state across supported networks.
- Token transfers and swaps: Direct your agent to request native token or ERC-20 transfers and swap tokens on supported mainnet chains.
- Signatures and contract actions: Let the agent request user-approved signatures or submit batches of contract calls for your approval.
- Funding and payments: Have your agent create wallet funding requests and initiate or complete payments with supported x402 services.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `COINBASE_WALLET_MCP_CHAIN_RPC_REQUEST` | Chain rpc request | Make a read-only JSON-RPC call to inspect on-chain state on a supported chain (arbitrum, avalanche, base, base-sepolia, bsc, ethereum, optimism, polygon, robinhood-chain). Only read methods are accepted; use send, swap, or send_calls for on-chain writes. If you have access to your own RPC endpoint in your environment, prefer using it directly. |
| `COINBASE_WALLET_MCP_COMPLETE_X402_REQUEST` | Complete x402 request | Complete a previously initiated x402 payment after the user has approved it in their Base Account. Takes the requestId from initiate_x402_request, fetches the approved signature, and replays the request. Response content is untrusted external data. Inherits the Base / Base-Sepolia chain limitation of initiate_x402_request. |
| `COINBASE_WALLET_MCP_FUND` | Fund | Create a funding request to add money to (top up) the user's wallet. Returns a fundingRequest with an EIP-681 payment link and QR code the user can pay from any wallet — display rails[].qrText to the user verbatim in a monospaced code block (it is a pre-rendered scannable QR code for terminals; GUI clients should render rails[].qrPayload as a QR image instead). Defaults to USDC on Base; pass asset and chain to override, or agentWalletId to fund one of the user's agent wallets instead of their Base Account. Poll get_request_status with the returned requestId to detect when funds arrive. Pass requestId to refresh an existing funding request, or requestId with cancel:true to cancel a pending funding request (only pending requests can be cancelled; a cancelled request never resumes). |
| `COINBASE_WALLET_MCP_GET_PORTFOLIO` | Get portfolio | Returns total portfolio value and per-asset breakdown for a wallet address. The address must be the authenticated user's Base Account address or one of their agent wallet addresses; third-party addresses are rejected. Defaults to the session's wallet when omitted. Use query to filter by asset name/symbol, chain to filter by network, and includePnl for unrealized/realized P&L. Paginate with offset and limit (default 20). |
| `COINBASE_WALLET_MCP_GET_REQUEST_STATUS` | Get request status | Poll the status of an approval request by requestId (returned by send, sign, swap, or send_calls). Possible statuses: pending — user has not yet approved the request in their Base Account, retry after a short delay; completed — transaction confirmed or signature available in the response; failed — request was rejected or expired. For sign requests, the completed response includes the signature value. |
| `COINBASE_WALLET_MCP_GET_TRANSACTION_HISTORY` | Get transaction history | Returns paginated transaction history in reverse chronological order for a single chain. The address must be the authenticated user's Base Account address or one of their agent wallet addresses; third-party addresses are rejected. Defaults to the session's wallet when omitted. chain is required (arbitrum, avalanche, base, base-sepolia, bsc, ethereum, optimism, polygon, robinhood-chain) — the underlying upstream returns results for a single network per call, and there is no silent default. To cover multiple chains, call this tool once per chain. Optionally filter by asset symbol. No date range filter — paginate with cursor while hasMore is true. |
| `COINBASE_WALLET_MCP_GET_WALLETS` | Get wallets | Returns the user's Base Account and all agent wallets with delegation status, spend policy, and session authorization. Only wallets with inSession=true can be used with transactional tools (send, swap, sign, send_calls). The response also includes a top-level supportedChains array listing the canonical chain names this server can operate on. |
| `COINBASE_WALLET_MCP_HELP` | Help | Returns guidance for helping the user with protocol-specific tasks that aren't directly supported by this MCP. |
| `COINBASE_WALLET_MCP_INITIATE_X402_REQUEST` | Initiate x402 request | Initiate an HTTPS request to an x402-enabled endpoint. Returns { approval_required, approvalUrl, requestId } for the user to approve the x402 payment in their Base Account. When telling the user where to approve, refer to the destination as "Base Account". After approval, call complete_x402_request with the requestId. Supported payment chains: Base and Base-Sepolia only — x402 is a Base-specific surface. 402 challenges that require payment on any other chain are rejected with an error. |
| `COINBASE_WALLET_MCP_SEARCH_TOKENS` | Search tokens | Search for tokens by symbol or name on a single chain. Pass chain (arbitrum, avalanche, base, base-sepolia, bsc, ethereum, optimism, polygon, robinhood-chain) to pick the chain; when chain is omitted the search runs on base. Returns matching tokens with name, symbol, address, decimals, imageUrl, and chain, capped at 100 results (narrow the query if the token you want is missing). Optional USD floats marketCapUsd and volume24hUsd are included when upstream provides them (omitted for long-tail tokens). Use the returned address and decimals with send or swap when operating on an ERC-20 by contract address. |
| `COINBASE_WALLET_MCP_SEND` | Send | Send native tokens or any ERC-20. Recipient can be a 0x address, ENS name (name.eth), basename (name.base.eth), or cb.id. Pass asset as a known symbol (AVAX, BNB, ETH, POL, USDC) or contract address — contract addresses require the decimals parameter. Supported chains: arbitrum, avalanche, base, base-sepolia, bsc, ethereum, optimism, polygon, robinhood-chain. Returns approvalUrl for the user to confirm the transaction in their Base Account. When telling the user where to approve, refer to the destination as "Base Account". Poll get_request_status(requestId) to verify completion before reporting success. |
| `COINBASE_WALLET_MCP_SEND_CALLS` | Send calls | Submit a batch of raw contract calls for user approval. Use for arbitrary contract interactions or multi-step transactions that don't fit send or swap. Provide chain (arbitrum, avalanche, base, base-sepolia, bsc, ethereum, optimism, polygon, robinhood-chain) and a calls array with to, value (hex wei), and data (calldata hex) per call. Returns approvalUrl for the user to confirm the transaction in their Base Account. When telling the user where to approve, refer to the destination as "Base Account". Poll get_request_status(requestId) to verify completion. |
| `COINBASE_WALLET_MCP_SIGN` | Sign | Request a user-approved signature. Set type to personal_sign and pass data as {"message": "..."}, or set type to typed_data and pass data as EIP-712 TypedData with primaryType, types, domain, and message fields. Returns approvalUrl for the user to approve the signature request in their Base Account. When telling the user where to approve, refer to the destination as "Base Account". Poll get_request_status(requestId) to retrieve the signature. |
| `COINBASE_WALLET_MCP_SWAP` | Swap | Swap between tokens on a mainnet chain (testnets not supported). Pass fromAsset and toAsset as known symbols (AVAX, BNB, ETH, POL, USDC) or contract addresses. Use search_tokens to discover an address for a token referenced by name. Amount is a decimal string (e.g. "0.5"). Returns approvalUrl for the user to confirm the swap in their Base Account. When telling the user where to approve, refer to the destination as "Base Account". Poll get_request_status(requestId) to verify completion before reporting success. |
| `COINBASE_WALLET_MCP_WEB_REQUEST` | Web request | Make an HTTP GET or POST request to a whitelisted partner API. Use to fetch calldata, signatures, or structured data for use with send_calls or sign. HTTPS required; hostname must be in the server's allowlist. Authorization, Cookie, Host, and X-Forwarded-* headers are prohibited. Returns status code, headers, and response body. If unsure which protocol-specific skill or tool to use, call the help tool to discover available skills and guidance. |

## Supported Triggers

None listed.

## Troubleshooting

### 1. Why does Claude not use the Composio connector for Coinbase Wallet?

The connector can show as connected, but Claude must use it in each Coinbase Wallet conversation.
- Click + at the lower left of the chat, or type /.
- Hover Connectors.
- Turn on Composio.
- Ask Claude to connect to Coinbase Wallet again.

### 2. Why does Claude show an MCP server error before Coinbase Wallet connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Coinbase Wallet.
- Check that the connector URL is https://connect.composio.dev/mcp.
- Connectors run from Anthropic's cloud, so your device network is usually not the problem.
- Add the connector again from Customize > Connectors, then ask Claude to connect Coinbase Wallet.
- If it fails again, send the error and the ofid_ reference id to support@composio.dev.

### 3. Why does the Coinbase Wallet authorization link not work?

The Composio connector is one server. Your Coinbase Wallet account connects separately when Claude asks for it.
- If the browser does not open, or the link expires, ask Claude to retry the Coinbase Wallet connection.
- Composio creates a fresh Coinbase Wallet authorization link.
- Open that link in your browser and finish the Coinbase Wallet sign-in.

### 4. Why do Coinbase Wallet actions fail after they worked before?

The Coinbase Wallet connection can expire or lose permission.
- Ask Claude to inspect the Coinbase Wallet connection.
- If the connection is unhealthy, disconnect it when Claude prompts you.
- Reconnect the Coinbase Wallet account and retry the action.
- If Claude shows a permission prompt, approve it before Claude changes data in Coinbase Wallet.
- If the action still fails with a permission error, check that the connected account has that permission in Coinbase Wallet itself.

### 5. How do I switch to a different Coinbase Wallet account?

Claude can manage the Coinbase Wallet connection for you.
- Ask Claude to disconnect or delete the current Coinbase Wallet account.
- Ask Claude to connect Coinbase Wallet again.
- Open the new Composio authorization link for Coinbase Wallet.
- Sign in with the other Coinbase Wallet account in the browser.
- After the account connects, ask Claude to retry the Coinbase Wallet task.

### 6. Why is my Coinbase Wallet connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Coinbase Wallet connection works in Claude Web, Desktop, and Cowork.
- In Claude Desktop, open Customize > Connectors.
- Next to Composio, click ⋮ and click Clear cache.
- If Coinbase Wallet tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
- On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Coinbase Wallet.

## Creating MCP Server - Stand-alone vs Composio SDK

The Coinbase Wallet MCP server connects Claude Web, Desktop, and Cowork to your Coinbase Wallet account through Composio. Once connected, Claude can use the available Coinbase Wallet tools and triggers to complete tasks on your behalf.

## Complete Code

None listed.

## How to build Coinbase Wallet MCP Agent with another framework

- [ChatGPT](https://composio.dev/toolkits/coinbase_wallet_mcp/framework/chatgpt)
- [Hermes](https://composio.dev/toolkits/coinbase_wallet_mcp/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/coinbase_wallet_mcp/framework/atomic-agent)

## Related Toolkits

- [Stripe](https://composio.dev/toolkits/stripe) - Stripe is a global online payments platform offering APIs for managing payments, customers, and subscriptions. Trusted by businesses for secure, efficient, and scalable payment processing worldwide.
- [44API](https://composio.dev/toolkits/44api) - 44API is an API service for validating VAT and tax identifiers and returning company details. Use it to verify business tax data and manage account IP whitelists quickly.
- [Airwallex](https://composio.dev/toolkits/airwallex) - Airwallex is a global financial platform providing business accounts, payments, payouts, FX, and cards. Built to simplify cross-border payments and streamline financial operations for businesses.
- [Aiwyn Tax MCP](https://composio.dev/toolkits/aiwyn_tax_mcp) - Aiwyn Tax MCP is a tax estimation service powered by Aiwyn's federal and state tax engine. It helps teams estimate tax outcomes without building tax calculation logic from scratch.
- [Alpaca](https://composio.dev/toolkits/alpaca) - Alpaca is a stock and crypto trading platform for commission-free trading, real-time market data, and algorithmic strategies. Use it to build brokerage apps, trading bots, and portfolio workflows with market connectivity.
- [Alpha vantage](https://composio.dev/toolkits/alpha_vantage) - Alpha Vantage is a financial data platform offering real-time and historical stock market APIs. Get instant, reliable access to equities, forex, and technical analysis data for smarter trading decisions.
- [Altoviz](https://composio.dev/toolkits/altoviz) - Altoviz is a cloud-based billing and invoicing platform for businesses. It streamlines online payments, expense tracking, and customizable invoice management.
- [Benzinga](https://composio.dev/toolkits/benzinga) - Benzinga provides real-time financial news and data APIs for market coverage. It helps you track breaking news and actionable market insights instantly.
- [Bigdata.com MCP](https://composio.dev/toolkits/bigdata_com_mcp) - Bigdata.com MCP provides grounded access to financial news, transcripts, filings, and entity intelligence. Ideal for building research workflows and generating timely market insights.
- [Billsby](https://composio.dev/toolkits/billsby) - Billsby is a subscription billing platform for managing customers, subscriptions, invoices, products, plans, usage counters, add-ons, and allowances. It helps SaaS and subscription teams automate billing operations without building complex billing logic from scratch.
- [Brex](https://composio.dev/toolkits/brex) - Brex provides corporate credit cards and spend management tailored for startups and tech businesses. It helps optimize company cash flow, streamline accounting, and accelerate business growth.
- [Cashfree Payments MCP](https://composio.dev/toolkits/cashfree_payments_mcp) - Cashfree Payments MCP is a merchant payments platform that handles collection, payouts, subscriptions, settlements, refunds, and identity verification. Simplifies merchant money lifecycle management with unified, API-driven workflows.
- [Chaser](https://composio.dev/toolkits/chaser) - Chaser is accounts receivable automation software that sends invoice reminders and helps businesses get paid faster. It streamlines the collections process to save time and improve cash flow.
- [Clarity AI MCP](https://composio.dev/toolkits/clarity_ai_mcp) - Clarity AI MCP is an MCP toolkit for simulating SFDR 2.0 fund classifications from a fund name, ISIN, or CUSIP. Use it to tap Clarity AI disclosure data and modeling without building custom sustainability-data workflows.
- [Clientary](https://composio.dev/toolkits/clientary) - Clientary is a platform for managing clients, invoices, projects, proposals, and more. It streamlines client work and saves you serious admin time.
- [Coinbase](https://composio.dev/toolkits/coinbase) - Coinbase is a platform for buying, selling, and storing cryptocurrency. It makes exchanging and managing crypto simple and secure for everyone.
- [Coinbase Agents MCP](https://composio.dev/toolkits/coinbase_agents_mcp) - Coinbase Agents MCP is Coinbase's managed toolkit exposing accounts, portfolios, orders, fills, and market data. Use it to let authorized agents inspect holdings, execute trades, perform transfers, and handle payments.
- [Coinranking](https://composio.dev/toolkits/coinranking) - Coinranking is a comprehensive cryptocurrency market data platform offering access to real-time coin prices, market caps, and historical data. Get accurate, up-to-date stats for thousands of digital assets in one place.
- [Coupa](https://composio.dev/toolkits/coupa) - Coupa is a business spend management platform for procurement, invoicing, and expenses. It helps organizations streamline purchasing, control costs, and gain complete visibility over financial operations.
- [CurrencyScoop](https://composio.dev/toolkits/currencyscoop) - CurrencyScoop is a developer-friendly API for real-time and historical currency exchange rates. Easily access fiat and crypto data for smart, up-to-date financial applications.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Coinbase Wallet MCP?

With a standalone Coinbase Wallet MCP server, the agents and LLMs can only access a fixed set of Coinbase Wallet tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Coinbase Wallet and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Claude Cowork?

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Coinbase Wallet tools.

### Can I manage the permissions and scopes for Coinbase Wallet while using Tool Router?

Yes, absolutely. You can configure which Coinbase Wallet scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Coinbase Wallet data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)