agenticbtc-mcp 1.0.5 → 1.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenticbtc-mcp",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "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

@@ -1212,19 +1212,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),
       }],
     };