402-mcp

Nostr: npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2

👁 MIT licence
👁 TypeScript
👁 Node
👁 Coverage
👁 Nostr
👁 GitHub Sponsors

L402 + x402 客户端 MCP，赋予 AI 智能体经济代理能力。发现、支付并使用任何受支付限制的 API —— 无需人工注册，无需 API 密钥，无需中间商。

• 发现 Nostr 上的付费 API —— 无需预先提供 URL

• 自动支付 支持闪电网络 (NWC)、Cashu 电子现金或人工二维码回退

• 凭据缓存并加密 存储于本地 (AES-256-GCM)

• 兼容任何 L402 服务器 —— toll-booth、Aperture 或任何未来的实现

快速开始

1. 安装

npx 402-mcp

2. 连接到 Claude Code

claude mcp add 402-mcp -- npx 402-mcp

3. 尝试使用

询问 Claude：“使用 l402-search 搜索付费笑话 API” —— 无需钱包，只需发现。

准备好进行付费调用了吗？请参阅完整快速入门指南以设置钱包，并观察您的智能体支付其首次 API 调用。

Related MCP server: ag402-mcp

工作原理

graph LR
 A["1. l402-config()"] --> B["2. l402-discover(url)"]
 B --> C["3. Agent reasons<br/>about pricing"]
 C --> D["4. l402-buy-credits()<br/>or l402-fetch()"]
 D --> E["5. l402-fetch(url)<br/>with credentials"]
 E --> F["6. Data returned<br/>+ balance cached"]

示例会话：

Agent: "I need routing data from routing.trotters.cc"

1. l402-config()
 -> nwcConfigured: true, maxAutoPaySats: 1000

2. l402-discover("https://routing.trotters.cc/api/route")
 -> 10 sats/request, toll-booth detected, tiers available

3. Agent reasons: "I need ~20 requests. The 500-sat tier
 gives 555 credits. Better value."

4. l402-buy-credits(url, amountSats=500)
 -> Paid 500 sats, received 555 credits

5. l402-fetch("https://routing.trotters.cc/api/route?from=...&to=...")
 -> 200 OK, route data, 545 credits remaining

有关详细的架构和支付流程图，请参阅 docs/architecture.md。

配置

传输选择与回退

当 kind 31402 事件广播多个 URL（每个传输一个）时，402-mcp 会根据您的配置选择最佳 URL：

1. 优先选择 —— 如果 TRANSPORT_PREFERENCE=tor 且存在 .onion URL，则优先尝试。

2. 可用性回退 —— 如果首选传输不可达（未配置代理、超时），客户端将回退到列表中的下一个 URL。

3. 明网默认 —— 如果未设置偏好，则在 .onion 或 HNS 条目之前尝试明网 URL。

服务可以为同一服务（相同定价、相同 macaroon 密钥）在不同传输上发布多个端点。这纯粹是为了抗审查；切换传输时无需重新认证。要访问 Tor 或 HNS 端点，您必须配置上述相应的代理/网关环境变量。

工具

核心 L402 (任何服务器)

toll-booth 扩展

支付方式

三种支付轨道，按优先级尝试：

1. NWC (Nostr Wallet Connect) —— 完全自主；从您连接的钱包支付

2. Cashu —— 完全自主；熔化电子现金令牌以支付发票

3. 人工介入 —— 展示二维码，轮询结算状态

智能体可以按调用覆盖支付方式，或者您可以仅配置您想要的方式。

l402-fetch 透明地处理四种 HTTP 402 挑战变体：

安全性

MAX_AUTO_PAY_SATS 限制了任何单笔自主支付。超过此限额，智能体必须请求人工批准。智能体可以通过 l402-config 读取此限额并将其纳入购买决策。

隐私

402-mcp 仅在您的机器上本地存储凭据（~/.402-mcp/credentials.json，静态加密）。不会向任何第三方发送数据。无账户、无追踪、无分析。支付使用闪电网络或 Cashu —— 设计上即为假名。

生态系统

在 402.pub 浏览实时 L402 服务 —— 这是受支付限制 API 的去中心化市场。

402-mcp 是 Lightning Labs 的 lightning-agent-tools 和 Coinbase 的 x402 的与支付轨道无关的替代方案 —— 无需闪电网络节点，支持多个钱包，凭据加密。

如果您希望智能体运行自己的闪电网络节点，请使用 Lightning Labs 的工具。如果您希望智能体无需基础设施即可从任何钱包支付，请使用 402-mcp。

有关开发设置和指南，请参阅 CONTRIBUTING.md。

由 @forgesworn 构建。

• 闪电网络打赏：thedonkey@strike.me

• Nostr: npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2

ForgeSworn 工具包的一部分

ForgeSworn 为 Nostr 构建开源的加密身份、支付和协调工具。

许可证

MIT

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers