mcp-facturacion-electronica-es

Overview Schema Source Related Servers Discussions Admin

Es Generate B2B Einvoice Es

es__generate_b2b_einvoice_es

Generate a B2B e-invoice compliant with EN 16931 in UBL 2.1 or Facturae 3.2.2 formats, meeting Spain's Crea y Crece requirements.

Instructions

Genera una factura B2B conforme a EN 16931 en formato UBL 2.1 o Facturae 3.2.2.

Según la Ley 18/2022 'Crea y Crece'. RD 238/2026 publicado; formatos confirmados (EN 16931: CII/UBL/EDIFACT/Facturae). Orden Ministerial (Hacienda) pendiente para la solución pública.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`format`	No	Formato de salida: 'ubl' (por defecto) o 'facturae'.	ubl
`invoice`	Yes	Datos de la factura.

Output Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedv0.8.0Aug 26, 2026
- addedInput schema / additionalProperties
```
Added value: +false
```
- removedInput schema / properties / format / enum
```
Removed value: -[
-  "ubl",
-  "facturae"
-]
```
- addedInput schema / properties / invoice / additionalProperties
```
Added value: +true
```
- changedOutput schema / (root)
```
Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "type": "object"
+}
```
First observedv0.0.1May 14, 2026

TDQS

C2.9/5.0

Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No hay anotaciones, por lo que la descripción debe asumir toda la carga de transparencia. Solo menciona la generación conforme a normas, pero no informa sobre efectos secundarios, si valida el contenido, si firma el documento, o si realiza alguna comprobación de obligatoriedad. Para una herramienta de generación compleja, esto es insuficiente.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

La primera frase es directa y va al grano. La segunda frase aporta contexto regulatorio útil aunque no imprescindible para la invocación; el conjunto es breve, estructurado y no contiene relleno excesivo.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

La herramienta tiene un esquema complejo con un objeto 'invoice' sin propiedades definidas y no hay anotaciones. La descripción no explica cómo estructurar los datos de la factura, si el resultado requiere validación o firma posterior, ni cómo se relaciona con las herramientas hermanas de envío a AEAT/FACE. La existencia de output schema no compensa la falta de orientación práctica.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

La cobertura del esquema es del 100%, por lo que la línea base es 3. El parámetro 'format' tiene descripción suficiente ('ubl' por defecto o 'facturae'), pero 'invoice' solo se describe como 'Datos de la factura' y no se detalla su estructura interna ni campos obligatorios, pese a ser un objeto anidado con additionalProperties.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

La descripción indica claramente el verbo ('Genera'), el recurso ('factura B2B') y los formatos de salida ('UBL 2.1 o Facturae 3.2.2'), además de la norma aplicable (EN 16931). Aunque no diferencia explícitamente de herramientas hermanas como generate_facturae_xml, el propósito es claro y accionable.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No se indica cuándo usar esta herramienta frente a alternativas ni cuándo no usarla. La referencia a la Ley 18/2022 y al RD 238/2026 aporta contexto normativo, pero no orienta al agente sobre la elección entre esta herramienta y las relacionadas con Facturae, Verifactu o SII.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.