Skip to content
MCP server

Lightning Wallet

Bitcoin Lightning wallet for agents: pay L402 and X402 APIs, invoices and addresses

Pricing
Free
Platforms
API, CLI, macOS
Runs
Locally or Remotely
Version
1.15.0
Listing updated
3 days ago

About Lightning Wallet

Lightning Wallet is a free MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.

Lightning Wallet is custodial, so there is no node, channel or liquidity to manage. An agent registers itself with a register_operator call, and credentials are saved to a local file and reused. Registering is free, and the first payment needs a deposit of at least 100 sats paid from any Lightning wallet. The site lists a 1% fee with a one-sat minimum.

The suite includes 91 tools covering balances, invoices, L402 (Lightning) and X402 (USDC on Base) API payments with the protocol detected automatically, and operator tools. A matching lw command-line tool prints JSON for scripts. Prediction-market bets and the Arena need a separate agent key with its own budget.

The hosted endpoint at lightningfaucet.com/mcp gives only public read-only tools unless you send your own key as a bearer token. Paying and betting need the local package or a keyed connection, and key-management tools are stdio only.

Install

Run in a terminal

claude mcp add --transport http lightning-wallet-mcp https://lightningfaucet.com/mcp

Add to Settings → Connectors → Add custom connector

https://lightningfaucet.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "lightning-wallet-mcp": {
      "url": "https://lightningfaucet.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "lightning-wallet-mcp": {
      "type": "http",
      "url": "https://lightningfaucet.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "lightning-wallet-mcp": {
      "serverUrl": "https://lightningfaucet.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "lightning-wallet-mcp": {
      "type": "http",
      "url": "https://lightningfaucet.com/mcp"
    }
  }
}

Tools this server provides (14)

Taken from the project documentation; the running server may differ.

register_operator
Register an operator and save credentials.
get_deposit_invoice
Create an invoice to fund the wallet.
create_agent
Create an agent key.
fund_agent
Fund an agent key.
set_agent_credentials
Save agent credentials.
pay_invoice
Pay a Lightning invoice.
pay_l402_api
Pay an L402 API.
get_info
Public information tool.
decode_invoice
Decode a Lightning invoice.
list_l402_apis
List L402 APIs.
verify_fair
Verify fairness of a result.
prediction_markets
Browse prediction markets.
arena_list
List Arena entries.
arena_leaderboard
Arena leaderboard.

What it does

Pay L402 and X402 APIs
Detects the protocol and pays Lightning or USDC-on-Base APIs automatically.
Invoices and addresses
Pays any Lightning invoice or Lightning address and receives payments.
Agent keys with budgets
Create and fund agent keys with a spend policy.
CLI
The lw command prints JSON for bash agents and scripts.
Read-only hosted tools
Decode invoices, list L402 APIs and browse markets without a key.
Self-registration
An agent can register and activate its own wallet.

Good for

  • Let an agent pay for a metered API with sats
  • Pay a Lightning invoice from a script
  • Give an agent a capped budget to spend
  • Look up L402-enabled APIs

Pricing

Free

Free to register; 1% fee per payment, minimum 1 sat

Prices change. Check lightningfaucet.com before you buy.

Lightning Wallet FAQ

Is it custodial?

Yes, so there is nothing to run: no node, channels or liquidity.

What does it cost?

Registering is free; the site lists a 1% fee with a minimum of 1 sat, and a first deposit of at least 100 sats.

What can the hosted server do without a key?

Only the public read-only tools such as get_info, decode_invoice and list_l402_apis.

How do I add it to Claude Code?

Run claude mcp add lightning-wallet -- npx -y lightning-wallet-mcp.

Is Lightning Wallet free?

Yes. Lightning Wallet is free to use.

How do I add Lightning Wallet to Claude Code?

Run this command in your terminal: claude mcp add --transport http lightning-wallet-mcp https://lightningfaucet.com/mcp

What are the best alternatives to Lightning Wallet?

The closest alternatives to Lightning Wallet are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to Lightning Wallet

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government