🎁 Get the FREE AI Skills Starter Guide — Subscribe →
BytesAgainBytesAgain
BytesAgain › Skills › SatsRail MCP — Bitcoin Lightning Payments for AI Agents
🦀 ClawHub

SatsRail MCP — Bitcoin Lightning Payments for AI Agents

by @rubytuess

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

Versionv1.0.0
Downloads936
#crypto-defi#audio#translation#finance#legal
TERMINAL
clawhub install satsrail-mcp

📖 About This Skill

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 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

  • GitHub
  • npm
  • Developer Docs
  • AI Agents Guide
  • satsrail.com

    • ⚡ When to Use

    TriggerAction
    - **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

    ⚙️ Configuration

    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"