mcp-server-erechnung
Generates and validates DATEV-compatible ZUGFeRD 2.5 / Factur-X PDF/A-3b e-invoices, enforcing German e-invoicing business rules and embedding structured invoice XML in PDF/A-3b documents.
Supports SEPA payments by stamping scannable EPC SEPA GiroCode QR codes on invoices and validating seller IBANs with ISO 13616 MOD-97 checks.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-server-erechnung Create an XRechnung for 3 hours of consulting at €120 to Stadt Köln"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
German E-Rechnung MCP Server (mcp-server-erechnung)
Official Model Context Protocol (MCP) server for German B2B & B2G E-Invoicing compliance (EN 16931 / Wachstumschancengesetz 2025–2027, KoSIT XRechnung 3.0.2, DATEV ZUGFeRD 2.5 / Factur-X PDF/A-3b, SEPA GiroCode QR, and Smart Hybrid Parsing).
Connect Claude Desktop, Claude Code, Cursor, Windsurf, Cline, or n8n AI Agents to deterministic German E-Rechnung generation, official KoSIT/veraPDF validation, and guarded Empfangspflicht parsing — with zero silent LLM hallucinations in tax or monetary fields.
Why Use This MCP Server?
100% Deterministic Financial Math (
BigDecimal+ ISO 13616MOD-97): Your AI agent never generates raw XML and never computes final invoice math. Everyqty * unitPriceNet, VAT bucket, andgrossTotalis calculated deterministically in exact decimal arithmetic, and every Seller IBAN is verified via Modulo-97.DATEV & KoSIT XRechnung 3.0 Compliant (
BR-DE-*+veraPDF): Enforces German Business Rules (SellerContact,Leitweg-ID/BT-10, SEPABG-16), embeds TrueType fonts +sRGBICC profiles (ISO 19005-3 PDF/A-3b), and stamps scannable German GiroCode (EPC SEPA QR) payment codes.Smart Developer DX: Automatically maps human units (
"Stk","Std","Tage","pauschal","kg","kWh") to UN/ECE Rec 20 codes (C62,HUR,DAY,LS,KGM,KWH) and auto-infers0%VAT categories (AE§ 13b Reverse Charge,K§ 6a Intra-EU,E§ 19 UStG,GExport) with mandatoryBT-120German exemption text.100% Stateless & GDPR / DSGVO Safe: Zero invoice persistence or PII logging.
Related MCP server: einvoice-mcp
Available MCP Tools
Tool Name | Description |
| Deterministically generate a |
| Validate any ZUGFeRD PDF or XRechnung XML against official EN 16931 XSD, KoSIT |
| Smart Hybrid Empfangspflicht parser: |
| Upgrade an existing visual PDF (Base64) + JSON into a true |
| Convert a flat legacy PDF (Base64, max 5 pages) into ZUGFeRD 2.5 |
Quickstart
1. Get an API Key (Free Tier Available)
Subscribe to the German E-Rechnung ZUGFeRD & XRechnung API on RapidAPI Hub: https://rapidapi.com/flamegoalhunter/api/german-e-rechnung-zugferd-and-xrechnung
2. Option A — Local npx (stdio) for Claude Desktop / Cursor / Windsurf
Add to your claude_desktop_config.json or .cursor/mcp.json:
{
"mcpServers": {
"german-erechnung": {
"command": "npx",
"args": ["-y", "mcp-server-erechnung"],
"env": {
"ERECHNUNG_RAPIDAPI_KEY": "YOUR_RAPIDAPI_KEY"
}
}
}
}3. Option B — Zero-Install Remote Streamable HTTP MCP
Connect any Streamable HTTP MCP client directly without npx:
URL:
https://german-e-rechnung-zugferd-and-xrechnung.p.rapidapi.com/api/v1/mcpHeaders:
X-RapidAPI-Key: YOUR_RAPIDAPI_KEYX-RapidAPI-Host: german-e-rechnung-zugferd-and-xrechnung.p.rapidapi.com
License
MIT © FGH Studio
Available Tools
5 toolsembed_zugferd_pdfCRead-onlyIdempotentInspect
Deterministically upgrade an existing visual PDF (Base64) + structured invoice JSON into an ISO 19005-3 PDF/A-3b ZUGFeRD 2.5 hybrid invoice with embedded factur-x.xml and GiroCode QR.
Inputs: invoice (required), pdfBase64 (required), profile, stampGiroCode.
generate_erechnungARead-onlyIdempotentInspect
Deterministically generate an official German E-Rechnung (ZUGFeRD 2.5 PDF/A-3b with SEPA GiroCode QR or KoSIT XRechnung 3.0.2 XML) from structured JSON (<300ms, zero LLM hallucinations, exact BigDecimal math & MOD-97 IBAN verification).
Inputs: invoice (required), format, profile, stampGiroCode.
magic_convert_pdfBRead-onlyIdempotentInspect
Convert a flat legacy PDF (Base64, max 5 pages) into a ZUGFeRD 2.5 PDF/A-3b under strict BigDecimal Math & ISO 13616 MOD-97 IBAN guardrails.
Inputs: pdfBase64 (required), profile, stampGiroCode.
parse_erechnungARead-onlyIdempotentInspect
Smart Hybrid German E-Rechnung parser (Empfangspflicht): extracts embedded ZUGFeRD/Factur-X/XRechnung XML deterministically in ~20ms (source='NATIVE_XML'), or falls back to guarded extraction on flat PDFs with math_verified and iban_valid checks.
Inputs: filename, fileBase64, xmlContent.
validate_erechnungARead-onlyIdempotentInspect
Validate a ZUGFeRD PDF/A-3b (Base64) or XRechnung 3.0 XML against official EN 16931 XSD, KoSIT German Business Rules (BR-DE-*), and veraPDF ISO 19005-3. Returns valid=true/false plus structured rule_id, field, and human_hint.
Inputs: filename, fileBase64, xmlContent.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
generate_erechnung, embed_zugferd_pdf, and magic_convert_pdf all ultimately produce a ZUGFeRD PDF/A-3b hybrid invoice, and the boundaries between 'generate from JSON', 'upgrade PDF+JSON', and 'convert flat PDF' are not fully crisp—magic_convert appears to combine parse+embed. validate_erechnung and parse_erechnung are clearly distinct, and the descriptions do help an agent pick the right entry point, but there is real overlap in the generation/conversion cluster.
generate_/validate_/parse_erechnung follow a clean verb+domain pattern, but the set drifts to a different object name in embed_zugferd_pdf and a non-standard quirky verb in magic_convert_pdf. Readable but not one predictable convention across all five tools.
Five tools is well within a healthy scope and each maps to a recognizable invoice operation (generate, validate, parse, embed, convert). Slight over-partitioning in the generation/embedding area keeps it from being a perfect fit, but nothing feels padded or missing count-wise.
The core lifecycle is covered: create both ZUGFeRD and XRechnung from JSON, validate against EN 16931/KoSIT/veraPDF, parse inbound invoices, embed and convert legacy PDFs. Minor gaps remain—no direct ZUGFeRD↔XRechnung format conversion and no preview/readable rendering—but agents can work around these via generate with the appropriate format flag.
Maintenance
Related MCP Connectors
German e-invoicing: generate XRechnung 3.0, pre-check and extract (incl. ZUGFeRD PDF). Paid.
KoSIT-verified German e-invoices: generate & validate ZUGFeRD, Factur-X, XRechnung, EN 16931.
Create ZUGFeRD e-invoices from JSON or PDF, verify Factur-X, check VAT IDs and Peppol.
XRechnung and ZUGFeRD e-invoicing (EN 16931): create, validate, check Leitweg-IDs, German VAT.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for DACH e-invoicing. Create XRechnung (UBL) and ZUGFeRD 2.3 (Factur-X CII) invoices, validate against EN 16931 rules, extract data from XML, and convert between UBL, CII and JSON formats.661 npm2MIT
- AlicenseAqualityDmaintenanceMCP server for German e-invoice compliance (XRechnung 3.0 & ZUGFeRD 2.x) enabling AI agents to validate, generate, parse, and check compliance of electronic invoices per EN 16931.61MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to locally parse, validate, audit, explain, generate, and convert XRechnung and ZUGFeRD/Factur-X e-invoices using official rule sets, fully offline with no API keys required.Apache 2.0
- AlicenseAqualityAmaintenanceCreate and check EU e-invoices (XRechnung, ZUGFeRD / Factur-X PDF, Peppol BIS, UBL, CII) on your own machine. Validation runs the official KoSIT, CEN and Peppol rules, and its verdicts match the official KoSIT validator 100% on the official test invoices. Free, open source, no API key.67587 npm4Apache 2.0