Server MCP — strumenti fiscali italiani per agenti AI, senza login e senza API key

Collega un agente AI (Claude, Cursor, o qualunque client MCP) agli strumenti fiscali italiani di Imperio: Codice Fiscale, P.IVA, IBAN, ATECO, IVA, IMU, regime forfettario, F24, FatturaPA SDI, INTRASTAT, NIS2 e la verifica anti-frode del beneficiario. JSON-RPC 2.0 su streamable-HTTP, anonimo e deterministico — nessuna inferenza LLM sul calcolo. Comando di connessione e configurazione JSON pronti da copiare.

Server MCP (Model Context Protocol) che espone strumenti fiscali e di compliance italiani verificati a un agente AI: validazione Codice Fiscale/P.IVA/IBAN/PEC, ATECO ISTAT, calcolo IVA (con reverse charge e split payment), IMU, regime forfettario, righe F24, parsing FatturaPA/SDI, INTRASTAT, ambito NIS2 e verifica anti-frode del beneficiario con VIES live. Trasporto streamable-HTTP, JSON-RPC 2.0, stateless, senza autenticazione. Gli algoritmi sono ufficiali e deterministici: nessun modello linguistico produce i risultati.

Cosa include

Endpoint unico: POST /api/mcp — JSON-RPC 2.0, streamable-HTTP, stateless
Nessun login, nessuna API key, nessun consumo di crediti
Algoritmi e tabelle ufficiali: nessuna inferenza LLM sul risultato
Due soli tool con I/O esterno (VIES live), con degrado onesto quando VIES è giù
Pubblicato sul registry ufficiale Model Context Protocol
Chiamate anonime soggette a un rate limit per IP

Prezzo: gratis

La piattaforma è in beta: i pagamenti non sono ancora attivi, quindi i piani a pagamento non sono acquistabili — si aprono nel 2027. Tutto quello che vedi si usa da subito gratis, con le quote del piano gratuito e senza carta di credito.

Come ci si collega

Endpoint: POST https://imperioutils.com/api/mcp — JSON-RPC 2.0, trasporto streamable-HTTP, stateless (nessun session id). Metodi: initialize, tools/list, tools/call.

Claude Code (CLI)

Un comando. Il server è remoto: non c'è niente da installare.

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

Configurazione JSON (.mcp.json, client compatibili)

La forma dichiarativa, per i client che leggono un file di configurazione. `type` accetta anche `streamable-http`, il nome che usa la specifica MCP.

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

Client che parlano solo stdio

Alcuni client non parlano ancora HTTP verso un server remoto. Il ponte ufficiale `mcp-remote` traduce: stessa URL, nessuna chiave.

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

Senza client: JSON-RPC 2.0 diretto

Il server è stateless (nessun session id): una POST basta. Utile per provarlo in dieci secondi prima di configurare qualsiasi 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 voce con `url` ma senza `type` viene interpretata come server stdio e scartata: `type` non è opzionale.

Una chiamata vera, e la sua risposta vera

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

I 23 tool esposti

