io.github.genesiscode2026/genesis-agent-mcp

GENESIS Agent Tools

Pay-per-call AI-agent APIs on Base USDC (x402 v2). No account, no API key, no subscription. Every paid endpoint returns HTTP 402 with the payment challenge; sign the quoted USDC amount to the canonical Exodus treasury and retry to receive the premium result.

Live origin: https://genesis-agent-tools.genesisagenttools.workers.dev

Direct buyer page: /release-guardian — free preview, no account, 0.001 USDC.

Topics: openapi · breaking-changes · api-testing · github-actions · release · mcp · x402

Release Guardian (primary)

Pay-per-call x402 cross-contract preflight for MCP tools, common OpenAPI breakages, GraphQL, SDK exports and JSON Schema changes before release.

• Endpoint: POST /api/flagships/release-guardian
• Input: { "tier": "quick", "input": { "previous": …, "current": … } }
• Output: SAFE / RISKY / BREAKING / UNKNOWN / UNSUPPORTED
• Price: Quick $0.001 · Deep $0.019 (USDC)
• Network: Base (eip155:8453) · USDC · non-custodial (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

Runnable CI examples (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 }}

The action reads only the two spec files you supply, enforces a spending ceiling against the live 402 challenge before signing, and never holds your key. Live demo: genesiscode2026/release-guardian-demo.

MCP

npx -y genesis-agent-mcp

Two transports for the same five flagship tools:

• Local / package (stdio): npx -y genesis-agent-mcp
• Hosted Streamable HTTP: https://genesis-agent-tools.genesisagenttools.workers.dev/mcp (initialize / tools/list / tools/call; stateless JSON-RPC; paid tools return the x402 challenge unless the request carries a valid PAYMENT-SIGNATURE header)

A thin buyer-side MCP adapter exposes Release Guardian + Workflow Runner (and the other flagships) as tools for Cline / Claude / Cursor. Buyer key via X402_PRIVATE_KEY (never committed); per-call ceiling + session budget built in. Config: mcp/README.md.

Other flagships

All prices in USDC. Release Guardian Quick is the $0.001 acquisition wedge; all other Quick ≤ $0.005 (Agent402 execute); all Deep ≤ $0.040 (execute-plus). Bounded workflow example: examples/workflow-runner/.

Availability

Live / submitted distribution surfaces (machine-native, no account, no API key):

How do I pay? (x402 v2)

• Network: Base (eip155:8453)
• Asset: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
• Recipient: Exodus treasury 0xC6F86e170411182114FcCdb28793dC76B5e8D144 (non-custodial)
• Scheme: exact (EIP-3009), fallback facilitator: Dexter (Permit2)

An x402 client decodes the 402, signs the EIP-3009 USDC authorization, and retries with the PAYMENT-SIGNATURE header. See examples/ for runnable curl + JavaScript (@x402/fetch) buyers — replace only the funded buyer key.

The Agent402 50-settlement gate affects Agent402 auto-dispatch only; direct x402 buyers (these examples) can purchase without Agent402 routing.

Machine discovery

• Agent402 index: registered origin genesis-agent-tools.genesisagenttools.workers.dev (find it via GET https://agent402.tools/api/route?q=<task>)
• OpenAPI: GET /openapi.json · x402 manifest: GET /.well-known/x402
• Machine catalog: GET /api/flagships · llms.txt: GET /llms.txt · Health: GET /health

Also available (secondary)

• Source-code products (55 saleable): API-contract detectors, agent-security SDKs, quant-research suites, financial-visualization and privacy tooling — sold under a non-exclusive GENESIS license. Catalog: /catalog.json · /catalog.md.
• Compatibility APIs (6 paid + 1 free): 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, free POST /api/preflight.
• NFT access tiers: GENESIS AGENTS — ORIGIN (ERC-721) + GENESIS PASSES (ERC-1155). GET /nft.

Security

No private keys or seed material in this repository. GENESIS never holds buyer funds and never requests private keys. Report issues via GitHub Issues. See SECURITY.md.

Privacy

The GitHub Action and MCP adapter transmit only the API/schema artifacts you explicitly supply. Nothing else in your repository is read or uploaded; there is no server-side repo cloning, no IP/geolocation persistence, and no analytics trackers. Payment wallet addresses are necessarily public/on-chain.

Support

Use GitHub Issues for product support and private GitHub Security Advisories for vulnerabilities. No personal contact details are required.

License

Discovery/documentation only. Proprietary source is sold separately under a non-exclusive GENESIS license.