EuroValidate MCP Server

MCP (Model Context Protocol) сервер для EuroValidate — позволяет Claude, ChatGPT и любому агенту, поддерживающему MCP, проверять номера НДС ЕС (VIES), IBAN и таможенные номера EORI, искать данные о компаниях и получать ставки НДС через один надёжный REST API.

Зачем

Проверка европейских бизнес-данных обычно означает жонглирование пятью разрозненными государственными сервисами: VIES SOAP API (который постоянно истекает по тайм-ауту — только Германия генерирует 95% его ошибок), EC EORI endpoint, HMRC, GLEIF и национальными реестрами. EuroValidate объединяет их в один JSON API с кэшированием, с автоматическими выключателями по странам и плавной деградацией — и этот MCP-сервер предоставляет его LLM-агентам в виде готовых инструментов.

Related MCP server: eu-company-mcp-server

Инструменты

Настройка

1. Получите бесплатный API-ключ (100 запросов в месяц, без кредитной карты) на eurovalidate.com.

2. Добавьте сервер в ваш MCP-клиент:

Claude Desktop / Claude Code

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

Claude Code одной строкой:

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

Любой другой MCP-клиент

Запуск через stdio:

EUROVALIDATE_API_KEY=your_api_key uvx eurovalidate-mcp

Или установите постоянно: pip install eurovalidate-mcp → eurovalidate-mcp.

Примеры запросов

• "Проверьте номер НДС DE811569869 и скажите, какая компания за ним стоит"

• "Проверьте, действителен ли этот IBAN и к какому банку он относится: DE89 3704 0044 0532 0130 00"

• "Работает ли VIES для Германии прямо сейчас?"

• "Какая ставка НДС в Португалии?"

• "Проверьте номера НДС этих 5 поставщиков, прежде чем я выставлю им счета"

Примечания для агентов (и людей)

• Германия и Испания никогда не возвращают название/адрес компании через VIES (закон о защите данных) — используйте lookup_company_by_vat как запасной вариант.

• Греция — это EL в VIES, но GR в ISO 3166 — принимаются оба.

• Каждый ответ содержит confidence: HIGH|MEDIUM|LOW|UNKNOWN и вышестоящий source, чтобы агенты могли оценивать свежесть данных, когда государственный сервис недоступен.

• Бесплатный тариф: 100 запросов в месяц. Платные тарифы от €19/мес (500 000 запросов в месяц) на eurovalidate.com.

Переменные окружения

Лицензия

MIT

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