EuroValidate MCP Server

MCP (Model Context Protocol) server for EuroValidate — permite a Claude, ChatGPT y cualquier agente compatible con MCP validar números de IVA de la UE (VIES), IBAN y números aduaneros EORI, consultar datos de empresas y obtener tipos de IVA a través de una API REST fiable.

Por qué

Validar datos empresariales europeos normalmente significa lidiar con cinco servicios gubernamentales fragmentados: la API SOAP de VIES (que se agota constantemente — solo Alemania genera el 95% de sus errores), el endpoint EORI de la CE, HMRC, GLEIF y los registros nacionales. EuroValidate los envuelve en una única API JSON con caché primero, con interruptores de circuito por país y degradación gradual — y este servidor MCP la expone a los agentes LLM como herramientas listas para usar.

Related MCP server: eu-company-mcp-server

Herramientas

Configuración

1. Obtén una clave API gratuita (100 solicitudes/mes, sin tarjeta de crédito) en eurovalidate.com.

2. Añade el servidor a tu cliente MCP:

Claude Desktop / Claude Code

{
  "mcpServers": {
    "eurovalidate": {
      "command": "uvx",
      "args": ["eurovalidate-mcp"],
      "env": { "EUROVALIDATE_API_KEY": "your_api_key" }
    }
  }
}

Claude Code en una línea:

claude mcp add eurovalidate -e EUROVALIDATE_API_KEY=your_api_key -- uvx eurovalidate-mcp

Cualquier otro cliente MCP

Ejecutar sobre stdio:

EUROVALIDATE_API_KEY=your_api_key uvx eurovalidate-mcp

O instala permanentemente: pip install eurovalidate-mcp → eurovalidate-mcp.

Ejemplos de prompts

• "Valida el número de IVA DE811569869 y dime la empresa que hay detrás"

• "Comprueba si este IBAN es válido y a qué banco pertenece: DE89 3704 0044 0532 0130 00"

• "¿Está VIES caído para Alemania ahora mismo?"

• "¿Cuál es el tipo de IVA en Portugal?"

• "Valida los números de IVA de estos 5 proveedores antes de facturarles"

Notas para agentes (y humanos)

• Alemania y España nunca devuelven nombre/dirección de empresa a través de VIES (ley de protección de datos) — usa lookup_company_by_vat como respaldo.

• Grecia es EL en VIES pero GR en ISO 3166 — ambos se aceptan.

• Cada respuesta incluye confidence: HIGH|MEDIUM|LOW|UNKNOWN y el source (fuente) ascendente, para que los agentes puedan razonar sobre la frescura de los datos cuando un servicio gubernamental está caído.

• Plan gratuito: 100 solicitudes/mes. Planes de pago desde 19 €/mes (500.000 solicitudes/mes) en eurovalidate.com.

Variables de entorno

Licencia

MIT

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