mcpField
E

Eleata Einvoice Mcp

Local
github.com/hernaninversoFinance0Updated 17w ago
Repository

About Eleata Einvoice Mcp

Eleata Einvoice Mcp is an MCP server for coding agents that validates EU e-invoices and explains validation errors. It combines a hosted validation API with an offline error-code reference covering formats such as Peppol BIS, XRechnung, and Factur-X/ZUGFeRD.

Key features

  1. 01Validate supported EU e-invoice formats
  2. 02Return rule identifiers and suggested fixes
  3. 03List currently supported formats
  4. 04Explain error codes offline

Use cases

  1. 01Validate an XRechnung invoice before submission
  2. 02Diagnose a FatturaPA validation error
  3. 03Check which invoice formats are supported

MCP support

The MCP server exposes tools to validate invoices, list formats, and explain error codes. Invoice validation uses the hosted eleata API; format listing and error explanations work offline.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "eleata-einvoice": {
      "command": "npx",
      "args": [
        "-y",
        "eleata-einvoice-mcp"
      ],
      "env": {
        "EINVOICE_API_KEY": "<EINVOICE_API_KEY>"
      }
    }
  }
}
Run commandnpx -y eleata-einvoice-mcp
Environment variables to set
EINVOICE_API_KEYSecretFree API key for the eleata e-invoice validation backend (https://eleata.io/signup/)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmeleata-einvoice-mcp0.1.1

Tools

3

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
formatenumNoFormat hint. Default: auto (the server sniffs XML vs PDF and the profile).auto | peppol-bis-3 | en16931-ubl | en16931-cii | xrechnung-ubl | xrechnung-cii | factur-x | ubl | cii
is_pdfbooleanNoSet true if `content` is a base64-encoded PDF (Factur-X/ZUGFeRD). Default false.
contentstringYesThe invoice to validate. For XML formats, the raw XML text. For a Factur-X / ZUGFeRD PDF, the base64-encoded PDF bytes (set is_pdf=true).

Details

From the project README

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.

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.