@codespar/mcp-moonpay 0.2.0 → 0.2.2

package/README.md

@@ -15,20 +15,30 @@ MoonPay spans 100+ crypto assets and many geographies, with both buy (fiat → c
 
 Use MoonPay when an agent needs broader crypto coverage (beyond USDC), longer-tail geographies, or a sell-side flow that pays out to local fiat.
 
-## Tools
+## Tools (20)
 
 | Tool | Purpose |
-|------|---------|
-| `get_buy_quote` | Preview a fiat → crypto quote before committing |
-| `create_buy_transaction` | Create a buy transaction (fiat → crypto) |
-| `get_buy_transaction` | Retrieve a buy transaction by id |
-| `list_buy_transactions` | List buy transactions with filters |
-| `get_sell_quote` | Preview a crypto → fiat quote |
-| `create_sell_transaction` | Create a sell transaction (crypto → fiat) |
-| `get_sell_transaction` | Retrieve a sell transaction by id |
-| `create_customer` | Create a KYC'd end user |
-| `get_customer` | Retrieve a customer by id |
-| `list_currencies` | List supported fiat + crypto assets (dynamic discovery) |
+|---|---|
+| `get_buy_quote` | Preview a fiat -> crypto buy quote in real time. |
+| `create_buy_transaction` | Create a buy transaction (fiat -> crypto). |
+| `get_buy_transaction` | Retrieve a buy transaction (fiat -> crypto) by its MoonPay id. |
+| `list_buy_transactions` | List buy transactions with optional filters. |
+| `get_sell_quote` | Preview a crypto -> fiat sell quote in real time. |
+| `create_sell_transaction` | Create a sell transaction (crypto -> fiat). |
+| `get_sell_transaction` | Retrieve a sell transaction (crypto -> fiat) by its MoonPay id. |
+| `refund_sell_transaction` | Request a refund on an off-ramp (sell) transaction. |
+| `create_customer` | Create a MoonPay customer (KYC'd end user). |
+| `get_customer` | Retrieve a MoonPay customer by id. |
+| `get_customer_kyc_status` | Fetch KYC verification status (and any pending document requirements) for a MoonPay customer. |
+| `list_customer_transactions` | List all transactions (buy + sell) tied to a single MoonPay customer. |
+| `get_transaction_receipt` | Fetch a tax-/audit-grade receipt for a completed buy or sell transaction. |
+| `list_currencies` | List supported currencies (fiat + crypto). |
+| `get_currency` | Retrieve metadata for a single currency (fiat or crypto) by its MoonPay code. |
+| `list_countries` | List countries supported by MoonPay along with which flows (buy / sell / NFT) are allowed per geography. |
+| `list_payment_methods` | List payment methods supported for a given fiat currency / country combination (e.g. |
+| `get_user_country` | Resolve the caller's (or a given IP's) country via MoonPay's IP-address geolocation endpoint. |
+| `sign_buy_url` | Build and HMAC-SHA256 sign a MoonPay buy widget URL (buy.moonpay.com). |
+| `sign_sell_url` | Build and HMAC-SHA256 sign a MoonPay sell widget URL (sell.moonpay.com). |
 
 ## Install
 
@@ -63,6 +73,10 @@ npx @codespar/mcp-moonpay
 MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-moonpay
 ```
 
+## 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

@@ -123,7 +123,10 @@ function signWidgetUrl(widgetBase, params) {
     const signature = createHmac("sha256", SECRET_KEY).update(query).digest("base64");
     return `${widgetBase}${query}&signature=${encodeURIComponent(signature)}`;
 }
-const server = new Server({ name: "mcp-moonpay", 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-moonpay", version: "0.2.1" }, { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -547,7 +550,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-moonpay", version: "0.2.0" }, { capabilities: { tools: {} } });
+                const s = new Server({ name: "mcp-moonpay", 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-moonpay",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP server for MoonPay — fiat-to-crypto on/off-ramp covering 100+ crypto assets, multi-geography, Pix supported for Brazil",
   "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-moonpay",
-  "description": "MCP server for MoonPay — fiat-to-crypto on/off-ramp across 100+ crypto assets and multiple geographies. Pix supported for Brazil onramp.",
+  "description": "MCP server for MoonPay — fiat-to-crypto on/off-ramp, 100+ assets; Pix for Brazil onramp",
   "repository": {
-    "url": "https://github.com/codespar/mcp-dev-brasil",
+    "url": "https://github.com/codespar/mcp-dev-latam",
     "source": "github",
     "subfolder": "packages/crypto/moonpay"
   },
-  "version": "0.2.0",
+  "version": "0.2.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@codespar/mcp-moonpay",
-      "version": "0.2.0",
+      "version": "0.2.2",
       "transport": {
         "type": "stdio"
       },
@@ -61,5 +61,14 @@
         }
       ]
     }
-  ]
+  ],
+  "provider": {
+    "homepage": "https://www.moonpay.com",
+    "logoUrl": "https://logo.clearbit.com/moonpay.com",
+    "logoFallback": "https://www.google.com/s2/favicons?domain=moonpay.com&sz=128",
+    "docsUrl": "https://dev.moonpay.com",
+    "sandbox": {
+      "available": true
+    }
+  }
 }

package/src/index.ts

@@ -125,9 +125,14 @@ function signWidgetUrl(widgetBase: string, params: Record<string, unknown>): str
   return `${widgetBase}${query}&signature=${encodeURIComponent(signature)}`;
 }
 
+// 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-moonpay", version: "0.2.0" },
-  { capabilities: { tools: {} } }
+  { name: "mcp-moonpay", version: "0.2.1" },
+  { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT }
 );
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -549,7 +554,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-moonpay", version: "0.2.0" }, { capabilities: { tools: {} } });
+        const s = new Server({ name: "mcp-moonpay", 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);