Back to Directory/Automation & Workflow

io.github.genesiscode2026/genesis-agent-mcp

Pay-per-call x402 MCP tools on Base USDC: Release Guardian + Workflow Runner.

Automation & WorkflowJavaScriptv1.0.0

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

FlagshipWhat it does (buyer intent)EndpointQuickDeep
Workflow RunnerValidate or run a bounded HTTP/JSON workflow with a deterministic trace.POST /api/flagships/workflow-runner0.0050.035
Asset IntelligenceVerify a crypto asset's live multi-source price, freshness, and on-chain owner.POST /api/flagships/asset-intelligence0.0050.025
Research & EvidenceExtract cited claims and contradictions from supplied URLs.POST /api/flagships/research-evidence0.0050.040
Agent AssuranceAudit an agent or MCP server for readiness, observed risk, and evidence.POST /api/flagships/agent-assurance0.0050.029

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):

ChannelStatusLink
Agent402INDEXED (health 1.0; dispatch gated by settlement floor)https://agent402.tools
x402scanLISTEDhttps://www.x402scan.com/server/c6741010-aff0-42ae-85dc-a28523d26cb2
MCP RegistryLIVE v1.0.0io.github.genesiscode2026/genesis-agent-mcp
true402REGISTERED (free discovery)https://true402.dev/catalog
PayAPI MarketLIVE · x402 verified (Release Guardian)https://payapi.market/api/genesis-release-guardian
FiatDock5 callable listings · pending/unverified · 0 ratingshttps://fiatdock.com/browse
PayanAgentregistration endpoint returned 500 (retried) — pendinghttps://payanagent.com

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.

Setup from the maintainer

This listing does not have a supported local package template. Use the maintainer’s documentation for its hosted endpoint, authentication, and client-specific setup. No install command has been inferred.

Package

https://github.com/genesiscode2026/genesis-agent-tools/releases/download/v1.0.0/genesis-agent-mcp-v1.0.0.mcpbother

Compatible MCP Clients

io.github.genesiscode2026/genesis-agent-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More