Facturolia

Lee y verifica facturas electrónicas europeas (Factur-X, ZUGFeRD, XRechnung, UBL, CII) contra EN 16931.

GitHubPrueba este MCPPatrocinado

Documentación

Servidor MCP de Facturolia

tests

Permite que un asistente de IA lea y verifique facturas electrónicas europeas.

Apunte Claude (o cualquier cliente compatible con MCP) a una factura .pdf o .xml y responderá con el contenido en lenguaje sencillo, además de una verificación de coherencia contra el estándar europeo EN 16931.

Admite Factur-X, ZUGFeRD, XRechnung, UBL y 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.

Por qué existe esto

Una factura Factur-X es un PDF con datos estructurados ocultos en su interior. La página que una persona lee y los datos que una máquina importa son dos cosas diferentes, y no siempre coinciden. Este servidor expone ambos, para que un asistente pueda responder "¿qué hay realmente en este archivo?" en lugar de leer la página visible y esperar que sea correcta.

Francia hizo obligatoria la facturación electrónica estructurada para la recepción el 1 de septiembre de 2026, por lo que estos archivos ahora están llegando a las bandejas de entrada habituales.

Instalación

Sin dependencias. Solo necesitas Python 3.10 o superior.

  1. Descargue facturolia_mcp.py.
  2. Obtenga una clave API gratuita en facturolia.fr/en/pricing.
  3. Agréguela a la configuración de su cliente. Para Claude Desktop, eso es claude_desktop_config.json:
{
  "mcpServers": {
    "facturolia": {
      "command": "python",
      "args": ["/absolute/path/to/facturolia_mcp.py"],
      "env": { "FACTUROLIA_API_KEY": "your-key" }
    }
  }
}

Reinicie el cliente. Aparecen dos herramientas.

Herramientas

HerramientaQué devuelve
read_invoiceContenido completo: partes, fechas, líneas, desglose de IVA, totales, IBAN, más la verificación EN 16931
check_invoiceSolo el veredicto de cumplimiento y las anomalías, para "¿es correcta esta factura?"

Ambas aceptan un argumento, path, una ruta absoluta a un archivo .pdf o .xml.

Configuración

VariablePredeterminadoSignificado
FACTUROLIA_API_KEYobligatorioSu clave
FACTUROLIA_LANGenIdioma de respuesta, en o fr
FACTUROLIA_BASE_URLhttps://facturolia.frAnulación para pruebas. Debe ser https:// (solo http:// simple para localhost), de lo contrario la clave no se envía

Con FACTUROLIA_LANG=fr las respuestas llegan en francés, con convenciones de fecha y etiquetas francesas. Las descripciones de las herramientas permanecen en inglés para que todos los clientes las entiendan.

Qué hace con su archivo

El archivo se envía a la API de Facturolia para ser analizado. Se procesa en memoria y se descarta inmediatamente, no se almacena ninguna factura y el contenido no aparece en los registros técnicos. Los servidores están en la Unión Europea.

Dicho esto, esto no es procesamiento local. Si su política prohíbe enviar facturas a un servicio externo, use la API usted mismo dentro de su propia red en su lugar, o no use este servidor.

Límites: 10 MB por archivo, solo .pdf y .xml.

Qué no es esto

Lee y verifica facturas. No las emite, no las transmite, y no es una solución de cumplimiento. En Francia, enviar una factura legalmente pasa por una plataforma acreditada (Plateforme Agréée). Esta herramienta se sitúa antes y después de ese paso, nunca en lugar de él.

Pruebas

Solo biblioteca estándar, sin necesidad de red:

python -m unittest discover -s tests

Enlaces

Licencia

MIT. Consulte LICENSE.