validate_codice_fiscale: Valida un Codice Fiscale italiano (formato + carattere di controllo, con gestione omocodia).
generate_codice_fiscale: Genera il Codice Fiscale "base" da dati anagrafici (cognome, nome, data, sesso, comune/stato di nascita o codice Belfiore). La variante omocodica in caso di collisione è assegnata dall'Agenzia delle Entrate, non calcolabile.
validate_partita_iva: Valida una Partita IVA italiana (11 cifre + checksum).
validate_iban: Valida un IBAN (checksum MOD-97) e, per gli IBAN italiani, identifica la banca dal codice ABI.
lookup_cap: Restituisce l'area/provincia INDICATIVA di un CAP italiano dal prefisso a 2 cifre (non il comune): approssimativo per le grandi città e per le province istituite dopo il 2004.
validate_pec: Valida un indirizzo PEC: formato + dominio confrontato con l'elenco dei provider certificati AGID, con livello di confidenza.
lookup_ateco: Cerca e valida un codice ATECO 2007 ISTAT e restituisce la descrizione dell'attività.
search_ateco: Ricerca full-text sui codici ATECO ISTAT partendo dalla descrizione dell'attività ("fotografo", "sviluppo software") invece che dal codice; accetta anche un prefisso di codice. Da usare quando il codice NON è noto — `lookup_ateco` serve al caso opposto.
calc_forfettario: Calcola imposta sostitutiva e contributi INPS del regime forfettario dal fatturato e (opzionale) dal codice ATECO.
parse_fatturapa: Estrae dati strutturati (cedente, cessionario, righe, imposte) da un XML FatturaPA/SDI. Solo parsing: nessuna verifica VIES.
parse_verify_fatturapa: Estrae i dati da un XML FatturaPA/SDI E verifica anti-frode il fornitore nella stessa chiamata: le parti sono estratte deterministicamente dall'XML (nessun LLM), poi IBAN, P.IVA/CF e — quando raggiungibile — la ragione sociale VIES live producono un verdetto. Secondo e ultimo tool con I/O esterno: stessa cache, stesso budget VIES e stessa degradazione onesta di `verify_payee`, una sola interrogazione VIES per chiamata.
calc_iva: Calcola l'IVA italiana su un imponibile (22/10/5/4/0/esente/fuori campo), con ritenuta d'acconto opzionale e regimi non imponibili intra-UE ed export. Tiene distinte le due basi della fattura di un professionista: il contributo integrativo della cassa entra nella base IVA ma non in quella della ritenuta, la rivalsa INPS in entrambe.
calc_reverse_charge: Calcola l'IVA che il cessionario deve autoliquidare in regime di inversione contabile e gli obblighi delle due parti con la norma applicabile: distingue reverse charge intracomunitario (art. 46 DL 331/93 / art. 17 c.2 DPR 633/72), interno (art. 17 c.6 — solo settori tassativi) e paese non-UE (errore esplicito).
calc_split_payment: Calcola la scissione dei pagamenti per le forniture alla PA (art. 17-ter DPR 633/72): il fornitore incassa il solo imponibile, l'IVA la versa la PA all'Erario. Restituisce i due importi, l'impatto di liquidità e le istruzioni FatturaPA (EsigibilitaIVA=S, niente codici Natura N6).
calc_imu: Calcola l'IMU (L. 160/2019) per fabbricati, terreni agricoli e aree edificabili, con acconto e saldo. L'aliquota (‰) è quella deliberata dal Comune e va fornita in input.
compose_f24: Compone le RIGHE del modello F24 (Erario, INPS, IMU) con codici tributo e causali ufficiali a partire da importi già calcolati. Componibile con gli output di calc_forfettario e calc_imu. NON genera il modello ministeriale né un suo facsimile.
intrastat_periodicity: Determina se gli elenchi riepilogativi INTRASTAT vanno presentati e con quale periodicità (mensile, trimestrale o nessun obbligo) dagli ammontari dei quattro trimestri precedenti, e calcola la scadenza (giorno 25 del mese successivo, con slittamento per sabato, domenica e festività nazionali). Restituisce la soglia applicata con la sua fonte normativa.
intrastat_compose: Compone e valida le sezioni dell'elenco riepilogativo INTRASTAT (INTRA-1bis/ter/quater/quinquies/sexies e INTRA-2bis/ter/quater/quinquies) dalle righe di operazione: Stato membro ammesso, partita IVA della controparte, nomenclatura combinata, campi obbligatori per sezione. NON genera il file telematico per il Servizio Telematico Doganale: produce struttura-dati e prospetto di controllo.
intrastat_reference: Senza input: Stati membri ammessi, sezioni dei modelli INTRASTAT, ogni soglia vigente con criterio, effetto e fonte normativa (inclusa quella acquisti di beni innalzata a € 2.000.000 dal periodo 01/2026), termine di presentazione e la lista esplicita di ciò che NON viene generato.
nis2_tipologie: Elenco ufficiale delle tipologie di soggetto degli allegati I–IV del D.Lgs. 138/2024 (recepimento NIS2), verbatim dal testo di Gazzetta Ufficiale, con ricerca testuale. Serve a trovare il `tipologia_id` da passare a `nis2_ambito`. Non esiste alcuna mappa ATECO → tipologia e questo strumento non ne usa una: l'ambito si determina sulla tipologia di attività, non sul codice ATECO.
nis2_ambito: Dice se un soggetto rientra nel campo di applicazione del D.Lgs. 138/2024 (NIS2) e se è soggetto ESSENZIALE o IMPORTANTE, citando articolo e comma per ogni passo del ragionamento. Logica a tre valori: se un dato mancante non cambia l'esito non viene chiesto; se lo blocca, il tool risponde `indeterminato` e dice esattamente quale dato serve.
nis2_reference: Senza input: le soglie dimensionali NIS2 con la formula esatta di superamento e la fonte (raccomandazione 2003/361/CE, allegati I–IV, artt. 3 e 6 del D.Lgs. 138/2024), le categorie sempre-essenziali e le avvertenze (DORA per banche e mercati finanziari, consolidamento di gruppo).
verify_payee: Verifica anti-frode di un beneficiario prima di pagare una fattura (truffa del cambio-IBAN / BEC): IBAN, P.IVA, CF e — quando raggiungibile — ragione sociale via VIES live. Uno dei due soli tool con I/O esterno (l'altro è `parse_verify_fatturapa`, che riusa questa stessa verifica): se VIES è giù o il budget è esaurito il verdetto degrada onestamente ad "attenzione", mai a un falso "ok".

Registry ufficiale

Il server è pubblicato sul registry ufficiale del Model Context Protocol come 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.