facts402: x402 API finder + fact checks

facts402-mcp

为任务找到合适的付费 API，并为 AI Agent 提供经过验证的事实核查。 在 Agent 为未知 API 付费之前，x402_recommend 会根据相关性、链上真实买家和服务可用性，对适合该任务的 x402 端点进行排序，费用为 $0.005（免费预览）。每次调用仅需 $0.01：在付款前验证 IBAN。开具发票前，在 VIES 查询欧盟 VAT 号码。根据 OFAC 制裁名单筛查姓名。查询公司的 LEI。联系对方前验证电话号码或电子邮件。按欧洲央行官方汇率换算货币。查询域名的注册年限。这些都是 Agent 可以信赖的简明、准确答案，无需 API 密钥或注册。

通过 x402 按次付费：使用 Base 上的 USDC，从你自己的钱包支付，并受你设定的单次调用限额和会话预算约束。

工具

工具	价格（USDC）	用途
x402_recommend	$0.005	为任务找到最佳付费 x402 端点：url、价格、网络、近 30 天买家数、服务可用性、风险标记、评分
x402_recommend_preview	免费	查看任务的首选结果（主机、价格、买家数）
iban_check	$0.01	验证 IBAN，并获取银行名称、BIC 和 SEPA 成员资格
eu_vat_check	$0.01	在 VIES 查询欧盟 VAT 号码：状态、公司名称和地址
sanctions_screen	$0.01	根据 OFAC SDN 名单模糊筛查个人、公司、船只或飞机
lei_lookup	$0.01	按 LEI 或名称查询 GLEIF LEI 索引中的公司
phone_check	$0.01	验证并规范化电话号码：E.164、线路类型、运营商、时区
email_check	$0.01	检查电子邮件语法、MX、一次性邮箱和角色账户标记
fx_convert	$0.01	按欧洲央行参考汇率换算货币，支持最近一天或过去 90 天内任意日期
domain_check	$0.01	通过 RDAP（WHOIS）获取域名的注册年限、注册商、状态和 DNSSEC 信息
business_days	$0.01	计算两个日期之间的工作日数并列出公共假日
weather_forecast	$0.01	获取任意坐标的天气预报，最长可达 7 天
sun_times	$0.01	获取日出、日落、黄金时段和白昼时长
base_token_check	$0.01	获取 Base ERC-20 合约的原始链上事实（所有者、代理、铸造 / 暂停 / 黑名单）

服务仅对成功（2xx）的回答收费：无效输入、上游错误，以及没有匹配结果的推荐查询（404）均不收费。推荐结果使用 x402-list.com 目录（CC BY 4.0）和卖家自己的 402 报价，由 facts402 进行筛选和重新评分；facts402 自有 API 也按相同公式排序。 如需检查 Base 上的 memecoin 交易安全性（蜜罐、rug pull、退出流动性、聪明钱），请参阅 base-memecoin-guard-mcp。

付款与限制

变量	默认值	说明
X402_PRIVATE_KEY	(未设置)	你控制且持有一定 USDC 的 Base 主网钱包的私钥。未设置时，x402_recommend_preview 可用，付费工具会返回价格和设置步骤，但不会扣款。
X402_MAX_PER_CALL_USD	0.30	单次调用最多可支付的金额。
X402_SESSION_BUDGET_USD	2.00	服务重启前最多可支出的金额。

• 使用余额较少的专用热钱包。1 美元的 USDC 可支付 100 次检查或 200 次推荐。
• 无需 ETH：x402 exact 付款使用免 Gas 的 EIP-3009 USDC 授权。
• 密钥保留在你的设备上。它绝不会被记录或返回，且只会为你发起的那一次请求签名。
• 付款仅会发送至 facts402 收款地址 (0x5498b0Aa90cd56F8962CBd136DF3D3769C85f149)。任何其他收款方、其他代币或 Permit2 授权的报价都会被拒绝。
• 每份付费回答都附带收据：金额、交易哈希和会话总额。

安装

服务使用 uv 运行（uvx facts402-mcp）。

Claude Desktop

将以下内容添加到 claude_desktop_config.json（Settings > Developer > Edit Config）：

{
  "mcpServers": {
    "facts402": {
      "command": "uvx",
      "args": ["facts402-mcp"],
      "env": {
        "X402_PRIVATE_KEY": "0xYOUR_HOT_WALLET_KEY",
        "X402_MAX_PER_CALL_USD": "0.30",
        "X402_SESSION_BUDGET_USD": "2.00"
      }
    }
  }
}

Claude Code

claude mcp add facts402 --scope user -e X402_PRIVATE_KEY=0xYOUR_HOT_WALLET_KEY -- uvx facts402-mcp

Cursor

使用 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目；请勿将密钥纳入版本控制）：

{
  "mcpServers": {
    "facts402": {
      "command": "uvx",
      "args": ["facts402-mcp"],
      "env": { "X402_PRIVATE_KEY": "0xYOUR_HOT_WALLET_KEY" }
    }
  }
}

Windsurf

使用 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "facts402": {
      "command": "uvx",
      "args": ["facts402-mcp"],
      "env": { "X402_PRIVATE_KEY": "0xYOUR_HOT_WALLET_KEY" }
    }
  }
}

示例提示词

• “我应该使用哪个付费 API 进行网页搜索？请告诉我当前最便宜且有真实买家的 API。”
• “验证 IBAN DE89 3704 0044 0532 0130 00，并告诉我所属银行。”
• “IE6388047V 是有效的 VAT 号码吗？对应的公司是哪家？”
• “根据 OFAC 制裁名单筛查 ‘Banco Nacional de Cuba’。”
• “2026 年 12 月 21 日至 2027 年 1 月 8 日期间，德国有多少个工作日？”

开发（两个服务）

此文件夹还包含 base-memecoin-guard-mcp 使用的共享核心：HTTP 调用器、x402 钱包、预算和服务基础设施。在 A2A_MICROPAYMENTS_TRACK/mcp 中运行：

python -m venv .venv
.venv/bin/pip install -e "./facts402-mcp[test]" -e "./base-memecoin-guard-mcp[test]"
.venv/bin/pytest facts402-mcp && .venv/bin/pytest base-memecoin-guard-mcp     # unit tests, mocked HTTP
.venv/bin/pytest -m live facts402-mcp && .venv/bin/pytest -m live base-memecoin-guard-mcp   # live, never pays
.venv/bin/python scripts/sync_schemas.py     # refresh input schemas and prices from the live /openapi.json
.venv/bin/python scripts/write_manifest.py   # refresh each manifest.json (MCPB) from the code