Mcp Coinbase Commerce

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

MCP server for Coinbase Commerce — crypto merchant payments (BTC/ETH/USDC); settle crypto or fiat

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Coinbase Commerce MCP server that lets an assistant create and manage crypto merchant charges, checkouts, invoices and events.

What you can do
  • Create, retrieve, list, cancel and manually resolve crypto charges priced in local fiat
  • Create, retrieve, list, update and delete reusable hosted checkouts
  • Create, retrieve, list and void invoices directed at a named recipient
  • List and retrieve lifecycle events such as charge created, confirmed, failed or delayed
  • Fetch current Coinbase exchange rates for a base asset
  • Verify a webhook payload locally with HMAC-SHA256
When to use it
Use it when an assistant needs to bill a buyer in crypto for a merchant: issuing a one-time charge, sharing a reusable checkout link, sending an invoice, or tracking payment events and exchange rates.
Requirements
Runs locally over stdio via npx from the npm package, or over HTTP when MCP_HTTP and MCP_PORT are set. Requires a Coinbase Commerce API key in COINBASE_COMMERCE_API_KEY; COINBASE_COMMERCE_API_VERSION is optional and defaults to 2018-03-22. The webhook verification tool also needs COINBASE_COMMERCE_WEBHOOK_SECRET. Network access to the Coinbase Commerce API.
Before you install
The API key in COINBASE_COMMERCE_API_KEY grants access to a merchant payment account and should be treated as a secret; the webhook secret is likewise sensitive. Several tools change real payment state: charges can be cancelled or manually marked paid, checkouts updated or deleted, and invoices voided. Manually resolving a charge as paid can release goods without an actual payment, so review such actions.

Installation

In SourceWeft

  1. Open Mcp Coinbase Commerce in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@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

ServerUse caseDirection
@codespar/mcp-coinbase-commerceMerchants accept crypto at checkoutBuyer pays merchant
@codespar/mcp-unblockpayBRL / MXN <-> USDC corridorValue transfer
@codespar/mcp-moonpayEnd-user fiat <-> crypto (100+ assets)Onramp / offramp
@codespar/mcp-transakEnd-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)

ToolPurpose
create_chargeCreate a crypto charge — a one-time merchant invoice priced in local fiat that a buyer can settle in BTC, E...
retrieve_chargeRetrieve a charge by its Coinbase Commerce id OR its short code (the 8-character code embedded in the hoste...
list_chargesList charges, newest first.
cancel_chargeCancel a charge that has not yet been paid.
resolve_chargeManually resolve a charge as paid.
create_checkoutCreate a reusable hosted checkout — think product-page-style link that can be paid multiple times.
retrieve_checkoutRetrieve a checkout by id.
list_checkoutsList reusable hosted checkouts, newest first.
update_checkoutUpdate an existing reusable checkout.
delete_checkoutDelete a reusable checkout.
list_eventsList events — the lifecycle signals (charge:created, charge:confirmed, charge:failed, charge:delayed, charg...
retrieve_eventRetrieve a single event by id.
create_invoiceCreate an invoice — a directed bill sent to a specific named recipient.
retrieve_invoiceRetrieve an invoice by code.
list_invoicesList invoices, newest first.
void_invoiceVoid an unpaid invoice.
list_exchange_ratesFetch current Coinbase exchange rates for a base asset (e.g.
verify_webhook_signatureLocal helper — verify a Coinbase Commerce webhook payload using HMAC-SHA256.

Install

bash
npm install @codespar/mcp-coinbase-commerce

Environment

bash
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

bash
# 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

Source: packages/crypto/coinbase-commerce/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts