@quackai/q402-mcp 0.7.4 → 0.7.6

package/dist/index.js

@@ -211,7 +211,7 @@ var isValidPrivateKey = (s) => typeof s === "string" && PRIVATE_KEY_RE.test(s);
 
 // src/version.ts
 var PACKAGE_NAME = "@quackai/q402-mcp";
-var PACKAGE_VERSION = "0.7.4";
+var PACKAGE_VERSION = "0.7.6";
 
 // src/tools/quote.ts
 import { z } from "zod";
@@ -1193,6 +1193,10 @@ var PAY_TOOL = {
         enum: ["eoa", "agentic-local", "agentic-server"],
         description: `Which wallet to spend from. "eoa" = user's real MetaMask EOA (Q402_PRIVATE_KEY). "agentic-local" = Agent Wallet exported key (Q402_AGENTIC_PRIVATE_KEY). "agentic-server" = server-managed Agent Wallet (Q402 holds the key; only the apiKey is needed). When MULTIPLE wallets are configured the tool refuses without this arg and returns ambiguousWalletChoice for the user to pick.`
       },
+      walletId: {
+        type: "string",
+        description: `Server-managed Agent Wallet only (walletMode="agentic-server"). Lowercased Agent Wallet address selecting which of the user's wallets to spend from when they hold more than one (max 10 per owner). Omit to use the user's default wallet. Ignored for the other walletMode values since those modes carry their own signing key.`
+      },
       confirm: {
         type: "boolean",
         const: true,
@@ -1350,7 +1354,8 @@ async function runBatchPay(input) {
     } catch {
     }
   }
