# facts402: x402 API finder + fact checks

> facts402: x402 API finder + fact checks is a freemium MCP server for finance and payments. Pay-per-call fact checks (IBAN, EU VAT, OFAC, LEI, FX) and an x402 API finder. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://api.facts402.com
- **Repository:** https://github.com/veselin9931/facts402-mcp/tree/HEAD/facts402-mcp
- **MCP Registry name:** com.facts402/facts402-mcp
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add facts402-mcp --env X402_PRIVATE_KEY='<X402_PRIVATE_KEY>' -- uvx facts402-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "facts402-mcp": {
      "command": "uvx",
      "args": [
        "facts402-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "facts402-mcp": {
      "command": "uvx",
      "args": [
        "facts402-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "facts402-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "facts402-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "facts402-mcp": {
      "command": "uvx",
      "args": [
        "facts402-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "facts402-mcp": {
      "command": "uvx",
      "args": [
        "facts402-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/facts402-x402-api-finder-fact-checks
