z-zero-mcp-server 1.0.5 → 1.0.7

package/README.md

@@ -21,7 +21,7 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
   "mcpServers": {
     "openclaw": {
       "command": "npx",
-      "args": ["-y", "z-zero-mcp-server"],
+      "args": ["-y", "z-zero-mcp-server@latest"],
       "env": {
         "Z_ZERO_API_KEY": "zk_live_your_passport_key_here"
       }

package/dist/api_backend.js

@@ -55,7 +55,11 @@ async function getBalanceRemote(cardAlias) {
     const card = cards.find((c) => c.alias === cardAlias);
     if (!card)
         return null;
-    return { balance: card.balance, currency: card.currency };
+    return {
+        wallet_balance: card.balance,
+        currency: card.currency,
+        note: "This is the total wallet balance (human-level). Cards have 'limits' set at creation, not 'balances'. Use list_cards to see active token limits."
+    };
 }
 async function getDepositAddressesRemote() {
     return await apiRequest('/api/tokens/cards', 'GET');
@@ -71,6 +75,9 @@ async function issueTokenRemote(cardAlias, amount, merchant) {
     });
     if (!data)
         return null;
+    // Forward API errors (402 insufficient, 429 max cards, etc.)
+    if (data.error)
+        return data;
     // Adapt Dashboard API response to MCP expected format
     return {
         token: data.token,
@@ -78,7 +85,7 @@ async function issueTokenRemote(cardAlias, amount, merchant) {
         amount: amount,
         merchant: merchant,
         created_at: Date.now(),
-        ttl_seconds: 1800, // Matching Dashboard TTL
+        ttl_seconds: 1800,
         used: false
     };
 }

package/dist/index.js

@@ -42,12 +42,16 @@ server.tool("list_cards", "List all available virtual card aliases and their bal
         };
     }
     const cards = data?.cards || [];
+    const activeTokens = data?.active_tokens || [];
+    const recentTokens = data?.recent_tokens || [];
     return {
         content: [
             {
                 type: "text",
                 text: JSON.stringify({
                     cards,
+                    active_tokens: activeTokens,
+                    recent_tokens: recentTokens,
                     note: "Use card aliases to request payment tokens. Never ask for real card numbers.",
                 }, null, 2),
             },
@@ -57,7 +61,7 @@ server.tool("list_cards", "List all available virtual card aliases and their bal
 // ============================================================
 // TOOL 2: Check card balance (safe)
 // ============================================================
-server.tool("check_balance", "Check the remaining balance of a virtual card by its alias.", {
+server.tool("check_balance", "Check the wallet balance (human-level total). This is the spendable USD available for issuing new cards. Cards themselves have 'limits' (set at creation), not 'balances' — use list_cards to see active token limits.", {
     card_alias: zod_1.z
         .string()
         .describe("The alias of the card to check, e.g. 'Card_01'"),
@@ -68,7 +72,7 @@ server.tool("check_balance", "Check the remaining balance of a virtual card by i
             content: [{
                     type: "text",
                     text: "❌ AUTHENTICATION REQUIRED: Your Z_ZERO_API_KEY (Passport Key) is missing from the MCP configuration.\n\n" +
-                        "👉 Please GET your key here: https://clawcard.store/dashboard/agents\n" +
+                        "👉 Please GET your key here: https://www.clawcard.store/dashboard/agents\n" +
                         "👉 Then SET it as the 'Z_ZERO_API_KEY' environment variable and RESTART."
                 }],
             isError: true
@@ -104,7 +108,7 @@ server.tool("get_deposit_addresses", "Get your unique deposit addresses for EVM
             content: [{
                     type: "text",
                     text: "❌ AUTHENTICATION REQUIRED: Your Z_ZERO_API_KEY (Passport Key) is missing from the MCP configuration.\n\n" +
-                        "👉 Please GET your key here: https://clawcard.store/dashboard/agents\n" +
+                        "👉 Please GET your key here: https://www.clawcard.store/dashboard/agents\n" +
                         "👉 Then SET it as the 'Z_ZERO_API_KEY' environment variable and RESTART."
                 }],
             isError: true
@@ -116,7 +120,7 @@ server.tool("get_deposit_addresses", "Get your unique deposit addresses for EVM
             content: [
                 {
                     type: "text",
-                    text: "Failed to retrieve deposit addresses. Please ensure your Z_ZERO_API_KEY (Passport Key) is valid. You can find it at https://clawcard.store/dashboard/agents",
+                    text: "Failed to retrieve deposit addresses. Please ensure your Z_ZERO_API_KEY (Passport Key) is valid. You can find it at https://www.clawcard.store/dashboard/agents",
                 },
             ],
             isError: true,
@@ -167,12 +171,22 @@ server.tool("request_payment_token", "Request a temporary payment token for a sp
             content: [{
                     type: "text",
                     text: "❌ AUTHENTICATION REQUIRED: Your Z_ZERO_API_KEY (Passport Key) is missing from the MCP configuration.\n\n" +
-                        "👉 Please GET your key here: https://clawcard.store/dashboard/agents"
+                        "👉 Please GET your key here: https://www.clawcard.store/dashboard/agents"
                 }],
             isError: true
         };
     }
     if (!token || token.error) {
+        // Show actual API error if available (e.g. 429 max cards, 402 insufficient)
+        if (token?.message) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ ${token.message}`
+                    }],
+                isError: true,
+            };
+        }
         const balanceData = await (0, api_backend_js_1.getBalanceRemote)(card_alias);
         const balance = balanceData?.balance;
         return {
@@ -227,7 +241,7 @@ server.tool("execute_payment", "Execute a payment using a temporary token. This
             content: [{
                     type: "text",
                     text: "❌ AUTHENTICATION REQUIRED: Your Z_ZERO_API_KEY (Passport Key) is missing from the MCP configuration.\n\n" +
-                        "👉 Please GET your key here: https://clawcard.store/dashboard/agents"
+                        "👉 Please GET your key here: https://www.clawcard.store/dashboard/agents"
                 }],
             isError: true
         };
@@ -270,7 +284,7 @@ server.tool("execute_payment", "Execute a payment using a temporary token. This
 // ============================================================
 // TOOL 5: Cancel payment token (returns funds to wallet)
 // ============================================================
-server.tool("cancel_payment_token", "Cancel a payment token that has not been used yet. This will cancel the Airwallex card and refund the full amount back to the wallet. Use this when: (1) checkout price is higher than token amount, (2) purchase is no longer needed, or (3) human requests cancellation. IMPORTANT: Do NOT auto-cancel without human awareness — always inform the human first.", {
+server.tool("cancel_payment_token", "Cancel a payment token that has not been used yet. This will cancel the virtual card at the issuing network and refund the full amount back to the wallet. Use this when: (1) checkout price is higher than token amount, (2) purchase is no longer needed, or (3) human requests cancellation. IMPORTANT: Do NOT auto-cancel without human awareness — always inform the human first.", {
     token: zod_1.z
         .string()
         .describe("The payment token to cancel"),
@@ -284,7 +298,7 @@ server.tool("cancel_payment_token", "Cancel a payment token that has not been us
             content: [{
                     type: "text",
                     text: "❌ AUTHENTICATION REQUIRED: Your Z_ZERO_API_KEY (Passport Key) is missing from the MCP configuration.\n\n" +
-                        "👉 Please GET your key here: https://clawcard.store/dashboard/agents"
+                        "👉 Please GET your key here: https://www.clawcard.store/dashboard/agents"
                 }],
             isError: true
         };

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "z-zero-mcp-server",
-    "version": "1.0.5",
-    "description": "Z-ZERO MCP Server — Secure JIT Virtual Card Payment tools for AI Agents (Claude, AutoGPT, CrewAI) — Real Airwallex Mastercards",
+    "version": "1.0.7",
+    "description": "Z-ZERO MCP Server — Secure JIT Virtual Card Payment tools for AI Agents (Claude, Cursor, AutoGPT) — Real Single-Use Visa Cards",
     "main": "dist/index.js",
     "bin": "dist/index.js",
     "scripts": {