stables-mcp-server 1.4.0 → 2.1.0

package/build/tools/quotes.js

@@ -1,66 +1,115 @@
 /**
  * Quote Tools for Stables MCP Server
- * Synced with OpenAPI spec from https://api.stables.money/docs
+ *
+ * Mirrors POST /api/v1/quotes and GET /api/v1/quotes/:id as of 2026-07-30. The
+ * request takes `source`/`destination` (was `from`/`to`), the response is the
+ * quote itself with no `{ quote }` wrapper, and `paymentMethodType` is gone —
+ * the payment network is now `destination.network`.
  */
 import { z } from "zod";
+const LIVE_NETWORKS = [
+    "arbitrum",
+    "avalanche",
+    "base",
+    "ethereum",
+    "optimism",
+    "polygon",
+    "solana",
+    "tron",
+];
+function secondsUntil(iso) {
+    return Math.max(0, Math.floor((new Date(iso).getTime() - Date.now()) / 1000));
+}
+function describeAmount(side) {
+    return `${side.amount} ${side.currency}${side.network ? ` (${side.network})` : ""}`;
+}
+function feeLines(quote) {
+    const fees = quote.fees;
+    let out = `Total Fees: ${fees.total_fee.amount} ${fees.total_fee.currency}`;
+    if (fees.fx_fee)
+        out += `\n  FX Fee: ${fees.fx_fee.amount} ${fees.fx_fee.currency}`;
+    if (fees.platform_fee)
+        out += `\n  Platform Fee: ${fees.platform_fee.amount} ${fees.platform_fee.currency}`;
+    if (fees.payment_method_fee)
+        out += `\n  Payment Method Fee: ${fees.payment_method_fee.amount} ${fees.payment_method_fee.currency}`;
+    if (fees.network_fee)
+        out += `\n  Network Fee: ${fees.network_fee.amount} ${fees.network_fee.currency}`;
+    if (fees.integrator_fee)
+        out += `\n  Integrator Fee: ${fees.integrator_fee.amount} ${fees.integrator_fee.currency}`;
+    return out;
+}
 export function registerQuoteTools(server, client) {
     // Create Quote
-    server.tool("create_quote", "Get a quote for currency exchange. Quotes show the exchange rate, fees, and amount the customer will receive. Quotes expire after 30 seconds. Currently supports crypto → fiat (off-ramp) with more types coming soon.", {
-        customerId: z.string().optional().describe("The customer ID to associate this quote with. Required if the quote will be used to create a transfer."),
-        fromCurrency: z.enum(["USDC", "USDT"]).describe("Source cryptocurrency (USDC or USDT)"),
-        fromAmount: z.string().describe("Amount to convert (e.g., '125.75')"),
-        fromNetwork: z.enum(["ethereum", "polygon"]).describe("Blockchain network for the source crypto"),
-        toCurrency: z.string().describe("Destination currency code (e.g., 'EUR', 'USD', 'GBP')"),
-        toCountry: z.string().describe("Destination country code (e.g., 'GR', 'US', 'GB')"),
-        paymentMethodType: z.enum(["SWIFT", "LOCAL"]).describe("Payment method for fiat payouts - 'SWIFT' for international, 'LOCAL' for domestic rails"),
-    }, async ({ customerId, fromCurrency, fromAmount, fromNetwork, toCurrency, toCountry, paymentMethodType }) => {
+    server.tool("create_quote", "Get a quote for a currency exchange: the rate, the fees, and what the customer receives. Quotes are short-lived, so create one immediately before the transfer. " +
+        "Off-ramp converts a stablecoin to fiat (source network required, destination country required); on-ramp converts fiat to a stablecoin (destination address required). " +
+        "Set preview to price without committing.", {
+        sourceCurrency: z
+            .string()
+            .describe("Source currency: a stablecoin for off-ramp (e.g. 'USDT'), fiat for on-ramp"),
+        sourceAmount: z.string().describe("Amount to convert, in major units (e.g. '125.75')"),
+        sourceNetwork: z
+            .enum(LIVE_NETWORKS)
+            .optional()
+            .describe("Blockchain network of the source. Required for off-ramp, omitted for on-ramp"),
+        destinationCurrency: z
+            .string()
+            .describe("Destination currency: fiat for off-ramp (e.g. 'EUR'), a stablecoin for on-ramp"),
+        destinationCountry: z
+            .string()
+            .optional()
+            .describe("Destination country, ISO 2-letter. Required for off-ramp"),
+        destinationNetwork: z
+            .string()
+            .optional()
+            .describe("Off-ramp: payment network, 'swift' or 'bank'. On-ramp: blockchain network. Replaces the old paymentMethodType"),
+        destinationAddress: z
+            .string()
+            .optional()
+            .describe("Destination wallet address. Required for on-ramp"),
+        preview: z
+            .boolean()
+            .optional()
+            .describe("Price the quote without persisting it — use to show an estimate"),
+        metadata: z.record(z.string()).optional().describe("Optional metadata"),
+    }, async (input) => {
         try {
-            const response = await client.createQuote({
-                customerId,
-                from: {
-                    currency: fromCurrency,
-                    amount: fromAmount,
-                    network: fromNetwork,
+            const quote = await client.createQuote({
+                source: {
+                    currency: input.sourceCurrency,
+                    amount: input.sourceAmount,
+                    ...(input.sourceNetwork && { network: input.sourceNetwork }),
                 },
-                to: {
-                    currency: toCurrency,
-                    country: toCountry,
-                    paymentMethodType,
+                destination: {
+                    currency: input.destinationCurrency,
+                    ...(input.destinationCountry && { country: input.destinationCountry }),
+                    ...(input.destinationNetwork && { network: input.destinationNetwork }),
+                    ...(input.destinationAddress && { address: input.destinationAddress }),
                 },
+                ...(input.preview !== undefined && { preview: input.preview }),
+                ...(input.metadata && { metadata: input.metadata }),
             });
-            const quote = response.quote;
-            const expiresIn = Math.max(0, Math.floor((new Date(quote.expiresAt).getTime() - Date.now()) / 1000));
-            let feeDetails = `Total Fees: ${quote.fees.totalFee.amount} ${quote.fees.totalFee.currency}`;
-            if (quote.fees.fxFee)
-                feeDetails += `\n  FX Fee: ${quote.fees.fxFee.amount} ${quote.fees.fxFee.currency}`;
-            if (quote.fees.platformFee)
-                feeDetails += `\n  Platform Fee: ${quote.fees.platformFee.amount} ${quote.fees.platformFee.currency}`;
-            if (quote.fees.paymentMethodFee)
-                feeDetails += `\n  Payment Method Fee: ${quote.fees.paymentMethodFee.amount} ${quote.fees.paymentMethodFee.currency}`;
-            if (quote.fees.networkFee)
-                feeDetails += `\n  Network Fee: ${quote.fees.networkFee.amount} ${quote.fees.networkFee.currency}`;
-            if (quote.fees.integratorFee)
-                feeDetails += `\n  Integrator Fee: ${quote.fees.integratorFee.amount} ${quote.fees.integratorFee.currency}`;
             return {
                 content: [
                     {
                         type: "text",
                         text: `Quote created successfully!
 
-Quote ID: ${quote.quoteId}
+Quote ID: ${quote.quote_id}
 Status: ${quote.status}
 
 Converting:
-  From: ${quote.from.amount} ${quote.from.currency}${quote.from.network ? ` (${quote.from.network})` : ""}
-  To: ${quote.to.amount} ${quote.to.currency} via ${quote.to.paymentMethodType}
+  From: ${describeAmount(quote.source)}
+  To: ${describeAmount(quote.destination)}
 
-Exchange Rate: ${quote.exchangeRate}
-${feeDetails}
+Exchange Rate: ${quote.exchange_rate}
+${feeLines(quote)}
 
-Expires in: ${expiresIn} seconds
-Expires at: ${quote.expiresAt}
+Expires in: ${secondsUntil(quote.expires_at)} seconds
+Expires at: ${quote.expires_at}
 
-To execute this quote, use 'create_transfer' with this quoteId and include bank details for off-ramp transfers.`,
+${quote.status === "preview"
+                            ? "This is a preview and was not persisted. Create a real quote before transferring."
+                            : "To execute it, call 'create_transfer' with this quote ID and the payout destination."}`,
                     },
                 ],
             };
@@ -82,24 +131,19 @@ To execute this quote, use 'create_transfer' with this quoteId and include bank
         quoteId: z.string().describe("The quote ID to look up"),
     }, async ({ quoteId }) => {
         try {
-            const response = await client.getQuote(quoteId);
-            const quote = response.quote;
-            const isExpired = quote.status === "QUOTE_STATUS_EXPIRED" || new Date(quote.expiresAt) < new Date();
-            const isUsed = quote.status === "QUOTE_STATUS_USED";
-            const isCancelled = quote.status === "QUOTE_STATUS_CANCELLED";
-            let statusMessage = "";
-            if (isUsed) {
+            const quote = await client.getQuote(quoteId);
+            let statusMessage;
+            if (quote.status === "used") {
                 statusMessage = "This quote has already been used to create a transfer.";
             }
-            else if (isCancelled) {
+            else if (quote.status === "cancelled") {
                 statusMessage = "This quote has been cancelled.";
             }
-            else if (isExpired) {
+            else if (quote.status === "expired" || new Date(quote.expires_at) < new Date()) {
                 statusMessage = "This quote has expired. Create a new quote to proceed.";
             }
             else {
-                const expiresIn = Math.max(0, Math.floor((new Date(quote.expiresAt).getTime() - Date.now()) / 1000));
-                statusMessage = `This quote is active and expires in ${expiresIn} seconds.`;
+                statusMessage = `This quote is active and expires in ${secondsUntil(quote.expires_at)} seconds.`;
             }
             return {
                 content: [
@@ -107,18 +151,18 @@ To execute this quote, use 'create_transfer' with this quoteId and include bank
                         type: "text",
                         text: `Quote Details:
 
-Quote ID: ${quote.quoteId}
+Quote ID: ${quote.quote_id}
 Status: ${quote.status}
 
 Converting:
-  From: ${quote.from.amount} ${quote.from.currency}${quote.from.network ? ` (${quote.from.network})` : ""}
-  To: ${quote.to.amount} ${quote.to.currency} via ${quote.to.paymentMethodType}
+  From: ${describeAmount(quote.source)}
+  To: ${describeAmount(quote.destination)}
 
-Exchange Rate: ${quote.exchangeRate}
-Total Fees: ${quote.fees.totalFee.amount} ${quote.fees.totalFee.currency}
+Exchange Rate: ${quote.exchange_rate}
+Total Fees: ${quote.fees.total_fee.amount} ${quote.fees.total_fee.currency}
 
-Created: ${quote.createdAt}
-Expires: ${quote.expiresAt}
+Created: ${quote.created_at}
+Expires: ${quote.expires_at}
 
 ${statusMessage}`,
                     },

package/build/tools/quotes.js.map

@@ -1 +1 @@
-{"version":3,"file":"quotes.js","sourceRoot":"","sources":["../../src/tools/quotes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"quotes.js","sourceRoot":"","sources":["../../src/tools/quotes.ts"],"names":[],"mappings":"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"}

package/build/tools/sandbox.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Sandbox simulation tools for the Stables MCP Server.
+ *
+ * These endpoints exist only on non-live deployments. Without them an agent
+ * cannot drive a deposit to a terminal state in test — a real bank payment would
+ * be required — so a test integration could never see a completed payout.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StablesApiClient } from "../lib/stables-client.js";
+export declare function registerSandboxTools(server: McpServer, client: StablesApiClient): void;
+//# sourceMappingURL=sandbox.d.ts.map

package/build/tools/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/tools/sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,QAuF/E"}

package/build/tools/sandbox.js

@@ -0,0 +1,78 @@
+/**
+ * Sandbox simulation tools for the Stables MCP Server.
+ *
+ * These endpoints exist only on non-live deployments. Without them an agent
+ * cannot drive a deposit to a terminal state in test — a real bank payment would
+ * be required — so a test integration could never see a completed payout.
+ */
+import { z } from "zod";
+export function registerSandboxTools(server, client) {
+    server.tool("simulate_route_deposit", "SANDBOX ONLY. Simulate a fiat deposit into a payment route so you can watch the conversion and payout complete without a real bank transfer. Fails on production.", {
+        customerId: z.string().describe("The customer ID"),
+        virtualAccountId: z.string().describe("The payment route (virtual account) ID"),
+        amount: z.string().describe("Deposit amount in major units (e.g. '500.00')"),
+        scenario: z
+            .enum(["create_only", "completed", "failed"])
+            .optional()
+            .describe("'completed' runs the deposit through to payout, 'failed' exercises the failure path, 'create_only' stops at the deposit"),
+        senderName: z.string().optional().describe("Name to attribute the deposit to"),
+        senderReference: z.string().optional().describe("Payment reference on the deposit"),
+        externalDepositId: z.string().optional().describe("Your own reference for this deposit"),
+    }, async ({ customerId, virtualAccountId, amount, scenario, senderName, senderReference, externalDepositId, }) => {
+        try {
+            const result = await client.simulateVirtualAccountDeposit(customerId, virtualAccountId, {
+                amount,
+                ...(scenario && { scenario }),
+                ...(senderName && { sender_name: senderName }),
+                ...(senderReference && { sender_reference: senderReference }),
+                ...(externalDepositId && { external_deposit_id: externalDepositId }),
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Simulated deposit of ${amount} into route ${virtualAccountId}:\n\n${JSON.stringify(result, null, 2)}\n\nUse 'get_virtual_account_history' to see the deposit and its payout.`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to simulate the deposit: ${error instanceof Error ? error.message : "Unknown error"}\n\nThis endpoint exists only in sandbox — on production it will not be found.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("simulate_transfer_deposit", "SANDBOX ONLY. Simulate the customer sending the crypto an off-ramp transfer is waiting on, so the transfer can progress to payout without an on-chain payment. Fails on production.", {
+        transferId: z.string().describe("The transfer awaiting funds"),
+    }, async ({ transferId }) => {
+        try {
+            const result = await client.simulateTransferDeposit(transferId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Simulated the inbound deposit for transfer ${transferId}:\n\n${JSON.stringify(result, null, 2)}\n\nUse 'get_transfer' to follow the status.`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to simulate the transfer deposit: ${error instanceof Error ? error.message : "Unknown error"}\n\nThis endpoint exists only in sandbox — on production it will not be found.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=sandbox.js.map

package/build/tools/sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../../src/tools/sandbox.ts"],"names":[],"mappings":"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"}

package/build/tools/transfers.d.ts

@@ -1,6 +1,9 @@
 /**
  * Transfer Tools for Stables MCP Server
- * Synced with OpenAPI spec from https://api.stables.money/docs
+ *
+ * Mirrors POST /api/v1/transfer as of 2026-07-30. The wire is snake_case and the
+ * payout target is a discriminated `destination`, not the old nested
+ * `paymentMethod.bankTransfer`.
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StablesApiClient } from "../lib/stables-client.js";

package/build/tools/transfers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transfers.d.ts","sourceRoot":"","sources":["../../src/tools/transfers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,QAiQhF"}
+{"version":3,"file":"transfers.d.ts","sourceRoot":"","sources":["../../src/tools/transfers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAuC,MAAM,0BAA0B,CAAC;AA2CjG,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,QAyUhF"}