Genesis402 by UnyKorn (x402 pay-per-call)

io.github.FTHTrading由 GitHub 帳號 FTHTrading 發布v0.3.10更新於 Oct 24, 2026

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

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取金融安全與監控

概覽

AI 產生的概覽

Genesis402 讓助理按次付費呼叫 360 多個 x402 介面,用於制裁篩查、公司查詢、加密錢包與代幣風險、網頁與網域查核以及 AI 文字處理。

可以做什麼
瀏覽介面目錄並依 id 查詢付費呼叫回執,皆免費且唯讀。依名稱呼叫目錄中的任一介面,涵蓋 DeFi、SEC、研究與多鏈讀取。查核交易對手:制裁名單姓名與地址篩查、公司與 LEI 查詢、錢包與代幣風險簡報、多鏈掃描。取得市場與財務資料:DeFi 收益率、加密價格快照、SEC XBRL 基本面、OpenAlex 論文檢索。查核網頁與電子郵件:網頁正文擷取、WHOIS/RDAP 網域資訊、郵件可達性與 SPF/DMARC 檢查。處理文字:欄位擷取為 JSON、摘要、附原文引用的問答、翻譯以及附簽章的存證。
適用情境
適合助理需要臨時進行交易對手盡職調查、制裁或錢包風險訊號、公司登記資訊、加密市場資料,或小型文字處理任務,而你不願為每家資料來源個別開戶或申請 API 金鑰、寧願按次支付幾分錢的情境。
執行需求
可作為不持有金鑰的遠端 streamable HTTP 端點使用,也可透過 npx genesis402-mcp 以 stdio 在本機執行(需 Node.js)。付費需設定 GENESIS402_LIVE=1 與 GENESIS402_PAYER_KEY(持有 USDC 的 Base 錢包私鑰),GENESIS402_MAX_USD 限制單次費用。需要能連線至該服務的網路。
安裝前請注意
付費工具會花費真實的 Base 鏈上 USDC;付款金鑰是私鑰,應使用餘額很少的專用錢包,絕不要用主錢包。預設僅報價,未開啟即時模式前不會簽章或付款。風險與制裁結果是基於公開資料的自動啟發式訊號,不構成 KYC、合規認定或法律意見,未命中名單也不等於清白。存證回執未做外部錨定。傳送給該服務的文字與地址會交給第三方。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Genesis402 by UnyKorn (x402 pay-per-call),將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.FTHTrading%2Fgenesis402-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

來源:mcp/README.md,提交 e06266f

工具

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.

輸入參數filter

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.

輸入參數receipt_id必填

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.

輸入參數paramsendpoint必填payment_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.

輸入參數typequery必填payment_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.

輸入參數name必填typedob_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.

輸入參數query必填payment_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.

輸入參數chainaddress必填payment_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.

輸入參數chaincontract必填payment_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.

輸入參數address必填payment_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.

輸入參數address必填payment_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.

輸入參數sortchainlimittokenprojectmin_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.

輸入參數coinspayment_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.

輸入參數ciktickerpayment_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.

輸入參數email_or_domain必填payment_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.

輸入參數domain必填payment_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.

輸入參數text必填fields必填payment_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.

輸入參數url必填max_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.

輸入參數textclaimsha256payment_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.

輸入參數text必填stylemax_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.

輸入參數text必填question必填payment_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.

輸入參數to必填fromtext必填payment_signature

版本歷史

7
  1. v0.3.10最新Oct 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

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分