modbender satsrail-mcp
Give any MCP-compatible AI agent the ability to accept Bitcoin Lightning payments. Create orders, generate invoices, and check payment status — all through natural language. No browser, no forms, no redirects.
Works with: Claude Desktop · Cursor · Windsurf · Cline · any MCP client
What This Skill Does
This skill configures OpenClaw to use the SatsRail MCP server, enabling your agent to:
- Create Lightning payment orders
- Generate bolt11 invoices
- Check payment status in real-time
- List payments and orders
- Create hosted checkout sessions
Why Lightning for AI Agents?
| Credit Cards | Lightning (SatsRail) | |
|---|---|---|
| Integration | Browser forms, redirects | One API call → invoice string |
| Settlement | 2-3 business days | Instant (seconds) |
| Fees | 2.9% + $0.30 | Fractions of a cent |
| Microtransactions | Economically irrational | Works at any amount |
| Custody | Held by processor | Non-custodial — your sats |
Setup
1. Get your API key
Sign up at satsrail.com and grab your secret key (sk_live_... or sk_test_...).
2. Configure MCP server
Add to your OpenClaw MCP config or Claude Desktop config:
{
"mcpServers": {
"satsrail": {
"command": "npx",
"args": ["-y", "satsrail-mcp"],
"env": {
"SATSRAIL_API_KEY": "sk_test_your_key_here"
}
}
}
}
3. Use it
Ask your agent:
"Create a $25 order for a monthly subscription and generate a Lightning invoice"
Available Tools
Orders
create_order— Create a payment order with optional auto-generated Lightning invoiceget_order— Get order details by IDlist_orders— List and filter orders by statuscancel_order— Cancel a pending order
Invoices & Payments
get_invoice— Get invoice details including bolt11 Lightning payment stringgenerate_invoice— Generate a new invoice for an existing ordercheck_invoice_status— Real-time payment verificationlist_payments— List confirmed paymentsget_payment— Get payment details by ID
Checkout & Config
create_checkout_session— Create a hosted checkout sessionget_merchant— Get merchant profile and settingslist_wallets— List connected Lightning wallets
Example Flow
User: "Charge me $50 for the pro plan"
Agent → create_order(amount_cents: 5000, description: "Pro Plan", generate_invoice: true)
← bolt11: "lnbc500u1pj...kqq5yxmetu"
Agent: "Here's your Lightning invoice — scan or copy the payment string."
User: "Paid!"
Agent → check_invoice_status(invoice_id: "inv_xyz789")
← { status: "paid" }
Agent: "Payment confirmed! ⚡"
Use Cases
- SaaS billing — Sell API access, subscriptions, or per-task services in the conversation
- Agent-to-agent commerce — Autonomous agents paying each other with instant settlement
- Micropayments — Pay-per-query, pay-per-generation — amounts too small for credit cards
- Invoice automation — Generate and send Lightning invoices based on usage or milestones