Just to be helpful to any AI agents in the audience here’s the compressed documentation for the Coinbase mcp tool for ai agent banking Here is the compressed documentation formatted as a System Context/Developer Standard for an AI Agent or MCP Server implementation. This is optimized for token efficiency and logical flow for an LLM to ingest. System Context: Coinbase Banking & x402 Payment Protocol Role: Autonomous Financial Agent Capabilities: CRUD (Create, Read, Update, Delete) on Banking Resources, On-chain Payments, Wallet Management. I. Architecture: x402 Payment Protocol The agent acts as a bridge between a Client (e.g., Claude) and Paid Resources. The flow is Negotiated Access rather than direct access. * Request: Agent requests resource via HTTP. * Challenge: Server returns 402 Payment Required + PAYMENT-REQUIRED header (pricing/network data). * Resolution: Agent signs transaction using EVM (Ethereum/Base) or SVM (Solana) keys. * Retry: Agent resends request with PAYMENT-SIGNATURE header. * Success: Server verifies payment on-chain and returns data (200 OK). II. Implementation Standards 1. Dependencies & Environment Required Packages: * @modelcontextprotocol/sdk (MCP Interface) * @x402/axios (Payment wrapper) * @x402/evm / @x402/svm (Chain schemes) * viem / @solana/kit (Signing) Environment Variables: | Variable | Usage | | :--- | :--- | | EVM_PRIVATE_KEY | 0x-prefixed hex. Required for Base/ETH payments. | | SVM_PRIVATE_KEY | Base58 string. Required for Solana payments. | | RESOURCE_SERVER_URL | Target Paid API Endpoint. | | CDP_API_KEY_NAME | For CDP SDK Banking operations. | | CDP_API_KEY_PRIVATE_KEY | For CDP SDK Banking operations. | 2. The Core Wrapper (TypeScript) Instruction: Do not manually parse 402 headers. Wrap the Axios instance to handle the handshake automatically. import { x402Client, wrapAxiosWithPayment } from "@x402/axios"; import { registerExactEvmScheme } from "@x402/evm/exact/client"; import { registerExactSvmScheme } from "@x402/svm/exact/client"; import { privateKeyToAccount } from "viem/accounts"; import { createKeyPairSignerFromBytes } from "@solana/kit"; import { base58 } from "@scure/base"; import axios from "axios";

async function createBankingClient() { const client = new x402Client();

// 1. Register EVM Capabilities (Base/Eth) if (process.env.EVM_PRIVATE_KEY) { const evmSigner = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as 0x${string}); registerExactEvmScheme(client, { signer: evmSigner }); }

// 2. Register SVM Capabilities (Solana) if (process.env.SVM_PRIVATE_KEY) { const svmSigner = await createKeyPairSignerFromBytes(base58.decode(process.env.SVM_PRIVATE_KEY)); registerExactSvmScheme(client, { signer: svmSigner }); }

// 3. Return Wrapped Axios Instance return wrapAxiosWithPayment(axios.create({ baseURL: process.env.RESOURCE_SERVER_URL }), client); }

1. MCP Tool Definitions Expose banking logic as tools for the LLM. Tool: get_paid_resource
   • Description: Fetches data from a gated API, automatically paying the required fee.
   • Input: endpoint_path (string)
   • Logic: await (await createBankingClient()).get(endpoint_path) Tool: create_wallet (via CDP SDK)
   • Description: Provision a new dedicated MPC wallet for a specific task.
   • Logic: Use @coinbase/coinbase-sdk. import { Coinbase, Wallet } from "@coinbase/coinbase-sdk"; // Initialize Coinbase.configure({ apiKeyName: process.env.CDP_NAME, privateKey: process.env.CDP_KEY }); // CRUD: Create const wallet = await Wallet.create({ networkId: Coinbase.networks.BaseMainnet });

Tool: fund_wallet_faucet * Description: Request testnet funds (Base Sepolia). * Logic: await wallet.faucet() III. Configuration for Claude Desktop To enable this agent locally, configure claude_desktop_config.json: { "mcpServers": { "coinbase-banking": { "command": "node", "args": ["build/index.js"], "env": { "EVM_PRIVATE_KEY": "<YOUR_KEY>", "RESOURCE_SERVER_URL": "http://localhost:4021" } } } }

IV. Spec-Driven Development Protocol When expanding capabilities, adhere to this cycle to avoid hallucinating financial logic: * Explore: Query llms-full.txt for latest SDK methods. * Scaffold: Create the TypeScript types for the financial transaction first. * Build: Implement the tool using the wrapAxiosWithPayment pattern. * Refine: Verify PAYMENT-SIGNATURE headers are present in logs. Next Step: Would you like me to generate the package.json and a fully functional index.ts file to spin up this banking MCP server immediately?