@quackai/q402-mcp 0.3.4 → 0.3.5

package/README.md

@@ -5,6 +5,10 @@
 [![npm](https://img.shields.io/npm/v/@quackai/q402-mcp.svg)](https://www.npmjs.com/package/@quackai/q402-mcp)
 [![license](https://img.shields.io/npm/l/@quackai/q402-mcp.svg)](./LICENSE)
 
+> **🎟️ Free trial available (2026-05-13 → 2026-05-20)** — 2,000 gasless transactions on BNB Chain (USDC + USDT), 30-day window, no card. One wallet signature: <https://q402.quackai.ai>.
+>
+> **BNB-focus sprint window:** while the sprint is on, `q402_pay` accepts `chain: "bnb"` with `token: "USDC"` or `"USDT"` only; the other 6 chains and RLUSD return after the sprint. `q402_quote` is narrowed to BNB Chain accordingly. Source-of-truth flag: [`feature-flags.ts`](https://github.com/bitgett/Q402-Institutional/blob/feat/bnb-focus-sprint/app/lib/feature-flags.ts).
+
 Claude can now reason about stablecoin payments end to end — quote a transfer across 7 chains, pick the cheapest route, and (optionally) settle the transaction over [Q402](https://q402.quackai.ai)'s EIP-7702 relayer infrastructure. The recipient receives the full amount; the sender pays $0 in gas.
 
 ---

package/dist/index.js

@@ -163,12 +163,24 @@ var CHAIN_CONFIG = {
     note: "USDT only until Circle CCTP native USDC ships (announced for Q2 2026)."
   }
 };
+var BNB_FOCUS_MODE = true;
+var BNB_FOCUS_REJECTION_MESSAGE = 'BNB-focus sprint: this chain/token is temporarily hidden. Full multi-chain support returns after the sprint window. Pass chain: "bnb" with token "USDC" or "USDT".';
+if (BNB_FOCUS_MODE) {
+  for (const key of CHAIN_KEYS) {
+    if (key !== "bnb") {
+      CHAIN_CONFIG[key].supportedTokens = [];
+    }
+  }
+}
 function getChain(key) {
   const cfg = CHAIN_CONFIG[key];
   if (!cfg) throw new Error(`Unsupported chain: ${key}. Supported: ${CHAIN_KEYS.join(", ")}`);
   return cfg;
 }
 function tokenFor(cfg, token) {
+  if (BNB_FOCUS_MODE && !(cfg.supportedTokens?.includes(token) ?? false)) {
+    throw new Error(BNB_FOCUS_REJECTION_MESSAGE);
+  }
   if (token === "RLUSD") {
     if (!cfg.rlusd) {
       throw new Error(
@@ -207,6 +219,7 @@ function runQuote(input) {
   const filterChain = input.chain;
   const filterToken = input.token;
   const candidates = (filterChain ? [filterChain] : CHAIN_KEYS).map((k) => CHAIN_CONFIG[k]).filter((cfg) => {
+    if (cfg.supportedTokens && cfg.supportedTokens.length === 0) return false;
     if (!filterToken) return true;
     if (cfg.supportedTokens && !cfg.supportedTokens.includes(filterToken)) return false;
     return true;
@@ -227,7 +240,7 @@ function runQuote(input) {
 }
 var QUOTE_TOOL = {
   name: "q402_quote",
-  description: "Compare gas costs and supported tokens across the 7 chains Q402 relays for. Read-only \u2014 no API key needed, no funds move. Use this before q402_pay so the user can pick the cheapest chain.",
+  description: "Compare gas costs and supported tokens for the chains Q402 relays for. BNB-focus sprint: results are currently restricted to BNB Chain + USDC/USDT (other chains and RLUSD return after the sprint window). Read-only \u2014 no API key needed, no funds move. Use this before q402_pay so the user sees what's currently routable.",
   // Plain JSON schema mirroring the Zod schema above; MCP servers receive parameters as JSON.
   inputSchema: {
     type: "object",
@@ -518,7 +531,7 @@ function describeSandboxReason() {
 }
 var PAY_TOOL = {
   name: "q402_pay",
-  description: "Send a gasless USDC, USDT, or RLUSD payment via Q402. RLUSD (Ripple USD, NY DFS regulated, decimals 18) is supported on Ethereum mainnet only; USDC/USDT span all seven Q402 chains (Injective is USDT-only). SANDBOX BY DEFAULT \u2014 no funds move unless Q402_API_KEY (live tier), Q402_PRIVATE_KEY, and Q402_ENABLE_REAL_PAYMENTS=1 are all set. The recipient receives the full amount; the sender pays $0 in gas. ALWAYS get explicit user confirmation of the exact recipient address, amount, chain, and token in conversation immediately before calling this tool.",
+  description: 'Send a gasless USDC or USDT payment via Q402. BNB-FOCUS SPRINT IS ACTIVE: only chain: "bnb" with token "USDC" or "USDT" is accepted; every other chain and RLUSD return an error directing the caller back to BNB. (The other 6 chains and RLUSD return after the sprint window.) SANDBOX BY DEFAULT \u2014 no funds move unless Q402_API_KEY (live tier), Q402_PRIVATE_KEY, and Q402_ENABLE_REAL_PAYMENTS=1 are all set. The recipient receives the full amount; the sender pays $0 in gas. ALWAYS get explicit user confirmation of the exact recipient address, amount, chain, and token in conversation immediately before calling this tool.',
   inputSchema: {
     type: "object",
     properties: {
@@ -573,16 +586,24 @@ async function runBalance() {
     body: JSON.stringify({ apiKey: CONFIG.apiKey })
   });
   const verifyJson = resp.ok ? await resp.json() : { error: `HTTP ${resp.status}` };
+  const v = verifyJson;
+  const trialMeta = v && v.isTrial && typeof v.trialExpiresAt === "string" ? {
+    daysLeft: typeof v.trialDaysLeft === "number" ? v.trialDaysLeft : 0,
+    expiresAt: v.trialExpiresAt,
+    creditsRemaining: typeof v.remainingCredits === "number" ? v.remainingCredits : 0,
+    signupUrl: "https://q402.quackai.ai"
+  } : void 0;
   return {
     apiKeyKind: CONFIG.apiKeyKind,
     apiKeyMasked: mask(CONFIG.apiKey),
     verify: verifyJson,
-    dashboardUrl: "https://q402.quackai.ai/dashboard"
+    dashboardUrl: "https://q402.quackai.ai/dashboard",
+    ...trialMeta ? { trial: trialMeta } : {}
   };
 }
 var BALANCE_TOOL = {
   name: "q402_balance",
-  description: "Verify the configured API key and report its plan tier (live vs sandbox). Read-only. For remaining daily quota and per-chain gas tank balances, point the user at https://q402.quackai.ai/dashboard \u2014 those need a wallet signature, not a bare key.",
+  description: "Verify the configured API key and report its plan tier (live vs sandbox vs trial). Read-only. When the key is on the free trial, returns the days-left and credits-remaining summary so the agent can surface it. Free trial available at https://q402.quackai.ai \u2014 2,000 gasless TX over 30 days, one wallet signature. For per-chain gas tank balances, point the user at https://q402.quackai.ai/dashboard \u2014 those need a wallet signature, not a bare key.",
   inputSchema: {
     type: "object",
     properties: {},
@@ -755,7 +776,7 @@ var RECEIPT_TOOL = {
 
 // src/index.ts
 var PACKAGE_NAME = "@quackai/q402-mcp";
-var PACKAGE_VERSION = "0.3.4";
+var PACKAGE_VERSION = "0.3.5";
 function jsonText(value) {
   return { type: "text", text: JSON.stringify(value, null, 2) };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quackai/q402-mcp",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "MCP server for Q402 — gasless USDC, USDT, and RLUSD payments across 7 EVM chains, callable directly from Claude Desktop and any other Model Context Protocol client.",
   "mcpName": "io.github.bitgett/q402-mcp",
   "keywords": [