Genesis Agent Mcp

io.github.genesiscode2026Published by GitHub account genesiscode2026v1.0.0Updated Oct 27, 2026

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

VerifiedSTDIODesktop onlyFinanceDeveloper ToolsAI & ML

Overview

AI-generated overview

Pay-per-call x402 MCP adapter exposing Release Guardian, Workflow Runner and other paid API tools on Base USDC to assistants like Cline, Claude or Cursor.

What you can do
  • Check API and schema compatibility before release: compare previous and current OpenAPI, GraphQL, SDK export or JSON Schema inputs and get SAFE, RISKY, BREAKING, UNKNOWN or UNSUPPORTED.
  • Validate or run a bounded HTTP/JSON workflow and return a deterministic trace.
  • Verify a crypto asset's live multi-source price, freshness and on-chain owner.
  • Extract cited claims and contradictions from supplied URLs, and audit an agent or MCP server for readiness and risk.
  • Call the same five flagship tools over local stdio or a hosted Streamable HTTP endpoint.
When to use it
Useful when you want an assistant to run paid pre-release compatibility checks on API specs, execute small bounded HTTP workflows, or pull the vendor's other paid checks without creating an account or API key.
Requirements
Runs as a local process (npx package or .mcpb bundle) on desktop, or via the hosted HTTP endpoint. Needs a funded buyer wallet key in X402_PRIVATE_KEY holding USDC on Base, plus optional GENESIS_MAX_SPEND_USD and GENESIS_SESSION_BUDGET_USD caps. Network access to the vendor origin is required; no account or API key.
Before you install
Every paid call costs USDC on Base, signed with the buyer key in X402_PRIVATE_KEY, so real funds are at risk; keep the per-call ceiling and session budget low. The README says the vendor never holds funds or requests keys, but the key still signs payments from your machine. Supplied specs and URLs are sent to the vendor's hosted service. Prices and endpoints are third-party claims.

Installation

In SourceWeft

  1. Open Genesis Agent Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

yaml
- 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

bash
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.

Source: README.md at commit 19b929d

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 23, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.