docsCoinbase.subtitle
docsCoinbase.intro
docsCoinbase.step1Label
docsCoinbase.step1Desc
docsCoinbase.step2Label
docsCoinbase.step2Desc
docsCoinbase.step3Label
docsCoinbase.step3Desc
docsCoinbase.step4Label
docsCoinbase.step4Desc
docsCoinbase.step5Label
docsCoinbase.step5Desc
docsCoinbase.advantageTitle
docsCoinbase.advantageDesc
authenticate— docsCoinbase.skillAuthfund— docsCoinbase.skillFundsend-usdc— docsCoinbase.skillSendtrade— docsCoinbase.skillTradesearch-for-service— docsCoinbase.skillSearchpay-for-service— docsCoinbase.skillPaymonetize-service— docsCoinbase.skillMonetizecheck-balance— docsCoinbase.skillBalance| docsCoinbase.pricingTool | Description | docsCoinbase.pricingPrice |
|---|---|---|
| create_web3_escrow | Create on-chain escrow (wallet-to-wallet) | $0.15 |
| fund_web3_escrow | Fund an existing escrow with USDC/USDT | $0.10 |
| release_web3_escrow | Release funded escrow to payee | $0.10 |
| dispute_web3_escrow | Dispute escrow + log reason on-chain | $0.10 |
| get_web3_escrow | Read escrow from on-chain contract (real-time) | $0.02 |
| check_web3_status | Check Web3 escrow status (DB cached) | $0.01 |
| list_web3_escrows | List Web3 escrows by wallet/chain | $0.01 |
| create_session_key | Create scoped session key (gasless ERC-4337) | $0.15 |
| fund_with_session_key | Fund escrow gaslessly via session key | $0.10 |
| check_balance | Check wallet token balance on any chain | $0.01 |
| list_trade_offers | List on-chain trade offers from contract | $0.01 |
| accept_trade | Accept a trade offer as counterparty | $0.10 |
| create_escrow | Create fiat escrow with CLABE/wire instructions | $0.10 |
| release_funds | Release escrowed funds to seller via bank | $0.05 |
| upload_evidence | Attach delivery confirmation / docs | $0.05 |
| raise_dispute | Raise dispute on in-custody payment | $0.05 |
| request_refund | Request refund via SPEI/ACH | $0.05 |
| check_status | Check fiat payment status | $0.01 |
| get_fx_rate | Live FX rates (USD/MXN/USDC/MXNB) | $0.01 |
| list_payments | List fiat payments with filters | $0.01 |
| cancel_payment | Cancel before deposit | $0.01 |
Endpoint: POST /api/v1/mcp/x402 • Pricing: GET /api/v1/mcp/x402/pricing
payee_addressstringrequired— Seller/payee wallet addressamountnumberrequired— Amount in token unitstoken'USDC' | 'USDT' | 'MXNB'required— ERC-20 tokenchain_idnumberrequired— 42161, 8453, 137agent_private_keystring— CDP wallet private key (signs tx)use_zerodevboolean— Use gasless ZeroDev smart accountescrow_idnumberrequired— On-chain escrow IDamountnumberrequired— Amount to fundtoken'USDC' | 'USDT' | 'MXNB'required— ERC-20 tokenchain_idnumberrequired— Chain IDagent_private_keystringrequired— CDP wallet private keyamountnumberrequired— Amount to escrowcurrency'MXN' | 'USD'required— Escrow currencypayer_emailstringrequired— Buyer emailrecipient_emailstringrequired— Seller emaildeposit_currency'MXN' | 'USD'— Buyer deposit currencypayout_currency'MXN' | 'USD'— Seller payout currencycustody_daysnumber— Days to hold (1-365, default: 30)from'USD' | 'MXN' | 'USDC' | 'MXNB'required— Source currencyto'USD' | 'MXN' | 'USDC' | 'MXNB'required— Target currencyamountnumber— Amount to convertescrow_idnumberrequired— On-chain escrow IDchain_idnumberrequired— Chain ID (42161, 8453, 137, 1439)wallet_addressstringrequired— Wallet address to checktoken'USDC' | 'USDT' | 'MXNB'required— Token to checkchain_idnumberrequired— Chain ID# pip install cdp-agentkit-core
from cdp_agentkit_core import CdpAgent
import requests
# 1. Call the x402-protected endpoint
url = "https://kustodia-backend-566620759381.us-central1.run.app/api/v1/mcp/x402"
response = requests.post(url, json={
"tool": "get_fx_rate",
"params": { "from": "USD", "to": "MXN" }
})
# 2. Response: HTTP 402 with payment instructions
# { "accepts": [{ "scheme": "exact", "price": "$0.01",
# "network": "eip155:8453", "payTo": "0xC8d5..." }] }
# 3. Agent wallet auto-pays USDC on Base, retries with payment header
# 4. Tool executes, returns result
# { "success": true, "result": { "rate": 17.45 } }
Bazaar Auto-Discovery
No manual registration needed — x402 Bazaar automatically catalogs your endpoint the first time a payment is processed through the facilitator.
Alchemy Agent Compatible
Alchemy agents use the same x402 protocol. Install Alchemy skills with npx skills add alchemyplatform/skills --yes — they'll auto-discover Kustodia's endpoint and pay with USDC via SIWE + x402.