-  const scopeRequest = input.keyScope ?? "auto";
+  const rawScopeRequest = input.keyScope ?? "auto";
+  const scopeRequest = effectiveMode === "agentic-server" && rawScopeRequest === "auto" ? "multichain" : rawScopeRequest;
   if (scopeRequest === "trial" && input.recipients.length > RECIPIENT_LIMIT_TRIAL) {
     guardsApplied.push("trial_cap_exceeded");
     return {
@@ -2811,6 +2816,16 @@ async function runRecurringList(input = {}) {
       setupHint: "No live Q402 API key configured. Run q402_doctor to set one up, or open the dashboard to create rules from the UI."
     };
   }
+  if (!CONFIG.multichainApiKey || !CONFIG.multichainApiKey.startsWith("q402_live_")) {
+    return {
+      configured: false,
+      walletId: null,
+      rules: [],
+      count: 0,
+      dashboardUrl,
+      setupHint: "Recurring payments require a paid Multichain API key (Q402_MULTICHAIN_API_KEY). Trial keys can't see recurring rules. Activate a paid plan at https://q402.quackai.ai/payment."
+    };
+  }
   const explicitWalletId = typeof input.walletId === "string" && input.walletId.length > 0 ? input.walletId.toLowerCase() : CONFIG.walletId;
   try {
     const res = await fetch(`${base}/wallet/agentic/recurring-by-key`, {
@@ -2947,6 +2962,16 @@ async function runRecurringCreate(input) {
       dashboardUrl
     };
   }
+  if (!CONFIG.multichainApiKey || !CONFIG.multichainApiKey.startsWith("q402_live_")) {
+    return {
+      ok: false,
+      walletId: null,
+      rule: null,
+      error: "MULTICHAIN_KEY_REQUIRED",
+      message: "Recurring payments require a paid Multichain API key (Q402_MULTICHAIN_API_KEY). Trial keys can't schedule recurring rules. Activate a paid plan at https://q402.quackai.ai/payment.",
+      dashboardUrl
+    };
+  }
   const explicitWalletId = typeof input.walletId === "string" && input.walletId.length > 0 ? input.walletId.toLowerCase() : CONFIG.walletId;
   try {
     const res = await fetch(`${base}/wallet/agentic/recurring-by-key`, {
@@ -3036,6 +3061,16 @@ async function runRecurringCancel(input) {
       dashboardUrl
     };
   }
+  if (!CONFIG.multichainApiKey || !CONFIG.multichainApiKey.startsWith("q402_live_")) {
+    return {
+      ok: false,
+      walletId: null,
+      rule: null,
+      error: "MULTICHAIN_KEY_REQUIRED",
+      message: "Recurring payments require a paid Multichain API key (Q402_MULTICHAIN_API_KEY). Activate a paid plan at https://q402.quackai.ai/payment.",
+      dashboardUrl
+    };
+  }
   const explicitWalletId = typeof input.walletId === "string" && input.walletId.length > 0 ? input.walletId.toLowerCase() : CONFIG.walletId;
   try {
     const res = await fetch(`${base}/wallet/agentic/recurring-by-key`, {
@@ -3128,6 +3163,18 @@ async function runRecurringFires(input) {
       setupHint: "No live Q402 API key configured. Run q402_doctor to set one up, or open the dashboard to view fire history from the UI."
     };
   }
+  if (!CONFIG.multichainApiKey || !CONFIG.multichainApiKey.startsWith("q402_live_")) {
+    return {
+      configured: false,
+      walletId: null,
+      ruleId: input.ruleId,
+      rule: null,
+      fires: [],
+      count: 0,
+      dashboardUrl,
+      setupHint: "Recurring payments require a paid Multichain API key (Q402_MULTICHAIN_API_KEY). Trial keys can't see fire history. Activate a paid plan at https://q402.quackai.ai/payment."
+    };
+  }
   const explicitWalletId = typeof input.walletId === "string" && input.walletId.length > 0 ? input.walletId.toLowerCase() : CONFIG.walletId;
   try {
     const res = await fetch(`${base}/wallet/agentic/recurring-by-key`, {
@@ -3221,6 +3268,16 @@ async function runRecurringPause(input) {
       dashboardUrl
     };
   }
+  if (!CONFIG.multichainApiKey || !CONFIG.multichainApiKey.startsWith("q402_live_")) {
+    return {
+      ok: false,
+      walletId: null,
+      rule: null,
+      error: "MULTICHAIN_KEY_REQUIRED",
+      message: "Recurring payments require a paid Multichain API key (Q402_MULTICHAIN_API_KEY). Activate a paid plan at https://q402.quackai.ai/payment.",
+      dashboardUrl
+    };
+  }
   const explicitWalletId = typeof input.walletId === "string" && input.walletId.length > 0 ? input.walletId.toLowerCase() : CONFIG.walletId;
   try {
     const res = await fetch(`${base}/wallet/agentic/recurring-by-key`, {
@@ -3304,6 +3361,16 @@ async function runRecurringResume(input) {
       dashboardUrl
     };
   }
+  if (!CONFIG.multichainApiKey || !CONFIG.multichainApiKey.startsWith("q402_live_")) {
+    return {
+      ok: false,
+      walletId: null,
+      rule: null,
+      error: "MULTICHAIN_KEY_REQUIRED",
+      message: "Recurring payments require a paid Multichain API key (Q402_MULTICHAIN_API_KEY). Activate a paid plan at https://q402.quackai.ai/payment.",
+      dashboardUrl
+    };
+  }
   const explicitWalletId = typeof input.walletId === "string" && input.walletId.length > 0 ? input.walletId.toLowerCase() : CONFIG.walletId;
   try {
     const res = await fetch(`${base}/wallet/agentic/recurring-by-key`, {
@@ -3387,6 +3454,16 @@ async function runRecurringSkipNext(input) {
       dashboardUrl
     };
   }
+  if (!CONFIG.multichainApiKey || !CONFIG.multichainApiKey.startsWith("q402_live_")) {
+    return {
+      ok: false,
+      walletId: null,
+      rule: null,
+      error: "MULTICHAIN_KEY_REQUIRED",
+      message: "Recurring payments require a paid Multichain API key (Q402_MULTICHAIN_API_KEY). Activate a paid plan at https://q402.quackai.ai/payment.",
+      dashboardUrl
+    };
+  }
   const explicitWalletId = typeof input.walletId === "string" && input.walletId.length > 0 ? input.walletId.toLowerCase() : CONFIG.walletId;
   try {
     const res = await fetch(`${base}/wallet/agentic/recurring-by-key`, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quackai/q402-mcp",
-  "version": "0.7.4",
+  "version": "0.7.6",
   "description": "MCP server for Q402 — gasless USDC, USDT, and RLUSD payments across 9 EVM chains, callable from Claude (Desktop / Code), OpenAI Codex CLI, and any other Model Context Protocol client.",
   "mcpName": "io.github.bitgett/q402-mcp",
   "keywords": [