Imperio — Italian Tax & Compliance Tools

Ferramentas de impostos e conformidade italianas (Codice Fiscale, P.IVA, IBAN, ATECO, IVA, IMU, forfettario, F24, FatturaPA, Intrastat, escopo NIS2 sob o Decreto Legislativo italiano 138/2024) além de verificação antifraude do beneficiário, citando o artigo para cada etapa. Algoritmos oficiais determinísticos — sem inferência de LLM.

Ver em imperioutils.comExperimente este MCPPatrocinado

Documentação

Servidor MCP — ferramentas fiscais italianas para agentes de IA, sem login

Conecte um agente de IA (Claude, Cursor ou qualquer cliente MCP) às ferramentas fiscais italianas da Imperio: Codice Fiscale, P.IVA, IBAN, ATECO, IVA, IMU, regime forfettario, F24, FatturaPA SDI, INTRASTAT, NIS2 e a verificação antifraude do beneficiário. JSON-RPC 2.0 sobre streamable-HTTP, determinístico — nenhuma inferência de LLM no cálculo. As ferramentas fiscais são anônimas; as ferramentas do guardião (caderno IBAN dos fornecedores) exigem uma chave de API de uma conta gratuita. Comando de conexão e configuração JSON prontos para copiar.

Servidor MCP (Model Context Protocol) que expõe ferramentas fiscais e de conformidade italianas verificadas a um agente de IA: validação de Codice Fiscale/P.IVA/IBAN/PEC, ATECO ISTAT, cálculo de IVA (com reverse charge e split payment), IMU, regime forfettario, linhas F24, parsing FatturaPA/SDI, INTRASTAT, escopo NIS2 e verificação antifraude do beneficiário com VIES ao vivo. Transporte streamable-HTTP, JSON-RPC 2.0, stateless. A autenticação é OPCIONAL: as ferramentas fiscais respondem anonimamente, enquanto as ferramentas do guardião de fornecedores exigem uma chave de API. Os algoritmos são oficiais e determinísticos: nenhum modelo de linguagem produz os resultados.

O que inclui

  • Endpoint único: POST /api/mcp — JSON-RPC 2.0, streamable-HTTP, stateless
  • Ferramentas fiscais: sem login e sem consumo de créditos
  • Guardião de fornecedores: exige uma chave de API (conta gratuita), sempre com zero créditos
  • Algoritmos e tabelas oficiais: nenhuma inferência de LLM no resultado
  • Apenas duas ferramentas com I/O externo (VIES ao vivo), com degradação honesta quando o VIES está fora
  • Publicado no registro oficial do Model Context Protocol
  • Chamadas anônimas sujeitas a um limite de taxa por IP

Preço: grátis

A plataforma está em beta: os pagamentos ainda não estão ativos, portanto os planos pagos não podem ser adquiridos — eles serão abertos em 2027. Tudo o que você vê pode ser usado imediatamente de graça, com as cotas do plano gratuito e sem cartão de crédito.

Como se conectar

Endpoint: POST https://imperioutils.com/api/mcp — JSON-RPC 2.0, transporte streamable-HTTP, stateless (sem ID de sessão). Métodos: initialize, tools/list, tools/call.

Claude Code (CLI)

Um comando. O servidor é remoto: não há nada para instalar.

claude mcp add --transport http imperio-fisco https://imperioutils.com/api/mcp

Configuração JSON (.mcp.json, clientes compatíveis)

A forma declarativa, para clientes que leem um arquivo de configuração. type\ também aceita streamable-http\, o nome usado pela especificação MCP.

{
  "mcpServers": {
    "imperio-fisco": {
      "type": "http",
      "url": "https://imperioutils.com/api/mcp"
    }
  }
}

Clientes que falam apenas stdio

Alguns clientes ainda não falam HTTP com um servidor remoto. A ponte oficial mcp-remote\ traduz: mesma URL, nenhuma chave.

{
  "mcpServers": {
    "imperio-fisco": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://imperioutils.com/api/mcp"
      ]
    }
  }
}

Sem cliente: JSON-RPC 2.0 direto

