# Italy Legal Research MCP Server (`it-legal-mcp`)

**[Italiano](#it-native) | [English Documentation](#english-documentation)**

---

<a id="it-native"></a>
## Server MCP di Legislazione e Giurisprudenza (`it-legal-mcp`) — Italiano

### Informazioni su questo repository

Questo repository fornisce un server Model Context Protocol (MCP) che collega il vostro client IA (Claude, Cursor, Windsurf, VS Code / Copilot, Cline o Antigravity) direttamente a Normattiva (`normattiva.it`) e alle banche dati giurisprudenziali di merito e di legittimità (Tribunali ordinari, TAR regionali, 26 Corti d'Appello, Corte di Cassazione, Consiglio di Stato e Corte Costituzionale).

### Installazione rapida (Selezione del client IA)

1. **Download:** Fare clic su **`<> Code` -> `Download ZIP`** ed estrarre la cartella sul computer.
2. **Avvio:** Fare doppio clic su **`Click_Here_To_Install_Windows.bat`** (Windows) o **`Click_Here_To_Install_Mac.command`** (macOS).
3. **Scelta dell'applicazione IA:** Selezionare i programmi IA utilizzati (Claude, Cursor, Windsurf, VS Code, Antigravity), avviare l'installazione e riavviare il client IA selezionato.

**Nota sulla sicurezza:** Lo strumento opera esclusivamente in sola lettura e non accede ai file personali presenti sul computer.

### Gradi di giudizio e fonti ufficiali

| Grado di giudizio | Organi giudiziari coperti |
|:---|:---|
| **Primo grado (Tribunali e TAR)** | Tribunali Ordinari, Giudici di Pace & Tribunali Amministrativi Regionali (TAR across 20 Regions) |
| **Secondo grado (Corti d'Appello)** | 26 Corti d'Appello, Corti di Giustizia Tributaria di secondo grado & Consiglio di Giustizia Amministrativa |
| **Cassazione, Consiglio di Stato e Corte Costituzionale** | Corte Suprema di Cassazione, Consiglio di Stato & Corte Costituzionale |

- **Službeni glasnik / Legislation:** Normattiva - Portale della Legge Vigente (normattiva.it) (`https://www.normattiva.it`)
- **Sudska praksa / Case Law Portal:** ItalgiureWeb / Banca Dati di Merito (Tribunali & Corti d'Appello), Giustizia Amministrativa (TAR/CdS) & Corte Costituzionale (`https://www.giustizia-amministrativa.it`)

---

<a id="english-documentation"></a>
## English Documentation

Model Context Protocol (MCP) server providing direct, read-only access to **Italy (IT)** legislation, multi-tier judicial decisions (First Instance, Regional/Cantonal/Appellate, and Supreme/Constitutional courts), and statutory citation verification across major AI clients (**Claude Desktop, Cursor, Windsurf, VS Code / GitHub Copilot, Cline, Continue.dev, and Antigravity**).

---

### Interactive Desktop Setup (Select Your AI Assistant)

This package includes a graphical installer for legal practitioners and non-technical users that lets you select which AI application(s) you use:

1. **Download:** Click **`<> Code`** at the top right of this repository, select **`Download ZIP`**, and extract the folder to your computer.
2. **Run the Setup Utility:**
   - **Windows:** Double-click `Click_Here_To_Install_Windows.bat`
   - **macOS:** Double-click `Click_Here_To_Install_Mac.command`
3. **Select Your AI Client(s) & Connect:** Check the box(es) for the AI assistant(s) installed on your computer (**Claude Desktop**, **Cursor**, **Windsurf**, **VS Code / GitHub Copilot**, **Cline**, **Continue.dev**, or **Antigravity**), click **Install to Selected AI Clients**, and restart your selected AI application.

**System Integrity Note:** The setup utility operates strictly in read-only mode with respect to your personal files and documents. It installs an isolated Python runtime inside the extracted folder and registers the server entry only in the AI client configuration files you select.

---

### Multi-Tier Judicial Hierarchy & Official Sources

This server indexes and queries decisions across the full judicial hierarchy of **Italy**, allowing practitioners to filter research by procedural stage:

| Judicial Tier | Covered Courts & Tribunals |
|:---|:---|
| **Tier 1 — First Instance** | Tribunali Ordinari, Giudici di Pace & Tribunali Amministrativi Regionali (TAR across 20 Regions) |
| **Tier 2 — Regional / Cantonal / Appellate** | 26 Corti d'Appello, Corti di Giustizia Tributaria di secondo grado & Consiglio di Giustizia Amministrativa |
| **Tier 3 — Supreme & Constitutional** | Corte Suprema di Cassazione, Consiglio di Stato & Corte Costituzionale |

#### Primary Legal Portals

- **National Legislation Registry:** Normattiva - Portale della Legge Vigente (normattiva.it) (`https://www.normattiva.it`)
- **Multi-Tier Case Law Database:** ItalgiureWeb / Banca Dati di Merito (Tribunali & Corti d'Appello), Giustizia Amministrativa (TAR/CdS) & Corte Costituzionale (`https://www.giustizia-amministrativa.it`)
- **Supported Citation Format Example:** `ECLI:IT:CASS:2024:1234CIV or Legge 241/1990`

#### Indexed Court & Regional Sub-Portals

| Sub-Portal Identifier (`sub_court`) | Official Endpoint / Registry |
|:---|:---|
| `corte_cassazione_italgiure` | `https://www.italgiure.giustizia.it` |
| `tar_consiglio_stato` | `https://www.giustizia-amministrativa.it` |
| `corte_costituzionale` | `https://www.cortecostituzionale.it` |

---

### Available MCP Tools

| Tool | Description |
|:---|:---|
| `search_legislation` | Searches enacted statutes, codes, decrees, and official gazette publications in Italy. |
| `search_case_law` | Searches national jurisprudence and European/ECLI-linked judgments for Italy. |
| `search_tiered_court_decisions` | Filters case law specifically by judicial instance (`first_instance`, `appellate_regional`, `supreme_constitutional`) or regional/cantonal court key (`sub_court`). |
| `list_court_hierarchy` | Returns the complete 3-tier court structure and registered sub-portal endpoints for Italy. |
| `get_legal_document_markdown` | Retrieves full statutory or judicial texts and converts them into clean Markdown. |
| `verify_citation` | Validates statutory and case law citations against official registries. |

---

<details>
<summary><b>Manual Configuration for Developers (Optional)</b></summary>

```json
{
  "mcpServers": {
    "it-legal-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jurisatlas/it-legal-mcp",
        "it-legal-mcp"
      ]
    }
  }
}
```
</details>