Lightning Wallet
Let coding agents hold a Bitcoin Lightning wallet and pay or charge via L402-aware APIs without you wiring custom payment code.
Overview
Lightning Wallet MCP is a Build-phase MCP server that gives AI agents a Bitcoin Lightning wallet with L402 payment support.
What is this MCP server?
- stdio MCP server (npm 1.2.4) runnable via npx lightning-wallet-mcp
- Bitcoin on-chain plus Lightning Network send and receive from agent tool calls
- L402 support for pay-per-request access to micropayment-gated APIs
- Targets AI agents on lightningfaucet.com/ai-agents documentation hub
- GitHub: lightningfaucet/lightning-wallet-mcp
- Server version 1.2.4 in MCP schema 2025-12-11
- Single npm package with stdio transport and registryType npm
- Repository: github.com/lightningfaucet/lightning-wallet-mcp
Community signal: 8 GitHub stars.
What problem does it solve?
Agents cannot safely move real Bitcoin or satisfy L402 paywalls when every amount and invoice is guessed in plain text.
Who is it for?
Builders wiring autonomous agents to Lightning micropayments, L402 APIs, or sats-based agent marketplaces.
Skip if: Teams that need fiat-only Stripe billing, no cryptocurrency exposure, or production treasury controls without running Lightning infrastructure.
What do I get? / Deliverables
After install, your agent can call wallet tools over MCP to handle Lightning flows and L402-gated requests with a defined npm stdio server.
- Registered stdio MCP server exposing Lightning wallet operations to your agent
- Agent-callable path to Lightning payments and L402-gated HTTP access
- Versioned npm package hook (identifier lightning-wallet-mcp) in your agent config
Recommended MCP Servers
Journey fit
Payment rails land in the Build phase when you connect agents to real money movement and gated HTTP APIs. Integrations is the shelf for MCP servers that expose wallets and protocol bridges to Claude Code, Cursor, and similar hosts.
How it compares
MCP payment wallet integration, not a Shopify-style checkout skill or generic REST wrapper you paste into prompts.
Common Questions / FAQ
Who is Lightning Wallet MCP for?
Solo builders and small teams who run Claude Code, Cursor, or similar agents and want Lightning plus L402 in the tool layer rather than custom scripts.
When should I use Lightning Wallet MCP?
Use it during Build when you integrate pay-per-call APIs, agent tipping, or Lightning settlements into an MCP-enabled coding workflow.
How do I add Lightning Wallet MCP to my agent?
Add the stdio MCP entry with npx and package identifier lightning-wallet-mcp (npm 1.2.4), fund or connect your Lightning setup per Lightning Faucet docs, then restart the host.