facturolia-mcp
This server lets an AI assistant read and validate European electronic invoices (Factur-X, ZUGFeRD, XRechnung, UBL, CII) from local PDF/XML files via two MCP tools.
read_invoice: extracts full invoice contents — parties, dates, line items, VAT breakdown, totals, IBAN — plus the EN 16931 consistency check.check_invoice: returns only the EN 16931 compliance verdict and anomalies, useful for “is this invoice correct?” screening.Accepts
.pdf(Factur-X/ZUGFeRD) and.xml(UBL/CII/XRechnung) files by absolute path.Can answer in English or French via
FACTUROLIA_LANG.Uploads files to the Facturolia API over HTTPS, processes them in memory, and discards them; 10 MB file limit.
Does not issue, transmit, or legally file invoices; it is a reading and consistency-checking tool only.
Facturolia MCP server
Let an AI assistant read and check European electronic invoices.
Point Claude (or any MCP-compatible client) at a .pdf or .xml invoice and it
answers with the contents in plain language, plus a consistency check against
the European standard EN 16931.
Supports Factur-X, ZUGFeRD, XRechnung, UBL and CII.
> Read ~/Downloads/invoice.pdf
Format: Factur-X / CII (EN 16931 (COMFORT) profile)
Invoice F-2026-0148 · issued 2026-07-15 · due 2026-08-14
Supplier: Studio Lumiere EURL
Customer: Cafe des Arts SARL
Total excl. VAT 1240.00 EUR · VAT 248.00 EUR · Total incl. VAT 1488.00 EUR
Lines (1):
- Consulting : 2 x 620.00 EUR = 1240.00 EUR (VAT 20 %)
EN 16931 check: no anomalies found.Why this exists
A Factur-X invoice is a PDF with structured data hidden inside it. The page a human reads and the data a machine imports are two different things, and they do not always agree. This server exposes both, so an assistant can answer "what is actually in this file?" rather than reading the visible page and hoping.
France made structured e-invoicing mandatory for receiving on 1 September 2026, so these files are now arriving in ordinary inboxes.
Related MCP server: eleata e-invoice MCP server
Install
No dependencies. Python 3.10 or newer is all you need.
Download
facturolia_mcp.py.Get a free API key at facturolia.fr/en/pricing.
Add it to your client configuration. For Claude Desktop, that is
claude_desktop_config.json:
{
"mcpServers": {
"facturolia": {
"command": "python",
"args": ["/absolute/path/to/facturolia_mcp.py"],
"env": { "FACTUROLIA_API_KEY": "your-key" }
}
}
}Restart the client. Two tools appear.
Tools
Tool | What it returns |
| Full contents: parties, dates, lines, VAT breakdown, totals, IBAN, plus the EN 16931 check |
| The compliance verdict and anomalies only, for "is this invoice correct?" |
Both take one argument, path, an absolute path to a .pdf or .xml file.
Configuration
Variable | Default | Meaning |
| required | Your key |
|
| Response language, |
|
| Override for testing. Must be |
With FACTUROLIA_LANG=fr the answers come back in French, with French date and
label conventions. The tool descriptions stay in English so that every client
understands them.
What it does with your file
The file is sent to the Facturolia API to be analysed. It is processed in memory and discarded immediately, no invoice is stored, and the contents do not appear in the technical logs. The servers are in the European Union.
That said, this is not local processing. If your policy forbids sending invoices to an external service, use the API yourself inside your own network instead, or do not use this server.
Limits: 10 MB per file, .pdf and .xml only.
What this is not
It reads and checks invoices. It does not issue them, does not transmit them, and is not a compliance solution. In France, sending an invoice legally goes through an accredited platform (Plateforme Agréée). This tool sits before and after that step, never in place of it.
Tests
Standard library only, no network needed:
python -m unittest discover -s testsLinks
Web reader, free and without an account: facturolia.fr/en
REST API documentation: facturolia.fr/en/api
Licence
MIT. See LICENSE.
Available Tools
2 toolscheck_invoiceCheck an e-invoice against EN 16931ARead-onlyIdempotent
Validate one electronic invoice file (Factur-X, ZUGFeRD, XRechnung, UBL or CII) against the EN 16931 standard and return only the verdict and the list of anomalies: totals that do not add up, VAT miscalculated for a rate, missing required fields, each with the rule code and the figures involved. Use it to answer 'is this invoice correct?' or to screen several files quickly. It does not list the invoice contents; for parties, lines and totals use read_invoice. This is a consistency check, not a legal compliance certificate, and it does not transmit the invoice to any tax platform. Side effects: the file is uploaded over HTTPS to the Facturolia API, processed in memory and discarded. Requires FACTUROLIA_API_KEY; 10 MB limit; rate limited per key tier.
Inputs: path (required).
read_invoiceRead an e-invoiceARead-onlyIdempotent
Extract the full contents of one electronic invoice file (Factur-X, ZUGFeRD, XRechnung, UBL or CII) as plain text: invoice number and dates, supplier and customer, every line, the VAT breakdown per rate, totals, IBAN, the EN 16931 consistency check, and whether the amounts on a Factur-X PDF's visible page match its embedded XML. Use it when the user wants to know what an invoice contains. If they only ask whether the invoice is correct, use check_invoice instead, which returns the verdict without the contents. Side effects: the file is uploaded over HTTPS to the Facturolia API, processed in memory and discarded; nothing is written locally. Requires FACTUROLIA_API_KEY; files over 10 MB are refused; requests are rate limited per key tier and a 429 error means wait and retry.
Inputs: path (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: read_invoice extracts full contents while check_invoice returns only the validation verdict. Their descriptions explicitly cross-reference each other to prevent confusion, so an agent can easily select the right one.
Both tool names follow a consistent verb_noun pattern (read_invoice, check_invoice), using snake_case and clear action words. The only minor deviation is that they are not from the same action family (read vs. check), but this is acceptable given the distinct operations.
With only 2 tools, the surface is quite thin, but for a focused invoice-processing server that offers exactly two complementary operations (read and check), it may be sufficient. However, typical MCP servers have more tools, so this feels slightly minimal.
The domain appears to be electronic invoice handling, and the two tools cover content extraction and validation. Missing operations include invoice creation, listing, or deletion, but for an analysis/validation service, these might be out of scope. Still, there is no way to manage invoices, so the surface is incomplete for a full lifecycle.
Maintenance
Related MCP Connectors
Validate, generate & convert EU e-invoices (UBL, CII, XRechnung, Factur-X) — EN 16931 pre-validated.
Validate, extract, repair and generate French Factur-X / EN16931 invoices via AgentForge API
Validate XRechnung, Peppol BIS 3 and EN 16931 invoices with KoSIT; explain rules; check auto-repair
Validiert E-Rechnungen (ZUGFeRD/Factur-X, XRechnung) gegen EN 16931 mit Korrekturvorschlägen.
Related MCP Servers
AlicenseNot gradedqualityBmaintenanceInvoiceXML brings e-invoice compliance to your AI agent. Create, validate, convert, render, and extract structured invoices across UBL (Peppol BIS Billing 3.0, used worldwide), CII, Factur-X, ZUGFeRD, and XRechnung, all checked against the EN 16931 standard and official Schematron rules. Ask your assistant to generate a compliant invoice, validate one for errors, or convert between formats, with n5MIT- AlicenseAqualityDmaintenanceValidates EU electronic invoices (Peppol, XRechnung, FatturaPA, etc.) and explains validation error codes, enabling AI coding agents to check invoice validity and get fixes before rejection.346 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to locally parse, validate, audit, explain, generate, and convert XRechnung and ZUGFeRD/Factur-X e-invoices using official rule sets, fully offline with no API keys required.Apache 2.0
- AlicenseBqualityCmaintenanceEnables AI assistants to locate invoice files, extract embedded ZUGFeRD/Factur-X XML from PDF/A-3 documents, and validate compliance with § 14 UStG and EN 16931, including direct PDF invoice checks.31MIT