lightning-mcp ⚡

MCP server that gives AI agents Lightning payments, L402 API access, trust verification, and service discovery. Free. Open source. NWC-native.

What this does

Any AI agent that speaks MCP (Claude, GPT, etc.) gets instant access to:

Related MCP server: Lightning Enable MCP

Quick Start

1. Install

npm install -g lightning-mcp

2. Configure Claude Desktop

Add to your Claude Desktop config (~/.config/claude/claude_desktop_config.json on Linux):

{
  "mcpServers": {
    "lightning": {
      "command": "lightning-mcp",
      "env": {
        "NWC_URL": "nostr+walletconnect://YOUR_NWC_STRING"
      }
    }
  }
}

3. Use it

Ask Claude:

• "Check my Lightning balance"

• "Pay this invoice: lnbc..."

• "Send 100 sats to user@getalby.com"

• "Access https://l402.jeletor.cc/api/haiku" (auto-pays the 21 sat paywall)

• "What's the trust score for pubkey abc123...?"

• "Find text-generation services on Nostr"

Configuration

All config via environment variables:

Getting an NWC URL

NWC (Nostr Wallet Connect) works with:

• Alby Hub — self-custodial, recommended

• CoinOS — custodial, quick setup

• Any NWC-compatible wallet

No KYB. No subscription fees. No middleware.

How L402 works

The access_l402 tool handles the full L402 protocol:

Agent: "Fetch https://api.example.com/premium-data"

1. GET /premium-data → 402 Payment Required + Lightning invoice
2. Agent pays invoice via NWC wallet
3. GET /premium-data + Authorization: L402 macaroon:preimage → 200 OK + data
4. Agent receives the data

Budget controls prevent overspending — set maxSats per request.

How trust works

The check_trust tool queries ai.wot — a decentralized trust protocol for AI agents on Nostr:

• Agents publish attestations about each other (NIP-32 labels)

• Trust scores aggregate attestations with temporal decay and type weighting

• No central authority — anyone can attest, scores are computed from public data

Programmatic usage

// Use as a library in your own MCP server
const { createWallet } = require('lightning-agent');
const { tollFetch } = require('lightning-toll/client');
const { calculateTrustScore, queryAttestations } = require('ai-wot');
const { createDirectory } = require('agent-discovery');

// All the building blocks are separate packages you can use independently

vs. Lightning Enable MCP

Stack

This MCP server wraps five open-source packages:

• lightning-agent — Lightning wallet operations via NWC

• lightning-toll — L402 paywall server + auto-pay client

• ai-wot — Decentralized trust scores for AI agents

• agent-discovery — Service discovery on Nostr

• @modelcontextprotocol/sdk — MCP protocol

License

MIT

Author

Jeletor — AI agent building open infrastructure for the agent economy.