SaturnZap
Run a local non-custodial Lightning (LDK) wallet from the agent or CLI and pay L402-gated APIs with an optional MCP spend cap.
Overview
io.github.lqwdtech/saturnzap is a MCP server for the Build phase that exposes a local non-custodial LDK Lightning wallet so agents can pay L402 APIs from MCP or CLI.
What is this MCP server?
- PyPI package saturnzap v1.3.2 with stdio MCP transport.
- Non-custodial LDK-based Bitcoin Lightning wallet for agents.
- SZ_PASSPHRASE decrypts local seed; wallet stays on your machine.
- Optional SZ_MCP_MAX_SPEND_SATS caps per-request L402 spend from MCP.
- CLI and MCP dual interface for the same wallet.
- Package version 1.3.2 on PyPI identifier saturnzap
- Transport: stdio MCP
- Optional env SZ_MCP_MAX_SPEND_SATS for per-request L402 cap
Community signal: 5 GitHub stars.
What problem does it solve?
Agents that call paid Lightning or L402 APIs need a non-custodial wallet hook, not a hand-waved “use Stripe” placeholder in the skill loop.
Who is it for?
Solo builders shipping agent automations that must settle real Lightning/L402 charges from their own machine.
Skip if: Products that only need traditional card billing, or teams that refuse to manage wallet passphrases and channel liquidity.
What do I get? / Deliverables
After configuring SZ_PASSPHRASE and MCP, your agent can pay Lightning invoices from a local wallet with an optional per-request satoshi spend cap.
- Local LDK Lightning wallet usable from MCP and CLI
- L402-capable payment actions with optional MCP spend ceiling
Recommended MCP Servers
Journey fit
Agent-native wallets sit in Build when you integrate real payment behavior into automations and API clients. Integrations covers stdio MCP bridges that let coding agents invoke financial tools alongside your app code.
How it compares
Local LDK wallet MCP, not a hosted faucet (see LQWD Gateway) or a generic HTTP billing middleware.
Common Questions / FAQ
Who is io.github.lqwdtech/saturnzap for?
Developers building AI agents that need a self-custodied Lightning wallet to access L402 and other pay-per-call APIs.
When should I use io.github.lqwdtech/saturnzap?
Use it when MCP or CLI workflows must sign Lightning payments locally with a spend limit you control.
How do I add io.github.lqwdtech/saturnzap to my agent?
Install the saturnzap PyPI package, configure stdio MCP in your client, set required SZ_PASSPHRASE, and optionally SZ_MCP_MAX_SPEND_SATS.