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<a funding key you are willing to spend from>",
        "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.

Tool	Cost	What it does
genesis402_catalog	free	Every endpoint with price, title, path and parameters. Call first.
genesis402_receipt	free	A paid-call receipt by id from the public receipts feed.
genesis402_call	per endpoint	Call any endpoint in the catalog by name.
genesis402_wallet_brief	paid	Wallet risk signals in one call: public sanctions-list check, 10-chain scan, activity and summary, with an evidence hash.
genesis402_token_brief	paid	Token pre-trade check: metadata, price, holder concentration, source verification, sanctions-list signal.
genesis402_screen_sanctions	paid	Public-data sanctions-list signal: OFAC SDN digital-currency entries and community blocklists.
genesis402_multi_chain_scan	paid	One call across 10 EVM chains for a single address.
genesis402_defi_yields	paid	DeFi yields from 15,000+ pools, filterable by chain, protocol, token, stablecoin-only and minimum TVL.
genesis402_market_snapshot	paid	Price with 24h and 7d change for the major coins, or up to 25 you name, in one call.
genesis402_sec_financials	paid	As-reported fundamentals for a US public company from SEC XBRL.
genesis402_email_check	paid	Email/domain deliverability: MX, provider, SPF, DMARC, disposable flag.
genesis402_whois	paid	Domain registrar, age, expiry, status and nameservers via RDAP.
genesis402_extract_json	paid	Extract your fields from any text as JSON; missing fields are null, never invented.
genesis402_web_extract	paid	Any public web page as clean text, title, headings and links.
genesis402_prove	paid	A signed Ed25519 receipt binding your SHA-256 digest (or text) to a settled payment.
genesis402_summarize	paid	Summary of text you supply: paragraph, bullets or TL;DR, 20 to 400 words.
genesis402_answer_from_text	paid	One answer from your document plus a supporting quote the rail verifies is in the text.
genesis402_translate	paid	Translation into any major language; names, numbers and formatting preserved.
genesis402_paper_search	paid	OpenAlex scholarly search, by relevance or most-cited, with open-access links.

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

Variable	Default	Meaning
GENESIS402_ORIGIN	https://twin.unykorn.org	Rail origin.
GENESIS402_LIVE	unset	1 enables payment. Anything else is quote-only.
GENESIS402_PAYER_KEY	unset	Private key that funds calls. Required for live mode.
GENESIS402_MAX_USD	0.25	Hard cap per call, checked against the quote and again when signing. Quotes above it are refused; a zero, negative or non-numeric value keeps the server quote-only.

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