Stride20k x402 Data Gateway

已退役源代码 — 恢复参考

活跃维护已转移至唯一维护中的私有仓库 Marysbrain/aye-today，位于 packages/mcp/。

请勿从此已退役仓库安装或部署。 以下历史说明仅供恢复和参考，不适用于当前操作。

现有公开部署保持不变。仓库退役不会删除或关闭服务。原始源代码和 Git 历史记录仍会保留；已退役仓库的工作流已停用。

退役通知：2026-09-03。

---

x402-gateway-mcp

面向 Agent 的实时 x402 市场动态。 x402_market_pulse 工具 免费——无需钱包、无需付款、无需注册：一览 x402 生态， 每天刷新约 3 次——按类别列出服务，并显示周环比变化、 新上架服务、核心 x402 软件包的 npm 下载趋势、 协议发布标签，以及各来源的可靠性评级。每项指标 都附有新鲜度标记；来源数据过时会如实说明，不会佯装正常。

在此动态 feed 背后，Aye Scout 提供两种付费的 付款前尽职调查工具：x402 类别覆盖情况，以及资源预检工具， 用于在 Agent 付款前检查可访问性、条款、目录收录情况和观测时效。 工具列表在启动时从已签名的公开清单获取；仅为兼容而保留的路由 会刻意省略（验证）。

在注册任何付费工具之前，系统会根据清单响应的原始字节进行验证。 金库地址和网关签名密钥 ID 均已固定；如果清单未签名或密钥意外轮换， 启动就会停止。

⚠️ 已注资钱包警告： WALLET_PRIVATE_KEY 用于签署真实付款。请使用 专用钱包，且只存入少量余额（几美元的 USDC）。切勿使用 主钱包。密钥从环境变量读取，绝不会记录到日志中，付款标头 也绝不会回显到 Agent 可见的输出中。

5 分钟完成设置（Claude Desktop / Claude Code）

1. 创建一个新钱包，并在 Base 上存入少量 USDC （测试时，也可以使用 https://faucet.circle.com 获取 Base Sepolia 测试 USDC）。
2. 执行 npm install -g x402-gateway-mcp（或使用 npx）。
3. 添加到 MCP 配置中（Claude Desktop 使用 claude_desktop_config.json，或 Claude Code 使用 claude mcp add）：

{
  "mcpServers": {
    "x402-gateway": {
      "command": "npx",
      "args": ["-y", "x402-gateway-mcp"],
      "env": {
        "GATEWAY_URL": "https://<your-gateway-host>",
        "WALLET_PRIVATE_KEY": "0x<small-balance-wallet-key>",
        "MAX_PER_CALL_USD": "0.25",
        "MAX_SESSION_USD": "2.00"
      }
    }
  }
}

4. 重启客户端。免费的 x402_market_pulse 工具会立即可用 （无需钱包）；每个付费工具的说明都会标明价格，例如 [costs $0.01 USDC per call] 在付款前为 x402 资源评分…

支出防护

• MAX_PER_CALL_USD（默认值为 0.25）：超过此金额定价的工具会被拒绝。
• MAX_SESSION_USD（默认值为 2.00）：每个服务会话累计已结算支出的上限；如果调用会超出上限，就会被拒绝，并返回清晰的消息供 Agent 转达。重启服务即可重置。

拒绝会在签署任何付款之前发生。

环境变量参考

变量	默认值	用途
GATEWAY_URL	https://pulse.aye.today	网关基础 URL（本地或测试网环境可覆盖）
WALLET_PRIVATE_KEY	—	付款方密钥（余额请保持较少！）。未设置时，工具仍会列出，但调用会失败并返回清晰的错误信息
MAX_PER_CALL_USD	0.25	单次调用上限
MAX_SESSION_USD	2.00	单个会话上限
EXPECTED_PAY_TO	Aye 金库地址	固定的付款目标；仅可在受控测试部署中覆盖
EXPECTED_SIGNING_KID	Aye 生产密钥 ID	固定的清单签名密钥；仅可随经过审计的网关版本发布进行轮换

如果在付款授权后发生传输错误或读取正文错误，MCP 会将全部标示金额 预留为可能已支出。它不会悄悄恢复该会话的可用额度；重试前请先核对钱包。