O servidor é stateless (sem ID de sessão): um POST é suficiente. Útil para testar em dez segundos antes de configurar qualquer coisa.

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"}'

Uma entrada com url\ mas sem type\ é interpretada como servidor stdio e descartada: type\ não é opcional.

Uma chamada real e sua resposta 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"
}

As 28 ferramentas expostas

validate_codice_fiscale

Valida um Codice Fiscale italiano (formato + caractere de controle, com gerenciamento de omocodia).

generate_codice_fiscale

Gera o Codice Fiscale "base" a partir de dados pessoais (sobrenome, nome, data, sexo, município/estado de nascimento ou código Belfiore). A variante omocódica em caso de colisão é atribuída pela Agenzia delle Entrate, não é calculável.

validate_partita_iva

Valida uma Partita IVA italiana (11 dígitos + checksum).

validate_iban

Valida um IBAN (checksum MOD-97) e, para IBANs italianos, identifica o banco pelo código ABI.

lookup_cap

Retorna a área/província INDICATIVA de um CAP italiano a partir do prefixo de 2 dígitos (não o município): aproximado para grandes cidades e para províncias criadas após 2004.

validate_pec

Valida um endereço PEC: formato + domínio comparado com a lista de provedores certificados AGID, com nível de confiança.

lookup_ateco

Pesquisa e valida um código ATECO 2007 ISTAT e retorna a descrição da atividade.

search_ateco

Pesquisa de texto completo nos códigos ATECO ISTAT a partir da descrição da atividade ("fotógrafo", "desenvolvimento de software") em vez do código; também aceita um prefixo de código. Use quando o código NÃO for conhecido — lookup\_ateco\ serve para o caso oposto.

calc_forfettario

Calcula imposto substitutivo e contribuições INPS do regime forfettario a partir do faturamento e (opcionalmente) do código ATECO.

parse_fatturapa

Extrai dados estruturados (cedente, cessionário, linhas, impostos) de um XML FatturaPA/SDI. Apenas parsing: nenhuma verificação VIES.

parse_verify_fatturapa

Extrai os dados de um XML FatturaPA/SDI E verifica antifraude do fornecedor na mesma chamada: as partes são extraídas deterministicamente do XML (sem LLM), depois IBAN, P.IVA/CF e — quando alcançável — a razão social VIES ao vivo produzem um veredito. Segunda e última ferramenta com I/O externo: mesma cache, mesmo orçamento VIES e mesma degradação honesta de verify\_payee\, uma única consulta VIES por chamada.

calc_iva

Calcula o IVA italiano sobre uma base tributável (22/10/5/4/0/isento/fora do campo), com retenção na fonte opcional e regimes não tributáveis intra-UE e exportação. Mantém distintas as duas bases da fatura de um profissional: a contribuição integrativa da caixa entra na base do IVA, mas não na da retenção; a rivalsa INPS entra em ambas.

calc_reverse_charge

Calcula o IVA que o cessionário deve autoliquidar em regime de inversão contábil e as obrigações das duas partes com a norma aplicável: distingue reverse charge intracomunitário (art. 46 DL 331/93 / art. 17 c.2 DPR 633/72), interno (art. 17 c.6 — apenas setores taxativos) e país não-UE (erro explícito).

calc_split_payment

Calcula a cisão de pagamentos para fornecimentos à administração pública (art. 17-ter DPR 633/72): o fornecedor recebe apenas a base tributável, o IVA é pago pela administração pública ao Erário. Retorna os dois valores, o impacto de liquidez e as instruções FatturaPA (EsigibilitaIVA=S, sem códigos Natura N6).

calc_imu

Calcula o IMU (L. 160/2019) para edifícios, terrenos agrícolas e áreas edificáveis, com entrada e saldo. A alíquota (‰) é a deliberada pelo município e deve ser fornecida na entrada.

compose_f24

Compõe as LINHAS do modelo F24 (Erário, INPS, IMU) com códigos de tributo e causais oficiais a partir de valores já calculados. Componível com as saídas de calc_forfettario e calc_imu. NÃO gera o modelo ministerial nem um fac-símile.

intrastat_periodicity

