lightning-mcp-server
par roasbeef
Web & Frontend DevelopmentRésumé
Build and configure the MCP server for Lightning Node Connect (LNC)
Description
Ce que fait ce skill
MCP server that connects AI assistants to Lightning Network nodes via Lightning Node Connect (LNC). Uses encrypted WebSocket tunnels through a mailbox relay, requiring only a 10-word pairing phrase from Lightning Terminal, no TLS certificates or macaroons. Read-only by default, exposing 18 tools for querying node state, channels, payments, invoices, peers, and on-chain data.
Access a remote lnd node without exposing TLS certificates, macaroons, or open gRPC ports; the mailbox relay handles all connectivity using only an in-memory pairing phrase.
Quand l'utiliser
- Check Lightning node channel balances and capacity mid-conversation
- Decode a BOLT11 invoice to verify amount and recipient before paying
- Review payment history and track a specific payment by hash
- Inspect peer connections and sample Lightning Network topology
- Estimate on-chain fees for different confirmation targets
Exemple de workflow
User asks: What is the current balance and channel status of my Lightning node?
- 1
Call lnc_connect with the 10-word pairing phrase to open an encrypted tunnel
- 2
Call lnc_get_balance to retrieve on-chain wallet and channel balances
- 3
Call lnc_list_channels to get active channels with capacity and local/remote balances
- 4
Call lnc_disconnect to close the tunnel
- 5
Return a summary of balances and channel status to the user
Node has 0.05 BTC on-chain, 3 active channels totaling 0.12 BTC capacity, with 0.08 BTC local balance available to send
Prérequis
- Lightning Terminal (litd) installed and running on the target lnd node to generate pairing phrases
Installation
clawhub install roasbeef/lightning-mcp-serverExécute la commande CLI, ou colle l'instruction dans Claude Code, Cursor, Codex ou l'agent de code que tu utilises.