MCP Server for Bitcoin Lightning
Description
# MCP Server for Bitcoin Lightning This repository uses https://github.com/ehallmark/btc-lightning-client for communicating with a local Lightning Network Daemon (`lnd`) and wraps it in a Model Context Protocol (MCP) server. This MCP server can be used with Agentic systems to…
About
# MCP Server for Bitcoin Lightning This repository uses https://github.com/ehallmark/btc-lightning-client for communicating with a local Lightning Network Daemon (`lnd`) and wraps it in a Model Context Protocol (MCP) server. This MCP server can be used with Agentic systems to interact with the Lightning Network. ###…
Details
- Author
- ehallmark
- Downloads
- 225
- Categories
- Finance
Jump to
- Commun
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP Server for Bitcoin LightningCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Configure environment variables for the LND RPC port, TLS certificate path, macaroon path, and the server’s host/port. Run the server with uv run main.py. Connect to it using SSE transport, for example via LangGraph’s MultiServerMCPClient.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp server for bitcoin lightning": {
"btc-lightning-mcp-server": {
"command": "uv",
"args": [
"run",
"main.py"
]
}
}
}
}McpServers
{
"btc-lightning-mcp-server": {
"command": "uv",
"args": [
"run",
"main.py"
]
}
}MCP Server for Bitcoin Lightning
This repository uses https://github.com/ehallmark/btc-lightning-client for communicating with a local Lightning Network Daemon (lnd) and wraps it in a Model Context Protocol (MCP) server. This MCP server can be used with Agentic systems to interact with the Lightning Network.
Prerequisites
+ Python >= 3.10
+ uv for package management
+ You must have a running Lightning Network Daemon (lnd) running on your machine. For more information on lnd, visit https://github.com/lightningnetwork/lnd.
Running the MCP Server
export LIGHTNING_RPC_PORT=<lnd_port>
export LIGHTNING_CERT_PATH="/path/to/lnd/tls.cert"
export LIGHTNING_MACAROON_PATH=/path/to/bitcoin/simnet/admin.macaroon
export UVICORN_PORT=<some port>
export UVICORN_HOST=<some host>
uv run main.py
Connecting to the MCP Server
This server uses SSE for transport.
With the LangGraph framework, you can connect to it using the following adapter:
from contextlib import asynccontextmanager
from langchain_mcp_adapters.client import MultiServerMCPClient
@asynccontextmanager
async def make_graph():
async with MultiServerMCPClient(
{
'lightning': {
'url': 'http://localhost:8000/sse',
'transport': 'sse',
}
}
) as lightning_mcp:
workflow = create_workflow(user, lightning_mcp)
graph = workflow.compile()
yield graph
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
