# lightningfaucet

> lightningfaucet is a freemium MCP server for finance and payments. MCP server giving AI agents a custodial Bitcoin Lightning wallet for paying and receiving. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API, Linux, macOS, Windows, Web
- **Repository:** https://github.com/lightningfaucet/mcp-server
- **MCP Registry name:** io.github.lightningfaucet/mcp-server
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-21

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server -- npx -y lightning-faucet-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "lightning-faucet-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "lightning-faucet-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "lightning-faucet-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "lightning-faucet-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "lightning-faucet-mcp"
      ]
    }
  }
}
```

## Tools

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

## 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.

## Alternatives

- [SaturnZap](https://ai-powered.com/mcp/saturnzap): SaturnZap is an open-source MCP server for finance and payments.
- [Nwc MCP](https://ai-powered.com/mcp/nwc-mcp): Nwc MCP is an open-source MCP server for finance and payments.
- [Lightning Wallet](https://ai-powered.com/mcp/lightning-wallet): Lightning Wallet is a free MCP server for finance and payments.
- [BTCPay Server MCP](https://ai-powered.com/mcp/btcpay-server-mcp): BTCPay Server MCP is an open-source MCP server for finance and payments.
- [Lightning Enable MCP Server](https://ai-powered.com/mcp/lightning-enable-mcp-server): Lightning Enable MCP Server is a freemium MCP server for finance and payments.
- [Agentpay](https://ai-powered.com/mcp/agentpay-9): Agentpay is an open-source MCP server for finance and payments.
- [SatoshiAPI — Bitcoin Intelligence via Lightning](https://ai-powered.com/mcp/satoshiapi-bitcoin-intelligence-via-lightning): SatoshiAPI — Bitcoin Intelligence via Lightning is a freemium MCP server for finance and payments.
- [L402 Kit](https://ai-powered.com/mcp/l402-kit): L402 Kit is an open-source MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/lightningfaucet
