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

Tools

Slug: COINBASE_AGENTS_MCP_COINBASE_BALANCEReturns 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)

Input Parameters

integer
Results per page
string
Pagination cursor
boolean
Include zero-balance accounts (default false)
string
UUID of the single portfolio to query. Omit to query only the default portfolio.

Output

integer
string
array
boolean
string
required
UUID of the single portfolio whose accounts and pagination metadata are returned; this response is not aggregated across portfolios.
Slug: COINBASE_AGENTS_MCP_COINBASE_CONVERT_EXECUTEExecutes 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)

Input Parameters

string
required
Target currency
string
required
Source currency
string
required
Quote ID from convert quote response

Output

object
Slug: COINBASE_AGENTS_MCP_COINBASE_CONVERT_GETCheck status of a conversion by quote ID. (3 fields, 3 required)

Input Parameters

string
required
Target currency
string
required
Source currency
string
required
Quote ID

Output

string
string
object
string
string
Slug: COINBASE_AGENTS_MCP_COINBASE_CONVERT_QUOTEQuotes 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)

Input Parameters

string
required
Target currency
string
required
Source currency
string
required
Amount to convert

Output

object
Slug: COINBASE_AGENTS_MCP_COINBASE_FEESFee tier, maker/taker rates, and 30-day volume. (1 field, 0 required)

Input Parameters

string ("SPOT" | "FUTURE" | "EQUITY")
FUTURE = CFM dated futures. Trading futures requires separate approval on the account beyond spot — if a futures order is rejected for eligibility, or the user asks how to get access, point them to https://help.coinbase.com/en/coinbase/trading-and-funding/derivatives/futures-intro to apply.

Output

object
required
number
required
Total fees (USD)
object
Margin rate (FUTURE only)
string
Total balance (USD)
number
number
number
Advanced Trade fees (USD)
boolean
number
Advanced Trade volume (USD)
Slug: COINBASE_AGENTS_MCP_COINBASE_ORDERS_CANCELCancels 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)

Input Parameters

array
required
Order IDs to cancel

Output

array
Slug: COINBASE_AGENTS_MCP_COINBASE_ORDERS_CLOSE_POSITIONPlaces 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)

Input Parameters

string
Partial close size (omit for full close)
string
required
Product to close
string
required
Idempotency key

Output

boolean
Whether the closing order was accepted
string
ID of the market order placed to close the position
string
Product whose position was closed
Slug: COINBASE_AGENTS_MCP_COINBASE_ORDERS_CREATEPlace 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)

Input Parameters

