Give AI agents a Bitcoin wallet with Lightning Network payments and L402 support.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"lightning-wallet": {
"args": [
"lightning-wallet-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Give your AI agent a Bitcoin wallet. MCP server + CLI. Works with Claude Code, OpenClaw, Cursor, and any agent framework.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'lightning-wallet-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked lightning-wallet-mcp against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in finance
Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators
A Model Context Protocol (MCP) server that provides AI assistants with direct access to the Spreedly payments API. Enables LLMs to manage gateways, process transactions, tokenize payment methods, and more, through structured, validated tool calls.
MCP server for InsightSentry financial data API - market data, options, screeners, and more
AI agents get on-chain identity, credentials, reputation, escrow, and persistent memory on XRPL.
MCP Security Weekly
Get CVE alerts and security updates for io.github.lightningfaucet/mcp-server and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
Give your AI agent a Bitcoin wallet. MCP server + CLI. Works with Claude Code, OpenClaw, Cursor, and any agent framework.
Note: This package was previously published as
lightning-faucet-mcp. The functionality is identical.
First 100 installs get 100 free sats — one per person!
npm i -g lightning-wallet-mcplw register --name "YourAgent"lw deposit 100We verify the invoice cryptographically and pay automatically. No trust required — the destination pubkey in the invoice proves it came from lw.
v1.3.0 - L402 protocol v0 support per the latest Lightning Labs spec.
version="0", token=, backward compatible with macaroon=.well-known/l402.json on lightningfaucet.com and certvera.comv1.1.0 - X402 protocol support (USDC on Base) as automatic fallback alongside L402 (Lightning).
pay_l402_api seamlessly handles both L402 and X402For CLI-first agents (OpenClaw, Pi, KiloCode, or any agent with Bash access):
npm install -g lightning-wallet-mcp
This installs the lw command:
# Register and save your API key
export LIGHTNING_WALLET_API_KEY=$(lw register --name "My Bot" | jq -r '.api_key')
# Check balance
lw balance | jq '.balance_sats'
# Pay an L402 API
lw pay-api "https://lightningfaucet.com/api/l402/fortune"
# Create and fund an agent
lw create-agent "Research Bot" --budget 5000
lw fund-agent 1 1000
# Check identity
lw whoami
Output is JSON by default (pipe to jq). Use --human for readable output.
Run lw help for all commands.
For MCP-native clients, configure as an MCP server:
Option A: Self-Registration
{
"mcpServers": {
"lightning-wallet": {
"command": "npx",
"args": ["lightning-wallet-mcp"]
}
}
}
Then ask Claude: "Register a new Lightning Wallet operator account"
Option B: Pre-configured API Key