Coinbase Agents MCP

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-portfolio view. The response portfolio_id identifies the effective portfolio queried. Balances show available funds and amounts on hold; available_balance excludes funds held by open orders. Use before trading or transferring to confirm available funds. (4 fields, 0 required)

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)

Check status of a conversion by quote ID. (3 fields, 3 required)

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 because quotes expire. (3 fields, 3 required)

Fee tier, maker/taker rates, and 30-day volume. (1 field, 0 required)

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)

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)

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/SELL. Bracket stops become aggressive limit exits; fills and loss limits are not guaranteed. TWAP requires base_size, start_time, end_time, and a positive limit_price; slice count is automatic. Use orders_preview for optional fee, fill, and execution-plan estimates. Set exactly one size: limit and market SELL convert quote_size to base_size; market BUY spends quote_size; stop_limit/bracket/twap/scaled require base_size. Attached exits require market/limit parents and activate as the parent fills, including partial fills. If a FUTURE order is rejected for account eligibility, direct the user to https://help.coinbase.com/en/coinbase/trading-and-funding/derivatives/futures-intro to apply. (24 fields, 3 required)

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 the parent fills, including partial fills. Stops become aggressive limit exits; fills and loss limits are not guaranteed. Attached updates replace both legs: send attached_take_profit_price and attached_stop_loss_price to keep both, even when changing one. Read orders_get first: attached_order_configuration.trigger_bracket_gtc.limit_price maps to attached_take_profit_price; stop_trigger_price maps to attached_stop_loss_price. cancel_attached_order removes both legs, but may be rejected after an exit activates. (6 fields, 1 required)

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 return errors. (3 fields, 1 required)

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. AAPL-USD), the same form orders_create expects. (8 fields, 0 required)

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). For EQUITY orders, product_id is TICKER-QUOTE (e.g. AAPL-USD), the same form orders_create expects. (1 field, 1 required)

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 expects. (9 fields, 0 required)

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 impact: compare current and projected margin ratios and liquidation buffers. If a FUTURE preview is rejected for account eligibility, direct the user to https://help.coinbase.com/en/coinbase/trading-and-funding/derivatives/futures-intro to apply. (23 fields, 3 required)

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)

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)

Renames an existing portfolio. Does not affect balances or positions. (2 fields, 1 required)

Returns portfolio metadata, balances, and positions. (2 fields, 1 required)

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)

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)

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)

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)

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)

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)

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)

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)

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 purchases through this connector use Base USDC, and max_amount uses its 6-decimal atomic units; for example, "50000" means "0.05 USDC". This tool accepts only resource URLs returned by x402_resources. max_amount is the spend control; when the user has requested the data or stated a budget, proceed in a single call rather than re-confirming. Protocol v2 only; v1 challenges are rejected. (6 fields, 1 required)

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 use Base USDC, and amount and max_amount use its 6-decimal atomic units; for example, "50000" means "0.05 USDC". Attach the returned header as X-PAYMENT for v1 or PAYMENT-SIGNATURE for v2. This authorizes moving funds up to max_amount — pass the smallest amount that satisfies the requirement. Funds-touching and gated internal-only behind a default-off feature flag. (12 fields, 7 required)

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 resource URL, its advisory price, and its input and output schemas. All currently supported x402 purchases through this connector use Base USDC. accepts[].amount and coinbase_x402_fetch's max_amount use USDC's 6-decimal atomic units; for example, "50000" means "0.05 USDC". A result's inputSchema is coinbase_x402_fetch's input verbatim: pass those properties flat; do not build an HTTP envelope. The live 402 challenge sets the exact amount. (1 field, 0 required)