Coinbase Agents MCP
Coinbase Agents MCP lets authorized agents inspect portfolios, accounts, products, fees, orders, fills, and market data, and perform permitted conversions, trades, transfers, portfolio changes, and x402 payments.
Verdict
Common use cases
- Check portfolio balances during standup
- Execute limit orders from Slack threads
- Convert stablecoins for treasury ops
- Cancel open orders before market close
- Review fee tiers before large trades
Integration
- Vendor
- Coinbase Agents MCP
- Category
- other
- Auth
- OAUTH2
- Tools
- 29
- Composio slug
coinbase_agents_mcp
Tools
- Coinbase balance
Returns account balances for exactly one portfolio. If portfolio_id is omitted, only the default portfolio is returned. Results are not aggregated across portfolios; use coinbase_portfolios_list and query each portfolio for a complete multi
- Coinbase convert execute
Executes a previously quoted conversion using the quote_id from convert_quote. This moves funds at the quoted rate — get a fresh quote first since quotes expire. The from/to currencies must match the original quote. (3 fields, 3 required)
- Coinbase convert get
Check status of a conversion by quote ID. (3 fields, 3 required)
- Coinbase convert quote
Quotes stablecoin↔fiat and stablecoin↔stablecoin conversions, returning rate, fees, and a quote ID. It does not support BTC, ETH, or other non-stablecoin assets; use an order to trade those assets. Pass the ID to convert_execute promptly be
- Coinbase fees
Fee tier, maker/taker rates, and 30-day volume. (1 field, 0 required)
- Coinbase orders cancel
Cancels one or more open orders by ID. Removes resting orders from the book so reserved funds are released; already-filled portions are unaffected. Returns per-order success so a partial batch can fail. (1 field, 1 required)
- Coinbase orders close position
Places a market order to flatten an open position for a product, moving funds immediately. Omit size for a full close or set it for a partial close. Preview the equivalent order first if fee or slippage impact matters. (3 fields, 2 required
- Coinbase orders create
Place a market, limit, stop_limit, bracket, twap, or scaled order, subject to venue eligibility. Equities: use market or limit. Spot brackets require SELL; for entry, use market/limit BUY with attached exits. Futures brackets support BUY/SE
- Coinbase orders edit
Atomically update an open order's price or size without cancelling. Omit attached fields to keep existing exits. Attach or change exits only on eligible unfilled limit orders: spot BUY or futures BUY/SELL, not equities. Exits activate as th
- Coinbase orders edit preview
Estimate the result, fees, fill price, and slippage of changing an open order's size or limit price without editing it. Hosted OAuth requires mcp:orders:create. CDP API-key callers may use rat#view where supported. Unsupported replacements
- Coinbase orders fills
Lists individual trade executions with commissions and maker/taker indicator, filterable by product, order, side, and time range. Use this to reconcile actual fill prices and fees paid. For EQUITY fills, product_id is TICKER-QUOTE (e.g. AAP
- Coinbase orders get
Retrieves the full status and fill details of a single order by ID. Use after creating an order to confirm execution, and before orders_edit to see the current attached take-profit/stop-loss (attached_order_id / attached_order_configuration
- Coinbase orders list
Lists orders with optional filters by status, product, side, and time range. Use status=OPEN to find resting orders that can be edited or cancelled. For EQUITY orders, product_id is TICKER-QUOTE (e.g. AAPL-USD), the same form orders_create
- Coinbase orders preview
Estimate fees, fill price, slippage, and execution plans without placing an order. Optional before orders_create; the same order-type and asset-class restrictions apply. Futures previews also estimate margin, leverage, and liquidation impac
- Coinbase portfolios create
Creates a new named portfolio for segregating funds and positions. Does not move any funds; use transfer afterward to fund it. (1 field, 1 required)
- Coinbase portfolios deletedestructive
Permanently deletes a portfolio. The portfolio must be empty first — transfer out any remaining funds and close all positions before deleting. The DEFAULT portfolio cannot be deleted. (1 field, 1 required)
- Coinbase portfolios edit
Renames an existing portfolio. Does not affect balances or positions. (2 fields, 1 required)
- Coinbase portfolios get
Returns portfolio metadata, balances, and positions. (2 fields, 1 required)
- Coinbase portfolios list
Lists all portfolios on the account, including their UUIDs and types. Use this to find the portfolio_id needed for orders, transfers, and balance queries. (1 field, 0 required)
- Coinbase products best bid ask
Returns best bid and ask for one or more products in a single call. Omit product_ids to return pricebooks for all products. Not currently available for equities. (1 field, 0 required)
- Coinbase products book
Returns the current bid/ask order book for a product. Use to gauge available liquidity and likely slippage before sizing a market order. Not currently available for equities. (2 fields, 1 required)
- Coinbase products candles
Returns historical OHLCV candles for a product at a chosen granularity and time range. Use for price history and technical analysis. Not currently available for equities. (5 fields, 1 required)
- Coinbase products get
Viewing a product, including a FUTURE one, doesn't require any special account approval. Trading it is a separate matter — see the product_type field description. (1 field, 1 required)
- Coinbase products list
Viewing products, including FUTURE ones, doesn't require any special account approval. Trading them is a separate matter — see the product_type field description. (5 fields, 0 required)
- Coinbase products ticker
Returns recent trade prints plus the current best bid/ask for a product. Use for a quick spot-price snapshot before previewing or placing an order. Not currently available for equities. (2 fields, 1 required)
- Coinbase transfer
Moves funds of a single currency from one portfolio to another. This executes immediately and moves money — verify the source has sufficient available balance first. Both portfolio UUIDs come from portfolios_list. (4 fields, 4 required)
- Coinbase x402 fetch
Fetches a resource returned by x402_resources. On a 402 challenge, pays from the caller's custodial Base USDC via a pre-authorized hold, then retries with PAYMENT-SIGNATURE — no manual challenge handling. All currently supported x402 purcha
- Coinbase x402 pay
Turns an x402 PaymentRequirements challenge into a ready-to-send payment header by placing a pre-authorized hold on the caller's Base USDC balance (EIP-3009 exact scheme, v0). All currently supported x402 purchases through this connector us
- Coinbase x402 resources
Discover curated x402 resources: paid on-chain and market metrics, wallet and entity intelligence, and derivatives data. Discovery spends nothing. An optional keyword q filters the catalog; omit it to list all. Each result carries the resou
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Click 'Add Integration', search for 'Coinbase Agents MCP', and select it. 3. Click 'Connect' to start the OAuth flow; you'll be redirected to Coinbase to authorize Switchy. 4. Grant the requested scopes: view balances, place orders, manage conversions, and read fee data. 5. After authorization, Coinbase redirects you back to Switchy and the integration appears as 'Connected'. 6. Open any Project, type '@Coinbase' in a message, and ask for your portfolio balance to confirm the connection works. 7. If the balance returns, the MCP is live; if it errors, revisit settings to check token validity. 8. To place an order, @mention Coinbase again and specify product, side, size, and order type in natural language.
What teammates see: by default, memories from Coinbase Agents MCP are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Portfolio Balance Check
@Coinbase show me the balance for my default portfolio, broken down by asset and available vs held funds.
Place Limit Buy Order
@Coinbase place a limit buy order for 0.01 BTC at $95,000 on BTC-USD. Confirm the order ID once placed.
Convert USDC to USD
@Coinbase quote a conversion of 1,000 USDC to USD, then execute it if the rate and fees look reasonable.
Cancel All Open Orders
@Coinbase cancel all my open orders across all products and confirm which ones were successfully removed.
Check Fee Tier and Volume
@Coinbase what's my current fee tier, maker/taker rates, and 30-day volume? I need to estimate costs for next week's trades.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@coinbase show me my current balances across all my portfolios and highlight anything over $1,000
Retrieved balances for 2 portfolios. **Default Portfolio**: USD $2,450.32 available, USDC $850.00 available, BTC 0.0234 ($1,180 equivalent). **Trading Portfolio**: USD $340.00 available, ETH 0.45 ($920 equivalent). Positions over $1,000: BTC in default portfolio ($1,180) and USD in default portfolio ($2,450). Note that balances reflect available funds only—reserved amounts in open orders are excluded.
This example demonstrates read-only balance retrieval across multiple portfolios. The MCP requires OAuth2 with view permissions. If you have many portfolios, results are not auto-aggregated; the AI must call the list endpoint first, then fetch each portfolio individually. Real-time pricing for crypto equivalents may lag by seconds.
@coinbase convert $500 USD to USDC at the current rate and execute immediately
Quoted conversion: $500.00 USD → 499.50 USDC at rate 0.999, fee $0.50 (0.1%). Quote ID: q_abc123xyz valid for 30 seconds. Executed conversion using quote q_abc123xyz. Status: complete. Your default portfolio now holds 499.50 USDC; USD balance reduced by $500.00. Transaction settled on-chain in ~15 seconds.
This write example shows the two-step quote-then-execute flow required for conversions. Quotes expire in 30 seconds, so the AI must call convert_quote then convert_execute in quick succession. Only stablecoin↔fiat and stablecoin↔stablecoin pairs are supported—BTC or ETH conversions require placing an order instead. Fees vary by account tier.
@coinbase review my last 10 trades, calculate my net P&L, and suggest whether I should close my open ETH position based on current market conditions
Analyzed 10 recent trades: 6 profitable (avg +3.2%), 4 losses (avg -1.8%), net P&L +$142.50. Open position: 0.45 ETH (entry $2,040, current $2,044, unrealized +$1.80). Market context: ETH up 0.2% in 24h, volume below 7-day average. Suggestion: hold position—minimal gain and low volume suggest waiting for clearer momentum. If you want to lock profit, use @coinbase orders close position for ETH to flatten immediately, but expect ~0.5% taker fee on market exit.
This synthesis example pairs the MCP's order history and position data with the AI's reasoning. The AI must fetch trade records, calculate P&L manually (the MCP provides raw fills, not aggregated metrics), then interpret market signals. Closing a position via the MCP triggers a market order with immediate execution and slippage risk—preview fees first if precision matters.
Use-case deep-dives
When this MCP wins for on-chain payroll and vendor settlements
A 12-person DAO tooling company pays contractors in USDC and converts runway to fiat monthly. The Coinbase MCP handles both: quote and execute stablecoin conversions for payroll batches, check balances across portfolios before wire transfers, and pull fee-tier data to forecast quarterly costs. OAuth2 means the finance lead authorizes once and the whole team references live balances in Switchy threads without passing API keys. The 29 tools cover order placement and position management, but those matter less here—treasury work lives in balance checks and convert quotes. If your team doesn't touch crypto or stablecoins weekly, skip this MCP; the auth overhead isn't worth it for one-off trades. If you run monthly on-chain ops, connect it and let Switchy draft the conversion plan before you click execute.
Why high-frequency traders won't use this MCP in production
A 3-person prop shop runs automated strategies on Coinbase Advanced Trade and wants to monitor open orders during standup. The MCP's orders_cancel and orders_create tools look relevant, but latency kills the use-case: routing through an LLM adds 800ms minimum, and the MCP doesn't expose WebSocket feeds for real-time book data. You can pull balances and fee tiers to sanity-check position limits or review yesterday's closes, but any live trading logic should hit the REST API directly. The sweet spot is post-trade reconciliation—ask Switchy to compare filled orders against your internal ledger or explain why a bracket didn't trigger. If your edge depends on sub-second execution, keep this MCP out of the hot path. If you're coordinating manual interventions or auditing overnight fills, it's a clean fit for the morning debrief.
When this MCP clarifies user conversion disputes in real time
A 6-person support team fields tickets about failed stablecoin-to-fiat conversions in a consumer wallet app built on Coinbase APIs. The MCP's convert_get tool pulls conversion status by quote ID, and convert_quote shows the rate and fees the user saw at request time. Support reps paste the quote ID into a Switchy thread, and the MCP confirms whether the conversion executed, expired, or hit a balance error—no need to ask engineering to grep logs. The 29 tools include order and position management, but support rarely touches those; the convert and balance scopes do the work. If your app doesn't use Coinbase's convert endpoint or you handle fewer than 10 conversion questions a week, the OAuth setup isn't justified. If conversion disputes are a daily pattern, connect this MCP and let support close tickets in one message instead of three Slack escalations.
Frequently asked
What does the Coinbase Agents MCP let me do in Switchy?
It connects your Coinbase account so AI agents can check balances, execute stablecoin conversions, place and cancel orders, and close positions. The MCP exposes 29 tools covering spot trading, fee lookups, and portfolio operations. Agents can quote conversion rates, submit market or limit orders, and flatten positions without leaving the chat.
Which OAuth scopes does Coinbase require for this MCP?
Coinbase uses OAuth2, so you'll authorize Switchy during setup and the MCP stores a token. The exact scopes depend on which tools you enable, but trading operations require wallet:accounts:read and wallet:trades:create at minimum. Check Coinbase's developer console for the full scope list if you want to audit permissions before connecting.
Can the MCP trade Bitcoin or Ethereum, or only stablecoins?
The convert tools only handle stablecoin-to-fiat and stablecoin-to-stablecoin swaps. For BTC, ETH, or other crypto assets you must use the orders_create tool, which places market, limit, or stop orders on Coinbase's order book. Conversions are instant quotes; orders execute at market or your limit price.
How is this different from logging into Coinbase directly?
You still own the account and see the same balances in Coinbase's app. The MCP lets AI agents execute trades and check positions inside Switchy's chat, so you can ask "close my ETH position" instead of clicking through the web UI. It's faster for repetitive tasks but doesn't add features Coinbase doesn't offer.
Who on my team should connect the Coinbase account?
Whoever has trading authority on the Coinbase account you want to use. The OAuth token grants the MCP the same permissions as that user, so don't connect a personal account if the team needs a shared trading portfolio. One connection per workspace; all agents inherit the same access.