Lightning Network MCP Server
by pblittle
The Lightning Network MCP Server allows LLM agents to query Lightning node data using natural language. It implements the Model Context Protocol (MCP) specification and is compatible with MCP Inspector.
Last updated: N/A
What is Lightning Network MCP Server?
The Lightning Network MCP Server is a tool that enables large language model (LLM) agents to interact with Lightning Network nodes using natural language. It translates natural language queries into actions performed on the node, returning both human-readable summaries and structured JSON output.
How to use Lightning Network MCP Server?
To use the server, configure it with your Lightning node credentials (LND via gRPC or LNC) in the .env
file. Then, run the server using npm run mcp:prod
. You can then interact with it using natural language queries, or test it with the MCP Inspector.
Key features of Lightning Network MCP Server
Natural language querying of Lightning nodes
Support for gRPC and Lightning Node Connect (LNC)
Returns both human-readable and machine-readable JSON output
Modular, testable, and extensible design
Compatible with MCP Inspector
Use cases of Lightning Network MCP Server
Allowing LLM agents to manage and monitor Lightning nodes
Building user interfaces for interacting with Lightning nodes
Integrating Lightning node data into downstream applications
Automating Lightning node management tasks
Providing natural language access to Lightning network information
FAQ from Lightning Network MCP Server
What Lightning node implementations are supported?
What Lightning node implementations are supported?
Currently, the server primarily supports LND via gRPC or LNC. Support for Core Lightning and Eclair is planned.
What kind of queries are supported?
What kind of queries are supported?
Currently, the system supports basic channel queries. More robust queries are in development across channels, invoices, nodes, and routing domains.
How do I configure the server to connect to my node?
How do I configure the server to connect to my node?
You need to configure the .env
file with your node's connection details, including the host, port, TLS certificate path, and macaroon path. For LNC, use the appropriate LNC connection string.
How do I test the server?
How do I test the server?
You can test the server using the official MCP inspector after building the project. Use the command LOG_LEVEL=warn npx @modelcontextprotocol/inspector node scripts/inspect.js
.
Where can I find more information about contributing?
Where can I find more information about contributing?
See the CONTRIBUTING.md file for setup, style, and testing guidance.