euinvoice-mcp

euinvoice-mcp

An MCP server for European invoicing rules. Query VAT rates, e-invoicing requirements, format specifications, and compliance rules for EU-27 + EEA countries — directly from your AI assistant.

Why

European invoicing is fragmented. Every country has different VAT rates, e-invoicing mandates, accepted formats, and compliance rules. This MCP server puts all of that knowledge at your fingertips.

What's included

10 tools covering the full EU invoicing landscape:

| Tool | Description | |------|-------------| | get_vat_rates | VAT rates for any country (standard, reduced, super-reduced, parking) | | list_vat_rates | Compare standard VAT rates across all countries | | get_einvoicing_requirements | E-invoicing mandates, systems, and formats per country | | get_invoice_format | Format specs (UBL, CII, Factur-X, XRechnung, FatturaPA, Peppol BIS) | | validate_invoice_fields | Required fields per country and transaction type (B2B/B2G/B2C) | | get_reverse_charge_rules | When and how to apply reverse charge | | get_oss_rules | One-Stop Shop rules for cross-border B2C sales | | get_b2b_mandate_status | B2B e-invoicing mandate timeline across all countries | | get_en16931_info | EN 16931 standard details and CIUS extensions | | compare_countries | Side-by-side comparison of two countries |

4 resources for direct data access:

• euinvoice://data/vat-rates — Complete VAT rates database
• euinvoice://data/einvoicing-requirements — E-invoicing requirements per country
• euinvoice://data/invoice-formats — Format specifications
• euinvoice://data/validation-rules — Validation rules, reverse charge, OSS

Coverage

EU-27 + United Kingdom, Norway, Switzerland, Iceland.

Data current as of January 2025.

Installation

npm install -g euinvoice-mcp

Or run directly:

npx euinvoice-mcp

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

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

Cursor / VS Code

Add to your MCP settings:

{
  "euinvoice": {
    "command": "npx",
    "args": ["-y", "euinvoice-mcp"]
  }
}

From source

git clone https://github.com/Artisan-at-Work/euinvoice-mcp.git
cd euinvoice-mcp
npm install
npm run build

Then point your MCP client to:

{
  "euinvoice": {
    "command": "node",
    "args": ["/path/to/euinvoice-mcp/dist/index.js"]
  }
}

Usage examples

Once connected, ask your AI assistant:

"What are the VAT rates in Germany?"

"What e-invoicing format do I need for B2G invoices in Italy?"

"Compare the invoicing requirements between France and Germany"

"When does the B2B e-invoicing mandate start in Poland?"

"What fields are required on a cross-border invoice to Spain?"

"Explain the reverse charge mechanism for intra-EU B2B services"

Data accuracy

The data covers current (2024/2025) rules including:

• Finland's standard rate increase to 25.5% (Sep 2024)
• Estonia's standard rate increase to 22% (Jan 2024)
• Germany's B2B e-invoicing mandate (receiving: Jan 2025, sending: 2027/2028)
• Slovakia's rate increase to 23% (2025)
• Czech Republic's merged reduced rate of 12% (2024)
• Romania's B2B clearance mandate (Jan 2024)
• France's B2B mandate timeline (Sep 2026 onwards)
• Poland's KSeF mandate (Feb 2026)

Contributing

Contributions welcome. Areas that would benefit from help:

• Additional country-specific validation rules
• SAF-T reporting requirements
• Withholding tax rules
• VIES validation integration
• More detailed sector-specific reduced rates

License

MIT