mcp-facturacion-electronica-es

Overview Schema Source Related Servers Discussions Admin

Es Detect Regional Regime

es__detect_regional_regime

Determine the Spanish electronic invoicing regime from a two-digit INE province code. Returns VERIFACTU, TICKETBAI, NATICKET, or VERIFACTU+SII. Run this first before calling other invoicing tools.

Instructions

Detecta el régimen de facturación electrónica aplicable.

A partir del código de provincia INE de dos dígitos. Devuelve VERIFACTU, TICKETBAI, NATICKET o VERIFACTU+SII. Usar siempre antes de llamar a cualquier otra herramienta de este servidor.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`province_code`	Yes	Código de provincia INE de dos dígitos (p. ej., '28', '01', '31').
`enrolled_in_sii`	No	Inscripción en el SII (por defecto: false).

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
```

changedInput schema / properties / province_code / description

Previous value: -"Código de provincia INE de dos dígitos (p. ej., '28', '01', '31')."New value: +"Código de provincia INE de dos dígitos (p. ej.,\n'28', '01', '31')."

removedInput schema / properties / province_code / pattern
```
Removed value: -"^[0-9]{1,2}$"
```

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "type": "object"
+}

First observedv0.0.1May 14, 2026

TDQS

A4.3/5.0

Behavior3/5

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

No hay anotaciones, y la descripción aporta que la herramienta devuelve un valor dentro de un conjunto finito y que depende de la provincia y de la inscripción en SII. Sin embargo, no dice explícitamente si es solo de lectura, si hace llamadas externas o si requiere autenticación/precondiciones. Aunque 'Detecta' sugiere una operación de consulta, el margen de mejora está en declarar esa naturaleza read-only.

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

Conciseness5/5

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

La descripción es breve y directa: tres frases, cada una con una función clara (qué hace, de dónde sale, cuándo usarla). No hay relleno y la información importante está al principio.

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

Completeness5/5

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

Para una herramienta con solo 2 parámetros, schema descrito al 100% y output schema declarado, la descripción proporciona lo esencial: propósito, entradas básicas, valores de salida y directriz de uso. No es necesario ampliar formato de retorno porque el output schema lo cubre.

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?

El input-schema ya documenta el 100% de los parámetros: province_code con formato y ejemplos, y enrolled_in_sii con valor por defecto. La descripción agrega el propósito global y los valores de salida, pero no explica explícitamente cómo enrolled_in_sii=true modifica el resultado (p. ej., cuándo aparece VERIFACTU+SII), por lo que se queda en la referencia mínima.

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

Purpose5/5

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

La descripción comienza con un verbo específico ('Detecta el régimen de facturación electrónica aplicable') y define el recurso (código de provincia INE) y los posibles resultados (VERIFACTU, TICKETBAI, NATICKET, VERIFACTU+SII). Esto la distingue de las herramientas hermanas de generación, validación, envío y consulta, al presentarla como una etapa previa de decisión.

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

Usage Guidelines5/5

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

La frase 'Usar siempre antes de llamar a cualquier otra herramienta de este servidor' es una pauta de uso explícita y jerárquica. No hay ambigüedad sobre cuándo invocarla: siempre antes de cualquier otra herramienta, lo cual compensa la ausencia de una sección de alternativas.

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