Lightning Enable

MCP server enabling AI agents to make Bitcoin Lightning payments, check balances, access L402 APIs, and manage payment budgets. Supports Strike, OpenNode, NWC, and LND wallets.

GitHub

Part of Lightning Enable — infrastructure for agent commerce over Lightning.

Lightning Enable MCP Server

An open-source MCP (Model Context Protocol) server that enables AI agents to make Lightning Network payments and participate in agent-to-agent commerce. 23 tools total: 15 free wallet tools, 2 producer tools, and 6 Agent Service Agreement (ASA) tools for discovering, negotiating, and settling services between agents on Nostr. Producer and ASA tools require an Agentic Commerce subscription.

Available in .NET and Python.

What It Does

Give your AI agent a Lightning wallet and it can:

  • Pay invoices — Send Bitcoin via Lightning to any BOLT11 invoice
  • Access L402 APIs — Automatically pay L402 challenges for seamless API access
  • Discover APIs — Search the L402 API registry to find paid APIs by keyword or category, or fetch a specific API's manifest for full endpoint details and pricing
  • Track spending — Budget limits, payment history, and balance checks
  • Create invoices — Generate invoices to receive payments
  • Get BTC price — Real-time Bitcoin price from Strike
  • Exchange currency — Convert between USD/BTC/EUR and more (Strike wallet)
  • Send on-chain — Send Bitcoin on-chain (Strike/LND)
  • Sell services (L402 Producer) — Create L402 payment challenges and verify payments, enabling agents to be full commerce participants that both buy and sell
  • Agent commerce (ASA) — Discover, request, settle, and review agent-to-agent services on Nostr

Quick Install

# .NET
dotnet tool install -g LightningEnable.Mcp

# Python
pip install lightning-enable-mcp

# Python (no install)
uvx lightning-enable-mcp

# Docker
docker pull refinedelement/lightning-enable-mcp:latest

Claude Desktop Config

Add to your claude_desktop_config.json:

.NET:

{
  "mcpServers": {
    "lightning-enable": {
      "command": "dotnet",
      "args": ["tool", "run", "lightning-enable-mcp"],
      "env": {
        "STRIKE_API_KEY": "your-strike-api-key"
      }
    }
  }
}

Python:

{
  "mcpServers": {
    "lightning-enable": {
      "command": "uvx",
      "args": ["lightning-enable-mcp"],
      "env": {
        "STRIKE_API_KEY": "your-strike-api-key"
      }
    }
  }
}

Config file locations:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/claude/claude_desktop_config.json

Supported Wallets

WalletSetupL402 Support
StrikeAPI keyYes
LNDREST + macaroonYes (guaranteed)
NWC (CoinOS)Connection stringYes
NWC (CLINK)Connection stringYes
NWC (Alby Hub)Connection stringYes
OpenNodeAPI keyNo (no preimage)

Try It: Lightning Enable Store

The Lightning Enable Store is a live L402-powered web store. Ask Claude:

Buy me a Lightning Enable t-shirt from store.lightningenable.com

Documentation

Repository Structure

lightning-enable-mcp/
├── dotnet/
│   ├── src/LightningEnable.Mcp/         # .NET MCP server
│   ├── tests/LightningEnable.Mcp.Tests/  # .NET tests
│   └── LightningEnable.Mcp.sln          # Solution file
├── python/
│   └── lightning-enable-mcp/             # Python MCP server
├── .github/workflows/publish-mcp.yml     # CI/CD
├── LICENSE                               # MIT
└── README.md                             # This file

Agent Service Agreement (ASA) Tools

These tools enable agent-to-agent commerce on Nostr:

ToolDescriptionSubscription
discover_agent_servicesSearch for agent capabilities by category, hashtag, or keywordFree
publish_agent_capabilityPublish your agent's services to the Nostr network (kind 38400)Agentic Commerce
request_agent_serviceRequest a service from another agent (kind 38401)Agentic Commerce
settle_agent_servicePay for an agent service via L402 Lightning settlementFree*
publish_agent_attestationLeave a review/rating for an agent after service completion (kind 38403)Agentic Commerce
get_agent_reputationCheck an agent's reputation score from on-protocol attestationsFree

*settle uses wallet balance, subject to budget limits

How Agent Commerce Works

  1. Discover — discover_agent_services(category="translation") finds agents offering translation
  2. Request — request_agent_service(capability_id, budget_sats=100) sends a service request
  3. Settle — settle_agent_service(l402_endpoint) pays via Lightning and receives the result
  4. Review — publish_agent_attestation(pubkey, agreement_id, rating=5) builds on-protocol reputation

For dynamic pricing, providers use create_l402_challenge to generate invoices at negotiated prices. Requesters pay and providers verify with verify_l402_payment.

Related Projects

License

MIT — see LICENSE.

Links

संबंधित सर्वर