io.github.codespar/mcp-coinbase-commerce — Model Context Protocol (MCP) server

MCP server for Coinbase Commerce that supports global crypto merchant payments. It is the merchant-accept side of crypto: stores price orders in local fiat (e.g., USD, BRL, EUR, MXN), buyers settle using assets like BTC, ETH, and USDC, and Coinbase settles to the merchant in crypto or fiat.

🛠️ Key Features

Coinbase Commerce merchant-accept payments
Crypto settlement supported: BTC / ETH / USDC (and other supported assets)
Fiat pricing for orders in multiple local currencies (USD, BRL, EUR, MXN, and others)
Merchant settlement selectable as crypto or fiat

🚀 Use Cases

Accepting crypto at checkout for online merchants
Processing payments across Latin America and other supported regions
Building fintech payment flows with agentic systems and MCP-compatible tooling

⚡ Developer Benefits

MCP integration via Model Context Protocol
Topics aligned with open-finance and payments tooling
Works with LLM tool ecosystems (e.g., “llm-tools”, “mcp”, “ai-agents”)

⚠️ Limitations

Details beyond merchant accept, listed currencies, and listed crypto assets are not provided in the source excerpt.

@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

Configuration

Environment variables

COINBASE_COMMERCE_API_KEYrequiredsecret

Coinbase Commerce API key. Create one at https://beta.commerce.coinbase.com/settings/security.

COINBASE_COMMERCE_API_VERSION

Coinbase Commerce API version pin (X-CC-Version header). Defaults to 2018-03-22.

COINBASE_COMMERCE_WEBHOOK_SECRETsecret

Shared secret used to verify X-CC-Webhook-Signature on incoming webhooks. Only required for the verify_webhook_signature tool.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-coinbase-commerce": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-coinbase-commerce@0.2.2"
      ],
      "env": {
        "COINBASE_COMMERCE_API_KEY": "<YOUR_COINBASE_COMMERCE_API_KEY>",
        "COINBASE_COMMERCE_API_VERSION": "<YOUR_COINBASE_COMMERCE_API_VERSION>",
        "COINBASE_COMMERCE_WEBHOOK_SECRET": "<YOUR_COINBASE_COMMERCE_WEBHOOK_SECRET>"
      }
    }
  }
}

io.github.codespar/mcp-coinbase-commerce