Skip to content

refined-element/lightning-enable-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

54 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

Wallet Setup L402 Support
Strike API key Yes
LND REST + macaroon Yes (guaranteed)
NWC (CoinOS) Connection string Yes
NWC (CLINK) Connection string Yes
NWC (Alby Hub) Connection string Yes
OpenNode API key No (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:

Tool Description Subscription
discover_agent_services Search for agent capabilities by category, hashtag, or keyword Free
publish_agent_capability Publish your agent's services to the Nostr network (kind 38400) Agentic Commerce
request_agent_service Request a service from another agent (kind 38401) Agentic Commerce
settle_agent_service Pay for an agent service via L402 Lightning settlement Free*
publish_agent_attestation Leave a review/rating for an agent after service completion (kind 38403) Agentic Commerce
get_agent_reputation Check an agent's reputation score from on-protocol attestations Free

*settle uses wallet balance, subject to budget limits

How Agent Commerce Works

  1. Discoverdiscover_agent_services(category="translation") finds agents offering translation
  2. Requestrequest_agent_service(capability_id, budget_sats=100) sends a service request
  3. Settlesettle_agent_service(l402_endpoint) pays via Lightning and receives the result
  4. Reviewpublish_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

About

MCP server enabling AI agents to make Lightning Network payments

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors