Genesis402 by UnyKorn (x402 pay-per-call)

io.github.FTHTradingPublished by GitHub account FTHTradingv0.3.10Updated Oct 24, 2026

Counterparty checks, sanctions screening, company lookup and 360+ pay-per-call APIs over x402.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingFinanceSecurity & Monitoring

Overview

AI-generated overview

Genesis402 gives an assistant pay-per-call access to 360+ x402 endpoints for sanctions screening, company lookup, crypto risk, web and domain checks, and AI and

What you can do
Browse the endpoint catalog and look up paid-call receipts by id, both free and read-only. Call any catalog endpoint by name, including DeFi, SEC, research and multi-chain reads. Screen counterparties: sanctions name and address checks, company and LEI lookup, wallet and token risk briefs, multi-chain scans. Pull market and financial data: DeFi yields, crypto price snapshots, SEC XBRL fundamentals, OpenAlex paper search. Vet web and email: page text extraction, WHOIS/RDAP domain data, email deliverability and SPF/DMARC checks. Process text: field extraction to JSON, summarization, quoted answers from a document, translation, and signed timestamp proofs.
When to use it
Useful when an assistant needs on-demand counterparty due diligence, sanctions or wallet risk signals, company registry data, crypto market figures, or small text-processing jobs, and you would rather pay a few cents per call than hold an account or API key with each provider.
Requirements
Runs as a hosted streamable HTTP endpoint that holds no keys, or locally via npx genesis402-mcp over stdio (Node.js). Payment needs GENESIS402_LIVE=1 plus GENESIS402_PAYER_KEY, a Base wallet private key holding USDC; GENESIS402_MAX_USD caps each call. Network access to the rail origin is required.
Before you install
Paid tools spend real USDC on Base; the payer key is a private key, so use a dedicated low-balance wallet, never a main one. Quote-only is the default and nothing is signed until live mode is enabled. Risk and sanctions results are automated heuristics from public data, not KYC, compliance determinations or legal advice, and absence from a list is not clearance. Proof receipts are not externally anchored. Text and addresses sent to the rail go to a third party.

Installation

In SourceWeft

  1. Open Genesis402 by UnyKorn (x402 pay-per-call) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.FTHTrading%2Fgenesis402-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "genesis402-by-unykorn-x402-pay-per-call": {
      "type": "http",
      "url": "https://twin.unykorn.org/mcp"
    }
  }
}

README

[Genesis402 by UnyKorn: pay-per-call APIs for AI agents]

[npm version] [npm weekly downloads] [CI] [SLSA provenance] [MCP Registry] [Glama] [MIT]

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)

jsonc
// 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:

