Lightning Wallet MCP

- Instant Lightning Network payments settle in milliseconds.
- L402 and X402 protocol support for paid APIs.
- Operator/agent hierarchy with isolated funds and spending limits.
- Free 100 sats for new operators (first 100 installs).
- Webhook notifications for payments and events.
- Full transaction history export in JSON or CSV.

| Env var | Default | Description |
|---|---|---|
| PRE_PAYMENT_HOOK_URL | _(unset)_ | Policy endpoint to POST each payment proposal to. Unset disables the hook entirely. |
| PRE_PAYMENT_HOOK_TIMEOUT_MS | 3000 | Per-request timeout in milliseconds. |
| PRE_PAYMENT_HOOK_FAIL_MODE | closed | closed denies a payment if the hook errors or times out; open lets it proceed. Default is fail-closed. |

{
  "mcpServers": {
    "lightning-wallet": {
      "command": "npx",
      "args": ["lightning-wallet-mcp"],
      "env": {
        "LIGHTNING_WALLET_API_KEY": "your-api-key",
        "PRE_PAYMENT_HOOK_URL": "https://your-policy-endpoint.example/hook"
      }
    }
  }
}