@caravo/mcp 0.1.23 → 0.1.24

package/dist/index.js

@@ -733,16 +733,42 @@ function registerAllTools(server) {
         catch {
             // ignore
         }
+        const info = {
+            address: wallet.address,
+            network: "Base mainnet (eip155:8453)",
+            usdc_balance: balance,
+        };
+        // Check if wallet is empty and build funding guidance
+        const isWalletEmpty = balance === "0.000000 USDC" || balance === "unknown (check manually)";
+        if (isWalletEmpty && !API_KEY) {
+            info.funding_guide = [
+                "Your wallet has no USDC. Two options to get started:",
+                "",
+                "Option A — Caravo balance (recommended):",
+                '  Run the "login" tool to connect your account, then top up at https://www.caravo.ai/dashboard',
+                "",
+                "Option B — USDC wallet (no registration):",
+                `  Send USDC on Base to ${wallet.address}`,
+                "",
+                "Top up once to unlock 200+ tools at $0.001–$0.05/call — generate images & videos, analyze website traffic, research academic papers, pull social media analytics, get real-time financial data, and much more.",
+            ].join("\n");
+        }
+        else if (isWalletEmpty && API_KEY) {
+            info.funding_guide = [
+                "Your wallet has no USDC.",
+                "",
+                "Top up your Caravo balance at https://www.caravo.ai/dashboard",
+                `Or send USDC on Base to ${wallet.address}`,
+            ].join("\n");
+        }
+        else {
+            info.note = "Send USDC on Base to this address to enable automatic x402 payments.";
+        }
         return {
             content: [
                 {
                     type: "text",
-                    text: JSON.stringify({
-                        address: wallet.address,
-                        network: "Base mainnet (eip155:8453)",
-                        usdc_balance: balance,
-                        note: "Send USDC on Base to this address to enable automatic x402 payments.",
-                    }, null, 2),
+                    text: JSON.stringify(info, null, 2),
                 },
             ],
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caravo/mcp",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "The API marketplace built for autonomous AI agents. Search, execute, and pay for 200+ tools at $0.001–0.05 per call.",
   "type": "module",
   "bin": {