Genesis402 by UnyKorn (x402 pay-per-call)

genesis402-mcp

Genesis402：基于 x402，为 AI Agent 提供按调用付费的 API。

这是 Genesis402 支付通道的 MCP 服务：提供 360 个按调用付费的端点，涵盖 DeFi 和市场数据、SEC 财务数据、基于公开数据的钱包和代币风险信号、网络与域名查询、AI 文本工具，以及对 EVM 链、Solana、Bitcoin、Stellar 和 XRP Ledger 的多链读取。

只为实际调用付费：无需账户、订阅或 API 密钥。每次调用价格低至 $0.001，并在付款前显示。本软件包通过 x402 v2 使用 Base 上的 USDC 付款。

默认仅报价

默认仅报价：除非启用付款并设置价格上限，否则不会签名或付款。

默认情况下，所有付费工具都会返回报价，然后停止。要启用付款，必须同时设置 GENESIS402_LIVE=1 和 GENESIS402_PAYER_KEY。即使如此，任何高于 GENESIS402_MAX_USD（默认值为 $0.25）的报价都会被拒绝，而不会付款。

价格由支付通道设定。此客户端不会设定价格，只负责决定是否接受。

托管端点（无需安装）

将支持可流式传输 HTTP 的任意 MCP 客户端连接到 **https://twin.unykorn.org/mcp**。它为目录中的所有端点提供相同的 22 个工具。

• 托管 MCP 端点：https://twin.unykorn.org/mcp；不持有任何密钥。付费工具会返回确切的 x402 报价。
• 如需付款，请使用你自己的钱包为该报价签署 x402 v2 付款（例如使用 @x402/fetch 或 CDP/AgentKit 钱包），然后在再次调用工具时传入 payment_signature。
• 健康检查：https://twin.unykorn.org/mcp/health

安装（本地，stdio）

// Claude Desktop: claude_desktop_config.json
// Cursor:         .cursor/mcp.json
{
  "mcpServers": {
    "genesis402": {
      "command": "npx",
      "args": ["-y", "genesis402-mcp"]
    }
  }
}

此配置可以浏览目录并查看价格，但无法进行任何支出。

如需启用付款：

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

请使用专用密钥，并仅在其中存放少量 Base 上的 USDC，切勿使用主钱包。

工具（14）

每个付费工具的描述都会显示实时价格。服务器启动时会从服务端的 /.well-known/x402 清单读取价格，因此服务端上的价格变动不会导致此客户端展示过时的数字。

工具	费用	功能
genesis402_catalog	免费	列出每个端点的价格、标题、路径和参数。请先调用。
genesis402_receipt	免费	根据 ID 从公开收据动态信息源获取付费调用的收据。
genesis402_call	按端点计费	按名称调用目录中的任意端点。
genesis402_wallet_brief	付费	一次调用获取钱包风险信号：公开制裁名单检查、10 条链的扫描、活动记录和摘要，并附带证据哈希。
genesis402_token_brief	付费	代币交易前检查：元数据、价格、持有者集中度、来源验证和制裁名单信号。
genesis402_screen_sanctions	付费	基于公开数据的制裁名单信号：OFAC SDN 数字货币条目和社区屏蔽名单。
genesis402_multi_chain_scan	付费	一次调用即可扫描 10 条 EVM 链上的一个地址。
genesis402_defi_yields	付费	从 15,000 多个池中获取 DeFi 收益率，可按链、协议、代币、仅稳定币和最低 TVL 筛选。
genesis402_market_snapshot	付费	一次调用获取主流币种的价格及 24 小时和 7 天涨跌幅，也可指定最多 25 种币。
genesis402_sec_financials	付费	从 SEC XBRL 获取美国上市公司的已报告基本面数据。
genesis402_email_check	付费	电子邮件／域名可送达性：MX、服务提供商、SPF、DMARC、一次性邮箱标记。
genesis402_whois	付费	通过 RDAP 获取域名注册商、年龄、到期时间、状态和名称服务器。
genesis402_extract_json	付费	从任意文本中提取你指定的字段并输出为 JSON；缺失字段为 null，绝不捏造。
genesis402_web_extract	付费	将任意公开网页提取为干净的文本、标题、各级标题和链接。
genesis402_prove	付费	生成签名的 Ed25519 收据，将你的 SHA-256 摘要（或文本）与已结算的付款绑定。
genesis402_summarize	付费	总结你提供的文本：段落、项目符号或 TL;DR，20 到 400 个词。
genesis402_answer_from_text	付费	根据你的文档提供一个答案，并附上服务端验证确实存在于文本中的支持性引文。
genesis402_translate	付费	翻译成任意主流语言；保留名称、数字和格式。
genesis402_paper_search	付费	在 OpenAlex 中按相关性或引用量最高进行学术搜索，并提供开放获取链接。

付费调用的工作方式

1. 免费验证。 参数首先发送到服务端的免费 /__validate。无效输入会在请求报价之前被拒绝。
2. 免费报价。 未付款的请求会返回包含价格的 402 挑战。
3. 付款，仅限实时模式，且不得超过你的限额，通过标准 x402 v2 客户端完成。
4. 结果和收据。 每次付费调用都会生成一份签名收据，并列在服务端的公开收据动态信息源中。

一次付款仅可执行一次；再次提交将返回 409。

明确说明限制

• 风险和制裁结果是根据公开数据生成的自动化启发式信号。它们不是 KYC，不构成合规判定，也不是法律建议。未出现在任何名单中并不代表已获放行。
• prove 会记录一项声明，但不会对其进行评估。收据链未锚定至外部：有效收据只能证明服务端签发了该收据且未对其进行篡改，不能证明服务端无法回溯修改自己的链。

环境变量

变量	默认值	含义
GENESIS402_ORIGIN	https://twin.unykorn.org	服务端来源。
GENESIS402_LIVE	未设置	1 启用付款。其他任何值都只获取报价。
GENESIS402_PAYER_KEY	未设置	用于支付调用费用的私钥。实时模式下必填。
GENESIS402_MAX_USD	0.25	每次调用的硬性上限，会根据报价进行检查，并在签名时再次检查。超过此上限的报价将被拒绝；值为零、负数或非数值时，服务端将仅获取报价。

社区

如有疑问、反馈或需要免费交易对手报告（/check），请访问：UnyKorn Discord。

测试

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 许可。变更记录：CHANGELOG。 发现：/.well-known/x402 · 收据：/receipts