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
Conecta un agente de IA (Claude, Cursor o cualquier cliente MCP) a 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 (libretto IBAN de los 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 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 con 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 Model Context Protocol
- Llamadas anónimas sujetas a un límite de tasa 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 comprar — 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 clientes que leen un archivo de configuración. type\ también acepta 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 es suficiente. Ú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 anagraficos (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 IBAN italianos, identifica el banco a partir del 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 grandes ciudades y para 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 se conoce — 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 (opcional) 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 de forma determinista 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 de 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 de impuesto opcional, y decide la territorialidad de las operaciones con el extranjero: bienes o servicios, empresa o particular, UE o extra-UE → base imponible en Italia, no imponible, no sujeta o IVA del país de destino (tipo ordinario oficial TEDB), con Natura FatturaPA, anotación en factura y norma a la fecha de la operación (DPR 633/72 hasta 2026, Testo unico IVA desde 2027). Umbral UE de 10.000 € no declarado → dos escenarios calculados. Mantiene separadas las dos bases de la factura de un profesional.
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 taxativos) y país no-UE (error explícito).
calc_split_payment
Calcula la escisión de pagos para 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 tasa (‰) 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.
intrastat_periodicity
Determina si las listas 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 la fecha límite (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 de la lista 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 Servicio Telemático Aduanero: 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 (incluida la de compras de bienes elevada 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 Gazzetta Ufficiale, con búsqueda textual. Sirve para encontrar el tipologia\_id\ que se debe 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 está dentro del 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 de cambio de 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
El libretto de los 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
El gesto 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 correo 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 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.
In English
Imperio exposes verified Italian tax & compliance tools as an MCP server: Codice Fiscale, VAT number, IBAN, ATECO, Italian VAT (incl. reverse charge and split payment), IMU property tax, flat-rate regime, F24 lines, FatturaPA/SDI parsing, INTRASTAT, NIS2 scope and anti-fraud payee verification. Anonymous, zero-cost, rate-limited. The results come from official algorithms and tables — no LLM inference. Connect with claude mcp add --transport http imperio-fisco https://imperioutils.com/api/mcp.