Determina se as listas resumidas INTRASTAT devem ser apresentadas e com qual periodicidade (mensal, trimestral ou nenhuma obrigação) a partir dos valores dos quatro trimestres anteriores, e calcula o prazo (dia 25 do mês seguinte, com deslocamento para sábado, domingo e feriados nacionais). Retorna o limite aplicado com sua fonte normativa.

intrastat_compose

Compõe e valida as seções da lista resumida INTRASTAT (INTRA-1bis/ter/quater/quinquies/sexies e INTRA-2bis/ter/quater/quinquies) a partir das linhas de operação: Estado-membro admitido, partita IVA da contraparte, nomenclatura combinada, campos obrigatórios por seção. NÃO gera o arquivo telemático para o Serviço Telemático Aduaneiro: produz estrutura de dados e quadro de controle.

intrastat_reference

Sem entrada: Estados-membros admitidos, seções dos modelos INTRASTAT, cada limite vigente com critério, efeito e fonte normativa (incluindo o de compras de bens elevado a € 2.000.000 a partir do período 01/2026), prazo de apresentação e a lista explícita do que NÃO é gerado.

nis2_tipologie

Lista oficial dos tipos de sujeito dos anexos I–IV do D.Lgs. 138/2024 (transposição NIS2), verbatim do texto da Gazzetta Ufficiale, com pesquisa textual. Serve para encontrar o tipologia\_id\ a passar para nis2\_ambito\. Não existe nenhum mapa ATECO → tipo e esta ferramenta não usa um: o escopo é determinado pelo tipo de atividade, não pelo código ATECO.

nis2_ambito

Diz se um sujeito está no campo de aplicação do D.Lgs. 138/2024 (NIS2) e se é sujeito ESSENCIAL ou IMPORTANTE, citando artigo e parágrafo para cada passo do raciocínio. Lógica de três valores: se um dado ausente não muda o resultado, não é solicitado; se o bloqueia, a ferramenta responde indeterminato\ e diz exatamente qual dado é necessário.

nis2_reference

Sem entrada: os limites dimensionais NIS2 com a fórmula exata de superação e a fonte (recomendação 2003/361/CE, anexos I–IV, arts. 3 e 6 do D.Lgs. 138/2024), as categorias sempre-essenciais e os avisos (DORA para bancos e mercados financeiros, consolidação de grupo).

verify_payee

Verificação antifraude de um beneficiário antes de pagar uma fatura (golpe de troca de IBAN / BEC): IBAN, P.IVA, CF e — quando alcançável — razão social via VIES ao vivo. Uma das duas únicas ferramentas com I/O externo (a outra é parse\_verify\_fatturapa\, que reutiliza esta mesma verificação): se o VIES estiver fora ou o orçamento esgotado, o veredito degrada honestamente para "atenção", nunca para um falso "ok".

guardian_list_suppliers

Os fornecedores monitorados por esta conta, com o status da última verificação VIES e quantos IBANs estão confirmados ou pendentes. Os IBANs saem mascarados.

guardian_supplier_ledger

O caderno de IBANs de um fornecedor: quais estão confirmados, quais aguardando confirmação humana, quais rejeitados e desde quando. É a memória contra a qual um novo IBAN é julgado.

guardian_supplier_status

Se um fornecedor é monitorado e como foi a última verificação: resultado VIES, se a resposta era autoritativa, desde quando não se obtém uma, anomalias detectadas.

guardian_check_iban

O gesto anti-BEC: compara o IBAN lido em uma fatura com o histórico daquele fornecedor e diz se já está confirmado, já visto mas nunca confirmado, ou NUNCA VISTO. Modifica o estado (registra o IBAN como "pendente") e envia um e-mail de aviso. A CONFIRMAÇÃO de um IBAN não é exposta aos agentes: exige uma pessoa.

guardian_watch_supplier

Coloca um ou mais fornecedores sob vigilância, para que suas mudanças de IBAN e variações VIES sejam interceptadas pelas verificações noturnas. Os IBANs indicados entram como "pendentes de confirmação", nunca como confirmados.

Registro oficial

O servidor está publicado no registro oficial do 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.