io.github.codespar/mcp-coinbase-commerce
io.github.codespar/mcp-coinbase-commerce · 273 stars · TypeScript · MIT
MCP server MCP server for Coinbase Commerce — crypto merchant payments (BTC/ETH/USDC); settle crypto or fiat
Install
The repo has no one-line install. Follow its README.
Published as
- npm
@codespar/mcp-coinbase-commercestdio
From the server's entry in the official MCP Registry.
Configuration
| Name | Set as | What it is |
|---|---|---|
COINBASE_COMMERCE_API_KEYRequired · Secret | Env var | Coinbase Commerce API key. Create one at https://beta.commerce.coinbase.com/settings/security. |
COINBASE_COMMERCE_API_VERSIONOptional | Env var | Coinbase Commerce API version pin (X-CC-Version header). Defaults to 2018-03-22. |
COINBASE_COMMERCE_WEBHOOK_SECRETOptional · Secret | Env var | Shared secret used to verify X-CC-Webhook-Signature on incoming webhooks. Only required for the verify_webhook_signature tool. |
Files
@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
Facts
- Kind
- MCP server
- Group
- Uncategorized
- Stars
- 273
- License
- MIT
- Language
- TypeScript
- Last push
- 2026-09-27
- Forks
- 50
- MCP Registry
- io.github.codespar/mcp-coinbase-commerce
- Homepage
- codespar.dev/servers
- Topics
- agentic-commerce, ai-agents, brazil, claude, fintech, latin-america, llm-tools, mcp, model-context-protocol, nfe, open-finance, payments, pix
- 1REAio.github.morluto/reaReverse engineer anything from your terminal or agent with one CLI and MCP server.125.3k
- 2com.browser-use/browser-usecom.browser-use/browser-useControl a real Chrome browser to complete any task: fill forms, extract data, book flights.117.7k
- 3World Monitorapp.worldmonitor/mcpLive markets, conflicts, country risk, chokepoints, energy, and China decision signals. 93 tools.88.3k
- 4Scrapling MCP Serverd4vinci/scrapling🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scraplingdev86.9k
- 5Everythingmodelcontextprotocol/serversThis MCP server attempts to exercise all the features of the MCP protocol. It is not intended to be a useful server, but rather a test server for builders of MCP clients. It implements prompts, tools, resources, sampling, and more to showcase MCP capabilities.85.8k
- 6Fetchmodelcontextprotocol/serversA Model Context Protocol server that provides web content fetching capabilities. This server enables LLMs to retrieve and process content from web pages, converting HTML to markdown for easier consumption.85.8k
