# genesis-agent-mcp

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/genesiscode2026/genesis-agent-tools  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/genesis-agent-mcp

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

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "genesis-agent-mcp": {
    "command": "npx",
    "args": ["-y","genesis-agent-mcp"]
  }
}
```

## Documentation & 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`](https://genesis-agent-tools.genesisagenttools.workers.dev/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/`](https://github.com/genesiscode2026/genesis-agent-tools/blob/HEAD/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`](https://github.com/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`](https://github.com/genesiscode2026/genesis-agent-tools/blob/HEAD/mcp/README.md).

## Other flagships

| Flagship | What it does (buyer intent) | Endpoint | Quick | Deep |
|---|---|---|---|---|
| **Workflow Runner** | Validate or run a bounded HTTP/JSON workflow with a deterministic trace. | `POST /api/flagships/workflow-runner` | 0.005 | 0.035 |
| **Asset Intelligence** | Verify a crypto asset's live multi-source price, freshness, and on-chain owner. | `POST /api/flagships/asset-intelligence` | 0.005 | 0.025 |
| **Research & Evidence** | Extract cited claims and contradictions from supplied URLs. | `POST /api/flagships/research-evidence` | 0.005 | 0.040 |
| **Agent Assurance** | Audit an agent or MCP server for readiness, observed risk, and evidence. | `POST /api/flagships/agent-assurance` | 0.005 | 0.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/`](https://github.com/genesiscode2026/genesis-agent-tools/blob/HEAD/examples/workflow-runner).

## Availability

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

| Channel | Status | Link |
|---|---|---|
| Agent402 | INDEXED (health 1.0; dispatch gated by settlement floor) | `https://agent402.tools` |
| x402scan | LISTED | `https://www.x402scan.com/server/c6741010-aff0-42ae-85dc-a28523d26cb2` |
| MCP Registry | LIVE v1.0.0 | `io.github.genesiscode2026/genesis-agent-mcp` |
| true402 | REGISTERED (free discovery) | `https://true402.dev/catalog` |
| PayAPI Market | LIVE · x402 verified (Release Guardian) | `https://payapi.market/api/genesis-release-guardian` |
| FiatDock | 5 callable listings · pending/unverified · 0 ratings | `https://fiatdock.com/browse` |
| PayanAgent | registration endpoint returned 500 (retried) — pending | `https://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](https://github.com/genesiscode2026/genesis-agent-tools/issues)
for product support and private [GitHub Security Advisories](https://github.com/genesiscode2026/genesis-agent-tools/security/advisories/new)
for vulnerabilities. No personal contact details are required.

## License

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