Genesis402 agent kit

MCP serverEverything else

Genesis402: pay-per-call APIs for AI agents over x402. A signed receipt for every paid call.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use Genesis402 agent kit

Install Genesis402 agent kit

The server’s own address, for the clients that take one directly. Or connect ahel onceand every client you use reads it from one address, with the account kept on ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http --scope user genesis402-agent-kit 'https://twin.unykorn.org/mcp'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://twin.unykorn.org/mcp

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=genesis402-agent-kit&config=eyJ1cmwiOiJodHRwczovL3R3aW4udW55a29ybi5vcmcvbWNwIn0=

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://twin.unykorn.org/mcp

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add genesis402-agent-kit --url 'https://twin.unykorn.org/mcp'

    Run it once, then sign in with codex mcp login genesis402-agent-kit if the server asks for an account.

From the project's README

As published by FTHTrading/genesis402-agent-kit in README.md.

Everything an outside developer needs to call and pay for the Genesis402 rail (https://twin.unykorn.org) from an agent.

ServicePriceWhat it returns
risk$0.25Risk snapshot of one EVM address on Base/Polygon (OFAC SDN, scam lists, explorer flags, activity, token/contract facts, evidence hash)
prove$0.25Ed25519-signed receipt binding your SHA-256 digest + claim to a settled payment; verify offline
genesis-sim$0.25Deterministic agent-economy simulation (Gini series, energy, SHA-256 state commitment)
wallet-ops$0.25Live operator treasury balances on Base, XRPL, Stellar
rwa-screen$0.25Curated static readiness table for 4 energy RWA markets (not a live feed)
llm$0.02One chat completion from an allowlisted model

Payment: x402 v2. USDC on Base, Polygon or Solana (facilitator-settled), USDC on Stellar or XRP on XRPL (pay-first, present the tx hash).

1. MCP server (Claude, Cursor, any MCP client)

{
  "mcpServers": {
    "genesis402": {
      "command": "node",
      "args": ["/path/to/genesis402-agent-kit/mcp/index.mjs"],
      "env": {
        "GENESIS402_LIVE": "0",
        "GENESIS402_PAYER_KEY": "",
        "GENESIS402_MAX_USD": "0.25"
      }
    }
  }
}

Once published to npm, the args become "command": "npx", "args": ["-y", "genesis402-mcp"].

  • Default is quote only: paid tools return the price and what you get; nothing is signed.
  • Set GENESIS402_LIVE=1 and GENESIS402_PAYER_KEY (a Base wallet holding a little USDC, no ETH needed) to pay.
  • Any quote above GENESIS402_MAX_USD is refused.

Tools: genesis402_catalog (free), genesis402_receipt (free), genesis402_risk, genesis402_prove, genesis402_genesis_sim, genesis402_wallet_ops, genesis402_rwa_screen, genesis402_llm.

2. Quickstart scripts

cd quickstart && npm install
node buy.mjs risk '{"address":"0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed"}'          # quote
PAYER_KEY=0x... LIVE=1 node buy.mjs genesis-sim '{"n":20,"epochs":20}'                # $0.25 USDC on Base
XRPL_SEED=s... LIVE=1 RAIL=xrpl node buy.mjs genesis-sim '{"n":20,"epochs":20}'       # 0.05 XRP on XRPL

pip install "x402[httpx,evm]" eth-account xrpl-py
python buy.py genesis-sim '{"n":20,"epochs":20}'
PAYER_KEY=0x... LIVE=1 python buy.py genesis-sim '{"n":20,"epochs":20}'

Flow: POST without payment -> 402 with PAYMENT-REQUIRED (base64 JSON) -> sign EIP-3009 transferWithAuthorization (Base) or send the XRPL payment -> retry with PAYMENT-SIGNATURE / X-PAYMENT -> 200 with result and a receipt id (/receipts/{id}).

Failed settlement never charges: the rail answers 402 settlement_failed and states that no funds moved.

Advanced
Delivery
genesis402-mcp MCP server → your ahel connector (mcp.ahel.ai) → your AI.
Catalog kind
mcp-server
Key
io-github-fthtrading-genesis402-mcp
Source
github.com/FTHTrading/genesis402-agent-kit
Hosted endpoint
https://twin.unykorn.org/mcp