lightningfaucet
MCP server giving AI agents a custodial Bitcoin Lightning wallet for paying and receiving
lightningfaucet is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
- Pricing
- Freemium
- Platforms
- CLI, API, Linux
- Runs
- Locally
- Version
- 2.0.5
- Listing updated
Similar MCP servers
Install
Run in a terminal
claude mcp add mcp-server -- npx -y lightning-faucet-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"lightning-faucet-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"lightning-faucet-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"lightning-faucet-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"lightning-faucet-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"lightning-faucet-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
About lightningfaucet
Lightning Wallet connects an AI assistant to a custodial Bitcoin wallet over the Model Context Protocol. The agent can pay Lightning invoices and Lightning addresses, pay for L402 and X402 paid APIs, send keysend payments, create invoices to receive sats, and check its balance and history. Because the wallet is custodial, there is no node, channel or liquidity to manage on the user's side.
The server runs locally over stdio through npm, and a remote Streamable HTTP endpoint is also offered for hosted clients. Operators can register an account from the CLI or an MCP host, fund it with a Lightning invoice, and optionally create agent sub-wallets with their own budgets and spend policies. A pre-payment hook can approve or deny outgoing payments before they are sent.
It suits developers building agents that need to buy API access or move small amounts of value, and people who want to script Lightning payments from a shell. Lightning-based prediction markets, dice games and a community board are also exposed as tools.
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- pay_invoice
- Pay any BOLT11 invoice; returns the preimage
- pay_l402_api
- Request a paid API and pay L402 or X402 challenges automatically
- pay_lightning_address
- Pay a user@domain Lightning address
- keysend
- Pay a node pubkey directly, with an optional message
- create_invoice
- Create an invoice to receive sats
- check_balance
- Balance in sats
- get_transactions
- Transaction history
What it does
- Lightning payments
- Pay BOLT11 invoices, Lightning addresses, node pubkeys via keysend, and Nostr zaps.
- Paid API access
- Requests L402 or X402 endpoints, detects the 402 challenge, pays and retries automatically.
- Custodial wallet
- Holds sats on the service side so no Lightning node or channels need to be run.
- Agent budgets
- Create agent sub-wallets with separate balances, spending caps and daily limits.
- Pre-payment policy hook
- Sends each outgoing payment to a configured endpoint for allow or deny approval.
- Webhooks
- Delivers signed notifications for paid invoices, completed and failed payments.
- CLI and MCP
- Runs as an MCP server for AI hosts and as an lw command-line tool with JSON output.
Good for
- Let a coding assistant pay for pay-per-request APIs without manual checkout
- Give an autonomous agent a capped Lightning budget for small recurring payments
- Send and receive sats from a shell script or CI job
- Create Lightning invoices so an agent can charge for its own services
Pricing
Freemium
Free to register and deposit; 1% platform fee on payments, free withdrawals to own wallet
lightningfaucet FAQ
Does the wallet need a Lightning node?
No. The wallet is custodial and runs on the service side, so no node, channels or liquidity are needed.
How much does lightningfaucet cost to use?
Registering and deposits are free. Payments carry a platform fee of 1% with a 1 sat minimum, plus routing fees at cost. Withdrawals to your own wallet have no platform fee.
Which platforms can run lightningfaucet?
It installs from npm and runs as a stdio MCP server in hosts such as Claude Code, Cursor and Windsurf, or via the CLI. A hosted HTTP endpoint is also available.
Is lightningfaucet open source?
The package is published under the MIT licence.
How do I add lightningfaucet to Claude Code?
Run this command in your terminal: claude mcp add mcp-server -- npx -y lightning-faucet-mcp
What are the best alternatives to lightningfaucet?
The closest alternatives to lightningfaucet are SaturnZap, Nwc MCP, Lightning Wallet, BTCPay Server MCP and Lightning Enable MCP Server.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.