facts402: x402 API finder + fact checks
Pay-per-call fact checks (IBAN, EU VAT, OFAC, LEI, FX) and an x402 API finder
- Pricing
- Freemium
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.1.1
- Listing updated
- 3 days ago
About facts402: x402 API finder + fact checks
facts402: x402 API finder + fact checks is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
The pitch is small, exact answers an agent can buy one at a time instead of holding API keys: validate an IBAN before a payout, check an EU VAT number in VIES before invoicing, fuzzy-screen a name against the OFAC list, or look up a company's LEI. Utility lookups cover phone and email validation, ECB exchange rates for the last 90 days, domain age via RDAP, business days and holidays, weather and sunrise times. A final tool returns raw on-chain facts for a Base token contract.
The standout is x402_recommend, which ranks paid x402 endpoints for a task by relevance, real buyers and liveness, using the x402-list.com catalogue (CC BY 4.0) plus sellers' own quotes. A free preview returns just the top pick.
Payments run through x402 in USDC on Base from your own wallet. Gasless authorisations mean no ETH is needed, payments go only to the facts402 address, and a per-call cap and session budget can be set. Without a wallet key only the preview tool works; paid tools return their price and setup steps. Failed requests and no-match queries are not charged.
Install
Run in a terminal
claude mcp add facts402-mcp --env X402_PRIVATE_KEY='<X402_PRIVATE_KEY>' -- uvx facts402-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"facts402-mcp": {
"command": "uvx",
"args": [
"facts402-mcp"
],
"env": {
"X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"facts402-mcp": {
"command": "uvx",
"args": [
"facts402-mcp"
],
"env": {
"X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"facts402-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"facts402-mcp"
],
"env": {
"X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"facts402-mcp": {
"command": "uvx",
"args": [
"facts402-mcp"
],
"env": {
"X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"facts402-mcp": {
"command": "uvx",
"args": [
"facts402-mcp"
],
"env": {
"X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
}
}
}
}Configuration
X402_PRIVATE_KEYPrivate key of your own Base mainnet wallet holding a little USDC. Optional: without it only the free tools work.X402_MAX_PER_CALL_USDMost a single tool call may pay, in USDX402_SESSION_BUDGET_USDMost the server may spend until it restarts, in USD
Tools this server provides (14)
Taken from the project documentation; the running server may differ.
- x402_recommend
- Ranks paid x402 endpoints for a task.
- x402_recommend_preview
- Free top pick for a task.
- iban_check
- Validates an IBAN and returns bank name, BIC and SEPA membership.
- eu_vat_check
- Checks an EU VAT number in VIES.
- sanctions_screen
- Screens a name against the OFAC SDN list.
- lei_lookup
- Looks up a company in the GLEIF LEI index.
- phone_check
- Validates and normalises a phone number.
- email_check
- Checks email syntax, MX and disposable flags.
- fx_convert
- Converts currency at ECB reference rates.
- domain_check
- Domain age, registrar and DNSSEC via RDAP.
- business_days
- Counts business days and lists holidays.
- weather_forecast
- Forecast for coordinates up to 7 days.
- sun_times
- Sunrise, sunset, golden hour and day length.
- base_token_check
- Raw on-chain facts for a Base ERC-20 contract.
What it does
- API recommendation
- Ranks paid x402 endpoints for a task by relevance, buyers, liveness and risk flags.
- Compliance lookups
- Checks IBANs, EU VAT numbers, OFAC sanctions and LEIs.
- Contact validation
- Validates phone numbers and email addresses with line type, MX and disposable flags.
- Reference data
- Converts currency at ECB rates, reports domain age and counts business days.
- Weather and sun times
- Returns forecasts up to 7 days and sunrise, sunset and golden hour.
- Spend controls
- Per-call cap, session budget and receipts for each paid answer.
Good for
- Validate an IBAN before an agent triggers a payout
- Verify a supplier's EU VAT number before invoicing
- Screen a counterparty name against the OFAC list
- Find the cheapest live paid API for a task
- Check email or phone quality before outreach
Pricing
Freemium
One free preview tool; other tools $0.005 to $0.01 per call in USDC on Base
Prices change. Check api.facts402.com before you buy.
facts402: x402 API finder + fact checks FAQ
What does each call cost?
$0.01 USDC for most checks and $0.005 for x402_recommend; the recommend preview is free.
Do I need ETH for gas?
No. The README says x402 exact payments are gasless EIP-3009 USDC authorisations.
Where do payments go?
Only to the facts402 receiving address; quotes for other payees or tokens are refused.
Am I charged for errors?
No. Invalid input, upstream errors and no-match recommend queries are not charged.
Is facts402: x402 API finder + fact checks free?
facts402: x402 API finder + fact checks has a free plan, with paid plans for more usage or features.
How do I add facts402: x402 API finder + fact checks to Claude Code?
Run this command in your terminal: claude mcp add facts402-mcp --env X402_PRIVATE_KEY='<X402_PRIVATE_KEY>' -- uvx facts402-mcp
What are the best alternatives to facts402: x402 API finder + fact checks?
The closest alternatives to facts402: x402 API finder + fact checks are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to facts402: x402 API finder + fact checks

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools