ClawHub

SatsRail MCP — Bitcoin Lightning Payments for AI Agents

Enable AI agents to create Bitcoin Lightning payment orders, generate invoices, check payment status, and manage payments via natural language with SatsRail...

Audits

Pending
ClawScanReview

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPending

Multi-engine malware detections and file reputation.

Install

openclaw skills install satsrail-mcp

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 CardsLightning (SatsRail)
IntegrationBrowser forms, redirectsOne API call → invoice string
Settlement2-3 business daysInstant (seconds)
Fees2.9% + $0.30Fractions of a cent
MicrotransactionsEconomically irrationalWorks at any amount
CustodyHeld by processorNon-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 invoice
  • get_order — Get order details by ID
  • list_orders — List and filter orders by status
  • cancel_order — Cancel a pending order

Invoices & Payments

  • get_invoice — Get invoice details including bolt11 Lightning payment string
  • generate_invoice — Generate a new invoice for an existing order
  • check_invoice_status — Real-time payment verification
  • list_payments — List confirmed payments
  • get_payment — Get payment details by ID

Checkout & Config

  • create_checkout_session — Create a hosted checkout session
  • get_merchant — Get merchant profile and settings
  • list_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

Resources