EuroValidate MCP Server

MCP (Model Context Protocol)-Server für EuroValidate – ermöglicht Claude, ChatGPT und jedem MCP-fähigen Agenten, EU-USt-IDs (VIES), IBANs und EORI-Zollnummern zu validieren, Unternehmensdaten nachzuschlagen und USt-Sätze abzurufen über eine zuverlässige REST-API.

Warum

Die Validierung europäischer Geschäftsdaten bedeutet normalerweise, fünf fragmentierte staatliche Dienste zu jonglieren: die VIES-SOAP-API (die ständig Timeouts hat – allein Deutschland verursacht 95 % ihrer Fehler), den EC-EORI-Endpunkt, HMRC, GLEIF und nationale Register. EuroValidate bündelt sie in einer cache-first JSON-API mit länderspezifischen Circuit-Breakern und Graceful Degradation – und dieser MCP-Server stellt sie LLM-Agenten als einsatzbereite Tools zur Verfügung.

Related MCP server: eu-company-mcp-server

Tools

Einrichtung

1. Holen Sie sich einen kostenlosen API-Schlüssel (100 Anfragen/Monat, keine Kreditkarte) unter eurovalidate.com.

2. Fügen Sie den Server zu Ihrem MCP-Client hinzu:

Claude Desktop / Claude Code

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

Claude Code-Einzeiler:

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

Jeder andere MCP-Client

Über stdio ausführen:

EUROVALIDATE_API_KEY=your_api_key uvx eurovalidate-mcp

Oder dauerhaft installieren: pip install eurovalidate-mcp → eurovalidate-mcp.

Beispiel-Prompts

• "Validiere die USt-ID DE811569869 und sag mir, welches Unternehmen dahintersteckt"

• "Prüfe, ob diese IBAN gültig ist und zu welcher Bank sie gehört: DE89 3704 0044 0532 0130 00"

• "Ist VIES gerade für Deutschland down?"

• "Wie hoch ist der USt-Satz in Portugal?"

• "Validiere die USt-IDs dieser 5 Lieferanten, bevor ich sie in Rechnung stelle"

Hinweise für Agenten (und Menschen)

• Deutschland und Spanien geben niemals Firmenname/Adresse über VIES zurück (Datenschutzgesetz) – verwenden Sie lookup_company_by_vat als Fallback.

• Griechenland ist in VIES EL, aber in ISO 3166 GR – beide werden akzeptiert.

• Jede Antwort enthält confidence: HIGH|MEDIUM|LOW|UNKNOWN und die vorgelagerte source, damit Agenten die Aktualität der Daten beurteilen können, wenn ein staatlicher Dienst ausfällt.

• Kostenlose Stufe: 100 Anfragen/Monat. Bezahlte Pläne ab 19 €/Monat (500.000 Anfragen/Monat) unter eurovalidate.com.

Umgebungsvariablen

Lizenz

MIT

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