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 — alojado por nosotros, o ejecutado por ti mismo. 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

Dos formas de conectarte — las mismas cuatro herramientas en ambos casos.

Endpoint alojado

Añade la URL directamente a la configuración de tu cliente MCP. Nada que instalar, nada que mantener en ejecución. validate_invoice funciona sin ninguna clave; las otras tres leen la cabecera X-API-Key.

{"mcpServers": {"crateapi-einvoicing": {
    "type": "http", "url": "https://api.crateapi.com/mcp",
    "headers": {"X-API-Key": "your-key-here"}}}}

Los nombres exactos de los campos type/url/headers varían un poco entre clientes MCP (Claude Desktop, Claude Code, Cursor…) — ajústalos al tuyo. Validar mediante el endpoint alojado sin clave está limitado por uso razonable (fair-use) por IP, igual que el validador gratuito del sitio (10/min · 50/día · 200/mes); una clave API válida elimina ese límite y pasa a la cuota de tu plan.

Autoalojado

¿Prefieres ejecutarlo tú mismo — por privacidad, un entorno aislado (air-gapped) o desarrollo local? Sigue siendo un único proceso Python, que llama a la misma API de producción con tu propia clave:

{"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.

Ambos son reales. El endpoint alojado ejecuta exactamente el mismo código de herramientas que el proceso autoalojado — mismas reglas, mismos límites, mismas respuestas. Usa la URL alojada para cero configuración, o autoalojado para control local total.

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

Valida tu factura electrónica gratisSin registro. Pega o sube, informe al instante.

Abrir el validador →