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.

Tools

Tool What it does
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
validate_iban Validate an IBAN (offline MOD-97) and resolve bank name + BIC
validate_eori Validate an EORI customs number (EU / GB / XI Northern Ireland)
lookup_company_by_lei Company data by Legal Entity Identifier (GLEIF)
lookup_company_by_vat Company data by VAT number — fallback for DE/ES where VIES hides names
get_vat_rates Current VAT rates for an EU country
check_service_status Live health of VIES (per country), EORI, HMRC, GLEIF — no API key needed

Setup

  1. Get a free API key (100 requests/month, no credit card) at eurovalidate.com.
  2. 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-mcp

Any other MCP client

Run over stdio:

EUROVALIDATE_API_KEY=your_api_key uvx eurovalidate-mcp

Or 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_vat as a fallback.
  • Greece is EL in VIES but GR in ISO 3166 — both are accepted.
  • 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.
  • Free tier: 100 requests/month. Paid plans from €19/mo (500,000 requests/month) at eurovalidate.com.

Environment variables

Variable Required Default
EUROVALIDATE_API_KEY yes (except check_service_status) —
EUROVALIDATE_BASE_URL no https://api.eurovalidate.com

License

MIT

mcp-name: io.github.nitrych/eurovalidate-mcp

Project links

Data verified by PyPI on Aug 26, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Nitrych from gravatar.com Nitrych

Credits

Author: EuroValidate

GitHub Statistics

Data verified by PyPI on Aug 26, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Tags

ai-agents compliance eori eu-vat iban kyb llm mcp model-context-protocol vat vat-validation vies

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

eurovalidate_mcp-0.1.0.tar.gz (5.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

eurovalidate_mcp-0.1.0-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

Details for the file eurovalidate_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: eurovalidate_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 5.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for eurovalidate_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 94c2d8162996c270e39287fb940de72a37c33dc7797443a88e42a7b8da8df213
MD5 30da14cf3aad31938717b31f5c8237fd
BLAKE2b-256 bf4b8bd58f95f6f44f4b1333f3519af14947cdcee493811d8c84f8c78398f309

See more details on using hashes here.

Provenance

The following attestation bundles were made for eurovalidate_mcp-0.1.0.tar.gz:

Publisher: publish.yml on Nitrych/eurovalidate-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file eurovalidate_mcp-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for eurovalidate_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c37204a5400c75a674cd876f3d1f4ed4f7c7d48a5b000130bd98c00981792800
MD5 dae60f03bda35528f54dc2ec0928d91c
BLAKE2b-256 d1d6b28c90867d169fd681a7647e1f71ed13745dd01a57c1a5fa0d293e3e2fdf

See more details on using hashes here.

Provenance

The following attestation bundles were made for eurovalidate_mcp-0.1.0-py3-none-any.whl:

Publisher: publish.yml on Nitrych/eurovalidate-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.1.1

2 files

This release

0.1.0 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page