Lightning Wallet MCP Server - install & status [2026]

01 · Install Lightning Wallet

before you install - you'll need

Set LIGHTNING_WALLET_API_KEY, PRE_PAYMENT_HOOK_URL, AGENT_ID, AGENT_KEY before connecting.

Claude Code

claude mcp add lightningfaucet-lightning-wallet-mcp -- npx -y lightning-wallet-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "lightningfaucet-lightning-wallet-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lightning-wallet-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package lightning-wallet-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.lightningfaucet is GitHub-verified and matches the repo owner

03 · What Lightning Wallet can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can get service status, version, and supported features, get current context - shows if operating as operator or agent, check current Lightning balance in satoshis, and check current rate limit status and request remaining.

Capability map

Tools grouped from the project's README - what Lightning Wallet lets an agent do.

Agent

8 tools - e.g. Create agent under operator; Transfer sats from operator to agent; Transfer sats between agents or from operator to agent

create_agent · fund_agent · transfer_to_agent · sweep_agent · deactivate_agent · reactivate_agent…

read & search

5 tools - e.g. Get service status, version, and supported features; Check current rate limit status and requests remaining; View transaction history

get_info · get_rate_limits · get_transactions · list_agents · list_webhooks

Invoice

5 tools - e.g. Decode a BOLT11 invoice to see amount, destination, and expiry; Generate invoice to receive payments; Check if an invoice has been paid

decode_invoice · create_invoice · get_invoice_status · get_deposit_invoice · invoice_paid

Pay

3 tools - e.g. Access paid APIs (L402/X402) - auto-detects protocol and pays; Pay any BOLT11 Lightning invoice; Pay to a Lightning address ([email protected] format)

pay_l402_api · pay_invoice · pay_lightning_address

Claim

2 tools - e.g. Claim funds from an LNURL-withdraw link; claim the free-sats install promo (verified email + 3h account)

claim_lnurl_withdraw · claim_promo

Register

2 tools - e.g. Create new operator account; Register a URL to receive event notifications

register_operator · register_webhook

Operator

2 tools - e.g. Switch to operator credentials; set operator email (sends verification link) and/or name

set_operator_key · update_operator

Budget

2 tools - e.g. Get agent's budget limit and spending; Set or update agent's spending limit

get_budget_status · set_budget

Latest releases

v1.2.9 · 2026-03-23

Lightning Wallet MCP v1.2.9 · Lightning wallet for AI agents. MCP server + CLI for Bitcoin Lightning payments. · 37 MCP tools for wallet management, Lightning payments, and L402 API access · L402 + X402 paid API…

v1.2.3 · 2026-02-26

Lightning wallet MCP server for AI agents. Includes L402 payments, X402 USDC fallback, agent management, board interactions, and CLI.

04 · Who maintains Lightning Wallet

Lightning Wallet is maintained by lightningfaucet. We track 2 MCP servers from lightningfaucet - 2 actively maintained, 18 combined GitHub stars, oldest repo from Jan 2026. Full record: all servers from lightningfaucet.

mcp-server Give AI agents a Bitcoin wallet with Lightning Network payments and L402 support. ★ 9

05 · Facts

repository: github.com/lightningfaucet/lightning-wallet-mcp
website: https://lightningfaucet.com/ai-agents/
category: finance - ranked #108 of 283 actively-maintained finance servers as of 2026-08-25.
registry: io.github.lightningfaucet/lightning-wallet-mcp (active, first published 2026-02-05 · 5 versions)
packages: npm:lightning-wallet-mcp

06 · Lightning Wallet FAQ

Is Lightning Wallet still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-02. We re-verify nightly.

What can Lightning Wallet do?

With this server connected, an agent can get service status, version, and supported features, get current context - shows if operating as operator or agent, check current Lightning balance in satoshis, and check current rate limit status and request remaining.

How do I install Lightning Wallet?

Run `npx -y lightning-wallet-mcp`. The README documents 4 environment variables (LIGHTNING_WALLET_API_KEY, PRE_PAYMENT_HOOK_URL, AGENT_ID…) to set first. Set LIGHTNING_WALLET_API_KEY, PRE_PAYMENT_HOOK_URL, AGENT_ID, AGENT_KEY before connecting. You can also paste the ready-made client config above.

Does Lightning Wallet run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Lightning Wallet

Alternatives to Lightning Wallet

Maintained finance servers if Lightning Wallet isn't the fit.

Pairs well with

Servers that cover what Lightning Wallet doesn't - only shown when the pairing reason fits the companion.

More finance MCP servers · Lightningfaucet MCP Server · Drillr - The financial MCP for AI agents · ATEX AI Gateway · Twitr Sh · Longbridge MCP Server

More JavaScript MCP servers · Lindo AI · Miner U · Outlook Assistant · Local Dfw MCP · see all