Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

io.github.codespar/mcp-coinbase-commerce

NPM · @CODESPAR/MCP-COINBASE-COMMERCE · SCANNED AUG 4

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

+32 this week 71 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security86
  • No malware found by supply-chain analysis.Pass
  • Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability81
  • AI-judged instruction clarity (excellent).Pass
  • Tool/resource definitions use about 1636 tokens (~90/item across 18 items; 18 tools + 0 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management30
  • Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @codespar/mcp-coinbase-commerce

# add to Claude Code
claude mcp add codespar-mcp-coinbase-commerce -- npx -y @codespar/mcp-coinbase-commerce
# add to Codex CLI
codex mcp add codespar-mcp-coinbase-commerce -- npx -y @codespar/mcp-coinbase-commerce
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "codespar-mcp-coinbase-commerce": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@codespar/mcp-coinbase-commerce"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add codespar-mcp-coinbase-commerce --command npx --arg -y --arg @codespar/mcp-coinbase-commerce
# ~/.hermes/config.yaml
mcp_servers:
  codespar-mcp-coinbase-commerce:
    command: "npx"
    args: ["-y", "@codespar/mcp-coinbase-commerce"]
// mcp.json
{
  "mcpServers": {
    "codespar-mcp-coinbase-commerce": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-coinbase-commerce"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 4 Aug 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.

  • 3 Aug 26 +4
    • Stability: unverified → 0.27 functional
  • 2 Aug 26 +46
    • Provenance: unverified → fail security
    • Known CVEs: unverified → partial security
    • Install scripts: unverified → pass security
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • Schema quality: unverified → excellent functional
    • License: unverified → pass functional
    • Dependency health: unverified → partial functional
    • Maintenance: unverified → pass functional
    • MCP protocol: unverified → pass functional
    • Tool coverage: unverified → 100 functional
    • Licence: MIT functional
  • 1 Aug 26 −8
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 31 Jul 26 −18
    • Malware scan: pass → unverified security
  • 30 Jul 26 +7

    No change was recorded against any check on this day. Schema Quality & AI Usability went from 0 to 29.

  • 28 Jul 26 −7
    • First check of Schema quality: unverified functional
  • 27 Jul 26 46

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 4 Aug 2026 · Analysed npm/@codespar/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 94 packages

94 packages in the resolved dependency tree · 94 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 18 exposed · ~1,569 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
cancel_charge ~46

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.

NameTypeReqDescription
codestringyesCharge short code

No output schema declared.

No examples provided.

create_charge ~199

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.

NameTypeReqDescription
cancel_urlstringBrowser redirect if the buyer abandons the hosted page
descriptionstringyesLonger human-readable description of what the buyer is paying for
local_priceobjectFiat-denominated price the charge is quoted in. Required when pricing_type is fixed_price.
metadataobjectArbitrary JSON you want echoed back on events (customer_id, order_id, etc.)
namestringyesShort product/order name shown on the hosted payment page
pricing_typestringyesfixed_price: exact amount in local_price. no_price: buyer chooses (donations).
redirect_urlstringBrowser redirect after a successful payment

No output schema declared.

No examples provided.

create_checkout ~126

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

NameTypeReqDescription
descriptionstringyesLonger description shown to buyers
local_priceobjectFiat-denominated price. Required when pricing_type is fixed_price.
namestringyesProduct / checkout name
pricing_typestringyesfixed_price: exact amount in local_price. no_price: buyer chooses.
requested_infoarrayBuyer fields Coinbase should collect on the hosted page (e.g. ["name", "email"])

No output schema declared.

No examples provided.

create_invoice ~122

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.

NameTypeReqDescription
business_namestringyesYour business name shown on the invoice
customer_emailstringyesEmail of the invoice recipient
customer_namestringyesDisplay name of the invoice recipient
local_priceobjectyesFiat-denominated amount the invoice is quoted in
memostringFree-form note to the recipient (appears on invoice)

No output schema declared.

No examples provided.

delete_checkout ~41

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

NameTypeReqDescription
idstringyesCheckout id to delete

No output schema declared.

No examples provided.

list_charges ~92

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

NameTypeReqDescription
ending_beforestringCursor: return results before this charge id
limitnumberMax results per page (default 25, max 100)
orderstringSort order by created_at. Defaults to desc.
starting_afterstringCursor: return results after this charge id

No output schema declared.

No examples provided.

list_checkouts ~94

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

NameTypeReqDescription
ending_beforestringCursor: return results before this checkout id
limitnumberMax results per page (default 25, max 100)
orderstringSort order by created_at. Defaults to desc.
starting_afterstringCursor: return results after this checkout id

No output schema declared.

No examples provided.

list_events ~122

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.

NameTypeReqDescription
ending_beforestringCursor: return results before this event id
limitnumberMax results per page (default 25, max 100)
orderstringSort order by created_at. Defaults to desc.
starting_afterstringCursor: return results after this event id

No output schema declared.

No examples provided.

list_exchange_rates ~86

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.

NameTypeReqDescription
currencystringBase currency code (e.g. BTC, ETH, USDC, USD). Defaults to USD.

No output schema declared.

No examples provided.

list_invoices ~91

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

NameTypeReqDescription
ending_beforestringCursor: return results before this invoice id
limitnumberMax results per page (default 25, max 100)
orderstringSort order by created_at. Defaults to desc.
starting_afterstringCursor: return results after this invoice id

No output schema declared.

No examples provided.

resolve_charge ~48

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

NameTypeReqDescription
codestringyesCharge short code

No output schema declared.

No examples provided.

retrieve_charge ~55

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.

NameTypeReqDescription
code_or_idstringyesCharge id or short code

No output schema declared.

No examples provided.

retrieve_checkout ~23

Retrieve a checkout by id.

NameTypeReqDescription
idstringyesCheckout id

No output schema declared.

No examples provided.

retrieve_event ~59

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.

NameTypeReqDescription
idstringyesEvent id (the id field on a webhook payload)

No output schema declared.

No examples provided.

retrieve_invoice ~51

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

NameTypeReqDescription
codestringyesInvoice short code

No output schema declared.

No examples provided.

update_checkout ~121

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.

NameTypeReqDescription
descriptionstringNew checkout description
idstringyesCheckout id to update
local_priceobjectNew fiat-denominated price
namestringNew checkout / product name
pricing_typestringUpdate pricing model
requested_infoarrayNew list of buyer fields to collect

No output schema declared.

No examples provided.

verify_webhook_signature ~145

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

NameTypeReqDescription
raw_bodystringyesExact raw request body bytes as a string
secretstringOverride webhook shared secret. Defaults to COINBASE_COMMERCE_WEBHOOK_SECRET env var.
signaturestringyesX-CC-Webhook-Signature header value (hex)

No output schema declared.

No examples provided.

void_invoice ~48

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

NameTypeReqDescription
codestringyesInvoice short code to void

No output schema declared.

No examples provided.