Satsrail MCP

⚡ satsrail-mcp

Bitcoin Lightning payments for AI agents via Model Context Protocol

______________________________________________________________________

赋予任何兼容MCP的AI代理接受比特币闪电支付的能力。通过自然语言创建订单、生成发票、检查付款状态。没有浏览器，没有表单，没有重定向。

适用于： 克劳德桌面·光标·Windsurf·Cline·任何MCP客户端

为什么Lightning适用于AI代理？

快速开始

1.获取API密钥

注册地址： satsrail.com 并获取你的密钥(sk_live_... 或 sk_test_...)从仪表板。

2.配置您的AI工具

Claude Desktop

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "satsrail": {
      "command": "npx",
      "args": ["-y", "satsrail-mcp"],
      "env": {
        "SATSRAIL_API_KEY": "sk_test_your_key_here"
      }
    }
  }
}

Cursor / Windsurf

增添 .cursor/mcp.json （或 .windsurf/mcp.json)在您的项目中：

{
  "mcpServers": {
    "satsrail": {
      "command": "npx",
      "args": ["-y", "satsrail-mcp"],
      "env": {
        "SATSRAIL_API_KEY": "sk_test_your_key_here"
      }
    }
  }
}

Any MCP client (npx)

SATSRAIL_API_KEY=sk_test_... npx satsrail-mcp

3.使用它

问你的AI代理：

“为每月订阅创建25美元的订单并生成Lightning发票”

代理人打电话来 create_order，返回bolt11 Lightning发票，客户使用任何Lightning钱包付款。几秒钟内结算。

可用工具

订单

发票和付款

检查和配置

示例：完成付款流程

User: "Charge me $50 for the pro plan"

Agent → create_order(amount_cents: 5000, description: "Pro Plan", generate_invoice: true)
     ← order_id: "ord_abc123", bolt11: "lnbc500u1pj...kqq5yxmetu"

Agent: "Here's your Lightning invoice — scan the QR or copy the payment string."

User: "Paid!"

Agent → check_invoice_status(invoice_id: "inv_xyz789")
     ← { status: "paid", settled_at: "2026-02-19T..." }

Agent: "Payment confirmed! Your Pro plan is active. ⚡"

用例

• SaaS计费 -销售API访问、订阅或每次任务服务并在对话中收取付款的代理
• 代理对代理商务 --自主代理通过即时结算相互支付服务（翻译、计算、数据）费用
• 发票自动化 --根据里程碑、使用情况或时间表以编程方式生成和发送Lightning发票
• 多商户平台 --构建由代理驱动的市场，让人工智能处理供应商之间的结账
• 小额付费 --按查询付费、按代付费、按任何东西付费——信用卡支付的金额太小

环境变量

测试模式

使用 sk_test_* 在完全隔离的沙箱中创建测试订单和发票的密钥。不处理实际付款，不将测试数据与生产混合。

无监护权的

SatsRail永远不会持有您的资金。连接您自己的Lightning节点——付款直接结算到您的钱包。 了解更多关于我们的非托管架构→

SDK

需要直接访问API而不是MCP？使用我们的SDK：

• **** — npm install satsrail
• python — pip install satsrail
• 红宝石 — gem install satsrail

资源

• 开发人员文档 --快速入门、测试、webhooks、嵌入
• AI代理指南 --代理支付流程和架构
• API 参考 -完整的REST API文档
• 博客 --闪电支付、代理经济、比特币采用

贡献

欢迎发布问题和PR。看 贡献.md 作为指导方针。

许可证

麻省理工学院——见 许可证 了解详情。

______________________________________________________________________

The payment rail for the agent economy.

satsrail.com · @satsrail