Skip to main content
CC

Coinbase Commerce

@codespar/mcp-coinbase-commerce · v0.2.2

🌐 GlobalCryptoAuth · API Keybeta18 tools3 env vars

Merchant-side crypto accept: buyer pays BTC/ETH/USDC at checkout, Coinbase settles to merchant's chosen crypto or fiat. Distinct from MoonPay/Transak (onramp) and UnblockPay (corridor) — zero overlap.

Get started · freeView docs

MIT · runs locally with your own credentials

Limitations

  • Hosted calls with a test key are not available: the provider has no test environment.
Package
@codespar/mcp-coinbase-commerce
Version
0.2.2
npm dist-tag
latest
Category
Crypto
Auth
API Key
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 variables3 variables read by this server's code, listed below.
Restart and make the first callThe agent can call any of the 18 tools. Try create_charge first.
terminal
# Claude Code claude mcp add coinbase-commerce -e COINBASE_COMMERCE_API_KEY=… -e COINBASE_COMMERCE_API_VERSION=… -e COINBASE_COMMERCE_WEBHOOK_SECRET=… -- npx -y @codespar/mcp-coinbase-commerce@0.2.2 # then: /mcp to confirm the server is connected
Environment variables3 variables
COINBASE_COMMERCE_API_KEYCoinbase Commerce API key. Create one at https://beta.commerce.coinbase.com/settings/security.requiredsecret
COINBASE_COMMERCE_API_VERSIONCoinbase Commerce API version pin (X-CC-Version header). Defaults to 2018-03-22.optional
COINBASE_COMMERCE_WEBHOOK_SECRETShared secret used to verify X-CC-Webhook-Signature on incoming webhooks. Only required for the verify_webhook_signature tool.optionalsecret

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

First call democreate_charge

"Create a crypto charge — a one-time merchant invoice priced in local fiat that a buyer can settle in BTC, ETH, USDC, and other supported assets. Returns a hosted_url the buyer can be redirected to, plus per-asset payment addresses"

tools/callcreate_chargeresult returned

Tools

What your agent can call.

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

create_charge

Create a crypto charge — a one-time merchant invoice priced in local fiat that a buyer can settle in BTC, ETH, USDC, and other supported assets. Returns a hosted_url the buyer can be redirected to, plus per-asset payment addresses.

retrieve_charge

Retrieve a charge by its Coinbase Commerce id OR its short code (the 8-character code embedded in the hosted URL). Returns current status, timeline, and payments.

list_charges

List charges, newest first. Supports cursor pagination via starting_after / ending_before.

cancel_charge

Cancel a charge that has not yet been paid. Only charges in NEW status can be cancelled; once pending or completed the call will fail.

resolve_charge

Manually resolve a charge as paid. Used for out-of-band settlement (e.g. underpayment you accept, delayed confirmation you want to honour).

create_checkout

Create a reusable hosted checkout — think product-page-style link that can be paid multiple times. Good for evergreen SKUs and donation pages.

retrieve_checkout

Retrieve a checkout by id.

list_checkouts

List reusable hosted checkouts, newest first. Cursor pagination via starting_after / ending_before.

update_checkout

Update an existing reusable checkout. Supply only the fields you want to change (Coinbase replaces the supplied fields). Use to retitle a product, change the price, or adjust which buyer fields are collected.

delete_checkout

Delete a reusable checkout. The hosted URL stops accepting new payments. Existing charges spawned by the checkout are unaffected.

list_events

List events — the lifecycle signals (charge:created, charge:confirmed, charge:failed, charge:delayed, charge:pending, charge:resolved) that Coinbase Commerce also delivers via webhook. Useful for reconciliation and agent polling.

retrieve_event

Retrieve a single event by id. Useful when auditing a webhook delivery or replaying state — fetch the event Coinbase Commerce recorded server-side and compare against what your endpoint received.

Names and descriptions come from the package's tools/list (@codespar/mcp-coinbase-commerce@0.2.2). 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: the provider has no test environment, so the runtime refuses test-mode calls.

Protocol

Any MCP client

stdio · streamable-http

Questions

Before you install.

How do I install the Coinbase Commerce MCP server?

Run npx -y @codespar/mcp-coinbase-commerce@0.2.2 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 Commerce?

Coinbase Commerce exposes 18 tools for crypto. Your agent calls them directly; the full list is above.

How does Coinbase Commerce authenticate, and how are credentials stored?

Coinbase Commerce uses API Key. Self-hosted, you hold the credentials: the server reads them from its environment variables.

How does Coinbase Commerce handle upstream API changes?

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

Is Coinbase Commerce open source? How do I report a bug?

Yes. Coinbase Commerce is MIT-licensed and published on npm as @codespar/mcp-coinbase-commerce, 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 Commerce — MCP server · 18 tools | CodeSpar