string ("BUY" | "SELL")
required
BUY or SELL
string ("market" | "limit" | "stop_limit" | "bracket" | "twap" | "scaled")
required
market: current price. limit: specified price or better. stop_limit: stop triggers a limit order. bracket: take-profit limit and stop-triggered aggressive limit exit; fills and loss limits are not guaranteed; spot SELL or eligible futures BUY/SELL. twap: split base_size over start_time/end_time with a positive limit_price and automatic slice count; requires GTD. scaled: 2 to 20 limit child orders between positive min_price/max_price. Equities: use market/limit. Other types depend on venue eligibility.
string
Expiry or execution end time (RFC 3339). Required for GTD and twap. The TWAP schedule may be adjusted.
string
Base currency amount (e.g. 0.001 BTC). Mutually exclusive with quote_size. Required for stop_limit, bracket, twap, and scaled. Max 15,000 USD notional.
string
Highest child limit price. Required for scaled. Must be positive and above min_price.
string
Lowest child limit price. Required for scaled. Must be positive and below max_price.
boolean
Post-only limit order: rejects if it would take liquidity. true is rejected for non-limit types.
integer
Number of limit child orders, from 2 to 20. Required for scaled.
string
required
Trading pair (BASE-QUOTE, e.g. BTC-USD or BTC-USDC) for spot crypto, a dated-futures contract code for CFM. For equities, use TICKER-QUOTE (e.g. AAPL-USD or AAPL-USDC). If the user names a quote currency (e.g. “use my USDC”), use that pair — never default to USD instead. If they don’t say, check the balance for this request’s portfolio_id (or the default portfolio if omitted) and use whichever of USD/USDC they hold there; if both, prefer the USDC pair. If the resulting pair doesn’t exist, tell the user rather than silently substituting a different one.
string
Quote-currency amount (e.g. $100 USD). Mutually exclusive with base_size. Market BUYs spend this amount; limit and market SELL convert it to base_size. Not supported for stop_limit, bracket, twap, or scaled — use base_size for those. Max 15,000 USD notional.
string
Requested execution start (RFC 3339). Required for twap. Slice count is automatic.
string
Stop trigger for stop_limit. For bracket, required positive decimal: above limit_price for futures BUY, below for SELL. Bracket stops become aggressive limit exits; no guaranteed fill or loss cap.
string
Required limit price for limit/stop_limit/bracket/twap. Bracket take-profit and TWAP execution price ceiling/floor must be strictly positive decimals.
boolean
Restrict the order to reducing existing exposure. Supported for INTX perpetuals; US dated futures, spot, and equities may reject it. Not supported for scaled.
string
The optional UUID of a portfolio containing accounts with which to trade. Defaults to the default portfolio when no portfolio_id is provided.
string ("GTC" | "IOC" | "FOK" | "GTD")
GTC=good til cancelled. IOC=immediate or cancel. FOK=fill or kill. GTD=good til date; requires end_time. stop_limit, bracket, and scaled support GTC/GTD. twap requires GTD. Extended-hours equity orders require GTD.
string ("up" | "down")
stop_limit only. Bracket direction is implied by side.
string
Idempotency key (auto-generated if omitted)
string
Equity trade date (YYYY-MM-DD). Ignored for crypto and futures.
string ("INCREASING" | "DECREASING" | "EVENLY_SPLIT")
Scaled size distribution. Defaults to an even split across child orders.
string ("FLAT" | "LINEAR_INCREASING" | "LINEAR_DECREASING")
Scaled price spacing. Defaults to FLAT (evenly spaced prices).
string ("NORMAL" | "PRE_MARKET" | "AFTER_HOURS" | "OVERNIGHT" | "MULTI_SESSION")
Equity trading session. Ignored for crypto and futures.
string
Positive decimal stop trigger, activated as a market/limit parent fills (including partial fills). Becomes an aggressive limit exit, not a guaranteed fill or loss cap. May combine with attached_take_profit_price. Spot: BUY parent only. Futures: BUY/SELL subject to venue eligibility. Not equities.
string
Positive decimal take-profit limit exit, activated as a market/limit parent fills (including partial fills). May combine with attached_stop_loss_price. Spot: BUY parent only. Futures: BUY/SELL subject to venue eligibility. Not equities. No guaranteed fill.

Output

string
string
string
string
Slug: COINBASE_AGENTS_MCP_COINBASE_ORDERS_EDITAtomically 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)

Input Parameters

string
required
Order to edit
string
New base size
string
New limit price
boolean
Remove both attached exit legs while keeping the parent order. Cannot be combined with attached_take_profit_price or attached_stop_loss_price. May be rejected after an exit activates.
string
Positive stop trigger for an eligible unfilled limit order. Send both attached prices to keep both legs. Triggers an aggressive limit exit; fills and loss limits are not guaranteed. Spot BUY or eligible futures BUY/SELL; not equities.
string
Positive take-profit limit price for an eligible unfilled limit order. Send both attached prices to keep both legs. Spot BUY or eligible futures BUY/SELL; not equities.

Output

string
string
Slug: COINBASE_AGENTS_MCP_COINBASE_ORDERS_EDIT_PREVIEWEstimate 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)

Input Parameters

string
required
Open order UUID to preview editing
string
Positive decimal replacement base size
string
Positive decimal replacement limit price

Output

string
string
string
string
string
string
string
object
string
string
object
Slug: COINBASE_AGENTS_MCP_COINBASE_ORDERS_FILLSLists 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)

Input Parameters

string
End time (RFC 3339 with timezone, e.g. 2024-12-31T23:59:59Z)
string ("BUY" | "SELL")
BUY or SELL
integer
Results per page
string
Start time (RFC 3339 with timezone, e.g. 2024-01-01T00:00:00Z)
string
Pagination cursor
array
Filter by order ID
string
Filter by product (e.g. BTC-USD)
string
Scope to a specific portfolio (defaults to all portfolios the caller can access)

