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.