lightning-wallet-mcp

finance MCP Server

MCP Server for Lightning Faucet - Give your AI agent a Bitcoin wallet

Install Ready
financefinance
4 views8 stars7 forksv1.4.0MIT

Why This Matters

Discovered via unknown and last synced 3mo ago.

Install Ready
Source
unknown
Stars
8
Last synced
3mo ago
Install
Instructions detected

Install

1. Install the package

npx lightning-wallet-mcp

2. Add to claude_desktop_config.json

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

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

46
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (46)

check_balance

Check current Lightning balance in satoshis

create_invoice

Generate invoice to receive payments

register_operator

Create new operator account

get_rate_limits

Check current rate limit status and requests remaining

get_invoice_status

Check if an invoice has been paid

recover_account

Recover account using recovery code

list_agents

List all agents under operator

keysend

Send payment directly to a node pubkey (no invoice needed)

method

string

create_agent

Create agent under operator

delete_webhook

Delete a webhook

get_info

Get service status, version, and supported features

pay_l402_api

Access paid APIs (L402/X402) - auto-detects protocol and pays

set_agent_credentials

Switch to agent credentials

pay_invoice

Pay any BOLT11 Lightning invoice

whoami

Get current context - shows if operating as operator or agent

rotate_api_key

Generate a new API key (60-min cooldown on withdrawals)

set_budget

Set or update agent's spending limit

message

string

claim_lnurl_withdraw

Claim funds from an LNURL-withdraw link

delete_agent

Permanently delete an agent (returns balance to operator)

test_webhook

Send a test event to verify webhook connectivity

destination

string

fund_agent

Transfer sats from operator to agent

body

string

withdraw

Withdraw funds to external Lightning destination

deactivate_agent

Temporarily disable an agent

get_budget_status

Get agent's budget limit and spending

Parameter

Type

transfer_to_agent

Transfer sats between agents or from operator to agent

reactivate_agent

Re-enable a deactivated agent

amount_sats

number

url

string

decode_invoice

Decode a BOLT11 invoice to see amount, destination, and expiry

lnurl_auth

Authenticate to a service using LNURL-auth protocol

set_operator_key

Switch to operator credentials

Command

Description

pay_lightning_address

Pay to a Lightning address ([email protected] format)

events

array

Tool

Description

get_transactions

View transaction history

get_deposit_invoice

Create invoice to fund operator account

sweep_agent

Sweep funds from agent back to operator

list_webhooks

List all registered webhooks

register_webhook

Register a URL to receive event notifications

max_payment_sats

number