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/mcpAdd to Settings → Connectors → Add custom connector
https://lightningfaucet.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"lightning-wallet-mcp": {
"url": "https://lightningfaucet.com/mcp"
}
}
}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

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government