Genesis402 by UnyKorn (x402 pay-per-call)

genesis402-mcp

Genesis402: pay-per-call APIs for AI agents over x402.

This is the MCP server for the Genesis402 rail: 360 pay-per-call endpoints covering DeFi and market data, SEC financials, wallet and token risk signals from public data, web and domain lookups, AI text tools, and multi-chain reads across EVM chains, Solana, Bitcoin, Stellar and the XRP Ledger.

Pay only for the call you make: no account, no subscription, no API key. Prices from $0.001 per call, shown before you pay. This package pays in USDC on Base via x402 v2.

Quote-only by default

Quote-only by default: nothing is signed or paid until you turn paying on and set a price cap.

Out of the box every paid tool returns the price quote and stops. To enable payment you must set *both* GENESIS402_LIVE=1 and GENESIS402_PAYER_KEY. Even then, any quote above GENESIS402_MAX_USD (default $0.25) is refused rather than paid.

The rail sets the price. This client never does; it only decides whether to accept it.

Hosted endpoint (no install)

Connect any MCP client that supports streamable HTTP to https://twin.unykorn.org/mcp. It exposes the same 22 tools over every endpoint in the catalog.

• Hosted MCP endpoint at https://twin.unykorn.org/mcp: it holds no keys. A paid tool returns the exact x402 quote.
• To pay, sign an x402 v2 payment for that quote with your own wallet (for example @x402/fetch or a CDP/AgentKit wallet) and call the tool again with payment_signature.
• Health check: https://twin.unykorn.org/mcp/health

Install (local, stdio)

// Claude Desktop: claude_desktop_config.json

// Cursor: .cursor/mcp.json { "mcpServers": { "genesis402": { "command": "npx", "args": ["-y", "genesis402-mcp"] } } }

That configuration can browse the catalog and see prices, and cannot spend anything.

To let it pay:

{

"mcpServers": { "genesis402": { "command": "npx", "args": ["-y", "genesis402-mcp"], "env": { "GENESIS402_LIVE": "1", "GENESIS402_PAYER_KEY": "0x ", "GENESIS402_MAX_USD": "0.05" } } } }

Use a dedicated key holding a few dollars of USDC on Base, never your main wallet.

Tools (14)

Each paid tool's description carries its live price, read from the rail's /.well-known/x402 manifest at startup, so a price change on the rail never leaves this client advertising a stale number.

How a paid call works

1. Free validation. Parameters go to the rail's free /__validate first. Bad input is refused before a quote is even requested.
2. Free quote. An unpaid request returns the 402 challenge with the price.
3. Payment, only in live mode, only under your cap, through the standard x402 v2 client.
4. Result and receipt. A signed receipt for every paid call, listed on the rail's public receipts feed.

One payment buys exactly one execution; re-presenting it returns 409.

Limits, stated plainly

• Risk and sanctions results are automated heuristic signals from public data. They are not KYC, not a compliance determination, and not legal advice. Absence from every list is not a clearance.
• prove records a claim; it does not evaluate it. The receipt chain is not externally anchored: a valid receipt shows the rail issued it and has not altered it, not that the rail could not have back-dated its own chain.

Environment

Community

Questions, feedback and a free counterparty report (/check): UnyKorn Discord.

Testing

node smoke.mjs      # read-only checks against the live rail; never pays

node boot-test.mjs # boots over stdio and lists the tools a client would see

UnyKorn LLC (Wyoming). MIT licensed. Changes: CHANGELOG. Discovery: /.well-known/x402 · Receipts: /receipts