# AgentBTC MCP Installation Guide
Quick guide for customers installing the AgentBTC MCP server.
## Prerequisites
1. **Node.js 18+** - [Download from nodejs.org](https://nodejs.org/)
2. **Lightning Node** - LND, Core Lightning, or compatible
3. **Claude Desktop** - [Download from anthropic.com](https://claude.ai/download)
## Installation
### Step 1: Install via NPM
```bash
npm install -g agentbtc-mcp
```
### Step 2: Setup Lightning Node Connection
```bash
agentbtc-mcp setup
```
This will prompt for:
- Lightning node host (e.g., `localhost:10009`)
- Path to macaroon file (e.g., `~/.lnd/data/chain/bitcoin/mainnet/readonly.macaroon`)
- Optional AgentBTC API key
### Step 3: Test Connection
```bash
agentbtc-mcp test
```
Should show:
```
✅ Lightning node connected successfully!
✅ AgentBTC API connected successfully!
🎉 Connection test complete!
```
### Step 4: Configure Claude Desktop
The setup command automatically updates your Claude Desktop config, but you can also run:
```bash
agentbtc-mcp claude
```
### Step 5: Restart Claude Desktop
Close and reopen Claude Desktop for the MCP server to load.
## Usage in Claude Desktop
Once installed, you can make Bitcoin payments directly in Claude:
```
"Pay 1000 sats for Bitcoin market data"
"Send 500 sats to access this premium API"
"Make a Lightning payment of 2000 sats for this service"
```
## Troubleshooting
### Common Commands
```bash
# Check configuration
agentbtc-mcp config
# Test connection
agentbtc-mcp test
# View help
agentbtc-mcp --help
```
### Common Issues
**"Command not found: agentbtc-mcp"**
- Run `npm list -g agentbtc-mcp` to verify installation
- Try `npx agentbtc-mcp` if global install failed
**"Lightning node connection failed"**
- Verify Lightning node is running
- Check macaroon path and permissions
- Try `localhost:8080` instead of `localhost:10009`
**"Claude Desktop not loading MCP"**
- Restart Claude Desktop completely
- Check config at: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Verify JSON syntax is valid
## Manual Configuration
If automatic setup doesn't work, manually add this to your Claude Desktop config:
```json
{
"mcpServers": {
"agentbtc": {
"command": "agentbtc-mcp",
"args": ["start"],
"env": {
"AGENTBTC_LND_HOST": "localhost:8080",
"AGENTBTC_LND_MACAROON": "/path/to/your/readonly.macaroon"
}
}
}
}
```
## Support
- **Documentation**: https://docs.agentbtc.io
- **Discord**: https://discord.gg/agentbtc
- **Email**: support@agentbtc.io
## Security Notes
- Only readonly macaroons are used
- Your Lightning credentials never leave your machine
- All payments are non-custodial
- Source code is open and auditable
---
**Ready to use Bitcoin payments in Claude Desktop!** ⚡