jsonc
{  "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.

ToolCostWhat it does
genesis402_catalogfreeEvery endpoint with price, title, path and parameters. Call first.
genesis402_receiptfreeA paid-call receipt by id from the public receipts feed.
genesis402_callper endpointCall any endpoint in the catalog by name.
genesis402_wallet_briefpaidWallet risk signals in one call: public sanctions-list check, 10-chain scan, activity and summary, with an evidence hash.
genesis402_token_briefpaidToken pre-trade check: metadata, price, holder concentration, source verification, sanctions-list signal.
genesis402_screen_sanctionspaidPublic-data sanctions-list signal: OFAC SDN digital-currency entries and community blocklists.
genesis402_multi_chain_scanpaidOne call across 10 EVM chains for a single address.
genesis402_defi_yieldspaidDeFi yields from 15,000+ pools, filterable by chain, protocol, token, stablecoin-only and minimum TVL.
genesis402_market_snapshotpaidPrice with 24h and 7d change for the major coins, or up to 25 you name, in one call.
genesis402_sec_financialspaidAs-reported fundamentals for a US public company from SEC XBRL.
genesis402_email_checkpaidEmail/domain deliverability: MX, provider, SPF, DMARC, disposable flag.
genesis402_whoispaidDomain registrar, age, expiry, status and nameservers via RDAP.
genesis402_extract_jsonpaidExtract your fields from any text as JSON; missing fields are null, never invented.
genesis402_web_extractpaidAny public web page as clean text, title, headings and links.
genesis402_provepaidA signed Ed25519 receipt binding your SHA-256 digest (or text) to a settled payment.
genesis402_summarizepaidSummary of text you supply: paragraph, bullets or TL;DR, 20 to 400 words.
genesis402_answer_from_textpaidOne answer from your document plus a supporting quote the rail verifies is in the text.
genesis402_translatepaidTranslation into any major language; names, numbers and formatting preserved.
genesis402_paper_searchpaidOpenAlex 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

VariableDefaultMeaning
GENESIS402_ORIGINhttps://twin.unykorn.orgRail origin.
GENESIS402_LIVEunset1 enables payment. Anything else is quote-only.
GENESIS402_PAYER_KEYunsetPrivate key that funds calls. Required for live mode.
GENESIS402_MAX_USD0.25Hard 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

bash
node smoke.mjs      # read-only checks against the live rail; never paysnode 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

Source: mcp/README.md at commit e06266f

Tools

22

genesis402_catalog

List endpoints and prices (free)

Free, no payment, read-only. Lists Genesis402 endpoints with name, HTTP path, USD price, title and parameter schema, read from the rail's live /.well-known/x402 manifest (refreshed every 10 minutes). Use it to find an endpoint that has no dedicated genesis402_* tool, then pass its exact name and parameters to genesis402_call. Filter by keyword to keep the list short (e.g. "defi", "sec", "wiki"); with no filter it returns every endpoint, up to 400. Returns the rail origin, total endpoint count, number matched, the current payer mode (QUOTE_ONLY, HOSTED or LIVE with its cap) and the matching endpoints.

Parametersfilter

genesis402_receipt

Look up a receipt (free)

Free, no payment, read-only and idempotent. Fetches one receipt by id from the rail's public receipts feed (twin.unykorn.org/receipts) to confirm that a paid call was settled and delivered. Use after any paid call, or to check a genesis402_prove receipt, using the receipt id returned with that result. It does not list or search receipts; you need the exact id. Returns the receipt exactly as published: the task called, amount in USD, payment rail, settlement transaction hash, settler, payer and timestamp. An unknown id returns an error with HTTP status 404; nothing is charged either way.

Parametersreceipt_idrequired

genesis402_call

Call any endpoint

Calls any of the 380 Genesis402 endpoints by name (DeFi, SEC filings, research, web/domain intel, AI text tools, multi-chain reads). Prices $0.001-$0.25 USDC on Base. Use for any endpoint without a dedicated tool; look up the name and parameters with genesis402_catalog first. Parameters are validated for free before any quote. Without payment_signature (or a local payer) it returns the exact price quote and signs nothing; with payment it returns the result plus the settlement details.

Parametersparamsendpointrequiredpayment_signature

genesis402_counterparty_report

Counterparty report: company, parents, sanctions verdict

Paid ($0.25 USDC). Check one company before you deal with it. Resolves the company in the GLEIF register (name or 20-character LEI), follows its registered direct and ultimate parent, and screens every name in that group against the UN, US OFAC SDN, EU and UK sanctions lists. Returns one verdict (clear, review or stop) with every reason sourced, the registry record, the group screened, the list versions used, an Ed25519-signed receipt, a private link to a branded PDF (7 days) and a public verify page. A vague name (e.g. a bare brand) returns review and names the entity it assumed. Screening and registry signals only: not KYC, not a compliance determination, not legal advice. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parameterstypequeryrequiredpayment_signature

genesis402_sanctions_name_screen

Screen a name against UN, OFAC, EU, UK sanctions

Paid ($0.02 USDC). Screen one person or organisation name against the UN, US OFAC SDN, EU and UK consolidated sanctions lists, including aliases and transliterations. Returns match, possible match or no match, each hit with list, list id, matched name and score, and the published date and SHA-256 of every list version used. For a company and its parents in one call use genesis402_counterparty_report; for a wallet address use genesis402_screen_sanctions. Screening signal only: not KYC, not a compliance determination, not legal advice. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parametersnamerequiredtypedob_yearpayment_signature

genesis402_company_lookup

Look up a company (GLEIF, SEC)

Paid ($0.01 USDC). Look up one company worldwide in the official registers: GLEIF (Legal Entity Identifiers, every country) and US SEC EDGAR. By LEI: legal name, status, jurisdiction, addresses, registration authority, renewal dates and its registered direct and ultimate parent. By name: ranked matches, live registrations first, with legal forms understood across languages and names in their own script. By SEC CIK: filer profile, tickers and latest filings. Registry data only: not KYC, not a compliance determination, not legal advice. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parametersqueryrequiredpayment_signature

genesis402_wallet_brief

Wallet risk brief

Paid ($0.03 USDC). Full risk brief for one EVM wallet in a single call: sanctions-list check (OFAC SDN digital-currency entries), native balance and activity scan across 10 EVM chains, recent activity on the chosen chain and a plain-language summary. Use before sending funds to, or accepting funds from, an unknown address. For a sanctions check alone use genesis402_screen_sanctions (cheaper, any chain); for balances without risk signals use genesis402_multi_chain_scan; for a token contract use genesis402_token_brief. Returns each part with its own sources (a part that cannot be read is marked unavailable with the reason, never zeroed) and an evidence hash over all parts. Heuristic signals from public data: not KYC, not a compliance determination, not legal advice. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parameterschainaddressrequiredpayment_signature

genesis402_token_brief

Token pre-trade brief

Paid ($0.03 USDC). Pre-trade check for one ERC-20 token contract in a single call: name, symbol, decimals and supply, current USD price, top-holder concentration, source-verification status and a sanctions-list check on the contract address. Use before buying, listing or accepting an unfamiliar token. For a wallet rather than a token use genesis402_wallet_brief. Returns each part with its sources (unreadable parts are marked unavailable, never zeroed) and an evidence hash. Signals only, not investment advice. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parameterschaincontractrequiredpayment_signature

genesis402_screen_sanctions

Screen address against sanctions lists

Paid ($0.008 USDC). List lookup for one address on any chain against OFAC SDN digital-currency entries, community scam-address blocklists and the Blockchain Fraud case registry. Use as a fast, cheap first gate on a counterparty address. For balances plus sanctions plus a summary on an EVM address use genesis402_wallet_brief. Returns whether any list matched, and for every list consulted its dataset name, fetch URL and entry count, plus an evidence hash. A hit means the address appears on a published list; absence from every list is not a clearance. Not a compliance decision, not a finding about any person, not legal advice. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parametersaddressrequiredpayment_signature

genesis402_multi_chain_scan

Scan address across 10 EVM chains

Paid ($0.008 USDC). Sweeps one address across 10 EVM chains at once and reports where it is actually active. Use to find which networks an address uses before drilling into one chain. No risk scoring or sanctions check: for that use genesis402_wallet_brief. Returns, per chain, the native balance, the number of transactions sent and whether contract bytecode is deployed; chains whose RPC did not answer are listed separately, never counted as inactive. Activity is inferred from nonce, balance and code, so an address that only ever received tokens can show a zero nonce; check its balance field. Public on-chain data with sources and an evidence hash. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parametersaddressrequiredpayment_signature

genesis402_defi_yields

Find DeFi yields

Paid ($0.01 USDC). Ranked DeFi yield pools from DefiLlama (15,000+ pools), filterable by chain, protocol, token, stablecoin-only and minimum TVL. Use to answer 'where is the best yield for X'. For other DeFi or market data search genesis402_catalog and call the endpoint through genesis402_call. All filters are optional and combine with AND; with none set it returns the top pools above $1M TVL. Returns up to limit pools, each with protocol, chain, symbol, TVL, base APY vs reward APY, 30-day mean APY, impermanent-loss risk, exposure and DefiLlama's outlook class. APYs are variable and backward-looking; not investment advice. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parameterssortchainlimittokenprojectmin_tvl_usdstablecoin_onlypayment_signature

genesis402_market_snapshot

Market snapshot: major coin prices with 24h and 7d change

Paid ($0.004 USDC). USD price with 24-hour and 7-day change for the major crypto assets in a single call, or for up to 25 coins you name. Use when you need more than one price at once: one payment instead of one per coin. For a single coin, or for a token by contract address, search genesis402_catalog and call the endpoint through genesis402_call. Returns one row per coin with price, both changes, timestamp and pricing confidence, plus how many coins rose and fell over 24 hours. Coins with no live price are marked unavailable, never priced at zero. Third-party market data from DefiLlama, as published: not investment advice and no recommendation. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parameterscoinspayment_signature

genesis402_sec_financials

Get SEC company financials

Paid ($0.01 USDC). As-reported fundamentals for one SEC filer from XBRL company facts. Use for quick fundamentals without a data vendor. For other SEC data search genesis402_catalog for "sec" and use genesis402_call. Give ticker or cik; one is required. Returns the latest annual and latest quarterly values for revenue, net income, operating income, total assets, liabilities, equity, cash, operating cash flow and diluted EPS, each with period end and filing date. Missing tags are marked unavailable, never estimated. Not investment advice. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parametersciktickerpayment_signature

genesis402_email_check

Check email or domain deliverability

Paid ($0.003 USDC). Deliverability and trust check for an email address or domain. Use to vet a signup email or an inbound sender. For the domain's registration age and registrar use genesis402_whois. Returns whether it can receive mail (MX), the hosting provider, SPF and DMARC records and policy, a disposable-domain flag and a 0-5 trust score. DNS-only: no SMTP probe, no email sent, the mailbox is never contacted. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parametersemail_or_domainrequiredpayment_signature

genesis402_whois

Look up domain registration (RDAP)

Paid ($0.003 USDC). Registry data for one domain via RDAP. Young domains are a common phishing and fraud signal. Use to vet a website or counterparty domain. For mail setup (MX, SPF, DMARC) use genesis402_email_check; for page content use genesis402_web_extract. Returns registrar, registration and expiry dates, domain age in days, days to expiry, status codes, nameservers and DNSSEC state. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parametersdomainrequiredpayment_signature

genesis402_extract_json

Extract JSON fields from text

Paid ($0.006 USDC). Pull the fields you define out of unstructured text as JSON. Anything the text does not state comes back null, never invented. Use to turn emails, invoices, contracts or listings into structured data. To get a web page's text first use genesis402_web_extract. The field descriptions steer the extraction, so include units and formats (e.g. "ISO date", "number in USD"). Returns one JSON object with exactly your keys, each holding the extracted value or null. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parameterstextrequiredfieldsrequiredpayment_signature

genesis402_web_extract

Extract text from a web page

Paid ($0.004 USDC). Server-side fetch of one public web page, returned as clean readable text. Use when you need a page's actual content. To pull specific fields out of the result use genesis402_extract_json; for domain registration facts use genesis402_whois. Returns the title, meta description, readable text with markdown-style headings (capped at max_chars), up to 40 headings, up to 50 absolute links, the final URL after redirects and a SHA-256 of the fetched bytes. No JavaScript is executed, so client-rendered pages may come back thin. Private or internal addresses are refused, and pages behind a login or paywall are not accessible. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parametersurlrequiredmax_charsinclude_linkspayment_signature

genesis402_prove

Issue a signed proof receipt

Paid ($0.25 USDC). Issue one Ed25519-signed, hash-chained receipt recording that a SHA-256 digest existed at the time of payment. Use as a cheap timestamped proof that you held a document or statement. To look the receipt up later use genesis402_receipt (free). Send text (hashed by the rail, labelled OBSERVED) or a sha256 you computed yourself (labelled ATTESTED; keeps the content private), not both. Returns the receipt bound to your payment transaction, with its truth labels and limitations. It verifies offline with the open verifier at github.com/FTHTrading/402-truth. The rail stores the receipt, never your bytes. Not externally anchored on a public blockchain yet. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parameterstextclaimsha256payment_signature

genesis402_summarize

Summarize text

Paid ($0.006 USDC). Summarize long text you already have (a report, transcript, filing, thread) as a paragraph, bullet list or one-line TL;DR, within a word limit, on UnyKorn's own GPU. Use when the text is in hand; to summarize a live web page by URL instead, call the summarize-url endpoint through genesis402_call. To answer one specific question from the text use genesis402_answer_from_text. Returns the summary in the requested style as JSON. Works only from the supplied text. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parameterstextrequiredstylemax_wordspayment_signature

genesis402_answer_from_text

Answer a question from a document

Paid ($0.006 USDC). Answer one question strictly from a document you supply, and return the verbatim quote that supports the answer. Use for contract, policy, filing or email questions where the answer must be traceable to the source. For an overview rather than one answer use genesis402_summarize; to pull many named fields at once use genesis402_extract_json. Returns the answer and a supporting quote that the rail verifies appears in the text. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parameterstextrequiredquestionrequiredpayment_signature

genesis402_translate

Translate text

Paid ($0.006 USDC). Translate text into any major language while preserving names, numbers and formatting. Use for customer messages, documents or UI strings. To only identify a text's language call the language-detect endpoint through genesis402_call. Returns the translation as JSON. Payment: call once without payment_signature to get the exact price quote (nothing is charged or signed), then call again with the signed payment to receive the result and settlement details.

Parameterstorequiredfromtextrequiredpayment_signature

Version history

7
  1. v0.3.10LatestOct 6, 2026
  2. v0.3.9Oct 2, 2026
  3. v0.3.8Sep 30, 2026
  4. v0.3.5Sep 29, 2026
  5. v0.3.2Sep 26, 2026
  6. v0.3.1Sep 25, 2026
  7. v0.2.0Sep 25, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts