MCP.Market

Coinbase Commerce MCP server

by codespar·io.github.codespar/mcp-coinbase-commerce·v0.2.2·271 stars

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

B82/100grade B
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
Growing

271 stars

Reviews

Write one

Nobody has reviewed Coinbase Commerce yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Coinbase Commerce tools (18, 8 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • cancel_chargewrite action

    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.

  • create_chargewrite action

    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.

  • create_checkoutwrite action

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

  • create_invoicewrite action

    Create an invoice — a directed bill sent to a specific named recipient. Unlike a charge, an invoice captures who it was issued to and has its own draft / viewed / paid lifecycle.

  • delete_checkoutwrite action

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

  • list_charges

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

  • list_checkouts

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

  • 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.

  • list_exchange_rates

    Fetch current Coinbase exchange rates for a base asset (e.g. BTC, ETH, USDC) against every supported fiat and crypto. Useful for quoting or reconciling fiat-equivalent amounts. This endpoint is public and does not require the API key.

  • list_invoices

    List invoices, newest first. Cursor pagination via starting_after / ending_before.

  • resolve_chargewrite action

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

  • retrieve_chargewrite action

    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.

  • retrieve_checkout

    Retrieve a checkout by id.

  • 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.

  • retrieve_invoice

    Retrieve an invoice by code. Returns recipient details, status (DRAFT, OPEN, VIEWED, PAID, VOID), and the linked charge once payment begins.

  • update_checkoutwrite action

    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.

  • verify_webhook_signature

    Local helper — verify a Coinbase Commerce webhook payload using HMAC-SHA256. Pass the EXACT raw request body string (do not re-stringify the parsed JSON, byte-equivalence matters) and the X-CC-Webhook-Signature header value. The shared secret comes from COINBASE_COMMERCE_WEBHOOK_SECRET unless overridden. Returns { valid: boolean }.

  • void_invoice

    Void an unpaid invoice. The recipient can no longer pay it. Already-paid invoices cannot be voided — refund out-of-band if needed.

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings
  • Code scan5 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 29 days ago15/15
  • Maintainer identityregistry namespace matches repository owner7/10
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Coinbase Commerce compares

Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 73% of 1,761 Finance servers
Tools
18
the typical Finance server has 8
Tools that change things
44%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
271
more than 95% of 946 Finance servers

What its tools let an agent do: 10 read · 3 create · 3 change · 2 delete

Install Coinbase Commerce in Claude Code, Cursor or VS Code

Runs npx -y @codespar/mcp-coinbase-commerce on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mcp-coinbase-commerce -- npx -y @codespar/mcp-coinbase-commerce
Add to Cursor

What the publisher says

From the Coinbase Commerce repository's README, as published. We do not edit it. Read it on GitHub

MCP Dev LATAM 🌎 Every commerce API your AI agent needs to run a business in Latin America. Brazil 🇧🇷 · Mexico 🇲🇽 · Argentina 🇦🇷 · Colombia 🇨🇴 · Chile 🇨🇱 · Peru 🇵🇪 · plus 4 agentic payment protocols. MCP servers for LATAM commerce · live in the official MCP Registry · MIT License Machine-readable catalog: codespar.dev/api/servers Catalog · Quick Start · Agentic Protocols · All Servers · Contribute

The Problem

AI agents can write code, analyze data, and chat. But they can't operate a business — collect payments, issue invoices, ship products, or notify customers. Especially not in Latin America, where every service has its own API, auth pattern, and quirks (mTLS for BACEN Pix v2, JWT-RSA for STP-SPEI, AFIP web services, contract-gated developer portals, and on).

Meanwhile, four agentic payment protocols are shipping in parallel — checkout protocols (Stripe ACP, Google UCP), authorization layers (AP2), and micropayment rails (x402) — and none of them compose cleanly with each other or with the regional rails businesses actually run on.

MCP Dev LATAM bridges both gaps. Traditional LATAM services + the new agentic payment protocols, all accessible through a single MCP interface.

The Solution

Each MCP server in this repo wraps a real provider — payments, fiscal, logistics, messaging, banking, ERP, identity, fraud, crypto, and the agentic protocols — so your agent can operate a complete business workflow.

🛒 Customer places order
  → 💳 Agent charges via Pix (Asaas / Mercado Pago / Zoop)
  → 📄 Agent issues NFe (Nuvem Fiscal / Focus NFe / NFe.io)
  → 📦 Agent generates shipping label (Melhor Envio / Skydropx)
  → 📱 Agent sends tracking via WhatsApp (Z-API / WhatsApp Cloud)
  → 📊 Agent records in ERP (Omie / Bling / Tiny)
  → 🏦 Agent reconciles balance (Stark Bank / Itaú / BTG)

Six systems. Zero human intervention. One agent.

Agentic Payment Protocols

Four servers for the emerging agentic payment stack:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Coinbase Commerce: common questions

Is Coinbase Commerce MCP server safe?
Mostly: it is graded B (82/100). Read the Coinbase Commerce safety report
How do I install Coinbase Commerce?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Coinbase Commerce need an API key?
Yes. The registry entry asks for COINBASE_COMMERCE_API_KEY, COINBASE_COMMERCE_WEBHOOK_SECRET.
Is Coinbase Commerce maintained?
The last commit was 67 days ago (2026-08-29). The latest release is v0.2.2.
What can I use instead of Coinbase Commerce?
Servers from other publishers that do the same job: Yolfi Payments MCP server, PayRam MCP server and Orla MCP server. Compare all Coinbase Commerce alternatives.
How does Coinbase Commerce compare with other Finance MCP servers?
safety score 82/100 (higher than 73% of 1,761 Finance servers); tools 18 (the typical Finance server has 8); tools that change things 44% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Coinbase Commerce

Same job from other publishers: the closest match first, then the best rated.

All Coinbase Commerce alternatives →
  • Yolfi Payments MCP
    Let AI agents add Yolfi crypto checkout, paylinks, webhooks, and status checks.
    A
  • PayRam
    Install, configure, operate and integrate self-hosted PayRam crypto payment gateways.
    B
  • Orla
    Personal, family and business books over fiat and crypto. Reads and records; it cannot pay.
    A
  • Infinihash Kyt
    Screen crypto wallets vs OFAC SDN + threat intel; pre-payment checks, signed receipts; SAR drafts
    A
  • Clawpay
    Non-custodial x402 payment MCP server for AI agents. Wallets, payments, and commerce on 17 chains.
    B

More from codespar →