Skip to main content
Glama

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 13616 MOD-97): Your AI agent never generates raw XML and never computes final invoice math. Every qty * unitPriceNet, VAT bucket, and grossTotal is 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, SEPA BG-16), embeds TrueType fonts + sRGB ICC 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-infers 0% VAT categories (AE § 13b Reverse Charge, K § 6a Intra-EU, E § 19 UStG, G Export) with mandatory BT-120 German exemption text.

  • 100% Stateless & GDPR / DSGVO Safe: Zero invoice persistence or PII logging.


Related MCP server: einvoice-mcp

Available MCP Tools

Tool Name

Description

generate_erechnung

Deterministically generate a ZUGFeRD 2.5 PDF/A-3b (with visual DIN 5008 layout + GiroCode QR + factur-x.xml) or pure XRechnung 3.0.2 XML from structured JSON (<300ms).

validate_erechnung

Validate any ZUGFeRD PDF or XRechnung XML against official EN 16931 XSD, KoSIT XR_30 Schematron, and veraPDF (rule_id, field, human_hint).

parse_erechnung

Smart Hybrid Empfangspflicht parser: ~20ms deterministic NATIVE_XML fast-path first, plus math-guarded legacy PDF extraction (math_verified, iban_valid, discrepancy).

embed_zugferd_pdf

Upgrade an existing visual PDF (Base64) + JSON into a true PDF/A-3b ZUGFeRD 2.5 hybrid document.

magic_convert_pdf

Convert a flat legacy PDF (Base64, max 5 pages) into ZUGFeRD 2.5 PDF/A-3b under strict BigDecimal & MOD-97 guardrails.


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/mcp

  • Headers:

    • X-RapidAPI-Key: YOUR_RAPIDAPI_KEY

    • X-RapidAPI-Host: german-e-rechnung-zugferd-and-xrechnung.p.rapidapi.com


License

MIT © FGH Studio

Available Tools

5 tools
embed_zugferd_pdfC
Read-onlyIdempotent
Inspect

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_erechnungA
Read-onlyIdempotent
Inspect

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_pdfB
Read-onlyIdempotent
Inspect

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_erechnungA
Read-onlyIdempotent
Inspect

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_erechnungA
Read-onlyIdempotent
Inspect

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

    B3.4/5.0

    Scored across 5 tools

    Disambiguation3/5

    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.

    Naming Consistency3/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      6
      61 npm
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      6
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      A
      quality
      A
      maintenance
      Create 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.
      6
      7
      587 npm
      4
      Apache 2.0