Skip to main content
CA

Coinbase Advanced Trade

@codespar/mcp-coinbase · v0.1.0

🌐 GlobalCryptoAuth · HMACbeta13 tools2 env vars

Exchange / treasury API: list accounts, place + cancel orders (market/limit), fills, transaction summary, portfolios. Distinct from Coinbase Commerce (merchant gateway) and CDP (onchain wallets). Uses legacy HMAC keys minted from coinbase.com/settings/api.

Get started · freeView docs

MIT · runs locally with your own credentials

Limitations

  • Hosted calls with a test key are not available: the runtime has not recorded this provider's test behaviour (test venue unclassified).
Package
@codespar/mcp-coinbase
Version
0.1.0
npm dist-tag
latest
Category
Crypto
Auth
HMAC
Country
🌐 Global
License
MIT
Transport
stdio · streamable-http

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, with your own credentials.

Add the server to your clientOne config entry. No build step, no SDK required.
Set the environment variables2 variables read by this server's code, listed below.
Restart and make the first callThe agent can call any of the 13 tools. Try list_accounts first.
terminal
# Claude Code claude mcp add coinbase -e COINBASE_ACCESS_KEY=… -e COINBASE_API_SECRET=… -- npx -y @codespar/mcp-coinbase@0.1.0 # then: /mcp to confirm the server is connected
Environment variables2 variables
COINBASE_ACCESS_KEYLegacy HMAC API key from the Coinbase dashboard (coinbase.com/settings/api)requiredsecret
COINBASE_API_SECRETAPI secret paired with the access key — used for HMAC-SHA256 request signingrequiredsecret

Names read from the package code (@codespar/mcp-coinbase@0.1.0). Descriptions and flags come from its manifest. Self-hosted, you hold the credentials.

First call demolist_accounts

"List the authenticated user's accounts"

tools/calllist_accountsresult returned

Tools

What your agent can call.

13 tools, as the package's tools/list returns them.

list_accounts

List the authenticated user's accounts (one per asset — BTC, ETH, USDC, etc.) with available + held balances. Use this before placing orders to confirm funding.

get_account

Get a specific account by UUID. Returns currency, available_balance, hold, ready, and parent portfolio info.

list_products

List all tradable products (e.g. BTC-USD, ETH-USD, USDC-BRL). Filter by product type if you only need spot or perpetuals.

get_product

Get a single product's metadata — base + quote increments, min order size, status (online / offline / maintenance).

get_best_bid_ask

Get top-of-book bid + ask + size for a product. Use this to peek price before placing a market order.

get_market_trades

Get recent trades (last N executions) for a product — handy for slippage estimation before placing a market order.

create_order

Place a market or limit order. Provide either market_market_ioc (market) or limit_limit_gtc / limit_limit_gtd (limit) inside order_configuration. Returns the order_id and initial status.

list_orders

List historical orders for the authenticated user. Filter by product_id, order_status, time range. Cursor-paginated.

get_order

Get a single order by order_id — returns full status, fills array, executed_value, average_filled_price.

cancel_orders

Cancel one or more open orders by order_id. Returns per-order success/failure.

list_fills

List individual fills (executions) across orders — useful for fee accounting + reconciliation. Filter by product_id + time range.

get_transaction_summary

Get the user's 30-day trading volume + fee tier. Drives variable maker/taker fee math.

Names and descriptions come from the package's tools/list (@codespar/mcp-coinbase@0.1.0). A kind (read, write, delete) is shown only when the package annotates its tools or each tool was verified one by one; neither exists for this server yet.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

codespar_discover lists this server's tools, but a project with a test key cannot call them yet: the runtime has not recorded what this provider does in test mode, and refuses rather than guess.

Protocol

Any MCP client

stdio · streamable-http

Questions

Before you install.

How do I install the Coinbase Advanced Trade MCP server?

Run npx -y @codespar/mcp-coinbase@0.1.0 and add the config block above to your MCP client: Claude Code, Cursor, Claude Desktop, VS Code, or any MCP-compatible client. No build step, no SDK required.

What can my agent do with Coinbase Advanced Trade?

Coinbase Advanced Trade exposes 13 tools for crypto. Your agent calls them directly; the full list is above.

How does Coinbase Advanced Trade authenticate, and how are credentials stored?

Coinbase Advanced Trade uses HMAC. Self-hosted, you hold the credentials: the server reads them from its environment variables.

How does Coinbase Advanced Trade handle upstream API changes?

Every server is versioned independently on npm. The command on this page pins 0.1.0, the version whose tools are listed here; your agent keeps running it until you change the version.

Is Coinbase Advanced Trade open source? How do I report a bug?

Yes. Coinbase Advanced Trade is MIT-licensed and published on npm as @codespar/mcp-coinbase, source on GitHub (link in the Details panel). Report issues on the package repository; security issues go to security@codespar.dev, and we respond within 24 hours.

Start in seconds.

Add the config above, set the variables, and your agent calls the tools.

Start in seconds demo
Add the server to your client with the config above.
Set the environment variables listed above.
Ask your agent for the first call.
Coinbase Advanced Trade — MCP server · 13 tools | CodeSpar