Skip to main content
Glama
io.github.nitrych/eurovalidate-mcp

io.github.nitrych/eurovalidate-mcp

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

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 the X-API-Key header. check_service_status sends 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.

  • uvx downloads the eurovalidate-mcp package from PyPI on first run.

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

Available Tools

7 tools
check_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

    A4/5.0

    Scored across 7 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      4
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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