# XRechnung Validator

> XRechnung Validator is a freemium MCP server for finance and payments. Validate XRechnung XML and ZUGFeRD PDFs against official German e-invoice rules. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web
- **Website:** https://checkxrechnung.com
- **Repository:** https://github.com/wenboteng/xrechnung-validator/tree/HEAD/mcp
- **MCP Registry name:** io.github.wenboteng/xrechnung-validator
- **Categories:** finance and payments, legal and government
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/xrechnung-validator
