Skip to main content
Glama
Lightning Tools MCP Server

Lightning Tools MCP Server

by getAlby

⚠️ DEPRECATED ⚠️

Please use Alby MCP instead!

This repository has been deprecated in favor of Alby MCP, which includes all the NWC tools along with additional lightning tools.

Lightning Tools MCP Server

Interact with lightning addresses and use other common lightning tools with your LLM. Works well combined with NWC MCP Server

This MCP server uses the official MCP TypeScript SDK

Quick Start

Add to Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "lightning-tools": {
      "command": "npx",
      "args": ["-y", "@getalby/lightning-tools-mcp-server"],
      "env": {
        "NWC_CONNECTION_STRING": "YOUR NWC CONNECTION STRING HERE"
      }
    }
  }
}

Add to Cline

Copy the below and paste it into a cline prompt.

Add the following to my MCP servers list:

"lightning-tools": {
  "command": "npx",
  "args": ["-y", "@getalby/lightning-tools-mcp-server"],
  "env": {
    "NWC_CONNECTION_STRING": "YOUR NWC CONNECTION STRING HERE"
  },
  "disabled": false,
  "autoApprove": []
}

Related MCP server: NWC MCP Server

From Source

Prerequisites

  • Node.js 20+

  • Yarn

Installation

yarn install

Building

yarn build

Inspect the tools (use/test without an LLM)

yarn inspect

Supported Tools

See the tools directory

Available Tools

3 tools
fiat_to_satsB

Convert fiat amounts to sats

Inputs: currency (required), amount (required).

parse_invoiceC

Parse a BOLT-11 lightning invoice

Inputs: invoice (required).

request_invoiceC

Request an invoice from a lightning address

Inputs: lightning_address (required), amount (required), description, payer_data.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: fiat_to_sats handles currency conversion, parse_invoice processes existing invoices, and request_invoice generates new invoices from lightning addresses. An agent can easily distinguish these functions without confusion.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern with clear verb_noun structures (e.g., parse_invoice, request_invoice). The naming is uniform and predictable across the set.

    Tool Count3/5

    With only 3 tools, the server feels thin for a Lightning domain, as it lacks operations like sending payments, checking balances, or managing channels. However, the tools are well-scoped for basic invoice and conversion tasks, making it borderline but not severely lacking.

    Completeness2/5

    The tool surface is significantly incomplete for Lightning functionality; it covers invoice parsing/requesting and fiat conversion but misses core operations like pay_invoice, get_balance, list_transactions, or channel management. This will likely cause agent failures in broader workflows.

    Related MCP Connectors

    Related MCP Servers