# Lightning Wallet

> Lightning Wallet is a free MCP server for finance and payments. Bitcoin Lightning wallet for agents: pay L402 and X402 APIs, invoices and addresses. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI, macOS, Linux
- **Website:** https://lightningfaucet.com/ai-agents/
- **Repository:** https://github.com/lightningfaucet/lightning-wallet-mcp
- **MCP Registry name:** io.github.lightningfaucet/lightning-wallet-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http lightning-wallet-mcp https://lightningfaucet.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://lightningfaucet.com/mcp
```

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

```json
{
  "mcpServers": {
    "lightning-wallet-mcp": {
      "url": "https://lightningfaucet.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "lightning-wallet-mcp": {
      "type": "http",
      "url": "https://lightningfaucet.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "lightning-wallet-mcp": {
      "serverUrl": "https://lightningfaucet.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "lightning-wallet-mcp": {
      "type": "http",
      "url": "https://lightningfaucet.com/mcp"
    }
  }
}
```

## Tools

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

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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/lightning-wallet
