Vai al contenuto principale
Per sviluppatori · Model Context Protocol

Fai usare al tuo agente AI gli strumenti fiscali italiani di TaxCompass

Collega Claude, Cursor o qualsiasi client MCP a TaxCompass e il tuo agente può cercare nel diritto tributario e societario italiano (fondato su fonti primarie, con le citazioni) e far girare un vero motore fiscale, senza uscire dall'editor. Gratuito, in sola lettura, senza chiave.

Non conosci MCP? È lo standard aperto che permette agli assistenti AI come Claude di chiamare strumenti esterni. Se questo non ti dice nulla, probabilmente ti serve la chat fiscale.

https://api.taxcompass.it/mcp
Aggiungilo al tuo agente

Come si presenta

Tu

Sono un consulente freelance che si trasferisce in Italia. Quanto pagherei di imposte su 50.000 € con il forfettario?

Claude · con TaxCompass

→ calculate_italian_tax(revenue_eur=50000, regime="forfettario_15")
→ search_italian_tax_sources("forfettario regime aliquota 15% Legge 190/2014")

Su 50.000 € la base imponibile è 39.000 € (coefficiente 78%). Dopo circa 10.167 € di INPS Gestione Separata, l'imposta sostitutiva al 15% è circa 4.325 €: il netto è quindi ≈ 35.508 € (aliquota effettiva ~29%). Con l'aliquota iniziale al 5% resterebbero ≈ 38.391 €.

Fonti citate nel testo: Agenzia delle Entrate · Legge 190/2014 (ognuna è un URL reale che il tuo agente può aprire).

Perché non chiederlo direttamente al modello?

Perché il fisco italiano è esattamente il terreno su cui i modelli generalisti sono meno affidabili: specifico, numerico e diverso ogni anno.

Il modello a memoria
  • Indovina aliquote e soglie, spesso di un anno d'imposta passato.
  • Nessuna citazione: non puoi verificare da dove arriva un numero.
  • Fa i conti da solo, così i totali si allontanano dal vero.
Con TaxCompass
  • Fondato sulle norme primarie in vigore: Normattiva, AdE, INPS.
  • Ogni cifra porta con sé l'URL della fonte, da aprire e verificare.
  • I numeri arrivano da un motore deterministico, non dal modello.

Gli strumenti

Quattro strumenti in sola lettura. La ricerca restituisce passaggi con la fonte; i calcolatori sono matematica pura e deterministica.

search_italian_tax_sources

Ricerca ibrida, semantica e per parole chiave, sul corpus delle fonti primarie. Restituisce passaggi con l'URL della fonte da citare: Normattiva, Agenzia delle Entrate, INPS, le tabelle fissate per anno d'imposta, ATECO e le fonti UE e convenzionali.

list_tax_sources

Il catalogo delle fonti consultabili e di che cosa copre ciascuna, così il tuo agente conosce i filtri validi e l'estensione del corpus.

calculate_italian_tax

Imposte esatte e deterministiche per un regime (forfettario 5%/15%, ordinario, impatriati): imposta sostitutiva o IRPEF, INPS, netto, aliquota effettiva e requisiti. Non è una stima.

compare_italian_regimes

Tutti i regimi italiani a confronto a un dato fatturato, ordinati per reddito netto: la risposta deterministica alla domanda “in quale regime dovrei stare?”

Installazione

È un server remoto in streamable HTTP: punta qualsiasi client MCP all'endpoint. Nessuna installazione, nessuna autenticazione. (I formati di configurazione dei client cambiano: controlla la documentazione MCP del tuo client se uno snippet sembra datato.)

Claude Code

claude mcp add --transport http taxcompass https://api.taxcompass.it/mcp

Claude Desktop

{
  "mcpServers": {
    "taxcompass": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.taxcompass.it/mcp"]
    }
  }
}

Cursor / VS Code

{
  "mcpServers": {
    "taxcompass": { "url": "https://api.taxcompass.it/mcp" }
  }
}
Poi prova a chiedere al tuo agente: «Usando TaxCompass, qual è il limite di ricavi del forfettario e quante imposte pagherei su 60.000 € come sviluppatore software?»
Sola lettura: nessuna scrittura, nessun account Gratuito, con limite di richieste per IP Le ricerche non vengono conservate · infrastruttura nell'UE

Domande

Che cos'è il server MCP di TaxCompass?

Un server Model Context Protocol (MCP) gratuito e in sola lettura che permette ad assistenti AI come Claude e Cursor di chiamare gli strumenti fiscali italiani di TaxCompass dentro il tuo agente: ricerca nelle fonti primarie (Normattiva, Agenzia delle Entrate, INPS) e un motore fiscale deterministico forfettario / IRPEF / INPS.

Perché usarlo invece di chiedere direttamente a ChatGPT o a Claude?

I modelli generalisti rispondono a memoria sulle domande fiscali italiane: spesso con dati superati e senza una citazione verificabile. L'MCP fonda ogni risposta sulle norme primarie in vigore (con l'URL della fonte) e calcola i numeri con un vero motore fiscale, non con l'aritmetica del modello. Lo stesso approccio di taxcompass.it, dentro il tuo agente.

Come lo collego a Claude o a Cursor?

Punta qualsiasi client MCP a https://api.taxcompass.it/mcp. In Claude Code: `claude mcp add --transport http taxcompass https://api.taxcompass.it/mcp`. Per Claude Desktop o Cursor, aggiungi il server alla configurazione MCP del tuo client. Nessun account e nessuna chiave API.

È gratuito, e i miei dati vengono conservati?

Sì, è gratuito: sola lettura, nessuna registrazione, nessuna chiave API. Ha un limite di richieste per IP e le tue ricerche non vengono conservate. Gira su infrastruttura residente nell'Unione europea.

Che cosa copre?

I regimi forfettario (5% e 15%), ordinario e impatriati; IRPEF, INPS Gestione Separata, soglie e coefficienti di redditività del forfettario; il catalogo dei codici ATECO 2025; più le fonti UE e le convenzioni contro le doppie imposizioni per le domande transfrontaliere.

È una consulenza fiscale?

No. È orientamento fondato sulle fonti per agenti AI: documentato ed esatto, ma non sostituisce un professionista. Verifica con un commercialista abilitato prima di presentare qualsiasi dichiarazione.

Preferisci non collegare nulla?

Chiedilo direttamente a TaxCompass: stesse fonti, stesso motore, nel browser.

Apri la chat