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 分