Skip to content
MCP server

facts402: x402 API finder + fact checks

Pay-per-call fact checks (IBAN, EU VAT, OFAC, LEI, FX) and an x402 API finder

Runs locallyStatus and history
Install
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-mcp

Add 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 USD
  • X402_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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools