Factur-X by Orvel

Servidor MCP de Factur-X

Genera, valida y lee facturas electrónicas Factur-X / EN 16931 (Francia, UE) desde cualquier cliente MCP.
Servidor remoto, sin instalación. PDF/A-3 · CII · UBL 2.1 · Reglas francesas fr-ctc.

Documentación · Guía MCP · Precios (clave gratuita, sin tarjeta) · Informe de conformidad · Estado

---

Endpoint: https://facturx.orvel.dev/mcp (HTTP Streamable, sin estado) Registro: io.github.LeBorgneAntoine/facturx en el registro oficial de MCP

Francia hace obligatoria la facturación electrónica para todas las empresas sujetas a IVA (recepción desde septiembre de 2026, emisión 2026–2027). Factur-X es el formato híbrido PDF + XML de esa reforma. Este servidor permite que un agente de IA en Claude, Cursor, VS Code, ChatGPT o tu propia aplicación produzca, verifique y lea facturas conformes sin escribir una integración.

Herramientas

Herramienta	Qué hace
generate_invoice	JSON de factura → PDF/A-3 Factur-X, XML CII o XML UBL. Perfiles MINIMUM → EXTENDED, EN 16931, renderizado FR/EN
embed_xml	Adjunta un XML Factur-X a tu propio PDF y produce un PDF/A-3 válido
validate_invoice	XSD + schematron EN 16931 (+ fr-ctc francés), hallazgos estructurados con identificadores de regla
extract_invoice	Lee una factura electrónica PDF o XML: partes, totales, desglose de IVA, líneas

Recursos: facturx://schema/invoice (JSON Schema del objeto de factura) y facturx://guide/french-reform.

Todas las herramientas son readOnlyHint / idempotentHint. No se almacena nada en el servidor. initialize, tools/list y resources/* funcionan sin clave para que puedas inspeccionar el servidor antes de elegir un plan.

Conectar

Obtén una clave en facturx.orvel.dev/docs/pricing (Plan gratuito: 50 documentos/mes, sin tarjeta) y envíala como Authorization: Bearer <key>.

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "facturx": {
      "url": "https://facturx.orvel.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "facturx": {
      "type": "http",
      "url": "https://facturx.orvel.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Claude Code

claude mcp add --transport http facturx https://facturx.orvel.dev/mcp --header "Authorization: Bearer YOUR_KEY"

Claude Desktop (los conectores personalizados aún no pueden enviar encabezados, así que usa un puente con mcp-remote)

{
  "mcpServers": {
    "facturx": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://facturx.orvel.dev/mcp", "--header", "Authorization: Bearer ${FACTURX_KEY}"],
      "env": { "FACTURX_KEY": "YOUR_KEY" }
    }
  }
}

Más clientes (SDK de Python, AgenticMarket de pago por llamada) en la guía MCP.

Ejemplos de indicaciones

• "Genera una factura Factur-X para esta cotización: vendedor Atelier Numérique SAS (SIREN 732829320, IVA FR40732829320, París), comprador Boulangerie Dupont (SIREN 552081317, Lyon), 1 × desarrollo web 2500 EUR sin IVA al 20 %, 12 meses de hosting a 15 EUR, vencimiento en 30 días."
• "Valida la factura de proveedor adjunta según las reglas francesas y explica cada regla fallida en palabras sencillas."
• "Extrae los totales y el desglose de IVA de estos tres PDF y dame una tabla."

Conformidad

Cada muestra publicada se valida con un motor independiente (Mustangproject, el validador de referencia de código abierto de Factur-X): XSD, schematron EN 16931, reglas francesas CTC, PDF/A-3 con el factur-x.xml incrustado. Informes y pasos de reproducción: Conformidad.

API REST

El mismo motor está disponible como API REST (/v1/invoices/generate, /v1/validate, /v1/extract, OpenAPI en /openapi.json). Una clave, ambas interfaces, una cuota. Consulta la referencia de API.

Acerca de

Construido y operado por Orvel (Antoine Le Borgne, Francia). Alojado en la UE (Railway, Ámsterdam). Soporte: support@orvel.dev.

Este repositorio contiene el manifiesto público (server.json), los recursos de marca y los ejemplos de clientes del servidor alojado. El motor en sí es de código cerrado.