mcpField
M
mcp-server-erechnung

mcp-server-erechnung

Remote
github.com/flame-goal-hunterOther0Updated 1d ago
Repository

About mcp-server-erechnung

mcp-server-erechnung provides tools for German business e-invoice generation, validation and parsing. It targets organizations handling XRechnung and ZUGFeRD documents, with deterministic financial calculations and validation against named standards.

Key features

  1. 01Generate XRechnung XML and ZUGFeRD PDF/A-3b
  2. 02Validate invoices against EN 16931 and KoSIT
  3. 03Parse XML and legacy PDF invoices
  4. 04Embed ZUGFeRD data in an existing PDF
  5. 05Check invoice calculations and IBANs

Use cases

  1. 01Create an XRechnung or ZUGFeRD invoice
  2. 02Validate an invoice before processing
  3. 03Extract data from received invoice files
  4. 04Convert a legacy PDF into ZUGFeRD format

MCP support

Exposes invoice generation, validation, parsing, PDF embedding and conversion tools to MCP clients. It is available through a local stdio setup or a remote Streamable HTTP endpoint.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://german-e-rechnung-zugferd-and-xrechnung.p.rapidapi.com/api/v1/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

All endpoints
Streamable HTTPhttps://german-e-rechnung-zugferd-and-xrechnung.p.rapidapi.com/api/v1/mcpAuth required
Packages
npmmcp-server-erechnung1.0.0

Tools

Details

From the project README

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.

Available MCP Tools

Tool NameDescription
generate_erechnungDeterministically 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_erechnungValidate any ZUGFeRD PDF or XRechnung XML against official EN 16931 XSD, KoSIT XR_30 Schematron, and veraPDF (rule_id, field, human_hint).
parse_erechnungSmart Hybrid Empfangspflicht parser: ~20ms deterministic NATIVE_XML fast-path first, plus math-guarded legacy PDF extraction (math_verified, iban_valid, discrepancy).
embed_zugferd_pdfUpgrade an existing visual PDF (Base64) + JSON into a true PDF/A-3b ZUGFeRD 2.5 hybrid document.
magic_convert_pdfConvert 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.