@quackai/q402-mcp 0.8.2 → 0.8.3

package/README.md

@@ -153,7 +153,7 @@ Then export the values in `~/.zshrc` / `~/.bashrc`. See the [Codex config refere
 
 ## Tools exposed
 
-**16 tools** — read-only by default; live mode needs an API key + signing path + `Q402_ENABLE_REAL_PAYMENTS=1`.
+**20 tools** — read-only by default; live mode needs an API key + signing path + `Q402_ENABLE_REAL_PAYMENTS=1`.
 
 | Tool | Auth | Purpose |
 |---|---|---|
@@ -173,8 +173,12 @@ Then export the values in `~/.zshrc` / `~/.bashrc`. See the [Codex config refere
 | `q402_recurring_resume` | api key | Resume a paused / stopped rule. |
 | `q402_recurring_skip_next` | api key | Skip only the next scheduled fire. |
 | `q402_recurring_cancel` | api key | Permanently stop a rule. |
+| `q402_bridge_quote` | none | Quote a Chainlink CCIP USDC bridge across eth/avax/arbitrum. Returns LINK + native fee. |
+| `q402_bridge_send` | live mode | Execute the bridge. v0.8.2 ships sandbox-only; live execution lands once session-binding ships. |
+| `q402_bridge_history` | api key | Recent CCIP bridges (50 most recent). |
+| `q402_bridge_gas_tank` | api key | Per-chain LINK + native Gas Tank balance for bridge fees. |
 
-`q402_pay` + `q402_batch_pay` require explicit in-chat confirmation. Batch confirmation = full batch, not per-row.
+`q402_pay` + `q402_batch_pay` + `q402_bridge_send` require explicit in-chat confirmation. Batch confirmation = full batch, not per-row.
 
 > ℹ️ `q402_pay` expects a 0x address — ENS isn't resolved server-side. Resolve client-side first.
 > Per-chain Gas Tank balances + full TX history live in the [dashboard](https://q402.quackai.ai/dashboard) (wallet-signature only).

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.8.2";
+var PACKAGE_VERSION = "0.8.3";
 
 // src/tools/quote.ts
 import { z } from "zod";
@@ -2813,10 +2813,26 @@ var BRIDGE_QUOTE_TOOL = {
   inputSchema: {
     type: "object",
     properties: {
-      src: { type: "string", enum: ["eth", "avax", "arbitrum"], description: "Source chain" },
-      dst: { type: "string", enum: ["eth", "avax", "arbitrum"], description: "Destination chain (must differ from src)" },
-      amount: { type: "string", description: "USDC amount in raw 6-decimal units" },
-      destReceiver: { type: "string", description: "Destination receiver (0x address)" }
+      src: {
+        type: "string",
+        enum: ["eth", "avax", "arbitrum"],
+        description: "Source chain."
+      },
+      dst: {
+        type: "string",
+        enum: ["eth", "avax", "arbitrum"],
+        description: "Destination chain (MUST differ from src; pool only routes inside the 3-chain triangle)."
+      },
+      amount: {
+        type: "string",
+        pattern: "^[0-9]+$",
+        description: "USDC amount in raw 6-decimal units (e.g. '1000000' = 1 USDC). Integer string only."
+      },
+      destReceiver: {
+        type: "string",
+        pattern: "^0x[0-9a-fA-F]{40}$",
+        description: "Destination receiver (0x 20-byte address). Same EOA on the destination chain."
+      }
     },
     required: ["src", "dst", "amount", "destReceiver"]
   }
@@ -2832,9 +2848,17 @@ async function runBridgeQuote(input) {
   if (!res.ok) {
     return { content: [{ type: "text", text: `Quote failed (HTTP ${res.status}): ${JSON.stringify(data)}` }], isError: true };
   }
+  const recommended = data.recommended;
+  const link = data.fee?.link;
+  const native = data.fee?.native;
+  const otherKey = recommended === "link" ? "native" : "link";
+  const recUsd = recommended ? data.fee?.[recommended]?.usd : void 0;
+  const otherUsd = recommended ? data.fee?.[otherKey]?.usd : void 0;
+  const cheaper = recommended && typeof recUsd === "number" ? `Cheaper: ${recommended.toUpperCase()} (~$${recUsd.toFixed(4)} vs $${(otherUsd ?? 0).toFixed(4)})` : "Quote returned.";
   return {
     content: [
-      { type: "text", text: JSON.stringify(data, null, 2) }
+      { type: "text", text: cheaper },
+      { type: "text", text: JSON.stringify({ recommended, link, native }, null, 2) }
     ]
   };
 }
@@ -2855,12 +2879,34 @@ var BRIDGE_SEND_TOOL = {
   inputSchema: {
     type: "object",
     properties: {
-      src: { type: "string", enum: ["eth", "avax", "arbitrum"] },
-      dst: { type: "string", enum: ["eth", "avax", "arbitrum"] },
-      amount: { type: "string", description: "USDC amount in raw 6-decimal units" },
-      walletId: { type: "string", description: "Agentic Wallet ID" },
-      feeToken: { type: "string", enum: ["LINK", "native", "auto"], description: "Default: LINK" },
-      sandbox: { type: "boolean", description: "Sandbox-only. Default true. Set to false for live bridge." }
+      src: {
+        type: "string",
+        enum: ["eth", "avax", "arbitrum"],
+        description: "Source chain."
+      },
+      dst: {
+        type: "string",
+        enum: ["eth", "avax", "arbitrum"],
+        description: "Destination chain (MUST differ from src)."
+      },
+      amount: {
+        type: "string",
+        pattern: "^[0-9]+$",
+        description: "USDC amount in raw 6-decimal units (e.g. '1000000' = 1 USDC). Integer string only."
+      },
+      walletId: {
+        type: "string",
+        description: "Agentic Wallet ID (from q402_agentic_info)."
+      },
+      feeToken: {
+        type: "string",
+        enum: ["LINK", "native", "auto"],
+        description: "Fee token. Default: LINK (~10% cheaper). 'auto' picks cheaper at quote time."
+      },
+      sandbox: {
+        type: "boolean",
+        description: "Sandbox-only in v0.8.3 (live bridging requires dashboard session-binding). Default true."
+      }
     },
     required: ["src", "dst", "amount", "walletId"]
   }
@@ -2903,7 +2949,11 @@ var BRIDGE_HISTORY_TOOL = {
   inputSchema: {
     type: "object",
     properties: {
-      ownerAddress: { type: "string", description: "Owner address (optional)" }
+      ownerAddress: {
+        type: "string",
+        pattern: "^0x[0-9a-fA-F]{40}$",
+        description: "Owner EOA (0x address, optional \u2014 defaults to configured wallet)."
+      }
     }
   }
 };
@@ -2911,8 +2961,9 @@ async function runBridgeHistory(_input) {
   return {
     content: [{
       type: "text",
-      text: "Bridge history via MCP requires owner-sig auth, which is dashboard-managed in v0.8.2. View at https://q402.quackai.ai/dashboard \u2192 Agent tab \u2192 Bridge History."
-    }]
+      text: "Bridge history via MCP requires owner-sig auth, which is dashboard-managed in v0.8.3. View at https://q402.quackai.ai/dashboard \u2192 Agent tab \u2192 Bridge History."
+    }],
+    isError: true
   };
 }
 
@@ -2923,11 +2974,15 @@ var BridgeGasTankInputSchema = z13.object({
 });
 var BRIDGE_GAS_TANK_TOOL = {
   name: "q402_bridge_gas_tank",
-  description: "Report the user's Bridge Gas Tank state \u2014 LINK + native balance per CCIP chain (eth/avax/arbitrum). Q402 charges no markup on bridges; users pay only the actual Chainlink CCIP fee, debited from this Gas Tank. LINK fees are ~10% cheaper than native. Tool returns guidance + dashboard URL in v0.8.2.",
+  description: "Report the user's Bridge Gas Tank state \u2014 LINK + native balance per CCIP chain (eth/avax/arbitrum). Q402 charges no markup on bridges; users pay only the actual Chainlink CCIP fee, debited from this Gas Tank. LINK fees are ~10% cheaper than native. Tool returns guidance + dashboard URL in v0.8.3.",
   inputSchema: {
     type: "object",
     properties: {
-      ownerAddress: { type: "string", description: "Owner address (optional)" }
+      ownerAddress: {
+        type: "string",
+        pattern: "^0x[0-9a-fA-F]{40}$",
+        description: "Owner EOA (0x address, optional \u2014 defaults to configured wallet)."
+      }
     }
   }
 };
@@ -2942,7 +2997,7 @@ async function runBridgeGasTank(_input) {
         "  \u2022 LINK (default, ~10% cheaper)",
         "  \u2022 native (ETH / AVAX / ETH respectively)",
         "",
-        "Top up by sending LINK or native to the Q402 facilitator address on the source chain. The next deposit-scan cron tick (15 min) credits your Gas Tank.",
+        "Top up by sending LINK or native to the Q402 facilitator address on the source chain. The next deposit-scan cron tick (~5 min) credits your Gas Tank.",
         "",
         "Live balance + deposit addresses: https://q402.quackai.ai/dashboard \u2192 Agent tab \u2192 Bridge Gas Tank"
       ].join("\n")

package/package.json

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