RAEN x402 Gateway

raen-mcp

RAEN 付费 x402 服务的模型上下文协议服务。 每项服务对应一个 MCP 工具；每次调用都会通过 x402 协议在 Base 主网上结算一笔 USDC 微支付。

在线网关（可流式 HTTP）：https://raen-mcp-gateway.fly.dev/mcp 身份验证：Authorization: Bearer <MCP_GATEWAY_KEY>（需要网关密钥——工具调用会花费真实 USDC）。

工具

工具	服务	价格（USDC，Base）	输入
raen_law_lookup	royal-ruby	$0.05	{topic} — FCRA/FDCPA/TILA/州 UDAP 引用
raen_ticker_analysis	tradingagents	$0.05	{ticker, date?} — 合成市场共识演示（非财务建议）
raen_dispute_letter	dispute-forge	$0.75	{creditor, reason} — FCRA 争议信 + SVG 证书
raen_image_generate	nanobanana	$0.01	{prompt, aspectRatio?} — AI 图像，base64 PNG
raen_contract_analysis	contract-eye	$0.05	{text, focus?} — 合同风险评分 + 标记的条款

运行

Stdio（本地 MCP 客户端 / Smithery）

{
  "mcpServers": {
    "raen-mcp": {
      "command": "node",
      "args": ["src/index.js"],
      "env": { "RAEN_PAYER_KEY": "0x...private key of a Base-mainnet USDC wallet..." }
    }
  }
}

可流式 HTTP（远程）

RAEN_PAYER_KEY=0x... MCP_GATEWAY_KEY=<random-secret> node src/http.js   # :8080/mcp

从任意 MCP 客户端连接：向 https://raen-mcp-gateway.fly.dev/mcp 发送 POST，并附上 Authorization: Bearer <key>。

部署到 Fly.io

flyctl apps create raen-mcp-gateway
flyctl secrets set -a raen-mcp-gateway RAEN_PAYER_KEY=- MCP_GATEWAY_KEY=<secret>
flyctl deploy --remote-only

付款方式

工具处理程序通过 @x402/fetch + @x402/evm（v2）调用 wrapFetchWithPayment(fetch, x402Client)。首次请求 → HTTP 402，并返回 PAYMENT-REQUIRED 挑战标头 → 客户端签署 EIP-3009 transferWithAuthorization → 通过协调器结算 → 最终返回包含产品载荷的 HTTP 200。付款方密钥仅来自 RAEN_PAYER_KEY（环境变量），绝不会记录或提交。

端点（在线清单）

仓库系列

• 面向 Agent 的模板：raen-agent-kit — LangChain/LangGraph + CrewAI，几分钟内即可接入此网关。
• 每个端点的集成示例：x402-cookbook — 可直接复制粘贴的 curl/Python 示例，涵盖 402 挑战流程、首次免费调用后收费并返款，以及网关配置。

每个端点的路径和架构均已根据服务的 /.well-known/x402.json 验证：

• https://royal-ruby-x402.fly.dev/.well-known/x402.json
• https://tradingagents-x402.fly.dev/.well-known/x402.json
• https://dispute-forge-x402.fly.dev/.well-known/x402.json
• https://nanobanana-x402.fly.dev/.well-known/x402.json
• https://contract-eye-x402.fly.dev/.well-known/x402.json

测试证据（2026 年 11 月 9 日）

• npm run test:paid → HTTP 200；针对 $0.05 法律查询返回真实引用（15 U.S.C. § 1681i、15 U.S.C. § 1692g）。
• 通过可流式 HTTP 使用 MCP 客户端（SDK）→ tools/list 返回全部 5 个工具；tools/call raen_law_lookup → 经由已部署网关返回 HTTP 200 和引用。

仅供参考——不构成法律或财务建议。