Output

array
string
Slug: COINBASE_AGENTS_MCP_COINBASE_ORDERS_GETRetrieves 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)

Input Parameters

string
required
Order ID

Output

string ("BUY" | "SELL")
required
BUY or SELL
string
required
string
required
string
required
Trading pair. EQUITY orders use TICKER-QUOTE (e.g. AAPL-USD), as in orders_create.
string
string
string
string
string
string
The ID of this order’s attached bracket exit, if one is set.
object
string
string
string
object
Attached exits, if set. trigger_bracket_gtc.limit_price is the take-profit limit; stop_trigger_price is the stop-loss trigger.
Slug: COINBASE_AGENTS_MCP_COINBASE_ORDERS_LISTLists 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)

Input Parameters

string
End date (RFC 3339 with timezone, e.g. 2024-12-31T23:59:59Z)
string ("BUY" | "SELL")
BUY or SELL
integer
Results per page
string
Start date (RFC 3339 with timezone, e.g. 2024-01-01T00:00:00Z)
string
Pagination cursor
string
Filter by status
string
Filter by product (e.g. BTC-USD). Comma-separated for multiple.
string
Scope to a specific portfolio (defaults to all portfolios the caller can access)
string ("SPOT" | "FUTURE" | "EQUITY")
FUTURE = CFM dated futures. Trading futures requires separate approval on the account beyond spot — if a futures order is rejected for eligibility, or the user asks how to get access, point them to https://help.coinbase.com/en/coinbase/trading-and-funding/derivatives/futures-intro to apply.

Output

string
required
array
required
boolean
required
Slug: COINBASE_AGENTS_MCP_COINBASE_ORDERS_PREVIEWEstimate 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)

Input Parameters

string ("BUY" | "SELL")
required
BUY or SELL
string ("market" | "limit" | "stop_limit" | "bracket" | "twap" | "scaled")
required
market: current price. limit: specified price or better. stop_limit: stop triggers a limit order. bracket: take-profit limit and stop-triggered aggressive limit exit; fills and loss limits are not guaranteed; spot SELL or eligible futures BUY/SELL. twap: split base_size over start_time/end_time with a positive limit_price and automatic slice count; requires GTD. scaled: 2 to 20 limit child orders between positive min_price/max_price. Equities: use market/limit. Other types depend on venue eligibility.
string
Expiry or execution end time (RFC 3339). Required for GTD and twap. The TWAP schedule may be adjusted.
string
Base currency amount (e.g. 0.001 BTC). Mutually exclusive with quote_size. Required for stop_limit, bracket, twap, and scaled.
string
Highest child limit price. Required for scaled. Must be positive and above min_price.
string
Lowest child limit price. Required for scaled. Must be positive and below max_price.
boolean
Post-only limit order: rejects if it would take liquidity. true is rejected for non-limit types.
integer
Number of limit child orders, from 2 to 20. Required for scaled.
string
required
Trading pair (BASE-QUOTE, e.g. BTC-USD or BTC-USDC) for spot crypto, a dated-futures contract code for CFM. For equities, use TICKER-QUOTE (e.g. AAPL-USD or AAPL-USDC). If the user names a quote currency (e.g. “use my USDC”), use that pair — never default to USD instead. If they don’t say, check the balance for this request’s portfolio_id (or the default portfolio if omitted) and use whichever of USD/USDC they hold there; if both, prefer the USDC pair. If the resulting pair doesn’t exist, tell the user rather than silently substituting a different one.
string
Quote currency amount (e.g. spend $100 USD). Mutually exclusive with base_size. Not supported for stop_limit, bracket, twap, or scaled — use base_size for those.
string
Requested execution start (RFC 3339). Required for twap. Slice count is automatic.
string
Stop trigger for stop_limit. For bracket, required positive decimal: above limit_price for futures BUY, below for SELL. Bracket stops become aggressive limit exits; no guaranteed fill or loss cap.
string
Required limit price for limit/stop_limit/bracket/twap. Bracket take-profit and TWAP execution price ceiling/floor must be strictly positive decimals.
boolean
Restrict the order to reducing existing exposure. Supported for INTX perpetuals; US dated futures, spot, and equities may reject it. Not supported for scaled.
string
The optional UUID of a portfolio containing accounts with which to trade. Defaults to the default portfolio when no portfolio_id is provided.
string ("GTC" | "IOC" | "FOK" | "GTD")
GTC=good til cancelled. IOC=immediate or cancel. FOK=fill or kill. GTD=good til date; requires end_time. stop_limit, bracket, and scaled support GTC/GTD. twap requires GTD. Extended-hours equity orders require GTD.
string ("up" | "down")
stop_limit only. Bracket direction is implied by side.
string
Equity trade date (YYYY-MM-DD). Ignored for crypto and futures.
string ("INCREASING" | "DECREASING" | "EVENLY_SPLIT")
Scaled size distribution. Defaults to an even split across child orders.
string ("FLAT" | "LINEAR_INCREASING" | "LINEAR_DECREASING")
Scaled price spacing. Defaults to FLAT (evenly spaced prices).
string ("NORMAL" | "PRE_MARKET" | "AFTER_HOURS" | "OVERNIGHT" | "MULTI_SESSION")
Equity trading session. Ignored for crypto and futures.
string
Positive decimal stop trigger, activated as a market/limit parent fills (including partial fills). Becomes an aggressive limit exit, not a guaranteed fill or loss cap. May combine with attached_take_profit_price. Spot: BUY parent only. Futures: BUY/SELL subject to venue eligibility. Not equities.
string
Positive decimal take-profit limit exit, activated as a market/limit parent fills (including partial fills). May combine with attached_stop_loss_price. Spot: BUY parent only. Futures: BUY/SELL subject to venue eligibility. Not equities. No guaranteed fill.

Output

array
Preview warning codes.
string
string
string
Futures orders only. Effective leverage for this order’s side.
string
string
string
string
string
Futures/perpetual orders only. Maximum leverage allowed for this product.
string
Futures/perpetual orders only.
string
Futures/perpetual orders only.
object
Estimated child-order distribution. Check each child’s errors and warnings before placing.
string
object
Futures orders only. Account-level margin-ratio impact of placing this order — compare the two to see how much closer to margin call/liquidation this order moves the account.
string
Futures orders only. Margin required to place this order.
object
Estimated TWAP slices. Slice count is automatic; the schedule may change during execution.
string
Futures/perpetual orders only.
string
Futures/perpetual orders only.
string
string
Futures orders only. Liquidation buffer before this order, for comparison against projected_liquidation_buffer.
string
Predicted liquidation price for CFM dated futures. Check alongside current position risk from portfolios_get before confirming.
string
Futures orders only. Liquidation buffer if this order is placed.
Slug: COINBASE_AGENTS_MCP_COINBASE_PORTFOLIOS_CREATECreates a new named portfolio for segregating funds and positions. Does not move any funds; use transfer afterward to fund it. (1 field, 1 required)

Input Parameters

string
required
Portfolio name

Output

string
string ("DEFAULT" | "CONSUMER")
DEFAULT (the primary portfolio), CONSUMER (Coinbase app)
string
boolean
Slug: COINBASE_AGENTS_MCP_COINBASE_PORTFOLIOS_DELETEPermanently 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)

Input Parameters

string
required
Portfolio UUID
Slug: COINBASE_AGENTS_MCP_COINBASE_PORTFOLIOS_EDITRenames an existing portfolio. Does not affect balances or positions. (2 fields, 1 required)

Input Parameters

string
New portfolio name
string
required
Portfolio UUID

Output

string
string ("DEFAULT" | "CONSUMER")
DEFAULT (the primary portfolio), CONSUMER (Coinbase app)
string
boolean
Slug: COINBASE_AGENTS_MCP_COINBASE_PORTFOLIOS_GETReturns portfolio metadata, balances, and positions. (2 fields, 1 required)

Input Parameters

string
Currency for balance denomination
string
required
Portfolio UUID

Output

object
array
array
array
object
Slug: COINBASE_AGENTS_MCP_COINBASE_PORTFOLIOS_LISTLists 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)

Input Parameters

string ("DEFAULT" | "CONSUMER")
DEFAULT (the primary portfolio), CONSUMER (Coinbase app)

Output

