genesis-agent-mcp

GENESIS Agent 工具

基于 Base USDC (x402 v2) 的按次付费 AI Agent API。无需账户、无需 API 密钥、无需订阅。每个付费端点都会返回包含支付挑战的 HTTP 402 响应；签署支付给规范 Exodus 国库的报价 USDC 金额，然后重试即可获取高级结果。

线上地址： https://genesis-agent-tools.genesisagenttools.workers.dev

直接购买页面： /release-guardian — 免费预览，无需账户，0.001 USDC。

主题： openapi · breaking-changes · api-testing · github-actions · release · mcp · x402

Release Guardian（主打工具）

面向 MCP 工具、常见 OpenAPI 变更、GraphQL、SDK 导出和 JSON Schema 变更的按次付费 x402 跨合约发布前检查。

• 端点： POST /api/flagships/release-guardian
• 输入： { "tier": "quick", "input": { "previous": …, "current": … } }
• 输出： SAFE / RISKY / BREAKING / UNKNOWN / UNSUPPORTED
• 价格： Quick $0.001 · Deep $0.019（USDC）
• 网络： Base (eip155:8453) · USDC · 非托管（EIP-3009）

curl -sS -D - -X POST \
  https://genesis-agent-tools.genesisagenttools.workers.dev/api/flagships/release-guardian \
  -H 'content-type: application/json' \
  -d '{"tier":"quick","input":{"previous":{"paths":{"/users":{},"/users/{id}":{}}},"current":{"paths":{"/users":{}}}}}'
# → HTTP 402 with a base64 PAYMENT-REQUIRED header; sign & retry to get SAFE/RISKY/BREAKING

可运行的 CI 示例（GitHub Actions、shell、JS）：examples/release-guardian/。

GitHub Action

- uses: genesiscode2026/genesis-release-guardian@v1
  with:
    previous-spec: spec/openapi.baseline.json
    current-spec: spec/openapi.json
    mode: quick
    fail-on: breaking
    max-spend-usd: '0.01'
    private-key: ${{ secrets.X402_PRIVATE_KEY }}

此 Action 只读取你提供的两个规范文件，会在签名前根据实时 402 挑战执行支出上限检查，并且绝不会持有你的密钥。线上演示： genesiscode2026/release-guardian-demo。

MCP

npx -y genesis-agent-mcp

同一组五个主打工具支持两种传输方式：

• 本地 / 软件包（stdio）： npx -y genesis-agent-mcp
• 托管的 Streamable HTTP： https://genesis-agent-tools.genesisagenttools.workers.dev/mcp （initialize / tools/list / tools/call；无状态 JSON-RPC；除非请求包含有效的 PAYMENT-SIGNATURE 标头，否则付费工具会返回 x402 挑战）

轻量级的买方 MCP 适配器将 Release Guardian + Workflow Runner（以及其他主打工具）作为工具提供给 Cline / Claude / Cursor。买方密钥通过 X402_PRIVATE_KEY 提供（绝不提交）；内置单次调用上限和会话预算。 配置：mcp/README.md。

其他主打工具

主打工具	功能（买方用途）	端点	Quick	Deep
Workflow Runner	验证或运行有界 HTTP/JSON 工作流，并生成确定性轨迹。	POST /api/flagships/workflow-runner	0.005	0.035
Asset Intelligence	验证加密资产的实时多源价格、数据新鲜度和链上所有者。	POST /api/flagships/asset-intelligence	0.005	0.025
Research & Evidence	从提供的 URL 中提取带引用的主张和矛盾之处。	POST /api/flagships/research-evidence	0.005	0.040
Agent Assurance	审核 Agent 或 MCP 服务的就绪情况、观察到的风险和证据。	POST /api/flagships/agent-assurance	0.005	0.029

所有价格均以 USDC 计。Release Guardian Quick 是 $0.001 的获客入口；其他所有 Quick 均 ≤ $0.005（Agent402 execute）；所有 Deep 均 ≤ $0.040 （execute-plus）。有界工作流示例：examples/workflow-runner/。

可用情况

已上线／已提交的分发平台（机器原生，无需账户或 API 密钥）：

渠道	状态	链接
Agent402	已编入索引（健康度 1.0；结算金额未达下限时会限制派发）	https://agent402.tools
x402scan	已列出	https://www.x402scan.com/server/c6741010-aff0-42ae-85dc-a28523d26cb2
MCP Registry	已上线 v1.0.0	io.github.genesiscode2026/genesis-agent-mcp
true402	已注册（可免费发现）	https://true402.dev/catalog
PayAPI Market	已上线 · x402 已验证（Release Guardian）	https://payapi.market/api/genesis-release-guardian
FiatDock	5 个可调用列表 · 待处理／未验证 · 0 条评分	https://fiatdock.com/browse
PayanAgent	注册端点返回 500（已重试）——待处理	https://payanagent.com

如何付款？（x402 v2）

• 网络：Base（eip155:8453）
• 资产：USDC（0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）
• 收款方：Exodus treasury 0xC6F86e170411182114FcCdb28793dC76B5e8D144（非托管）
• 方案：exact（EIP-3009），备用中介：Dexter（Permit2）

x402 客户端会解码 402 响应、签署 EIP-3009 USDC 授权，并在重试时附上 PAYMENT-SIGNATURE 标头。可在 examples/ 中查看可运行的 curl 和 JavaScript （@x402/fetch）购买示例——只需替换为有资金的买家密钥。

Agent402 的 50 笔结算门槛仅影响 Agent402 的自动派发；直接使用 x402 的买家（这些示例）无需经由 Agent402 路由即可购买。

机器发现

• Agent402 索引：已注册源站 genesis-agent-tools.genesisagenttools.workers.dev （通过 GET https://agent402.tools/api/route?q=<task> 查找）
• OpenAPI：GET /openapi.json · x402 清单：GET /.well-known/x402
• 机器目录：GET /api/flagships · llms.txt：GET /llms.txt · 健康状态：GET /health

另有提供（次要）

• 源代码产品（55 项可售）：API 合约检测器、Agent 安全 SDK、 量化研究套件、金融可视化和隐私工具——以非独占 GENESIS 许可证销售。目录：/catalog.json · /catalog.md。
• 兼容性 API（6 项付费 + 1 项免费）：POST /api/mcp-schema-drift、POST /api/openapi-breaking-change、 POST /api/sdk-compatibility、POST /api/compatibility-suite、POST /api/batch-compatibility-audit、 POST /api/release-readiness、免费 POST /api/preflight。
• NFT 访问等级：GENESIS AGENTS — ORIGIN（ERC-721）+ GENESIS PASSES（ERC-1155）。GET /nft。

安全

本仓库不含私钥或种子材料。GENESIS 从不持有买家资金，也从不索要私钥。请通过 GitHub Issues 报告问题。参见 SECURITY.md。

隐私

GitHub Action 和 MCP 适配器只会传输你明确提供的 API／架构文件。不会读取或上传你仓库中的其他内容；不会在服务器端克隆仓库，不会持久化 IP／地理位置数据，也不会使用分析跟踪器。 付款钱包地址必然公开在链上。

支持

产品支持请使用 GitHub Issues，漏洞请通过私密的 GitHub Security Advisories 报告。无需提供个人联系方式。

许可证

仅用于发现和文档。专有源代码另行以非独占 GENESIS 许可证销售。