@codespar/mcp-coinbase-commerce

@codespar/mcp-coinbase-commerce

MCP server for Coinbase Commerce — global crypto merchant payments.

Coinbase Commerce is the merchant-accept side of crypto. Your store prices an order in local fiat (USD, BRL, EUR, MXN, ...), the buyer settles in BTC / ETH / USDC / and other supported assets, and Coinbase settles to you in the crypto or fiat of your choice.

Positioning vs the rest of the catalog

Server	Use case	Direction
@codespar/mcp-coinbase-commerce	Merchants accept crypto at checkout	Buyer pays merchant
@codespar/mcp-unblockpay	BRL / MXN <-> USDC corridor	Value transfer
@codespar/mcp-moonpay	End-user fiat <-> crypto (100+ assets)	Onramp / offramp
@codespar/mcp-transak	End-user fiat <-> crypto (broad geo)	Onramp / offramp

Use Coinbase Commerce when an agent needs to bill a buyer in crypto — hosted charge page, reusable checkout, or directed invoice.

Tools (18)

Tool	Purpose
create_charge	Create a crypto charge — a one-time merchant invoice priced in local fiat that a buyer can settle in BTC, E...
retrieve_charge	Retrieve a charge by its Coinbase Commerce id OR its short code (the 8-character code embedded in the hoste...
list_charges	List charges, newest first.
cancel_charge	Cancel a charge that has not yet been paid.
resolve_charge	Manually resolve a charge as paid.
create_checkout	Create a reusable hosted checkout — think product-page-style link that can be paid multiple times.
retrieve_checkout	Retrieve a checkout by id.
list_checkouts	List reusable hosted checkouts, newest first.
update_checkout	Update an existing reusable checkout.
delete_checkout	Delete a reusable checkout.
list_events	List events — the lifecycle signals (charge:created, charge:confirmed, charge:failed, charge:delayed, charg...
retrieve_event	Retrieve a single event by id.
create_invoice	Create an invoice — a directed bill sent to a specific named recipient.
retrieve_invoice	Retrieve an invoice by code.
list_invoices	List invoices, newest first.
void_invoice	Void an unpaid invoice.
list_exchange_rates	Fetch current Coinbase exchange rates for a base asset (e.g.
verify_webhook_signature	Local helper — verify a Coinbase Commerce webhook payload using HMAC-SHA256.

Install

npm install @codespar/mcp-coinbase-commerce

Environment

COINBASE_COMMERCE_API_KEY="..."         # API key (required, secret)
COINBASE_COMMERCE_API_VERSION="..."     # Optional. Defaults to 2018-03-22.

Create an API key at https://beta.commerce.coinbase.com/settings/security.

Authentication

Every request carries two headers:

X-CC-Api-Key: <COINBASE_COMMERCE_API_KEY>
X-CC-Version: 2018-03-22

The version header is required. Pin it so future API changes don't silently break your integration.

Run

# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-coinbase-commerce

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-coinbase-commerce

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT