Enables non-custodial Bitcoin and Lightning Network transactions, allowing AI agents to manage wallets, create and pay invoices, and monitor node and channel status.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AgentBTC MCP Serverpay 500 sats to satoshi@getalby.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AgentBTC MCP Server
BYON (Bring Your Own Node) Bitcoin payments for AI agents via Model Context Protocol
The world's first Bitcoin/Lightning MCP server. Your Lightning node credentials never leave your machine. Works with Claude Desktop, OpenClaw, and any MCP-compatible AI tool.
🌟 Features
🔒 True BYON: Your Lightning credentials never leave your machine — zero-trust architecture
⚡ Lightning Network: Fast, cheap Bitcoin micropayments (~200ms per payment)
🤖 13 MCP Tools: Complete wallet management, payments, invoices, channels, and L402
📊 L402 Protocol: HTTP 402 "Payment Required" for API monetization
🛡️ Non-Custodial: Zero counterparty risk — you control your Bitcoin
🏷️ Lightning Addresses: Send to
bot@yourname.agentbtc.io💳 Spending Policies: Per-transaction, daily, and monthly limits for agent wallets
🚀 Quick Start
Option 1: npx (no install)
Option 2: Global install
Claude Desktop Config
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
🔧 Available Tools (13)
Tool | Description |
| List all agent wallets |
| Check wallet balance |
| Create a new agent wallet |
| Remove an agent wallet |
| Lightning node status |
| Generate payment requests |
| Send Lightning payments |
| Pay Lightning addresses |
| Decode BOLT11 invoices |
| Channel liquidity info |
| List Lightning channels |
| Payment history |
| Access L402-protected APIs |
⚙️ Configuration
Environment Variables
Variable | Required | Description |
| Yes | LND REST API endpoint (e.g., |
| Yes | Path to LND macaroon file |
| No | AgentBTC server URL (default: |
| No | Your owner API key for wallet management |
CLI Commands
📋 Requirements
Node.js 18+
Lightning Node — LND with REST API enabled
MCP Client — Claude Desktop, OpenClaw, or compatible
🔒 Security Model
AgentBTC uses a BYON (Bring Your Own Node) architecture:
Your Lightning node credentials stay on your machine
The MCP server runs locally, connecting directly to your node
No credentials are ever transmitted to AgentBTC servers
Agent wallets have configurable spending limits
All payments are logged with full audit trail
🧪 Testing
🆘 Troubleshooting
"Connection refused"
Verify your Lightning node is running
Check
AGENTBTC_LND_HOST— usuallylocalhost:8080for LND RESTFor Voltage nodes: use
your-node.t.voltageapp.io:8080
"Permission denied"
Check macaroon file exists and is readable
Use
readonly.macaroonfor safety
"Invalid macaroon"
Ensure you're using the correct network (mainnet vs testnet)
Try copying the macaroon to a new path
🌐 Links
Website: agentbtc.io
GitHub: github.com/bkblock/agentbtc-mcp
📜 License
MIT — see LICENSE.
Built by BK Block Solutions ⚡