Servidor MCP

Dale a Claude, Cursor o cualquier agente de IA compatible con MCP acceso directo a la facturación electrónica — valida, repara, genera y convierte facturas de la UE desde dentro de una conversación, sin integraciones separadas que escribir.

Qué es

CrateAPI ofrece un servidor Model Context Protocol (MCP) para la API de facturación electrónica. Apunta un agente compatible con MCP — Claude Desktop, Claude Code, Cursor o tu propio bucle de agente — hacia él, y obtiene cuatro herramientas que puede llamar directamente: validar una factura, reparar una, generar una a partir de datos estructurados o convertir entre sintaxis UBL y CII. El agente lee las descripciones de las herramientas y decide por sí mismo cuándo usarlas; la lógica de facturación en sí corre sobre la misma API determinista que el resto de CrateAPI.

Herramientas disponibles

Cuatro herramientas, un solo proceso. Cada una actúa como proxy hacia exactamente la misma API pública que puedes llamar por HTTP — mismas reglas, mismos límites, mismas respuestas.

validate_invoicegratis

Comprueba una factura XML (UBL o CII) frente a las reglas oficiales de EN 16931, Peppol BIS, XRechnung, RO_CIUS y BR-FR. Devuelve un informe estructurado — válida o no, recuento de errores/avisos, hallazgos. No necesita clave API.

repair_invoicerequiere clave API

Reparación automática de mejor esfuerzo: corrige formatos de fecha no ISO y totales que no cuadran, recalculados a partir de las líneas. Nunca inventa datos de negocio que faltan — informa de lo que pudo corregir y lo que no.

generate_invoicerequiere clave API

Construye un XML de factura conforme (UBL o CII) a partir de un modelo JSON estructurado de factura — vendedor, comprador, líneas, totales.

convert_invoicerequiere clave API

Convierte una factura entre sintaxis UBL y CII, sin pérdidas o rechazada: si algo no se puede convertir con limpieza, la operación falla con un motivo claro en lugar de perder datos en silencio.

Cómo lo ejecutas

Autoalojado, funciona ya hoy con tu propia clave API. Añade esto a la configuración de tu cliente MCP — Claude Desktop, Claude Code, Cursor o cualquier otro agente compatible con MCP:

{"mcpServers": {"crateapi-einvoicing": {
    "command": "python", "args": ["-m", "einvoicing.mcp_server"],
    "env": {"EINVOICE_API_KEY": "your-key-here"}}}}

validate_invoice no necesita clave alguna. Las otras tres leen EINVOICE_API_KEY del entorno — consigue una en la página de precios. EINVOICE_API_BASE puede sobrescribir la API de destino, útil para apuntar a una instancia local o de pruebas.

Autoalojado, por ahora. Todavía no existe un endpoint alojado mcp.crateapi.com — tú mismo ejecutas el servidor, un único proceso Python (python -m einvoicing.mcp_server), que llama a la misma API de producción con tu propia clave. Si surge suficiente demanda de una versión alojada, la construiremos; por ahora, este es el estado honesto de las cosas.

Por qué importa

Los agentes de IA redactan, revisan y presentan cada vez más documentos empresariales. Si el tuyo puede llamar a estas herramientas directamente, puede validar una factura antes de enviarla, o generar una conforme bajo demanda, en lugar de equivocarse de formato y descubrirlo días después con un rechazo. El motor detrás de las herramientas es el mismo que hay detrás del resto de CrateAPI — determinista, cero LLM en tiempo de ejecución (ver Trust & Security) — el agente decide cuándo llamar a una herramienta, las reglas de la factura en sí siguen basadas en reglas, nunca adivinadas.

¿Quieres comprobarlo tú mismo?

Cada herramienta de arriba llama a la misma API que puedes llamar hoy mismo — lee la referencia completa o prueba el validador gratuito con tu propia factura.

Probar el validador gratuito Leer la documentación