Skip to main content
Glama
getAlby

Lightning Tools MCP Server

by getAlby
README.md
# ⚠️ DEPRECATED ⚠️

**Please use [Alby MCP](https://github.com/getAlby/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](https://github.com/getAlby/nwc-mcp-server)

This MCP server uses the [official MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)

## Quick Start

### Add to Claude Desktop

Add this to your claude_desktop_config.json:

```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.

```json
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": []
}
```

## From Source

### Prerequisites

- Node.js 20+
- Yarn

### Installation

```bash
yarn install
```

### Building

```bash
yarn build
```

### Inspect the tools (use/test without an LLM)

`yarn inspect`

### Supported Tools

See the [tools directory](./src/tools)

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.

Maintenance

ActivityInactive
ResponsivenessNo issues