Skip to content
MCP server

lightningfaucet

MCP server giving AI agents a custodial Bitcoin Lightning wallet for paying and receiving

Runs locally
Install

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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "lightning-faucet-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "lightning-faucet-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers