Imperio — Italian Tax & Compliance Tools
Herramientas de impuestos y cumplimiento italiano (Codice Fiscale, P.IVA, IBAN, ATECO, IVA, IMU, forfettario, F24, FatturaPA, Intrastat, alcance NIS2 según el Decreto Legislativo italiano 138/2024) más verificación antifraude del beneficiario, citando el artículo en cada paso. Algoritmos oficiales deterministas: sin inferencia de LLM.
Documentación
Servidor MCP — herramientas fiscales italianas para agentes de IA, sin inicio de sesión
Conecta un agente de IA (Claude, Cursor o cualquier cliente MCP) con las herramientas fiscales italianas de Imperio: Codice Fiscale, P.IVA, IBAN, ATECO, IVA, IMU, régimen forfettario, F24, FatturaPA SDI, INTRASTAT, NIS2 y la verificación antifraude del beneficiario. JSON-RPC 2.0 sobre streamable-HTTP, determinista — sin inferencia LLM en el cálculo. Las herramientas fiscales son anónimas; las herramientas del guardián (libreta IBAN de proveedores) requieren una API key de una cuenta gratuita. Comando de conexión y configuración JSON listos para copiar.
Servidor MCP (Model Context Protocol) que expone herramientas fiscales y de cumplimiento italianas verificadas a un agente de IA: validación de Codice Fiscale/P.IVA/IBAN/PEC, ATECO ISTAT, cálculo de IVA (con reverse charge y split payment), IMU, régimen forfettario, líneas F24, parsing de FatturaPA/SDI, INTRASTAT, ámbito NIS2 y verificación antifraude del beneficiario con VIES en vivo. Transporte streamable-HTTP, JSON-RPC 2.0, stateless. La autenticación es OPCIONAL: las herramientas fiscales responden de forma anónima, mientras que las herramientas del guardián de proveedores exigen una API key. Los algoritmos son oficiales y deterministas: ningún modelo lingüístico produce los resultados.
Qué incluye
- Endpoint único: POST /api/mcp — JSON-RPC 2.0, streamable-HTTP, stateless
- Herramientas fiscales: sin inicio de sesión y sin consumo de créditos
- Guardián de proveedores: requiere una API key (cuenta gratuita), siempre a cero créditos
- Algoritmos y tablas oficiales: sin inferencia LLM en el resultado
- Solo dos herramientas con I/O externo (VIES en vivo), con degradación honesta cuando VIES está caído
- Publicado en el registro oficial de Model Context Protocol
- Llamadas anónimas sujetas a un límite de frecuencia por IP
Precio: gratis
La plataforma está en beta: los pagos aún no están activos, por lo que los planes de pago no se pueden adquirir — se abren en 2027. Todo lo que ves se puede usar de inmediato gratis, con las cuotas del plan gratuito y sin tarjeta de crédito.
Cómo conectarse
Endpoint: POST https://imperioutils.com/api/mcp — JSON-RPC 2.0, transporte streamable-HTTP, stateless (sin session id). Métodos: initialize, tools/list, tools/call.
Claude Code (CLI)
Un comando. El servidor es remoto: no hay nada que instalar.
claude mcp add --transport http imperio-fisco https://imperioutils.com/api/mcp
Configuración JSON (.mcp.json, clientes compatibles)
La forma declarativa, para los clientes que leen un archivo de configuración. type\ acepta también streamable-http\, el nombre que usa la especificación MCP.
{
"mcpServers": {
"imperio-fisco": {
"type": "http",
"url": "https://imperioutils.com/api/mcp"
}
}
}
Clientes que solo hablan stdio
Algunos clientes aún no hablan HTTP hacia un servidor remoto. El puente oficial mcp-remote\ traduce: misma URL, sin clave.
{
"mcpServers": {
"imperio-fisco": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://imperioutils.com/api/mcp"
]
}
}
}
Sin cliente: JSON-RPC 2.0 directo
El servidor es stateless (sin session id): una POST basta. Útil para probarlo en diez segundos antes de configurar cualquier cosa.
curl -s -X POST https://imperioutils.com/api/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Una entrada con url\ pero sin type\ se interpreta como servidor stdio y se descarta: type\ no es opcional.
Una llamada real, y su respuesta real
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "validate_partita_iva",
"arguments": {
"partita_iva": "00743110157"
}
}
}
{
"valid": true,
"partita_iva": "00743110157",
"formatted": "0074311 015 7",
"province_code": "015",
"progressive_code": "0074311",
"check_digit": "7"
}
Las 28 herramientas expuestas
validate_codice_fiscale
Valida un Codice Fiscale italiano (formato + carácter de control, con gestión de omocodia).
generate_codice_fiscale
Genera el Codice Fiscale "base" a partir de datos personales (apellido, nombre, fecha, sexo, municipio/estado de nacimiento o código Belfiore). La variante omocódica en caso de colisión la asigna la Agenzia delle Entrate, no es calculable.
validate_partita_iva
Valida una Partita IVA italiana (11 dígitos + checksum).
validate_iban
Valida un IBAN (checksum MOD-97) y, para los IBAN italianos, identifica el banco por el código ABI.
lookup_cap
Devuelve el área/provincia INDICATIVA de un CAP italiano a partir del prefijo de 2 dígitos (no el municipio): aproximado para las grandes ciudades y para las provincias creadas después de 2004.
validate_pec
Valida una dirección PEC: formato + dominio comparado con la lista de proveedores certificados AGID, con nivel de confianza.
lookup_ateco
Busca y valida un código ATECO 2007 ISTAT y devuelve la descripción de la actividad.
search_ateco
Búsqueda de texto completo en los códigos ATECO ISTAT a partir de la descripción de la actividad ("fotógrafo", "desarrollo de software") en lugar del código; también acepta un prefijo de código. Para usar cuando el código NO es conocido — lookup\_ateco\ sirve para el caso opuesto.
calc_forfettario
Calcula el impuesto sustitutivo y las contribuciones INPS del régimen forfettario a partir de la facturación y (opcionalmente) del código ATECO.
parse_fatturapa
Extrae datos estructurados (cedente, cesionario, líneas, impuestos) de un XML FatturaPA/SDI. Solo parsing: sin verificación VIES.
parse_verify_fatturapa
Extrae los datos de un XML FatturaPA/SDI Y verifica antifraude al proveedor en la misma llamada: las partes se extraen determinísticamente del XML (sin LLM), luego IBAN, P.IVA/CF y — cuando es alcanzable — la razón social VIES en vivo producen un veredicto. Segunda y última herramienta con I/O externo: misma caché, mismo presupuesto VIES y misma degradación honesta que verify\_payee\, una sola consulta VIES por llamada.
calc_iva
Calcula el IVA italiano sobre una base imponible (22/10/5/4/0/exento/fuera de campo), con retención a cuenta opcional y regímenes no imponibles intra-UE y export. Mantiene distintas las dos bases de la factura de un profesional: la contribución integrativa de la caja entra en la base del IVA pero no en la de la retención, la repercusión INPS en ambas.
calc_reverse_charge
Calcula el IVA que el cesionario debe autoliquidar en régimen de inversión contable y las obligaciones de las dos partes con la norma aplicable: distingue reverse charge intracomunitario (art. 46 DL 331/93 / art. 17 c.2 DPR 633/72), interno (art. 17 c.6 — solo sectores tasados) y país no-UE (error explícito).
calc_split_payment
Calcula la escisión de pagos para los suministros a la PA (art. 17-ter DPR 633/72): el proveedor cobra solo la base imponible, el IVA lo paga la PA al Erario. Devuelve los dos importes, el impacto de liquidez y las instrucciones FatturaPA (EsigibilitaIVA=S, sin códigos Natura N6).
calc_imu
Calcula el IMU (L. 160/2019) para edificios, terrenos agrícolas y áreas edificables, con pago a cuenta y saldo. La alícuota (‰) es la deliberada por el Municipio y debe proporcionarse como entrada.
compose_f24
Compone las LÍNEAS del modelo F24 (Erario, INPS, IMU) con códigos de tributo y causales oficiales a partir de importes ya calculados. Componible con las salidas de calc_forfettario y calc_imu. NO genera el modelo ministerial ni un facsímil del mismo.
intrastat_periodicity
Determina si los listados resumen INTRASTAT deben presentarse y con qué periodicidad (mensual, trimestral o sin obligación) a partir de los montos de los cuatro trimestres anteriores, y calcula el vencimiento (día 25 del mes siguiente, con desplazamiento por sábado, domingo y festivos nacionales). Devuelve el umbral aplicado con su fuente normativa.
intrastat_compose
Compone y valida las secciones del listado resumen INTRASTAT (INTRA-1bis/ter/quater/quinquies/sexies e INTRA-2bis/ter/quater/quinquies) a partir de las líneas de operación: Estado miembro admitido, partita IVA de la contraparte, nomenclatura combinada, campos obligatorios por sección. NO genera el archivo telemático para el Servizio Telematico Doganale: produce estructura de datos y prospecto de control.
intrastat_reference
Sin entrada: Estados miembros admitidos, secciones de los modelos INTRASTAT, cada umbral vigente con criterio, efecto y fuente normativa (incluido el de compras de bienes elevado a € 2.000.000 desde el período 01/2026), plazo de presentación y la lista explícita de lo que NO se genera.
nis2_tipologie
Lista oficial de los tipos de sujeto de los anexos I–IV del D.Lgs. 138/2024 (transposición NIS2), verbatim del texto de la Gazzetta Ufficiale, con búsqueda textual. Sirve para encontrar el tipologia\_id\ que pasar a nis2\_ambito\. No existe ningún mapa ATECO → tipo y esta herramienta no usa uno: el ámbito se determina por el tipo de actividad, no por el código ATECO.
nis2_ambito
Indica si un sujeto entra en el campo de aplicación del D.Lgs. 138/2024 (NIS2) y si es sujeto ESENCIAL o IMPORTANTE, citando artículo y apartado para cada paso del razonamiento. Lógica de tres valores: si un dato faltante no cambia el resultado no se pide; si lo bloquea, la herramienta responde indeterminato\ y dice exactamente qué dato se necesita.
nis2_reference
Sin entrada: los umbrales dimensionales NIS2 con la fórmula exacta de superación y la fuente (recomendación 2003/361/CE, anexos I–IV, arts. 3 y 6 del D.Lgs. 138/2024), las categorías siempre-esenciales y las advertencias (DORA para bancos y mercados financieros, consolidación de grupo).
verify_payee
Verificación antifraude de un beneficiario antes de pagar una factura (estafa del cambio-IBAN / BEC): IBAN, P.IVA, CF y — cuando es alcanzable — razón social vía VIES en vivo. Una de las dos únicas herramientas con I/O externo (la otra es parse\_verify\_fatturapa\, que reutiliza esta misma verificación): si VIES está caído o el presupuesto está agotado, el veredicto degrada honestamente a "atención", nunca a un falso "ok".
guardian_list_suppliers
Los proveedores vigilados por esta cuenta, con el estado de la última verificación VIES y cuántos IBAN resultan confirmados o en espera. Los IBAN salen enmascarados.
guardian_supplier_ledger
La libreta de IBAN de un proveedor: cuáles están confirmados, cuáles en espera de confirmación humana, cuáles rechazados, y desde cuándo. Es la memoria contra la que se juzga un IBAN nuevo.
guardian_supplier_status
Si un proveedor está vigilado y cómo fue la última verificación: resultado VIES, si la respuesta era autoritativa, desde cuándo no se obtiene una, anomalías detectadas.
guardian_check_iban
La acción anti-BEC: compara el IBAN leído en una factura con el historial de ese proveedor y dice si ya está confirmado, ya visto pero nunca confirmado, o NUNCA VISTO. Modifica el estado (registra el IBAN como "en espera") y envía un email de aviso. La CONFIRMACIÓN de un IBAN no está expuesta a los agentes: requiere una persona.
guardian_watch_supplier
Pone uno o más proveedores bajo vigilancia, para que sus cambios de IBAN y las variaciones VIES sean interceptados por las verificaciones nocturnas. Los IBAN indicados entran como "en espera de confirmación", nunca como confirmados.
Registro oficial
El servidor está publicado en el registro oficial del Model Context Protocol como com.imperioutils/fisco-it.
En inglés
Imperio expone herramientas fiscales y de cumplimiento italianas verificadas como servidor MCP: Codice Fiscale, número de IVA, IBAN, ATECO, IVA italiano (incl. reverse charge y split payment), impuesto sobre la propiedad IMU, régimen de tasa plana, líneas F24, parsing FatturaPA/SDI, INTRASTAT, ámbito NIS2 y verificación antifraude del beneficiario. Anónimo, sin coste, con límite de frecuencia. Los resultados provienen de algoritmos y tablas oficiales — sin inferencia LLM. Conéctate con claude mcp add --transport http imperio-fisco https://imperioutils.com/api/mcp.