array
Slug: COINBASE_AGENTS_MCP_COINBASE_PRODUCTS_BEST_BID_ASKReturns 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)

Input Parameters

array
Product IDs (e.g. BTC-USD and ETH-USD). Omit to return all products.

Output

array
Slug: COINBASE_AGENTS_MCP_COINBASE_PRODUCTS_BOOKReturns 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)

Input Parameters

integer
Number of levels
string
required
Product ID

Output

object
Slug: COINBASE_AGENTS_MCP_COINBASE_PRODUCTS_CANDLESReturns 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)

Input Parameters

string
End time (RFC 3339, e.g. 2024-01-01T00:00:00Z). Defaults to now.
integer
Max candles
string
Start time (RFC 3339, e.g. 2024-01-01T00:00:00Z). Defaults to 60 candles before end.
string
required
Trading pair (e.g. BTC-USD)
string ("1m" | "5m" | "15m" | "30m" | "1h" | "2h" | "4h" | "6h" | "1d")
Candle interval: 1m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 1d. Defaults to 1h.

Output

array
boolean
True when the requested time window was clamped (to the most-recent allowed span, or a future end pulled back to now); the returned candles cover a narrower window than requested.
Slug: COINBASE_AGENTS_MCP_COINBASE_PRODUCTS_GETViewing 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)

Input Parameters

string
required
Product ID (e.g. BTC-USD)

Output

string
string
string
Trading pair. EQUITY products use TICKER-QUOTE (e.g. AAPL-USD); see base_currency_id/quote_currency_id for the parts.
string
string
FUTURE = CFM dated futures, which requires separate account approval beyond spot. See https://help.coinbase.com/en/coinbase/trading-and-funding/derivatives/futures-intro to apply.
string
string
string
string
string
string
string
string
object
FUTURE products only (CFM dated futures).
object
FUTURE products only. Current trading-session state for this contract.
string
Slug: COINBASE_AGENTS_MCP_COINBASE_PRODUCTS_LISTViewing 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)

Input Parameters

integer
Results per page
string
Pagination cursor
string
Filter products by symbol, matches base or quote side (e.g. USD, BTC). For a specific product use products_get (e.g. BTC-USD). Pagination ignored when set.
string
Comma-separated product IDs
string ("SPOT" | "FUTURE" | "EQUITY")
FUTURE = CFM dated futures. Trading futures requires separate approval on the account beyond spot — if a futures order is rejected for eligibility, or the user asks how to get access, point them to https://help.coinbase.com/en/coinbase/trading-and-funding/derivatives/futures-intro to apply.

Output

string
boolean
array
integer
Slug: COINBASE_AGENTS_MCP_COINBASE_PRODUCTS_TICKERReturns 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)

Input Parameters

integer
Number of trades. Defaults to 100.
string
required
Trading pair (e.g. BTC-USD)

Output

array
string
string
Slug: COINBASE_AGENTS_MCP_COINBASE_TRANSFERMoves 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)

Input Parameters

string
required
Target portfolio UUID
string
required
Source portfolio UUID
string
required
Amount to transfer
string
required
Currency

Output

string
string
Slug: COINBASE_AGENTS_MCP_COINBASE_X402_FETCHFetches 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)

Input Parameters

object
Request parameters, exactly as described by the resource’s inputSchema from coinbase_x402_resources — pass those properties flat, at the top level. The tool routes them to the query string or the request body per the resource’s HTTP method; you do not construct the HTTP envelope. Validated strictly as a closed allowlist; unknown keys are rejected.
string
required
Resource URL returned by coinbase_x402_resources, with any path parameters substituted. Any URL that does not match a catalog resource is rejected.
string
Optional UUID of the USDC account to debit, within the chosen portfolio. Omit to use that portfolio’s single USDC account; an error (not a guess) is returned when the portfolio has zero or multiple USDC accounts.
string
Optional caller-set spend cap in Base USDC’s 6-decimal atomic units; for example, “50000” means “0.05 USDC”. Defaults to the catalog advisory ceiling for the resource; when supplied the effective cap is min(max_amount, advisory ceiling). Never derived from the live 402 challenge.
string
Optional UUID of the consumer portfolio to pay from. Omit only when exactly one accessible non-deleted consumer portfolio is available and the caller has portfolio listing permission. If discovery is not authorized, provide portfolio_id explicitly. For OAuth, ask the user to reconnect and select “View your trading portfolios” in Coinbase consent. For an API key, ask the user to edit it, open Advanced Settings, and enable “View (read-only)” for every portfolio the agent needs. If multiple consumer portfolios are available, call coinbase_portfolios_list, select the funding portfolio with the user, and retry with that portfolio_id.
string
Optional caller-supplied idempotency key for the payment; must be a UUID. Omit it on a first attempt — one is generated and returned to you. Reuse the SAME key when retrying an outcome-unknown fetch so a duplicate hold is not placed. If the tool reports a terminal rejection, do not reuse that key; start a new payment attempt with a new key.

