zugferd-mcp-client
v1.1.0
Published
ZUGFeRD Validator MCP-Client – E-Rechnungen (ZUGFeRD, Factur-X, XRechnung) per KI-Agent validieren und erstellen
Downloads
204
Maintainers
Readme
zugferd-mcp-client
MCP-Client zur automatisierten Validierung von ZUGFeRD, Factur-X und XRechnung E-Rechnungen über die ZUGFeRD Validator API.
Installation
npm install -g zugferd-mcp-clientVoraussetzungen
Kostenloser API-Key unter zugferd-validator.de/portal.html.
Konfiguration
{
"mcpServers": {
"zugferd": {
"command": "zugferd-mcp",
"env": {
"ZUGFERD_API_KEY": "zv_dein_key_hier"
}
}
}
}Verfügbare Tools
validate_invoice
Validiert eine E-Rechnung (ZUGFeRD/Factur-X PDF oder XRechnung XML) gegen EN 16931.
{
"file_content": "<base64>",
"file_type": "pdf"
}extract_xml
Extrahiert die eingebettete XML-Datei aus einem ZUGFeRD/Factur-X PDF.
check_consistency
Prüft ob die sichtbaren PDF-Daten mit den eingebetteten XML-Daten übereinstimmen.
create_invoice
Erzeugt aus strukturierten Daten eine valide E-Rechnung — als ZUGFeRD-PDF (PDF/A-3) oder reine XRechnung-XML (mit Leitweg-ID für B2G). Mehrere Positionen, alle USt-Kategorien, Belegtypen (Rechnung, Gutschrift/Storno, Korrektur, Anzahlung, Teilrechnung). Beträge in Cent. Stateless.
{
"format": "zugferd",
"number": "RE-2026-042",
"date": "2026-04-01",
"seller": { "name": "Muster GmbH", "vat_id": "DE123456789", "city": "Stuttgart" },
"buyer": { "name": "Beispiel AG", "city": "Berlin" },
"lines": [
{ "name": "Beratung", "quantity": 2, "unit_net_price_cents": 38000, "vat_category": "S", "vat_rate": 19 }
]
}Umgebungsvariablen
| Variable | Beschreibung | Standard |
|---|---|---|
| ZUGFERD_API_KEY | Dein API-Key | — (Pflicht) |
| ZUGFERD_API_URL | API-Basis-URL | https://api.zugferd-validator.de |
Links
Lizenz
MIT
