Dichiarino
Dichiarino is an MCP server that acts as an intelligent assistant for compiling the Italian Modello 730 precompilato, providing tax calculations, deductions, validations, guides, and checklists for Italian income tax returns.
Calculate taxes: IRPEF (calcola_irpef), work/pension income tax credits (calcola_detrazione_lavoro), and regional surcharges for all 20 Italian regions (calcola_addizionale_regionale_tool).
Compute family deductions: Detrazioni for spouse, children ≥21, and other dependants, correctly excluding under-21 children covered by Assegno Unico (calcola_detrazioni_familiari_tool).
Handle Quadro E expenses: Deductions/deductions for medical, mortgage, renovation, university, insurance, donations, etc., with automatic 260€ reduction for high incomes (calcola_oneri) and per-expense rules (verifica_spesa_detraibile).
Validate Italian fiscal code: Check digit validation and extraction of birth data and comune (valida_codice_fiscale_tool).
Get full 730 outcome: Combine income, withholdings, family, and expenses to determine refund (rimborso) or debt (debito) (calcola_risultato_dichiarazione).
Receive step-by-step form guidance: Detailed instructions for any Quadro (A–W, M, T) (guida_quadro), required documents for each expense type (lista_documenti_spesa), and a personalised compilation checklist (genera_checklist_730).
Analyze Certificazione Unica (CU): Validate internal consistency of CU data, plausibility of IRPEF withheld, and work days (analizza_certificazione_unica).
Access fiscal data resources: IRPEF brackets, quadro instructions, deadlines, regional surcharge tables, and deduction limits.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Dichiarino Calcola IRPEF per reddito 30.000€ nel 2024"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP (Model Context Protocol) server that acts as an intelligent assistant for compiling the Italian Modello 730 Precompilato - the pre-filled annual income tax return.
What is Dichiarino?
Dichiarino is an MCP server that gives any compatible AI assistant (Claude Desktop, Cursor, etc.) deep knowledge of the Italian tax system and calculation tools for the 730 form. It embeds official fiscal rules, IRPEF rates, and deduction limits so the AI can guide you through your annual tax return.
Note: The Agenzia delle Entrate provides no public API for the 730 precompilato. Dichiarino works as a knowledge + calculation engine - it cannot submit your return for you. Always verify results with a qualified professional (CAF, commercialista, consulente del lavoro).
Related MCP server: OpenAccountants
Features
Tool | Description |
| IRPEF lorda from income + year (2024: 23%/35%/43%) |
| Work income tax credit - formula per bracket + €65 bonus |
| Detrazioni for spouse, children ≥21, other dependants |
| Quadro E deductions - medical, mortgage, renovation, university… |
| Is this expense deductible? Which quadro? How much? |
| Validate + parse Italian codice fiscale (check digit algorithm) |
| Full 730 result - rimborso or debito |
| Step-by-step guide for any Quadro (A–W, M, T) |
| Documents needed for a specific expense type |
| Personalised compilation checklist |
| Regional IRPEF surcharge for all 20 Italian regions |
| Validate CU (Certificazione Unica) fields for consistency |
Resources:
dichiarino://aliquote/{anno}- IRPEF brackets and ratesdichiarino://quadri/{nome}- Full instructions for each Quadrodichiarino://scadenze/{anno}- Key deadlinesdichiarino://regioni- Regional surcharge tabledichiarino://detrazioni- Full deduction limits table
Agent Skills
In addition to the MCP server, Dichiarino ships a set of portable Agent Skills
in the skills/ folder - standalone instruction packages compatible with Claude, Cursor,
and any agentskills.io-supported tool. They work without the MCP server but are enhanced when it is connected.
Skill | When to use |
Compute IRPEF, brackets, detrazioni lavoro, 2025 cuneo fiscale | |
Fill in any quadro of the 730 form step by step | |
Validate and decode a codice fiscale | |
Calculate Quadro E deductions and limits | |
Generate a personalised document checklist | |
Parse and explain a Certificazione Unica (CU) |
See skills/README.md for installation instructions.
Requirements
Python 3.11+
uv (recommended) or pip
Installation
# Clone the repo
git clone https://github.com/gsaccardi/dichiarino-mcp.git
cd dichiarino-mcp
# Install with uv
uv syncUsage
With Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"dichiarino": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/dichiarino-mcp",
"run",
"dichiarino"
]
}
}
}With Cursor or other MCP clients
Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"dichiarino": {
"command": "uv",
"args": ["--directory", "/path/to/dichiarino-mcp", "run", "dichiarino"]
}
}
}Run directly
uv run dichiarino
# or
uv run python -m dichiarino.mainExample Interactions
Once connected to Claude Desktop:
You: Quanto IRPEF devo pagare su un reddito di 35.000€?
Claude: [calls calcola_irpef + calcola_detrazione_lavoro]
IRPEF lorda: 8.890€
Detrazione lavoro: 1.565€ + bonus 65€
IRPEF netta stimata: 7.260€You: Ho speso 1.200€ dal medico quest'anno. Cosa posso detrarre?
Claude: [calls calcola_oneri]
Spese sanitarie: 1.200€ - franchigia 129,11€ = 1.070,89€ x 19% = 203,47€
Documenti necessari: fatture mediche, scontrini farmacia con CFYou: Quali quadri devo compilare? Ho lavoro dipendente, mutuo, e figli under 21.
Claude: [calls genera_checklist_730]
Quadri: Frontespizio, C (lavoro), E (mutuo 19% su max 4.000€)
⚠️ I figli under 21 non generano detrazione - coperti dall'Assegno Unico Universale
Documenti: CU datore, quietanza interessi banca, contratto mutuoDevelopment
# Install dev dependencies
uv sync --dev
# Run tests
uv run pytest
# Lint
uv run ruff check src/ tests/
# Type check
uv run mypy src/Project Structure
src/dichiarino/
├── main.py # Entry point
├── server.py # MCP server setup + registration
├── types.py # Domain types
├── calculators/ # Pure calculation functions
│ ├── irpef.py
│ ├── detrazioni_lavoro.py
│ ├── detrazioni_familiari.py
│ ├── oneri.py
│ └── addizionali.py
├── validators/
│ └── codice_fiscale.py
├── data/ # Static fiscal data (2024)
│ ├── aliquote_irpef.py
│ ├── addizionali_regionali.py
│ ├── limiti_detrazioni.py
│ └── istruzioni_quadri.py
├── tools/ # MCP tool handlers
└── resources/ # MCP resource handlers
tests/
├── calculators/ # Unit tests for fiscal math
├── validators/ # Codice fiscale tests
└── integration/ # Full MCP server integration testsTax Year Coverage
Anno di imposta | Modello | Status |
2025 | 730/2026 | ✅ Fully supported (default) |
2024 | 730/2025 | ✅ Fully supported |
2023 | 730/2024 | ✅ IRPEF brackets supported |
Attribution
This project is licensed under the Apache License 2.0. If you redistribute this software or a Derivative Work, you must include the NOTICE file and retain the following attribution:
Powered by Dichiarino - https://github.com/gsaccardi/dichiarino-mcp
See LICENSE and NOTICE for full terms.
Disclaimer
The fiscal calculations provided are for informational purposes only and do not constitute professional tax or legal advice. Always verify your tax return with a qualified professional before submission. The authors accept no liability for errors or changes in fiscal legislation.
Available Tools
12 toolsanalizza_certificazione_unicaA
Analizza i dati della Certificazione Unica (CU) e rileva eventuali anomalie.
Verifica la coerenza interna dei dati CU: controlla se l'IRPEF trattenuta
è plausibile rispetto al reddito dichiarato, e se i giorni di lavoro
sono nel range corretto.
Args:
reddito_lordo: Reddito lordo (punto 1 CU).
imponibile_previdenziale: Imponibile previdenziale (punto 6 CU).
irpef_trattenuta: IRPEF trattenuta (punto 21 CU).
addizionale_regionale_trattenuta: Addizionale regionale trattenuta (punto 22 CU).
addizionale_comunale_trattenuta: Addizionale comunale (punti 23+24 CU).
giorni_lavoro: Giorni di lavoro/pensione nell'anno (punto 5 CU).
tipo_reddito: "lavoro_dipendente" | "pensione" | "lavoro_assimilato".
anno: Anno di imposta. Default: 2024.
Inputs: giorni_lavoro (required), reddito_lordo (required), irpef_trattenuta (required), imponibile_previdenziale (required), +4… Returns: object
calcola_addizionale_regionale_toolB
Calcola l'addizionale regionale IRPEF per una specifica regione.
L'addizionale regionale è un'imposta separata dall'IRPEF, trattenuta dal
sostituto d'imposta e conguagliata nella dichiarazione.
Args:
reddito_complessivo: Reddito complessivo in euro.
regione: Nome della regione (es. "lombardia", "lazio", "campania").
anno: Anno di imposta. Default: 2024.
Regioni disponibili:
abruzzo, basilicata, calabria, campania, emilia_romagna,
friuli_venezia_giulia, lazio, liguria, lombardia, marche, molise,
piemonte, puglia, sardegna, sicilia, toscana, trentino_alto_adige,
umbria, valle_d_aosta, veneto
Inputs: regione (required), reddito_complessivo (required), anno. Returns: object
calcola_detrazione_lavoroA
Calcola la detrazione per lavoro dipendente, pensione o redditi assimilati.
Per il 2025 include automaticamente il taglio cuneo fiscale (L. 207/2024):
- Reddito <= 20.000€: bonus graduato (7.1% / 5.3% / 4.8%)
- Reddito 20.001-32.000€: ulteriore detrazione fissa di 1.000€
- Reddito 32.001-40.000€: detrazione decrescente fino a 0 a 40.000€
Args:
reddito_complessivo: Reddito complessivo in euro.
giorni_lavoro: Giorni di lavoro/pensione nell'anno (1-366). Default: 365.
tipo_reddito: "lavoro_dipendente" | "pensione" | "lavoro_assimilato". Default: lavoro_dipendente.
anno: Anno di imposta. Supportati: 2023, 2024, 2025. Default: 2025.
Inputs: reddito_complessivo (required), anno, tipo_reddito, giorni_lavoro. Returns: object
calcola_detrazioni_familiari_toolA
Calcola le detrazioni per carichi di famiglia (coniuge, figli ≥21, altri).
ATTENZIONE: Dal 2022 le detrazioni per figli UNDER 21 sono state abolite
e sostituite dall'Assegno Unico Universale (AUU). Questa funzione le esclude.
Args:
reddito_complessivo: Reddito complessivo del dichiarante in euro.
familiari: Lista di familiari a carico. Ogni elemento è un dict con:
- tipo: "coniuge" | "figlio" | "altro"
- mesi_a_carico: mesi di carico nell'anno (1-12, default 12)
- percentuale_carico: quota di carico (0.5 o 1.0, default 1.0)
- eta_inferiore_21: true se figlio under 21 (default false)
anno: Anno di imposta. Default: 2024.
Esempi familiari:
[{"tipo": "coniuge"}, {"tipo": "figlio", "eta_inferiore_21": false}]
Inputs: familiari (required), reddito_complessivo (required), anno. Returns: object
calcola_irpefA
Calcola l'IRPEF lorda per un dato reddito complessivo e anno fiscale.
Utilizza gli scaglioni ufficiali (2024-2025: 23%/35%/43% - riforma IRPEF L. 207/2024).
Restituisce l'imposta totale e il dettaglio per scaglione.
Args:
reddito_complessivo: Reddito complessivo in euro (>= 0).
anno: Anno di imposta. Supportati: 2023, 2024, 2025. Default: 2025.
Inputs: reddito_complessivo (required), anno. Returns: object
calcola_oneriA
Calcola detrazioni e deduzioni per le spese del Quadro E (oneri e spese).
Gestisce spese sanitarie (franchigia 129,11€), mutuo prima casa, ristrutturazioni,
università, assicurazioni, contributi previdenziali, donazioni e molto altro.
Per redditi > 50.000€ applica automaticamente la riduzione di 260€ sulle
detrazioni al 19% (escluse le spese sanitarie).
Args:
reddito_complessivo: Reddito complessivo in euro.
spese: Lista di spese. Ogni elemento è un dict con:
- tipo: tipo di spesa (vedi valori ammessi)
- importo: importo in euro
- note: note opzionali (default "")
anno: Anno di imposta. Default: 2024.
Valori ammessi per tipo:
spese_sanitarie, spese_veterinarie, mutuo_prima_casa, ristrutturazione,
risparmio_energetico, istruzione_universita, istruzione_scuola,
assicurazione_vita, assicurazione_infortuni, contributi_previdenziali,
erogazioni_liberali_onlus, erogazioni_liberali_partiti, spese_funebri,
canoni_affitto_studenti, bonus_mobili, superbonus
Inputs: spese (required), reddito_complessivo (required), anno. Returns: object
calcola_risultato_dichiarazioneA
Calcola il risultato finale della dichiarazione 730: rimborso o debito IRPEF.
Combina IRPEF lorda, tutte le detrazioni spettanti e le ritenute già versate
per determinare se il contribuente riceverà un rimborso o dovrà pagare un saldo.
Args:
reddito_complessivo: Reddito complessivo in euro.
irpef_trattenuta: IRPEF già trattenuta dal sostituto d'imposta (da CU).
giorni_lavoro: Giorni di lavoro nell'anno (default 365).
tipo_reddito: "lavoro_dipendente" | "pensione" | "lavoro_assimilato".
regione: Regione di residenza (es. "lombardia"). Default: "lombardia".
familiari: Lista familiari a carico (vedi calcola_detrazioni_familiari).
spese: Lista spese Quadro E (vedi calcola_oneri).
oneri_deducibili_totale: Totale oneri già deducibili (riduce reddito imponibile).
anno: Anno di imposta. Default: 2024.
Inputs: irpef_trattenuta (required), reddito_complessivo (required), anno, spese, +5 more. Returns: object
genera_checklist_730A
Genera una checklist personalizzata per la compilazione del 730.
Basandosi sulla situazione del contribuente, indica quali quadri compilare,
quali documenti raccogliere e quali scadenze rispettare.
Args:
ha_lavoro_dipendente: Ha redditi da lavoro dipendente.
ha_pensione: Ha redditi da pensione.
ha_immobili: Possiede fabbricati/immobili (inclusa abitazione principale).
ha_terreni: Possiede terreni.
ha_coniuge_a_carico: Ha coniuge fiscalmente a carico.
ha_figli_under_21: Ha figli under 21 (coperti da Assegno Unico, non detraibili).
ha_figli_over_21_a_carico: Ha figli ≥21 anni fiscalmente a carico.
ha_spese_sanitarie: Ha spese mediche da detrarre.
ha_mutuo_prima_casa: Ha mutuo per prima casa (interessi detraibili).
ha_ristrutturazione: Ha effettuato lavori di ristrutturazione.
ha_investimenti_esteri: Ha conti o investimenti all'estero.
ha_criptovalute: Possiede criptovalute/cripto-attività.
ha_locazioni_brevi: Ha affittato immobili per brevi periodi (Airbnb, ecc.).
ha_plusvalenze_finanziarie: Ha ceduto titoli/partecipazioni nell'anno.
anno: Anno di imposta. Default: 2024.
Inputs: anno, ha_terreni, ha_immobili, ha_pensione, +11 more. Returns: object
guida_quadroA
Fornisce una guida dettagliata per la compilazione di un quadro del Modello 730.
Spiega cosa va dichiarato, i campi principali, le note importanti e i documenti
necessari per ogni sezione del modello.
Args:
quadro: Lettera del quadro (es. "A", "B", "C", "E", "M", "T", "W").
Case-insensitive.
Quadri disponibili: A, B, C, D, E, F, G, I, K, L, M, T, W
Inputs: quadro (required). Returns: object
lista_documenti_spesaA
Restituisce la lista dei documenti necessari per una specifica tipologia di spesa.
Utile per preparare la documentazione prima di recarsi al CAF o compilare il 730.
Args:
tipo_spesa: Tipo di spesa (es. "spese_sanitarie", "mutuo_prima_casa").
Valori ammessi: spese_sanitarie, spese_veterinarie, mutuo_prima_casa,
ristrutturazione, risparmio_energetico, istruzione_universita, istruzione_scuola,
assicurazione_vita, contributi_previdenziali, erogazioni_liberali_onlus,
erogazioni_liberali_partiti, spese_funebri, canoni_affitto_studenti,
bonus_mobili, superbonus
Inputs: tipo_spesa (required). Returns: object
valida_codice_fiscale_toolA
Valida un codice fiscale italiano e ne estrae i dati anagrafici codificati.
Verifica: formato, lunghezza, carattere di controllo (16° carattere).
Restituisce sesso, anno/mese/giorno di nascita (da codice) e codice comune.
Args:
codice_fiscale: Codice fiscale da validare (case-insensitive, spazi ignorati).
Inputs: codice_fiscale (required). Returns: object
verifica_spesa_detraibileC
Verifica se una spesa è detraibile/deducibile e con quali regole.
Args:
tipo_spesa: Tipo di spesa da verificare (es. "spese_sanitarie").
Inputs: tipo_spesa (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Most tools target distinct aspects of Italian tax preparation (IRPEF calculation, deductions, regional surcharge, CU validation). The only potential confusion is between verifica_spesa_detraibile and calcola_oneri, both dealing with expenses, but one is a rule-checker and the other a batch calculator.
Tool names generally follow a verb_noun pattern (calcola_, verifica_, valida_, analizza_, genera_), but there are deviations: guida_quadro and lista_documenti_spesa are noun phrases, and three tools carry an inconsistent '_tool' suffix (calcola_detrazioni_familiari_tool, valida_codice_fiscale_tool, calcola_addizionale_regionale_tool).
Twelve tools is appropriate for a tax declaration assistant. The set covers calculation, validation, guidance, and document needs without overwhelming redundancy.
The tool surface covers the main 730 workflow: IRPEF, deductions, oneri, regional surcharge, CU analysis, and final settlement. Minor gaps include no addizionale comunale calculator and no explicit tool for generating the 730 return itself, but guides and checklists mitigate this.
Maintenance
Related MCP Connectors
Sourced Italian tax tools for AI agents: cited primary-source search + a deterministic tax engine.
Deterministic European sovereign engine with 90 tools across 20 vertical suites for AI agents: EU Tax/KYB, FatturaPA/Peppol, AI Act, GDPR, DORA, NIS2, Italian Tenders (D.Lgs 36/2023), CBAM, EUDR, and Labour Law. Zero-Data-Retention with verifiable SHA-256 PDF/A audit certificates.
Verifiable US tax oracle for AI agents: cited, machine-checkable federal and state tax computation
Free, deterministic Italian tax tools for agents: CF, P.IVA, IBAN, ATECO, IVA, IMU, F24, NIS2.
Related MCP Servers
- AlicenseBqualityFmaintenanceEnables AI assistants to calculate French individual income tax and retrieve current tax brackets using official government data. Supports household composition calculations and provides up-to-date tax information for French residents.1114Apache 2.0

OpenAccountantsofficial
AlicenseAqualityAmaintenanceOpen-source, accountant-verified tax computation skills for AI agents. 261+ skills across 172+ jurisdictions covering income tax, VAT/GST, payroll, corporate tax, crypto, and cross-border planning. Every skill is verified section-by-section by licensed CPAs and chartered accountants. 3 tools (list_skills, get_skill, get_skill_sections) and 1 prompt (skill-review).46501AGPL 3.0- AlicenseNot gradedqualityBmaintenanceEnables an AI assistant to manage tax documents, run the filing interview, work with forms, and prepare a US federal return locally. It supports the workflow through to printing/mailing or entering the return in IRS Free File Fillable Forms.AGPL 3.0
- AlicenseAqualityBmaintenanceEnables AI assistants to calculate take-home pay, employer cost, and cross-country salary comparisons, and to look up official income tax and social security tables for 24 countries with tax-year and source citations.5189 npmMIT