facts402: x402 API finder + fact checks

com.facts402由 facts402.com 发布v0.1.1更新于 Nov 3, 2026

Find the right paid x402 API, plus fact checks: IBAN, EU VAT, OFAC sanctions, LEI, FX

发布方自己的服务：Finder Jobs

已验证STDIO仅桌面网页搜索与抓取金融商业与电商

服务详情

标识符: com.facts402/facts402-mcp
传输: STDIO
运行时: Desktop only
信任: Verified
发布于: Nov 1, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此服务的命名空间属于 facts402.com。它以软件包形式运行，而不是托管端点，因此没有可与该域名比对的端点。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/com.facts402%2Ffacts402-mcp.svg)](https://sourceweft.com/mcp/com.facts402%2Ffacts402-mcp?utm_source=readme&utm_medium=badge)

概览

AI 生成的概览

本地 MCP 服务器，用于查找付费 x402 API，并通过 USDC 微支付执行 IBAN、欧盟 VAT、OFAC、LEI、汇率等付费核查。

可以做什么: 按任务描述推荐并预览 x402 端点，含价格、网络、买家数、存活状态与风险标记
校验标识：IBAN/BIC、经 VIES 的欧盟 VAT 号、电话号码与电子邮箱
对 OFAC SDN 制裁名单做名称筛查，并在 GLEIF LEI 索引中查询企业
按欧洲央行参考汇率换算货币，并通过 RDAP 获取域名注册信息
统计工作日与公共假日，获取天气预报和日出日落时间
读取 Base 上 ERC-20 代币合约的链上原始事实
适用场景: 适合在付款、开票、企业入驻、交易对手筛查或外联前需要小而准确的答案时使用，也适合需要判断该调用哪个付费 x402 API 的场景。
运行要求: 通过 uvx 在本地运行（Python/uv）。付费工具需要 X402_PRIVATE_KEY 中持有 USDC 的 Base 主网钱包私钥；没有它只能使用免费预览。可选上限 X402_MAX_PER_CALL_USD（默认 0.30）和 X402_SESSION_BUDGET_USD（默认 2.00）。需要网络访问。

安装前请注意

需要钱包私钥（X402_PRIVATE_KEY）来签署 USDC 支付；请使用余额很少的专用热钱包，并避免把密钥提交到版本控制。调用会真实花钱：推荐 $0.005，每次核查 $0.01，受单次和会话上限约束。查询内容和标识会发送给 facts402 及 VIES、GLEIF、OFAC、ECB、MET Norway 等上游来源。

安装

在 SourceWeft 中

打开控制台中的 facts402: x402 API finder + fact checks，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照仓库中的启动说明。

README

facts402-mcp

Find the right paid API for a task, and verified fact checks for AI agents. Before an agent pays an unknown API, x402_recommend ranks the x402 endpoints that fit the task by relevance, real on-chain buyers and liveness, for $0.005 (the preview is free). And at $0.01 per call: validate an IBAN before a payout. Check an EU VAT number in VIES before invoicing. Screen a name against OFAC sanctions. Look up a company's LEI. Validate a phone number or email before outreach. Convert currency at official ECB rates. Check how old a domain is. These are small, exact answers an agent can rely on, with no API keys or sign-up.

Pay per call with x402: USDC on Base, from your own wallet, within a per-call cap and a session budget you set.

Tools

Tool	Price (USDC)	Use it to
`x402_recommend`	$0.005	Find the best paid x402 endpoints for a task: url, price, network, 30-day buyers, liveness, risk flags, score
`x402_recommend_preview`	free	See the single top pick (host, price, buyers) for a task
`iban_check`	$0.01	Validate an IBAN and get bank name, BIC and SEPA membership
`eu_vat_check`	$0.01	Check an EU VAT number in VIES: status, company name and address
`sanctions_screen`	$0.01	Fuzzy-screen a person, company, vessel or aircraft against the OFAC SDN list
`lei_lookup`	$0.01	Look up a company in the GLEIF LEI index, by LEI or by name
`phone_check`	$0.01	Validate and normalise a phone number: E.164, line type, carrier, time zone
`email_check`	$0.01	Check email syntax, MX, disposable and role-account flags
`fx_convert`	$0.01	Convert currency at ECB reference rates, for the latest day or any of the last 90
`domain_check`	$0.01	Get a domain's age, registrar, status and DNSSEC via RDAP (WHOIS)
`business_days`	$0.01	Count business days and list public holidays between two dates
`weather_forecast`	$0.01	Get a forecast for any coordinates, up to 7 days
`sun_times`	$0.01	Get sunrise, sunset, golden hour and day length
`base_token_check`	$0.01	Get raw on-chain facts for a Base ERC-20 contract (owner, proxy, mint / pause / blacklist)

The service charges only for a successful (2xx) answer: invalid input, upstream errors and a recommend query with no match (404) are never charged. Recommendations use the x402-list.com catalog (CC BY 4.0) and sellers' own 402 quotes, filtered and re-scored by facts402; facts402's own APIs are ranked with the same formula. For Base memecoin trading safety (honeypot, rug pull, exit liquidity, smart money), see base-memecoin-guard-mcp.

Payments and limits

Variable	Default	Meaning
`X402_PRIVATE_KEY`	(unset)	Private key of a Base mainnet wallet you control that holds some USDC. Without it, `x402_recommend_preview` works and the paid tools return their price and setup steps, paying nothing.
`X402_MAX_PER_CALL_USD`	`0.30`	The most one call may pay.
`X402_SESSION_BUDGET_USD`	`2.00`	The most the server may spend until it restarts.

Use a dedicated hot wallet with a small balance. One dollar of USDC buys 100 checks or 200 recommendations.
No ETH is needed: x402 exact payments are gasless EIP-3009 USDC authorisations.
The key stays on your machine. It is never logged or returned, and it signs only the one request you made.
Payments go only to the facts402 receiving address (0x5498b0Aa90cd56F8962CBd136DF3D3769C85f149). A quote for any other payee, any other token or a Permit2 approval is refused.
Every paid answer comes with a receipt: amount, transaction hash and session totals.

Install

The server runs with uv (uvx facts402-mcp).

Claude Desktop

Add this to claude_desktop_config.json (Settings > Developer > Edit Config):

json

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

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

bash

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

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

Cursor

Use ~/.cursor/mcp.json (global) or .cursor/mcp.json (project; keep the key out of version control):

json

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

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

Windsurf

Use ~/.codeium/windsurf/mcp_config.json:

json

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

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

Example prompts

"Which paid API should I use for web search? Show me the cheapest live one with real buyers."
"Validate IBAN DE89 3704 0044 0532 0130 00 and tell me the bank."
"Is IE6388047V a valid VAT number? What company is it?"
"Screen 'Banco Nacional de Cuba' against OFAC sanctions."
"How many business days are there in Germany between 21 Dec 2026 and 8 Jan 2027?"

Development (both servers)

This folder also holds the shared core used by base-memecoin-guard-mcp: the HTTP caller, the x402 wallet, the budget and the server plumbing. From A2A_MICROPAYMENTS_TRACK/mcp:

bash

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

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

来源：facts402-mcp/README.md，提交 6120ebc

工具

iban_check

IBAN and BIC validation

Validate an IBAN (structure, mod-97 and national BBAN checksum) and return country, bank code, account code, bank name, BIC/SWIFT and SEPA membership. Use before a payout, invoice or SEPA transfer. Price: $0.01 USDC per call via x402 on Base, paid from your own wallet (X402_PRIVATE_KEY) within your per-call cap and session budget; charged only for a successful answer.

输入参数iban必填

eu_vat_check

EU VAT number check (VIES)

Validate an EU VAT number: offline format and check-digit test plus a live lookup in the European Commission VIES, returning registration status, company name and address. For B2B invoicing, reverse charge, KYB and onboarding. Price: $0.01 USDC per call via x402 on Base, paid from your own wallet (X402_PRIVATE_KEY) within your per-call cap and session budget; charged only for a successful answer.

输入参数vat_number必填

sanctions_screen

OFAC sanctions screening

Fuzzy-screen a person, company, vessel or aircraft name against the US Treasury OFAC SDN sanctions list including aliases (refreshed every 6 h): matches with score, type, sanctions programs and remarks, plus the closest near-miss. AML / KYC / KYB compliance screening aid. Price: $0.01 USDC per call via x402 on Base, paid from your own wallet (X402_PRIVATE_KEY) within your per-call cap and session budget; charged only for a successful answer.

输入参数name必填min_scoreentity_type

lei_lookup

LEI company lookup (GLEIF)

Look up a legal entity in the official GLEIF LEI index: by 20-character LEI get legal name, status, jurisdiction, addresses, registration dates and direct/ultimate parent; or search by company name for up to 5 candidates. For KYB, onboarding and finance agents. Price: $0.01 USDC per call via x402 on Base, paid from your own wallet (X402_PRIVATE_KEY) within your per-call cap and session budget; charged only for a successful answer.

输入参数leiname

phone_check

Phone number validation

Validate and normalise any phone number worldwide: valid/possible, E.164 and national formats, country, line type (mobile, fixed line, toll-free, VoIP), original carrier, location and time zones. For CRM, outreach, KYC and calling agents. Price: $0.01 USDC per call via x402 on Base, paid from your own wallet (X402_PRIVATE_KEY) within your per-call cap and session budget; charged only for a successful answer.

输入参数number必填default_region

email_check

Email address check

Check an email address before sending: RFC syntax and normalisation, live DNS and MX records, null MX, disposable/throwaway domain and role-account (info@, support@) flags. No SMTP probing. For lead-gen, signup and outreach agents. Price: $0.01 USDC per call via x402 on Base, paid from your own wallet (X402_PRIVATE_KEY) within your per-call cap and session budget; charged only for a successful answer.

输入参数email必填

fx_convert

ECB currency conversion

Convert an amount between ~30 currencies at official European Central Bank (ECB) reference exchange rates, latest or any day in the last 90 days, with the publication date used and exact decimal results. For pricing, invoicing, travel-budget and accounting agents. Price: $0.01 USDC per call via x402 on Base, paid from your own wallet (X402_PRIVATE_KEY) within your per-call cap and session budget; charged only for a successful answer.

输入参数to必填datefrom必填amount必填

domain_check

Domain age and RDAP/WHOIS

Registration facts for any domain via RDAP (the WHOIS successor): registered or not, creation and expiry dates, domain age in days, registrar, EPP status, nameservers and DNSSEC. For fraud, phishing link-safety, lead-qualification and KYB agents. Price: $0.01 USDC per call via x402 on Base, paid from your own wallet (X402_PRIVATE_KEY) within your per-call cap and session budget; charged only for a successful answer.

输入参数domain必填

business_days

Business days and public holidays

Count business days between two dates for a country (optionally a state/region) and list the public holidays and weekends in the range. For payment deadlines, SLAs, delivery dates and scheduling. Price: $0.01 USDC per call via x402 on Base, paid from your own wallet (X402_PRIVATE_KEY) within your per-call cap and session budget; charged only for a successful answer.

输入参数end必填start必填country必填subdivision

weather_forecast

Weather forecast

Weather forecast for any latitude/longitude: current conditions plus up to 7 local-day summaries (min/max temperature, precipitation, wind, weather symbol) in the place's own time zone. Data from MET Norway. For travel, events and logistics agents. Price: $0.01 USDC per call via x402 on Base, paid from your own wallet (X402_PRIVATE_KEY) within your per-call cap and session budget; charged only for a successful answer.

输入参数lat必填lon必填days

sun_times

Sunrise and sunset times

Sunrise, sunset, solar noon, civil dawn/dusk, golden hour and day length for any coordinates and date, in local time; polar day/night flagged. For travel, photography, events and outdoor planning. Price: $0.01 USDC per call via x402 on Base, paid from your own wallet (X402_PRIVATE_KEY) within your per-call cap and session budget; charged only for a successful answer.

输入参数lat必填lon必填date

base_token_check

Base token contract facts

Raw on-chain facts for a Base mainnet ERC-20 token contract, read at one block: is it a contract, EIP-1967 proxy / implementation / admin, name, symbol, decimals, totalSupply, owner, and whether mint, pause or blacklist function selectors appear in the bytecode. Facts only, no rating. Price: $0.01 USDC per call via x402 on Base, paid from your own wallet (X402_PRIVATE_KEY) within your per-call cap and session budget; charged only for a successful answer.

输入参数token必填