Skip to main content
Glama
Dichiarino

Dichiarino

by gsaccardi

CI Python 3.11+ License: Apache 2.0 MCP Listed in italia-mcp-servers

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

calcola_irpef

IRPEF lorda from income + year (2024: 23%/35%/43%)

calcola_detrazione_lavoro

Work income tax credit - formula per bracket + €65 bonus

calcola_detrazioni_familiari_tool

Detrazioni for spouse, children ≥21, other dependants

calcola_oneri

Quadro E deductions - medical, mortgage, renovation, university…

verifica_spesa_detraibile

Is this expense deductible? Which quadro? How much?

valida_codice_fiscale_tool

Validate + parse Italian codice fiscale (check digit algorithm)

calcola_risultato_dichiarazione

Full 730 result - rimborso or debito

guida_quadro

Step-by-step guide for any Quadro (A–W, M, T)

lista_documenti_spesa

Documents needed for a specific expense type

genera_checklist_730

Personalised compilation checklist

calcola_addizionale_regionale_tool

Regional IRPEF surcharge for all 20 Italian regions

analizza_certificazione_unica

Validate CU (Certificazione Unica) fields for consistency

Resources:

  • dichiarino://aliquote/{anno} - IRPEF brackets and rates

  • dichiarino://quadri/{nome} - Full instructions for each Quadro

  • dichiarino://scadenze/{anno} - Key deadlines

  • dichiarino://regioni - Regional surcharge table

  • dichiarino://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

calcola-irpef-730

Compute IRPEF, brackets, detrazioni lavoro, 2025 cuneo fiscale

compila-quadro-730

Fill in any quadro of the 730 form step by step

verifica-codice-fiscale

Validate and decode a codice fiscale

calcola-detrazioni-730

Calculate Quadro E deductions and limits

checklist-documenti-730

Generate a personalised document checklist

analizza-cu

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 sync

Usage

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.main

Example 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 CF
You: 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 mutuo

Development

# 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 tests

Tax 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 tools
analizza_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

    A3.7/5.0

    Scored across 12 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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).

    Tool Count5/5

    Twelve tools is appropriate for a tax declaration assistant. The set covers calculation, validation, guidance, and document needs without overwhelming redundancy.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      F
      maintenance
      Enables 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.
      11
      14
      Apache 2.0
    • A
      license
      A
      quality
      A
      maintenance
      Open-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).
      4
      6
      501
      AGPL 3.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      5
      189 npm
      MIT