Eleata e-Invoice Validator

Validate EU e-invoices (Peppol, XRechnung, Factur-X, UBL, CII) and explain error codes.

FinanceJavaScriptv0.1.1

eleata e-invoice MCP server

Validate EU electronic invoices and explain validation error codes directly from your AI coding agent (Claude, Cursor, Copilot, …). It wraps the hosted eleata validation API plus a bundled offline error-code reference.

Never ship a broken invoice. When you ask your agent "is this FatturaPA / XRechnung / Peppol file valid?", it runs the official Schematron rules and gets back the rule id and the fix — before a rejection (an SdI scarto, a Chorus Pro refusal, a KSeF error) ever happens.

Tools

ToolWhat it doesAPI key
validate_einvoiceValidate one invoice (Peppol BIS 3.0, EN 16931 UBL/CII, XRechnung 3.0.x, Factur-X/ZUGFeRD, UBL, CII). Returns valid/invalid + each rule id, explanation and fix.required
list_formatsList the formats eleata validates today + roadmap.none
explain_error_codeExplain one error code (e.g. 00400, BR-DE-21) in plain English, with the fix. Works offline.none

Setup

  1. Get a free API key (200 validations/month, no card) at https://eleata.io/signup/.
  2. Add the server to your agent's MCP config.

Claude Desktop / Claude Code (claude_desktop_config.json or .mcp.json)

{
  "mcpServers": {
    "eleata-einvoice": {
      "command": "npx",
      "args": ["-y", "eleata-einvoice-mcp"],
      "env": { "EINVOICE_API_KEY": "your_free_key_here" }
    }
  }
}

Cursor (~/.cursor/mcp.json)

Same block as above.

Example prompts

  • "Validate this XRechnung file and tell me what to fix" (paste the XML)
  • "What does FatturaPA error 00400 mean and how do I fix it?"
  • "Which e-invoice formats can you validate today?"

Privacy

validate_einvoice sends the invoice you pass to the hosted eleata API for validation. list_formats and explain_error_code are local/offline (the error-code reference is bundled). See https://eleata.io/privacy/.

Links

MIT licensed. Schematron engines: Mustang / phive. Schematron rules from CEN, OpenPeppol, KoSIT.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y eleata-einvoice-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-hernaninverso-eleata-einvoice-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "eleata-einvoice-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

eleata-einvoice-mcpnpm

Compatible MCP Clients

Eleata e-Invoice Validator works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More