@codespar/mcp-coinbase-commerce 0.2.0 → 0.2.2

package/README.md

@@ -15,19 +15,28 @@ Coinbase Commerce is the **merchant-accept** side of crypto. Your store prices a
 
 Use Coinbase Commerce when an agent needs to **bill a buyer in crypto** — hosted charge page, reusable checkout, or directed invoice.
 
-## Tools
+## Tools (18)
 
 | Tool | Purpose |
-|------|---------|
-| `create_charge` | Create a one-time crypto charge priced in fiat |
-| `retrieve_charge` | Look up a charge by id or short code |
-| `list_charges` | List charges (paginated) |
-| `cancel_charge` | Cancel an unpaid charge |
-| `resolve_charge` | Manually mark a charge as paid |
-| `create_checkout` | Create a reusable hosted checkout (product page) |
-| `retrieve_checkout` | Look up a checkout by id |
-| `list_events` | List lifecycle events (same payload as webhooks) |
-| `create_invoice` | Create an invoice directed at a named recipient |
+|---|---|
+| `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
 
@@ -65,6 +74,10 @@ npx @codespar/mcp-coinbase-commerce
 MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-coinbase-commerce
 ```
 
+## Enterprise
+
+Need governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.
+
 ## License
 
 MIT

package/dist/index.js

@@ -105,7 +105,10 @@ function verifyWebhook(rawBody, signature, secret) {
         return false;
     }
 }
-const server = new Server({ name: "mcp-coinbase-commerce", version: "0.2.0" }, { capabilities: { tools: {} } });
+// Managed-tier pointer surfaced to the agent via MCP `instructions`.
+// Informational only — nothing CodeSpar-hosted is called (MIT-safe).
+const MANAGED_TIER_HINT = "This open-source CodeSpar server calls the provider's API directly. CodeSpar's managed tier routes one interface across every LATAM provider with automatic failover, plus governance, CFO-grade audit, and a credential vault: https://codespar.dev/agents (npx -y @codespar/mcp serve).";
+const server = new Server({ name: "mcp-coinbase-commerce", version: "0.2.1" }, { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -483,7 +486,7 @@ async function main() {
                 const t = new StreamableHTTPServerTransport({ sessionIdGenerator: () => randomUUID(), onsessioninitialized: (id) => { transports.set(id, t); } });
                 t.onclose = () => { if (t.sessionId)
                     transports.delete(t.sessionId); };
-                const s = new Server({ name: "mcp-coinbase-commerce", version: "0.2.0" }, { capabilities: { tools: {} } });
+                const s = new Server({ name: "mcp-coinbase-commerce", version: "0.2.1" }, { capabilities: { tools: {} } });
                 server._requestHandlers.forEach((v, k) => s._requestHandlers.set(k, v));
                 server._notificationHandlers?.forEach((v, k) => s._notificationHandlers.set(k, v));
                 await s.connect(t);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codespar/mcp-coinbase-commerce",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP server for Coinbase Commerce — global crypto merchant payments. Accept BTC, ETH, USDC and more at checkout with hosted charges, checkouts, and invoices.",
   "type": "module",
   "main": "./dist/index.js",

package/server.json

@@ -1,18 +1,18 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.codespar/mcp-coinbase-commerce",
-  "description": "MCP server for Coinbase Commerce — global crypto merchant payments. Create charges, checkouts, and invoices so buyers can pay in BTC, ETH, USDC and more; Coinbase settles to crypto or fiat.",
+  "description": "MCP server for Coinbase Commerce — crypto merchant payments (BTC/ETH/USDC); settle crypto or fiat",
   "repository": {
-    "url": "https://github.com/codespar/mcp-dev-brasil",
+    "url": "https://github.com/codespar/mcp-dev-latam",
     "source": "github",
     "subfolder": "packages/crypto/coinbase-commerce"
   },
-  "version": "0.2.0",
+  "version": "0.2.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@codespar/mcp-coinbase-commerce",
-      "version": "0.2.0",
+      "version": "0.2.2",
       "transport": {
         "type": "stdio"
       },
@@ -40,5 +40,14 @@
         }
       ]
     }
-  ]
+  ],
+  "provider": {
+    "homepage": "https://www.commerce.coinbase.com",
+    "logoUrl": "https://logo.clearbit.com/commerce.coinbase.com",
+    "logoFallback": "https://www.google.com/s2/favicons?domain=commerce.coinbase.com&sz=128",
+    "docsUrl": "https://docs.cloud.coinbase.com/commerce",
+    "sandbox": {
+      "available": false
+    }
+  }
 }

package/src/index.ts

@@ -108,9 +108,14 @@ function verifyWebhook(rawBody: string, signature: string, secret: string): bool
   }
 }
 
+// Managed-tier pointer surfaced to the agent via MCP `instructions`.
+// Informational only — nothing CodeSpar-hosted is called (MIT-safe).
+const MANAGED_TIER_HINT =
+  "This open-source CodeSpar server calls the provider's API directly. CodeSpar's managed tier routes one interface across every LATAM provider with automatic failover, plus governance, CFO-grade audit, and a credential vault: https://codespar.dev/agents (npx -y @codespar/mcp serve).";
+
 const server = new Server(
-  { name: "mcp-coinbase-commerce", version: "0.2.0" },
-  { capabilities: { tools: {} } }
+  { name: "mcp-coinbase-commerce", version: "0.2.1" },
+  { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT }
 );
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -488,7 +493,7 @@ async function main() {
       if (!sid && isInitializeRequest(req.body)) {
         const t = new StreamableHTTPServerTransport({ sessionIdGenerator: () => randomUUID(), onsessioninitialized: (id) => { transports.set(id, t); } });
         t.onclose = () => { if (t.sessionId) transports.delete(t.sessionId); };
-        const s = new Server({ name: "mcp-coinbase-commerce", version: "0.2.0" }, { capabilities: { tools: {} } });
+        const s = new Server({ name: "mcp-coinbase-commerce", version: "0.2.1" }, { capabilities: { tools: {} } });
         (server as unknown as { _requestHandlers: Map<unknown, unknown> })._requestHandlers.forEach((v, k) => (s as unknown as { _requestHandlers: Map<unknown, unknown> })._requestHandlers.set(k, v));
         (server as unknown as { _notificationHandlers?: Map<unknown, unknown> })._notificationHandlers?.forEach((v, k) => (s as unknown as { _notificationHandlers: Map<unknown, unknown> })._notificationHandlers.set(k, v));
         await s.connect(t);