io.github.nitrych/eurovalidate-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@io.github.nitrych/eurovalidate-mcp What's the VAT rate in Portugal?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
EuroValidate MCP Server
MCP (Model Context Protocol) server for EuroValidate — 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.
Why
Validating 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.
Related MCP server: commerce-validators
Tools
Tool | What it does |
| Validate an EU/UK VAT number via VIES/HMRC — returns validity + registered company name & address (where the member state exposes it) + confidence level |
| Validate an IBAN (offline MOD-97) and resolve bank name + BIC |
| Validate an EORI customs number (EU / GB / XI Northern Ireland) |
| Company data by Legal Entity Identifier (GLEIF) |
| Company data by VAT number — fallback for DE/ES where VIES hides names |
| Current VAT rates for an EU country |
| Live health of VIES (per country), EORI, HMRC, GLEIF — no API key needed |
Setup
Get a free API key (100 requests/month, no credit card) at eurovalidate.com.
Add the server to your MCP client:
Claude Desktop / Claude Code
{
"mcpServers": {
"eurovalidate": {
"command": "uvx",
"args": ["eurovalidate-mcp"],
"env": { "EUROVALIDATE_API_KEY": "your_api_key" }
}
}
}Claude Code one-liner:
claude mcp add eurovalidate -e EUROVALIDATE_API_KEY=your_api_key -- uvx eurovalidate-mcpAny other MCP client
Run over stdio:
EUROVALIDATE_API_KEY=your_api_key uvx eurovalidate-mcpOr install permanently: pip install eurovalidate-mcp → eurovalidate-mcp.
Example prompts
"Validate VAT number DE811569869 and tell me the company behind it"
"Check if this IBAN is valid and which bank it belongs to: DE89 3704 0044 0532 0130 00"
"Is VIES down for Germany right now?"
"What's the VAT rate in Portugal?"
"Validate the VAT numbers of these 5 suppliers before I invoice them"
Notes for agents (and humans)
Germany and Spain never return company name/address over VIES (data-protection law) — use
lookup_company_by_vatas a fallback.Greece is
ELin VIES butGRin ISO 3166 — both are accepted.Every response carries
confidence: HIGH|MEDIUM|LOW|UNKNOWNand the upstreamsource, so agents can reason about data freshness when a government service is down.Free tier: 100 requests/month. Paid plans from €19/mo (500,000 requests/month) at eurovalidate.com.
Agent Skill
skills/eu-business-validation/SKILL.md is a portable Agent Skill that teaches an agent when to validate, how to read status/confidence correctly (e.g. unavailable ≠ invalid), the DE/ES/EL/XI gotchas, and how to write checkout/KYB code that never blocks a sale when VIES is down. It works with this MCP server or falls back to plain REST calls.
# Claude Code (personal skills)
mkdir -p ~/.claude/skills && cp -r skills/eu-business-validation ~/.claude/skills/Claude plugin
This repository is also a Claude plugin bundle (.claude-plugin/plugin.json): it installs the skill above plus this MCP server, pinned to eurovalidate-mcp==0.1.1 and launched with uvx. On install you are asked for your EuroValidate API key; it is stored in Claude's secure credential store and passed only to the MCP server as EUROVALIDATE_API_KEY.
Data and network
The MCP server and the skill send only the identifiers you ask to check (VAT, IBAN, EORI, LEI numbers or a country code) to
https://api.eurovalidate.com, together with your API key in theX-API-Keyheader.check_service_statussends no identifiers and needs no key.Nothing else is read from your machine or sent anywhere else. No telemetry.
EuroValidate in turn queries public government services (EU VIES, EC EORI, UK HMRC, GLEIF) and caches results (VAT/EORI 24 h, IBAN 1 h). See the privacy policy and terms.
uvxdownloads theeurovalidate-mcppackage from PyPI on first run.
Environment variables
Variable | Required | Default |
| yes (except | — |
| no |
|
License
MIT
mcp-name: io.github.Nitrych/eurovalidate-mcp
Available Tools
7 toolscheck_service_statusA
Check live health of upstream government services (VIES per-country, EORI, HMRC, GLEIF).
Public endpoint — works without an API key. Use it to explain why a validation returned reduced confidence (e.g. Germany's VIES endpoint down).
Inputs: no named parameters. Returns: object
get_vat_ratesA
Get current VAT rates (standard/reduced) for an EU country by ISO 3166-1 alpha-2 code.
Inputs: country_code (required). Returns: object
lookup_company_by_leiB
Look up company data (legal name, address, status) by LEI via GLEIF.
Inputs: lei (required). Returns: object
lookup_company_by_vatB
Look up company data by VAT number (GLEIF cross-reference).
Useful as a fallback for German/Spanish VAT numbers where VIES returns no company name/address by law.
Inputs: vat_number (required). Returns: object
validate_eoriB
Validate an EORI customs number (EU via EC, GB via HMRC, XI for Northern Ireland).
Inputs: eori_number (required). Returns: object
validate_ibanA
Validate an IBAN (offline MOD-97 checksum) and resolve the bank name and BIC.
Covers all SEPA countries. Accepts the IBAN with or without spaces.
Inputs: iban (required). Returns: object
validate_vatA
Validate an EU or UK VAT number via VIES/HMRC.
Returns validity, registered company name and address where the member state exposes them (Germany and Spain never do), a confidence level, and the upstream source. Accepts the number with or without country prefix (e.g. "DE123456789" or "123456789" + country_code="DE"). Greece: EL or GR both work.
Inputs: vat_number (required), country_code. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools target distinct identifier types (IBAN, VAT, EORI, LEI, VAT rates, service status), but 'validate_vat' and 'lookup_company_by_vat' both accept VAT numbers and return company information, which could cause confusion. Descriptions help, but the overlap is real.
All tools use a consistent verb_noun pattern in snake_case (validate_*, lookup_company_by_*, get_*, check_*). The practice is uniform and predictable, making it easy for an agent to infer tool purpose from its name.
Seven tools is well within the ideal range for a domain-specific server. Each tool addresses a clear need (IBAN, VAT, EORI, LEI, VAT rates, and service status) without redundancy or bloat, making the set feel appropriately scoped.
The server covers the core European identifier validation landscape: bank accounts, VAT numbers, customs numbers, company lookup via LEI or VAT, VAT rates, and upstream service health. This is a complete surface for its stated purpose, with no obvious dead ends or missing critical operations.
Related MCP Connectors
Validate EU, UK, AU VAT numbers for AI agents. EU ViDA e-invoicing compliance.
AI VAT Number Validation: hosted MCP server for EU VAT number checks via VIES.
EU VIES VAT-number validation MCP (European Commission).
Commerce validators: live EU VAT (VIES), EORI, email/MX lookups; IBAN/ABA/GTIN checksums; VAT rates.
Related MCP Servers
- AlicenseAqualityCmaintenanceLocal MCP server for validating EU VAT numbers using the official VIES API. Enables AI to check VAT validity and optionally retrieve consultation numbers for legal proof.2MIT
- FlicenseNot gradedqualityCmaintenanceProvides real validation and live registry lookups for ecommerce and fintech workflows, including EU VAT, EORI, email domain, IBAN, ABA routing, and GTIN checks.-
- AlicenseAqualityBmaintenanceEnables users to validate EU VAT numbers through the official VIES SOAP API, with free local format checks, caching, and bilingual error messages. Supports compliance workflows by returning structured results, supported countries, and error-code resources.4MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents and onboarding/KYB workflows to validate VAT and EORI numbers, look up companies, screen sanctions lists, and run combined checks through remote MCP tools and a pay-per-call API.MIT