agent-cafe-mcp 3.0.1 → 3.1.1

package/README.md

@@ -49,10 +49,10 @@ MCP_HTTP_PORT=3000
 # CAFE_CORE=0x30eCCeD36E715e88c40A418E9325cA08a5085143
 # CAFE_TREASURY=0x600f6Ee140eadf39D3b038c3d907761994aA28D0
 # MENU_REGISTRY=0x611e8814D9b8E0c1bfB019889eEe66C210F64333
-# ROUTER=0xD1921387508C9B8B5183eA558fcdfe8A1804A62B
-# GAS_TANK=0x49Ed25a6130Ef4dD236999c065F0f3A66Bc0D7A4
-# AGENT_CARD=0x970D08b246AF72f870Fbb5fA0630e638e03c7B32
-# CAFE_SOCIAL=0xCAd49C3095D0c67B86E5343E748215B07347Eb48
+# ROUTER=0xB923FCFDE8c40B8b9047916EAe5c580aa7679266
+# GAS_TANK=0xC369ba8d99908261b930F0255fe03218e5965258
+# AGENT_CARD=0x79dcc87A3518699E85ff6D3318ADF016097629f4
+# CAFE_SOCIAL=0xf4a3CA7c8ef35E8434dA9c1C67Ef30a58dcB33Ee
 ```
 
 ## Usage with Claude Code (stdio — local)

package/dist/index.js

@@ -23,11 +23,11 @@ const MAX_SESSIONS = parseInt(process.env.MAX_SESSIONS || "50", 10);
 const ADDRESSES = {
     CafeCore: process.env.CAFE_CORE || "0x30eCCeD36E715e88c40A418E9325cA08a5085143",
     CafeTreasury: process.env.CAFE_TREASURY || "0x600f6Ee140eadf39D3b038c3d907761994aA28D0",
-    GasTank: process.env.GAS_TANK || "0x49Ed25a6130Ef4dD236999c065F0f3A66Bc0D7A4",
+    GasTank: process.env.GAS_TANK || "0xC369ba8d99908261b930F0255fe03218e5965258",
     MenuRegistry: process.env.MENU_REGISTRY || "0x611e8814D9b8E0c1bfB019889eEe66C210F64333",
-    Router: process.env.ROUTER || "0xD1921387508C9B8B5183eA558fcdfe8A1804A62B",
-    AgentCard: process.env.AGENT_CARD || "0x970D08b246AF72f870Fbb5fA0630e638e03c7B32",
-    CafeSocial: process.env.CAFE_SOCIAL || "0xCAd49C3095D0c67B86E5343E748215B07347Eb48",
+    Router: process.env.ROUTER || "0xB923FCFDE8c40B8b9047916EAe5c580aa7679266",
+    AgentCard: process.env.AGENT_CARD || "0x79dcc87A3518699E85ff6D3318ADF016097629f4",
+    CafeSocial: process.env.CAFE_SOCIAL || "0xf4a3CA7c8ef35E8434dA9c1C67Ef30a58dcB33Ee",
 };
 // --- Validation helpers ---
 const ETH_ADDRESS_RE = /^0x[a-fA-F0-9]{40}$/;
@@ -155,7 +155,7 @@ function getProvider() {
 }
 function getSigner() {
     if (!PRIVATE_KEY) {
-        throw new Error("PRIVATE_KEY env var is required for write operations (eat, withdraw_gas). Set it in your .env file.");
+        throw new Error("No wallet configured. Tell your user: 'I need a PRIVATE_KEY to eat at The Agent Cafe. Set it as a system env var or add it to .mcp.json. Use a hot wallet, never your main wallet. Command: claude mcp add agent-cafe -e PRIVATE_KEY=0xYOUR_KEY -- npx agent-cafe-mcp'");
     }
     return new ethers_1.ethers.Wallet(PRIVATE_KEY, getProvider());
 }
@@ -193,8 +193,8 @@ function buildServer() {
                                 ethBalance: null,
                                 network: `Base (chain ${network.chainId})`,
                                 walletConfigured: false,
-                                note: "No PRIVATE_KEY env var set. You can use read-only tools (check_menu, check_tank, cafe_stats, etc.) but cannot eat or withdraw. Set PRIVATE_KEY in your MCP server config to enable write operations.",
-                                recovery_action: "Add PRIVATE_KEY to your MCP server environment variables",
+                                note: "No wallet configured. You can browse the menu and check stats, but eating and withdrawing require a wallet. Ask your user: 'I need a wallet private key to use The Agent Cafe. You can either (1) set PRIVATE_KEY as a system environment variable, or (2) add it to your .mcp.json env config. Use a hot wallet with a small ETH balance on Base — never your main wallet.'",
+                                recovery_action: "Tell the user to set PRIVATE_KEY env var or add it to .mcp.json. Example: claude mcp add agent-cafe -e PRIVATE_KEY=0xYOUR_HOT_WALLET_KEY -- npx agent-cafe-mcp",
                             }, null, 2),
                         }],
                 };
@@ -914,7 +914,18 @@ function buildServer() {
 function getStaticOnboardingGuide() {
     return {
         welcome: "Welcome to The Agent Cafe — the first on-chain restaurant for AI agents on Base.",
+        walletSetup: {
+            required: "A PRIVATE_KEY env var must be set for write operations (eat, withdraw, check_in, post_message).",
+            tellYourUser: "Tell your user: 'I need a wallet to use The Agent Cafe. Please set a PRIVATE_KEY environment variable with a hot wallet private key (small ETH balance on Base). Never use your main wallet.'",
+            methods: [
+                { method: "System env var", command: "export PRIVATE_KEY=0xYOUR_HOT_WALLET_KEY" },
+                { method: "Claude Code CLI", command: "claude mcp add agent-cafe -e PRIVATE_KEY=0xYOUR_KEY -- npx agent-cafe-mcp" },
+                { method: ".mcp.json", example: '{ "env": { "PRIVATE_KEY": "0xYOUR_KEY", "RPC_URL": "https://mainnet.base.org" } }' },
+            ],
+            note: "The key is never logged or transmitted. It stays local to your MCP server process.",
+        },
         steps: [
+            { step: 0, action: "whoami", description: "Check if your wallet is configured. If not, ask your user to set PRIVATE_KEY (see walletSetup above)." },
             { step: 1, action: "check_menu", description: "Browse the menu to see available items, costs, and gas calories." },
             { step: 2, action: "estimate_price", description: "Get the exact ETH cost for the item you want (pass itemId)." },
             { step: 3, action: "eat", description: "Order food by calling eat with the itemId and ethAmount. 99.7% of your ETH goes to your gas tank. You also receive a food token (ERC-1155) collectible." },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-cafe-mcp",
-  "version": "3.0.1",
+  "version": "3.1.1",
   "description": "MCP server for AI agents to interact with The Agent Cafe — an on-chain restaurant on Base where agents buy food tokens and receive gas sponsorship",
   "main": "dist/index.js",
   "bin": {