{
  "markdown": "# EuroValidate MCP Server\n\nMCP ([Model Context Protocol](https://modelcontextprotocol.io)) server for [EuroValidate](https://eurovalidate.com) — lets Claude, ChatGPT and any MCP-capable agent **validate EU VAT numbers (VIES), IBANs and EORI customs numbers, look up company data, and fetch VAT rates** through one reliable REST API.\n\n## Why\n\nValidating European business data normally means juggling five fragmented government services: the VIES SOAP API (which times out constantly — Germany alone generates 95% of its errors), the EC EORI endpoint, HMRC, GLEIF, and national registries. EuroValidate wraps them into one cache-first JSON API with per-country circuit breakers and graceful degradation — and this MCP server exposes it to LLM agents as ready-to-use tools.\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `validate_vat` | Validate an EU/UK VAT number via VIES/HMRC — returns validity + registered company name & address (where the member state exposes it) + confidence level |\n| `validate_iban` | Validate an IBAN (offline MOD-97) and resolve bank name + BIC |\n| `validate_eori` | Validate an EORI customs number (EU / GB / XI Northern Ireland) |\n| `lookup_company_by_lei` | Company data by Legal Entity Identifier (GLEIF) |\n| `lookup_company_by_vat` | Company data by VAT number — fallback for DE/ES where VIES hides names |\n| `get_vat_rates` | Current VAT rates for an EU country |\n| `check_service_status` | Live health of VIES (per country), EORI, HMRC, GLEIF — no API key needed |\n\n## Setup\n\n1. Get a **free API key** (100 requests/month, no credit card) at [eurovalidate.com](https://eurovalidate.com).\n2. Add the server to your MCP client:\n\n### Claude Desktop / Claude Code\n\n```json\n{\n  \"mcpServers\": {\n    \"eurovalidate\": {\n      \"command\": \"uvx\",\n      \"args\": [\"eurovalidate-mcp\"],\n      \"env\": { \"EUROVALIDATE_API_KEY\": \"your_api_key\" }\n    }\n  }\n}\n```\n\nClaude Code one-liner:\n\n```bash\nclaude mcp add eurovalidate -e EUROVALIDATE_API_KEY=your_api_key -- uvx eurovalidate-mcp\n```\n\n### Any other MCP client\n\nRun over stdio:\n\n```bash\nEUROVALIDATE_API_KEY=your_api_key uvx eurovalidate-mcp\n```\n\nOr install permanently: `pip install eurovalidate-mcp` → `eurovalidate-mcp`.\n\n## Example prompts\n\n- *\"Validate VAT number DE811569869 and tell me the company behind it\"*\n- *\"Check if this IBAN is valid and which bank it belongs to: DE89 3704 0044 0532 0130 00\"*\n- *\"Is VIES down for Germany right now?\"*\n- *\"What's the VAT rate in Portugal?\"*\n- *\"Validate the VAT numbers of these 5 suppliers before I invoice them\"*\n\n## Notes for agents (and humans)\n\n- **Germany and Spain never return company name/address** over VIES (data-protection law) — use `lookup_company_by_vat` as a fallback.\n- **Greece** is `EL` in VIES but `GR` in ISO 3166 — both are accepted.\n- Every response carries `confidence: HIGH|MEDIUM|LOW|UNKNOWN` and the upstream `source`, so agents can reason about data freshness when a government service is down.\n- Free tier: 100 requests/month. Paid plans from €19/mo (500,000 requests/month) at [eurovalidate.com](https://eurovalidate.com).\n\n## Environment variables\n\n| Variable | Required | Default |\n|---|---|---|\n| `EUROVALIDATE_API_KEY` | yes (except `check_service_status`) | — |\n| `EUROVALIDATE_BASE_URL` | no | `https://api.eurovalidate.com` |\n\n## License\n\nMIT\n\n---\nmcp-name: io.github.Nitrych/eurovalidate-mcp\n",
  "bytes": 3348,
  "sha": "c4ce0bbade3b5eff7aea9087ebe388fd38bcd0dc29fa63fe3dda4075bda6cf98",
  "repo_slug": "nitrych/eurovalidate-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_nitrych_eurovalidate_mcp_b11b4c7a/readme"
}