agenticbtc-mcp 1.0.5 → 1.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenticbtc-mcp",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Privacy-intelligent payments for AI agents — your privacy, your choice. Universal payment router with Lightning, Strike, Coinbase, PayPal, Venmo support.",
   "keywords": [
     "bitcoin",

package/src/server.js

@@ -259,55 +259,35 @@ server.tool(
     agent: z.string().optional().describe("Agent wallet name or ID (optional)"),
   },
   async ({ amount_sats, description, agent }) => {
-    if (!LND_HOST) {
-      return { content: [{ type: "text", text: "Error: LND node not configured. Set AGENTBTC_LND_HOST environment variable." }] };
-    }
-
-    // Resolve agent if provided (for logging/tracking)
-    let agentName = null;
-    if (agent) {
-      const resolved = await resolveAgent(agent);
-      if (!resolved) {
-        return { content: [{ type: "text", text: `Error: Agent '${agent}' not found` }] };
-      }
-      agentName = resolved.name;
-    }
-
     try {
-      // Create invoice directly via LND REST API
-      const res = await fetch(`${LND_HOST}/v1/invoices`, {
+      // Route through the AgenticBTC API so the invoice is stored in the DB
+      // and the settlement poller can credit the agent wallet on payment
+      const { status, data } = await apiCall("/api/v1/invoices", {
         method: "POST",
-        headers: {
-          "Grpc-Metadata-macaroon": LND_MACAROON,
-          "Content-Type": "application/json",
-        },
         body: JSON.stringify({
-          value: amount_sats,
-          memo: description + (agentName ? ` [${agentName}]` : ""),
-          expiry: "3600",
+          amount_sats,
+          description,
         }),
       });
-      const data = await res.json();
 
-      if (res.ok && data.payment_request) {
+      if (status === 200 && data.invoice) {
         return {
           content: [{
             type: "text",
             text: JSON.stringify({
               success: true,
-              invoice: data.payment_request,
-              amount_sats: amount_sats,
-              description: description,
-              agent: agentName,
-              payment_hash: data.r_hash,
-              expires: "1 hour",
+              invoice: data.invoice,
+              amount_sats,
+              description: data.description || description,
+              payment_hash: data.payment_hash,
+              expires: data.expires_in || "1 hour",
             }, null, 2),
           }],
         };
       }
-      return { content: [{ type: "text", text: `Error creating invoice: ${JSON.stringify(data)}` }] };
+      return { content: [{ type: "text", text: `Error creating invoice: ${data?.detail || JSON.stringify(data)}` }] };
     } catch (e) {
-      return { content: [{ type: "text", text: `LND connection error: ${e.message}` }] };
+      return { content: [{ type: "text", text: `Error: ${e.message}` }] };
     }
   }
 );
@@ -1212,19 +1192,80 @@ server.tool(
         type: "text",
         text: JSON.stringify({
           success: true,
-          onboarding_prompt: `You are helping a user set up AgenticBTC — a payment system that lets AI agents send and receive Bitcoin payments via Lightning Network.
-
-Guide the user through these steps in a friendly, conversational way:
-
-STEP 1: Check current status — Call setup_check_status to see what's already configured.
-STEP 2: API Key — If no API key, ask them to sign up at https://agenticbtc.app/dashboard
-STEP 3: Lightning Node (optional) — Ask if they have one. If yes, use setup_configure_lightning. If no, recommend Voltage (voltage.cloud).
-STEP 4: Test Everything — Call setup_test_payment_capabilities
-STEP 5: Complete — Call setup_complete_onboarding
-
-IMPORTANT: Do NOT create wallets for the user. Wallet creation is always a deliberate owner action done through the dashboard. Your job is to get them connected and verified — not to create anything on their behalf.
-
-Be patient, explain everything in plain language, celebrate small wins.`,
+          onboarding_prompt: `You are helping a user set up AgenticBTC — a platform that lets AI agents send and receive Bitcoin payments via Lightning Network.
+
+Your job is to guide them through setup conversationally. Be friendly, patient, and explain everything in plain language. One step at a time — never dump multiple questions at once.
+
+---
+
+STEP 1: Check current status
+Call setup_check_status first. This tells you exactly what's already configured and what's missing. Use this to skip steps the user has already completed.
+
+---
+
+STEP 2: API Key
+If no API key is configured:
+- Ask them to open https://agenticbtc.app/dashboard in their browser
+- Tell them to create an account if they don't have one (takes 2 minutes)
+- Once logged in, go to Settings → API Keys → copy their Owner API Key
+- Ask them to paste it here
+- Call setup_validate_credentials to confirm it works
+
+---
+
+STEP 3: Lightning Node
+Ask: "Do you already have a Lightning Network node set up?"
+
+IF YES — they have a node:
+- Ask what type (Voltage, Umbrel, Start9, BTCPay, other)
+- For Voltage: ask for their node's REST URL and admin macaroon
+  - REST URL format: https://yournode.m.voltageapp.io:8080
+  - Macaroon: found in Voltage dashboard → Node → Connection Details → Admin Macaroon (hex)
+- For Umbrel: ask for their lndconnect URL
+  - Found in: Lightning Node app → ⋯ menu → Connect Wallet → REST Local Network
+- Call setup_configure_lightning with their credentials
+- Call setup_validate_credentials to test the connection
+
+IF NO — they don't have a node:
+- Explain: "Lightning lets your AI agents make instant Bitcoin payments. You'll need a node to use it. The easiest option is Voltage Cloud — it takes about 5 minutes and costs around $20/month."
+- Walk them through Voltage signup step by step:
+  1. Go to https://voltage.cloud and click "Start Building"
+  2. Create an account with email + password
+  3. Click "Create Node" → select "LND" → choose "Testnet" (for testing) or "Mainnet"
+  4. Pick the smallest plan (Standard is fine to start)
+  5. Wait 2-3 minutes for the node to initialize
+  6. Once ready, go to your node dashboard → click "Connect" → copy the REST API URL and Admin Macaroon
+  7. Paste both here and I'll configure the connection
+- After they have credentials, call setup_configure_lightning
+- Call setup_validate_credentials to confirm
+
+IF SKIPPING Lightning:
+- That's fine — AgenticBTC works without Lightning for wallet management and other payment rails
+- Tell them they can add Lightning later from the dashboard Settings
+
+---
+
+STEP 4: Test everything
+Call setup_test_payment_capabilities to verify the full stack is working.
+Report results clearly — what passed, what failed, and why.
+
+---
+
+STEP 5: Complete onboarding
+Call setup_complete_onboarding to mark setup as done and return a summary.
+Tell the user:
+- Their dashboard: https://agenticbtc.app/dashboard
+- To create agent wallets: go to Dashboard → Wallets → Create Wallet
+- Wallets are created by the owner through the dashboard — not automatically
+
+---
+
+CRITICAL RULES:
+- NEVER create wallets for the user. Ever. Wallet creation is always a deliberate owner action.
+- NEVER store or repeat credentials back to the user in plain text after they've been submitted.
+- NEVER rush — one question at a time, wait for confirmation before moving on.
+- If something fails, call setup_diagnose_issues and explain the fix in plain language.
+- Celebrate wins: "✅ API key confirmed!", "⚡ Lightning node connected!", etc.`,
         }, null, 2),
       }],
     };