Output

object
required
The resource’s JSON response body.
boolean
required
True when a payment was placed to obtain this response; false when the resource returned its data without a 402 challenge.
string
RFC 3339 time the payment authorization expires. Present only when paid is true.
string
Identifier of the placed hold, for reconciliation. Present only when paid is true.
string
The idempotency key generated for this payment. Present only when paid is true AND you omitted idempotency_key on the request; never echoes a key you supplied yourself.
Slug: COINBASE_AGENTS_MCP_COINBASE_X402_PAYTurns 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)

Input Parameters

string
required
USDC asset contract address on the network (the x402 asset field).
object
Full extra object from the resource’s 402 PaymentRequirements. Required when x402_version is 2; name and version must match the Base USDC EIP-712 domain.
string
required
The amount the resource requires, in Base USDC’s 6-decimal atomic units; for example, “50000” means “0.05 USDC”. Decimal string; never truncated.
string
required
Recipient address the payment authorizes (the x402 payTo field).
string
required
x402 payment scheme. Only “exact” is supported in v0.
string
required
x402 network as a CAIP-2 chain id. Only “eip155:8453” (Base mainnet) is supported in v0.
string
Optional UUID of the USDC account to debit, within the chosen portfolio. Omit to use that portfolio’s single USDC account; the tool returns an error (it does NOT guess) when the portfolio has zero or multiple USDC accounts.
string
required
Caller-set spend cap in Base USDC’s 6-decimal atomic units; for example, “50000” means “0.05 USDC”. The hold is rejected if amount exceeds this. Decimal string.
string
Optional UUID of the consumer portfolio to pay from. Omit only when exactly one accessible non-deleted consumer portfolio is available and the caller has portfolio listing permission. If discovery is not authorized, provide portfolio_id explicitly. For OAuth, ask the user to reconnect and select “View your trading portfolios” in Coinbase consent. For an API key, ask the user to edit it, open Advanced Settings, and enable “View (read-only)” for every portfolio the agent needs. If multiple consumer portfolios are available, call coinbase_portfolios_list, select the funding portfolio with the user, and retry with that portfolio_id.
integer
x402 protocol version from the resource’s 402 challenge. Pass the value the resource advertised. Optional; defaults to 1.
string
Optional caller-supplied idempotency key; must be a UUID. Omit it on a first attempt — one is generated and returned to you. Reuse the SAME key when retrying an outcome-unknown payment so a duplicate hold is not placed. If the tool reports a terminal rejection, do not reuse that key; start a new payment attempt with a new key.
integer
required
Validity window for the signed authorization, in seconds (the x402 maxTimeoutSeconds field). Must be between 1 and 300; the server caps how long the authorization stays valid. Pass a value no greater than the resource’s advertised maxTimeoutSeconds (a shorter window is valid, and settlement is near-instant); requests above 300 are rejected.

Output

string
RFC 3339 time the authorization expires.
string
Identifier of the placed hold for reconciliation.
string
Base64 payment header: attach as X-PAYMENT for v1 or PAYMENT-SIGNATURE for v2.
string
The effective idempotency key for this payment — the one you supplied, or the one generated for you when omitted. To retry an outcome-unknown payment safely (without placing a second hold), pass this value back as idempotency_key.
Slug: COINBASE_AGENTS_MCP_COINBASE_X402_RESOURCESDiscover 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)

Input Parameters

string
Optional keyword filter. Matched against each resource’s description, provider name, and tags using case-insensitive token search. Omit to return the full catalog.

Output

array
required