io.github.lightningfaucet/lightning-wallet-mcp

up checked 2026-11-10T22:37:29.407Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

Lightning Wallet

Publisher-provided description

Give AI agents a Bitcoin wallet with Lightning Network payments and L402 support.

Summary by lookupd

Lets agents hold a Lightning wallet, check balances, create and pay invoices, pay L402 APIs, manage agent budgets and webhooks.

Install

Claude Code, remote (streamable-http)

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

Claude Code, npm package (stdio)

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

Codex, remote (streamable-http)

codex mcp add lightning-wallet --url https://lightningfaucet.com/mcp

Codex, npm package (stdio)

codex mcp add lightning-wallet -- npx -y lightning-wallet-mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Cursor, npm package (stdio) → .cursor/mcp.json

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

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (showing 30 of 86)

Publisher-provided text

• check_balance Check your current Lightning balance in satoshis. Works with both operator and agent keys.
• pay_l402_api Make a request to a paid API. Supports L402 (Lightning) and X402 (USDC on Base) protocols. Platform fee on the API price: 1%, rounded down, minimum 1 sat, repor
• pay_invoice Pay a BOLT11 Lightning invoice. Platform fee: 1% of the amount, rounded down, minimum 1 sat, reported as platform_fee_sats; get_info returns the current schedul
• create_invoice Create a Lightning invoice to receive payment. Use get_invoice_status to check if paid.
• get_invoice_status Check if a created invoice has been paid. Use the payment_hash from create_invoice.
• get_transactions Get the agent transaction history. Returns both incoming and outgoing payments.
• update_operator Update operator profile: set your email (sends a verification link) and/or display name. REQUIRES OPERATOR KEY.
• claim_promo The 100-sat launch install promo has ended. This tool is kept for backward compatibility and reports the promo status; it no longer funds new wallets. REQUIRES
• get_deposit_invoice Create a Lightning invoice to fund your operator account. Pay this invoice to add sats to your balance.
• create_agent Create a new agent under your operator account. Returns the agent API key.
• fund_agent Transfer sats from operator balance to an agent. No platform fee.
• list_agents List all agents under your operator account.
• whoami Get current context - returns whether you are operating as an operator or agent, along with ID, name, and balance.
• register_webhook Register a webhook URL to receive payment and board notifications (use board.* events or "*" to get pinged about replies, votes, mentions, tips and bounties). M
• list_webhooks List all registered webhooks for the current agent. REQUIRES AGENT KEY.
• delete_webhook Delete a registered webhook. REQUIRES AGENT KEY.
• test_webhook Send a test event to a webhook to verify it works. REQUIRES AGENT KEY.
• get_budget_status Get budget status for an agent - shows limit, spent, remaining and the platform_fees schedule that counts against it. Works with operator or agent keys.
• set_budget Set or update budget limit for an agent. REQUIRES OPERATOR KEY.
• deactivate_agent Deactivate an agent - it cannot make payments until reactivated. REQUIRES OPERATOR KEY.
• reactivate_agent Reactivate a previously deactivated agent. REQUIRES OPERATOR KEY.
• rotate_api_key Generate a new API key, invalidating the old one. For operators: triggers 60-min withdrawal cooldown. For agents: 30-min cooldown.
• get_info Get service information including version, status, limits, supported features and the current platform_fees schedule (percent and minimum per action). No API ke
• decode_invoice Decode a BOLT11 invoice without paying it. Returns amount, description, expiry, and destination. No API key required — works before registering.
• get_rate_limits Get current rate limit status - requests remaining and reset time.
• withdraw Withdraw funds from the operator account to an external Lightning invoice (minimum 10 sats; no platform fee, only the Lightning routing fee at cost; unused rout
• create_withdraw_link Create an LNURL-withdraw link for the operator to receive funds. Opens in browser for QR code scanning with any Lightning wallet. Omit amount_sats to sweep full
• sweep_agent Sweep funds from agent back to operator balance. REQUIRES OPERATOR KEY.
• pay_lightning_address Pay to a Lightning address (user@domain.com format). Platform fee: 1% of the amount, rounded down, minimum 1 sat, reported as platform_fee_sats. Works with an o
• set_nostr_identity Set a Nostr identity for the agent. Stores the private key and derives the public key. REQUIRES AGENT KEY.

Details

• Version: 1.14.0
• Transports: streamable-http, stdio
• Uptime (7 days): 100%
• Median latency: 755 ms
• First indexed: 2026-11-01T09:38:30.017Z
• Last seen in registry: 2026-11-06T01:17:14.853Z
• Repository: https://github.com/lightningfaucet/lightning-wallet-mcp
• Website: https://lightningfaucet.com/ai-agents/

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.lightningfaucet/lightning-wallet-mcp.svg)](https://lookupd.com/servers/io.github.lightningfaucet/lightning-wallet-mcp)

• 62092 servers
• Last crawl: 2026-11-11T17:17:22.074Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp