MCP-Server für KI-Agenten: E-Rechnungen prüfen

Mit dem MCP-Server von eRechio kann ein KI-Agent oder Assistent eine XRechnung (UBL oder CII) oder das XML einer ZUGFeRD-/Factur-X-Rechnung prüfen lassen und bekommt dieselbe Antwort wie von der REST-API: Schemaprüfung, Regelprüfung nach KoSIT, jede Meldung mit deutscher Erklärung.

Adresse: https://api.erechio.de/mcp · Model Context Protocol, Transport „Streamable HTTP“ · seit API-Version 1.4.0 (22.11.2026). Anmeldung mit dem vorhandenen API-Schlüssel. Testschlüssel sofort erzeugen: kostenlos, 50 Dokumente im Monat.

Wozu

Ein Agent, der Rechnungen entgegennimmt oder erzeugt (etwa in einer Buchhaltungs- oder Automatisierungsumgebung), kann damit selbst prüfen, ob eine Rechnung als XRechnung beziehungsweise ZUGFeRD-XML formal in Ordnung ist, und die Erklärungen zu den Fehlern direkt weiterverarbeiten. Ergebnis und Regeln sind dieselben wie bei POST /v1/validate; der MCP-Server ist nur ein zweiter Zugang zur selben Prüfung.

Einrichtung

Sie brauchen einen API-Schlüssel (pk_…), z. B. den Testschlüssel. Er wird als Header Authorization: Bearer pk_… mitgeschickt (alternativ X-API-Key). OAuth gibt es nicht.

Claude Code

claude mcp add --transport http erechio https://api.erechio.de/mcp --header "Authorization: Bearer pk_IHR_SCHLUESSEL"

Andere Clients (z. B. Cursor, VS Code)

Clients mit Remote-MCP über HTTP lesen die Konfiguration meist aus einer JSON-Datei. Die Feldnamen weichen je nach Client leicht ab; prüfen Sie sie in der Dokumentation Ihres Clients.

{
  "mcpServers": {
    "erechio": {
      "type": "http",
      "url": "https://api.erechio.de/mcp",
      "headers": {
        "Authorization": "Bearer pk_IHR_SCHLUESSEL"
      }
    }
  }
}

Test mit curl

Die Werkzeugliste lässt sich ohne Schlüssel abrufen:

curl -s https://api.erechio.de/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Technik

Werkzeuge

WerkzeugArgumenteErgebnis
validate_invoice
(Rechnung prüfen)
xml (Pflicht): die Rechnung als XML-Text – XRechnung UBL/CII oder das XML einer ZUGFeRD-/Factur-X-Rechnung, höchstens 2 MB.
idempotency_key (optional): wie der Header Idempotency-Key, siehe Idempotenz; gleiche Regeln.
structuredContent ist genau die Antwort von POST /v1/validate mit denselben Feldern (vollstaendig_validiert, regelpruefung_bestanden, schemapruefung, meldungen mit erklaerung, kontingent, regelstand usw.; Felder: Antwort). Dazu eine kurze deutsche Zusammenfassung als Text.
explain_rule
(Regel erklären)
code (Pflicht): ein Regelcode, wie ihn ein Prüfer meldet, z. B. BR-DE-15; auch aus anderen Prüfern wie dem KoSIT-Validator.Deutsche Erklärung: titel, was (was die Regel verlangt), beheben, pfad_ubl, pfad_cii und mehr (Link auf die Fehlerseite). Erklärt sind die häufigsten Regeln; für andere Codes kommt gefunden: false, kein Fehler. Ohne Schlüssel, zählt nicht.
get_status
(Zustand)
keineDie Antwort von GET /v1/status. Ohne Schlüssel, zählt nicht.

Verlassen Sie sich bei validate_invoice auf vollstaendig_validiert, nicht auf die Textzusammenfassung. Ein erfolgreicher Aufruf heißt nur: Die Prüfung ist gelaufen, nicht: Die Rechnung ist fehlerfrei.

Limits und Kontingent

Es gelten dasselbe Kontingent und dieselben Limits wie bei der REST-API: Jede erfolgreiche Prüfung zählt ein Dokument im Monatskontingent Ihres Schlüssels (Testschlüssel: 50 Dokumente im Monat), höchstens 60 Prüfungen pro Minute, höchstens 2 MB je Rechnung. Aufrufe über REST und MCP teilen sich dasselbe Kontingent.

Fehler

Fehler der API (401, 413, 422, 429 …) kommen als Werkzeugergebnis mit isError=true und demselben Fehlercode und -text wie in der API (Statuscodes). Ein fehlender oder ungültiger Schlüssel bei validate_invoice ist ein 401.

Datenschutz

Die Rechnung wird nur im Arbeitsspeicher geprüft und danach verworfen, nicht gespeichert, wie bei der REST-API. Protokolliert werden je Prüfung nur Zeitpunkt, Schlüssel-Kennung, Syntax, Ergebnis, Anzahl der Fehler und Laufzeit, ohne IP-Adresse (Einzelheiten: Datenschutz der API). Bedenken Sie: Ihr KI-Client oder dessen Anbieter sieht die Rechnung ebenfalls; das liegt außerhalb von eRechio.

Was es nicht gibt

Technische Hinweise zum Datenformat, keine Steuer- oder Rechtsberatung. eRechio ist kein Angebot der KoSIT. Zurück zur API-Dokumentation.