Skip to main content
Coinbase Wallet MCP logo
  • Category: model context protocol
  • Auth: DCR_OAUTH
  • Composio-managed OAuth available? No
  • Tools: 15
  • Triggers: 0
  • Slug: COINBASE_WALLET_MCP
  • Version: 20261030_00

Tools

Slug: COINBASE_WALLET_MCP_CHAIN_RPC_REQUESTMake 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.

Input Parameters

string
Optional JSON-RPC request id echoed in the response. Defaults to 1.
string
required
Canonical chain name (e.g. base, ethereum, base-sepolia). See get_wallets.supportedChains.,required
string
required
JSON-RPC method name. Only read-only methods are allowed (eth_blockNumber, eth_getBalance, eth_call, eth_getLogs, eth_getTransactionReceipt, etc.). Transaction-submission and subscription methods are rejected.,required
string
JSON-RPC params array for the method. Defaults to [].
Slug: COINBASE_WALLET_MCP_COMPLETE_X402_REQUESTComplete 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.

Input Parameters

string
required
The requestId returned by initiate_x402_request.,required
Slug: COINBASE_WALLET_MCP_FUNDCreate 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).

Input Parameters

string
Asset symbol to receive. Defaults to USDC.
string
Chain to receive funds on. Defaults to base.
string
Human-readable decimal amount to add (e.g. 10 or 1.5). Required when creating a new funding request; ignored when requestId is set.
boolean
Set with requestId to cancel a pending funding request.
string
Refresh an existing funding request instead of creating a new one. Pass the requestId returned by a previous fund call.
string
Fund one of the user’s agent wallets instead of their Base Account. Must be an agent wallet id from get_wallets.
Slug: COINBASE_WALLET_MCP_GET_PORTFOLIOReturns 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).

Input Parameters

string
Optional chain filter. Defaults to all chains.
integer
Maximum number of assets to return. Defaults to 20.
string
Optional search filter to narrow the asset list.
integer
Pagination offset. Defaults to 0.
string
Wallet address to query. Must be the authenticated user’s Base Account address or one of their agent wallet addresses. Defaults to the session’s agent wallet when omitted. Third-party addresses are rejected.
boolean
Include unrealized and realized P&L data per asset. Defaults to false.
Slug: COINBASE_WALLET_MCP_GET_REQUEST_STATUSPoll 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.

Input Parameters

string
required
The request ID returned by a previous send/sign/swap/send_calls/initiate_x402_request call in approval mode,required
Slug: COINBASE_WALLET_MCP_GET_TRANSACTION_HISTORYReturns 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.

Input Parameters

string
Optional asset symbol filter. Filters transfers within transactions.
string
required
Chain to query.,required
integer
Deprecated — ignored. Page size is determined by the upstream service.
string
Pagination cursor from a previous response’s nextCursor. Omit for the first page.
string
Wallet address to query. Must be the authenticated user’s Base Account address or one of their agent wallet addresses. Defaults to the session’s agent wallet when omitted. Third-party addresses are rejected.
Slug: COINBASE_WALLET_MCP_GET_WALLETSReturns 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.
Slug: COINBASE_WALLET_MCP_HELPReturns guidance for helping the user with protocol-specific tasks that aren’t directly supported by this MCP.
Slug: COINBASE_WALLET_MCP_INITIATE_X402_REQUESTInitiate 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.

Input Parameters

string
required
Full HTTPS URL to the x402-enabled endpoint.,required
object
Optional JSON body for POST requests.
string
required
HTTP method: GET or POST.,enum=GET,enum=POST,required
object
Optional HTTP headers for the initial request.
string
required
Maximum USDC amount willing to pay (human-readable decimal e.g. ‘1.00’).,required
string
Ignored in approval mode. Scopes the payment to a specific agent wallet when agent wallets are present.
Slug: COINBASE_WALLET_MCP_SEARCH_TOKENSSearch 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.

Input Parameters

string
Chain to search. Defaults to base when omitted.
string
required
Search term such as a token symbol or name.,required
Slug: COINBASE_WALLET_MCP_SENDSend 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.

Input Parameters

string
required
Asset symbol or ERC-20 contract address. When passing a contract address you must also pass decimals.
string
required
Target chain.
string
required
Human-readable decimal amount (e.g. 1.5). Must be positive and not exceed the asset’s decimal precision.
string
ERC-20 decimals. Required when asset is a contract address; ignored otherwise. Must be 0-18.
string
required
Destination address, ENS name (name.eth), basename (name.base.eth), or cb.id name.
string
Ignored in approval mode. Scopes the send to a specific agent wallet when agent wallets are present.
Slug: COINBASE_WALLET_MCP_SEND_CALLSSubmit 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.

Input Parameters

string
required
Array of calls to execute. Each call specifies a target address and optional value/data.,required
string
required
Target chain.,required
Slug: COINBASE_WALLET_MCP_SIGNRequest 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.

Input Parameters

object
required
Signing payload. For personal_sign pass {message: ‘Hello world’}. For typed_data pass {primaryType, types, domain, message}.,required
string
required
Signing mode: personal_sign for a plain message or typed_data for EIP-712 structured data. Also accepts 0x45 and 0x01.,enum=personal_sign,enum=typed_data,enum=0x45,enum=0x01,required
Slug: COINBASE_WALLET_MCP_SWAPSwap 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.

Input Parameters

string
required
Target chain. Swaps are only supported on mainnet chains. Testnets are not supported.
string
required
Human-readable decimal amount of fromAsset to swap (e.g. 0.5). Must be positive.
string
required
Token symbol or ERC-20 contract address to swap to.
string
required
Token symbol or ERC-20 contract address to swap from.
string
Optional ERC-20 decimals for toAsset (0-18). Only needs to be set when the server cannot determine decimals on its own.
string
Optional ERC-20 decimals for fromAsset (0-18). Only needs to be set when the server cannot determine decimals on its own.
string
Ignored in approval mode. Scopes the swap to a specific agent wallet when agent wallets are present.
Slug: COINBASE_WALLET_MCP_WEB_REQUESTMake 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.

Input Parameters

string
required
Full HTTPS URL to request. The hostname must be in the server’s configured allowlist.,required
object
JSON request body for POST requests. Ignored for GET.
string
required
HTTP method: GET or POST.,enum=GET,enum=POST,required
object
Optional custom headers. Authorization, Cookie, Host, and X-Forwarded-* headers are prohibited.