Genesis402 by UnyKorn (x402 pay-per-call)

---

Guide: Screen a wallet before your agent moves money — $0.008 a check, three ways to call it.

Community: join the UnyKorn Discord. Run a free counterparty report with /check, watch paid calls settle live in #rail-feed, and ask questions in #help.

Connect in 30 seconds

Hosted MCP (nothing to install)

Add this remote to Claude, Cursor, VS Code or any MCP client that speaks streamable HTTP:

https://twin.unykorn.org/mcp

The hosted server holds no keys. Free tools (catalog, receipt) work immediately. Paid tools return the exact price quote, or run with a payment_signature you produce with your own wallet.

Local MCP (pays for you, within a cap you set)

{
  "mcpServers": {
    "genesis402": {
      "command": "npx",
      "args": ["-y", "genesis402-mcp"],
      "env": {
        "GENESIS402_LIVE": "1",
        "GENESIS402_PAYER_KEY": "0x<private key of a wallet holding a little USDC on Base>",
        "GENESIS402_MAX_USD": "0.25"
      }
    }
  }
}

Without GENESIS402_LIVE=1 the server is quote-only: it shows the price and signs nothing. The rail sets the price; the client decides whether to accept it. Use a dedicated wallet with a small balance.

Plain HTTP, any language

x402

GET https://twin.unykorn.org/price/bitcoin
→ 402, header payment-required: <base64 x402 v2 challenge>
sign the USDC authorization (EIP-3009) for the quoted amount, retry with X-PAYMENT
→ 200 + result + receipt id

MPP (the Payment HTTP auth scheme)

GET https://twin.unykorn.org/price/bitcoin
→ 402, header WWW-Authenticate: Payment id="…", method="usdc", intent="charge", request="…"
sign the same EIP-3009 authorization, retry with  Authorization: Payment <base64url credential>
→ 200 + result + Payment-Receipt header

Both dialects quote the same price to the same address in the same token. MPP discovery is the standard /openapi.json with x-payment-info on every operation.

Free before you pay: POST /__validate checks your parameters with the same validator the paid path uses, so a bad request is never charged.

---

MCP tools

Tool	What it does	Cost
genesis402_catalog	Every endpoint with path, price and parameter schema, from the live manifest	Free
genesis402_receipt	Look up a paid-call receipt by id	Free
genesis402_call	Call any of the 360 endpoints by name	Per endpoint
genesis402_counterparty_report	Company + registered parents + UN/OFAC/EU/UK sanctions screen, one verdict, signed receipt, branded PDF and public verify page	$0.25
genesis402_sanctions_name_screen	One name against the UN, OFAC SDN, EU and UK lists, with list versions cited	$0.02
genesis402_company_lookup	Any company worldwide by name, LEI or SEC CIK (GLEIF + SEC EDGAR), with registered parents	$0.01
genesis402_wallet_brief	Wallet risk signals: sanctions list, 10-chain scan, activity, summary	Paid
genesis402_token_brief	Token pre-trade check: metadata, price, holder concentration, verification	Paid
genesis402_screen_sanctions	Public-data sanctions-list signal for one address	Paid
genesis402_multi_chain_scan	One address across 10 EVM chains in one call	Paid
genesis402_defi_yields	Ranked yields from 15,000+ pools, filterable by chain, protocol, token, TVL	Paid
genesis402_sec_financials	As-reported fundamentals for a US public company from SEC XBRL	Paid
genesis402_email_check	MX, provider, SPF, DMARC, disposable flag, trust score	Paid
genesis402_whois	Registrar, age, expiry, status and nameservers via RDAP	Paid
genesis402_extract_json	Extract the fields you name from any text; missing fields are null	Paid
genesis402_web_extract	Any public page as clean text, title, headings and links	Paid
genesis402_prove	Signed Ed25519 receipt binding your digest to a settled payment	Paid
genesis402_summarize	Summarize text as a paragraph, bullets or TL;DR within a word limit	Paid
genesis402_answer_from_text	Answer one question from your document, with a verified supporting quote	Paid
genesis402_translate	Translate text into any major language, preserving names, numbers and formatting	Paid
genesis402_paper_search	Scholarly paper search (OpenAlex) with citation counts and open-access links	Paid

Live prices come from the rail's manifest; genesis402_catalog shows them. Every paid tool returns the receipt id and evidence hash with the result.

What is on the rail (360 endpoints)

Family	Count	Examples	Price
Crypto prices	72	/price/bitcoin, /price/ethereum …	$0.001
DeFi and markets	47	/defi/yields, /defi/stablecoins, /defi/chain/base, /defi/fees	$0.002–$0.01
Chain reads: 10 EVM chains + BTC, SOL, XLM, XRP	83	erc20-balance, evm-multi-chain-scan, evm-proof, xrpl-account, stellar-account, solana-account, btc-utxos	$0.001–$0.008
Deterministic compute	64	hashes, encodings, ABI encode/decode, EIP-712, merkle, ENS	$0.001–$0.003
Due diligence and risk	10	/wallet-brief, /token-brief, screen-sanctions, holder-concentration, /risk	$0.008–$0.25
Public records	12	/records/sec-financials, /records/sec-filings, /records/fx-rates, /records/treasury-yields, /records/vin-decode	$0.001–$0.01
Research	15	/research/arxiv-search, /research/doi, /research/npm-package, /research/wiki-summary	$0.001–$0.003
Web and domain intelligence	15	/web/whois, /web/dns, /web/tls-cert, /web/email-check, /web-extract, /summarize-url	$0.001–$0.004
Places, time, weather	10	/geo/geocode, /geo/weather-forecast, /geo/public-holidays	$0.001–$0.002
AI on our own GPU	16	/v1/chat/completions (OpenAI-compatible), /v1/embeddings, /ai/extract, /ai/text-to-sql, /ai/summarize	$0.002–$0.01
Proofs	2	/prove, /json-canonical	$0.001–$0.25

Full list with schemas and live examples: catalog, /.well-known/x402, /openapi.json.

What the rail commits to

• Validate before pay. Bad input returns 400 with "nothing was charged".
• Sources on every answer. Each response lists the upstream it read and an evidence_hash. A failed upstream is an error, never a silent zero.
• Make-good. A paid call that is not delivered is recorded as owed and re-delivered free on retry; the guardian reconciles every settlement on-chain within 48 hours.
• Public status. twin.unykorn.org/status is the guardian's own report, refreshed every 5 minutes.
• Identity. ERC-8004 agent 95721 on Base; A2A card at the rail root.

Payment rails

x402 v2 exact scheme and MPP usdc/charge (EIP-3009 authorization), on USDC on Base (primary) and Polygon. Solana USDC via facilitator settlement. XRP and USDC on XRPL and Stellar are pay-first, with the payment bound to the challenge nonce. The 402 response lists exactly which lanes are payable right now.

Repo layout

• mcp/ — the MCP server (npx genesis402-mcp; genesis402-mcp-http for hosted mode), server.json for the MCP Registry, smoke.mjs (13 read-only checks against the live rail).
• quickstart/ — Node and Python payers for Base, XRPL and Stellar; screen.mjs for the wallet-screening guide.
• assets/ — brand banner and icon.

---