Skip to content
MCP server

XRechnung Validator

Validate XRechnung XML and ZUGFeRD PDFs against official German e-invoice rules

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
API, CLI, Web
Runs
Locally
Version
0.2.0
Listing updated
2 days ago

About XRechnung Validator

XRechnung Validator is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Checks run against the official KoSIT validator rather than a model. The service states it uses KoSIT validator 1.6.3 with XRechnung 3.0.2 and EN 16931 Schematron 1.3.16, a configuration of 1,646 rules dated 2026-08-31. Each error carries a rule code such as BR-..., a location and a German hint, with a link to an explanation page.

The MCP server has three tools. validate_xrechnung takes a file path or raw XML, validate_zugferd runs a PDF/A-3 check, profile detection and CII Schematron, and extract_zugferd returns the embedded XML with a JSON summary. XML validation is capped at 5 MB and the ZUGFeRD tools at 10 MB. Because the tools call checkxrechnung.com, they are not a local offline check, although the service reports that files are not persisted.

The free limit is 50 requests per IP per UTC day and 10 per minute. A passing result does not guarantee a portal such as ZRE or OZG-RE will accept the invoice, since bank and portal overlays are not checked. Batch and higher-volume API access is a waitlist, planned from EUR 79 per month.

Install

Run in a terminal

claude mcp add xrechnung-validator -- npx -y xrechnung-validator-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "xrechnung-validator": {
      "command": "npx",
      "args": [
        "-y",
        "xrechnung-validator-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "xrechnung-validator": {
      "command": "npx",
      "args": [
        "-y",
        "xrechnung-validator-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "xrechnung-validator": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "xrechnung-validator-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "xrechnung-validator": {
      "command": "npx",
      "args": [
        "-y",
        "xrechnung-validator-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "xrechnung-validator": {
      "command": "npx",
      "args": [
        "-y",
        "xrechnung-validator-mcp"
      ]
    }
  }
}

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

validate_xrechnung
Uploads an XRechnung XML file or ZUGFeRD PDF for validation, from a file path or raw XML.
validate_zugferd
Uploads a PDF for a PDF/A-3 check, profile detection and EN 16931 CII Schematron validation.
extract_zugferd
Uploads a PDF and returns the embedded XML plus a JSON summary.

What it does

Official rule engine
Validation uses the KoSIT validator and XRechnung configuration, not AI judgement.
UBL and CII
`validate_xrechnung` accepts XRechnung XML in both syntaxes, or a ZUGFeRD PDF.
ZUGFeRD checks
`validate_zugferd` checks PDF/A-3, profile and EN 16931 CII rules.
XML extraction
`extract_zugferd` returns embedded XML and a JSON summary.
Readable errors
Each error has a rule id, severity, location, message, hint and rule URL.
No file storage
The service reports that files are processed in memory only.

Good for

  • Check an XRechnung before sending it to a public-sector customer
  • Find out why a ZUGFeRD invoice is rejected
  • Extract the XML embedded in a ZUGFeRD PDF
  • Add an e-invoice check to an automated workflow

Pricing

Freemium

Free up to 50 checks per IP per day; batch API planned from EUR 79 per month (waitlist)

Prices change. Check checkxrechnung.com before you buy.

XRechnung Validator FAQ

Is it free?

Yes, up to 50 requests per IP per UTC day and 10 per minute; batch access is a planned paid tier from EUR 79 per month.

Which rules does it use?

KoSIT validator 1.6.3, XRechnung 3.0.2 and EN 16931 Schematron 1.3.16.

Are my files stored?

The service reports that files are not persisted and not sent to a language model.

Does a pass mean a portal will accept it?

No. Portal and bank overlays are not checked, so ZRE or OZG-RE may still reject a file.

What are the file size limits?

5 MB for XML validation and 10 MB for the ZUGFeRD tools.

Is XRechnung Validator free?

XRechnung Validator has a free plan, with paid plans for more usage or features.

How do I add XRechnung Validator to Claude Code?

Run this command in your terminal: claude mcp add xrechnung-validator -- npx -y xrechnung-validator-mcp

What are the best alternatives to XRechnung Validator?

The closest alternatives to XRechnung Validator are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, NY LLC Publication (FileMyPublication) and Quantivex Research.

Alternatives to XRechnung Validator

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government
  5. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  6. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments