# Lightning Wallet

Hands an AI agent a Bitcoin wallet over Lightning Network: pays invoices and Lightning addresses, settles L402 and X402 APIs. Useful when your agent has to pay for access.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Author: lightningfaucet
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/lightningfaucet/lightning-wallet-mcp
- Updated: 2026-10-17
- HTML: https://affpapa.org/en/nevibecode/mcp/lightning-wallet

## What it does

Lightning Wallet ships as an MCP server and a CLI called `lw`. The agent asks in plain language and the tools do the rest: settle a BOLT11 invoice, send sats to `user@domain`, issue an invoice to receive funds, check the balance and the transaction log. Custody sits with the service, so there is no node to run, no channels to open and no liquidity to babysit.

For Claude the install is one line: `claude mcp add lightning-wallet -- npx -y lightning-wallet-mcp`. Ask the agent to register a wallet and `register_operator` writes credentials to `~/.lightning-wallet/credentials.json` with mode 0600; later sessions pick the file up on their own. Already holding a key? Set `LIGHTNING_WALLET_API_KEY` — it takes precedence over the saved file. A remote option exists too, `https://lightningfaucet.com/mcp` over Streamable HTTP, but without a key you only get the public read-only tools, and `register_operator`, `recover_account` plus the local credential tools stay stdio-only.

The platform fee is 1% rounded down with no minimum, and payments below 100 sats cost nothing. Withdrawals start at 10 sats. A payment still in flight comes back as `pending: true` rather than an error, which stops the model from paying twice. Requests time out after 45s. Give the agent its own `agent_...` key with a budget and spend policy — otherwise a single bad call can drain the operator balance.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add lightning-wallet-mcp -- npx -y lightning-wallet-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add lightning-wallet -- npx -y lightning-wallet-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "lightning-wallet": {
            "command": "npx",
            "args": [
                "-y",
                "lightning-wallet-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "lightning-wallet": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "lightning-wallet-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add lightning-wallet npx -y lightning-wallet-mcp
```

## When to use it
- pay a paid API that answers with HTTP 402
- issue an invoice and wait for sats to arrive
- send a payment to a Lightning address like `user@domain`
- check the balance and recent transactions
- give an agent its own budget and spend limits

## Example prompts
- Register a Lightning wallet for me with the email you@example.com
- Pay this invoice `lnbc...` and show me the preimage
- What's my balance and what were the last few transactions?

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md