Metadata-Version: 2.5
Name: fiscoai-mcp
Version: 1.0.2
Summary: Official Model Context Protocol (MCP) server for FiscoAI — Italian Tax & Legal AI platform
Project-URL: Homepage, https://fiscoai.it
Project-URL: Documentation, https://fiscoai.it/integrazioni-ai/
Author-email: FiscoAI Team <info@fiscoai.it>
License: Proprietary / Commercial
Keywords: anthropic,claude,fiscal,fisco,legal,mcp,model-context-protocol,rag,tax
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial :: Accounting
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: httpx>=0.25.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# FiscoAI Model Context Protocol (MCP) Server

[![Version](https://img.shields.io/badge/version-1.0.2-blue.svg)](https://fiscoai.it)
[![MCP Protocol](https://img.shields.io/badge/MCP-2024--11--05-green.svg)](https://modelcontextprotocol.io)
[![Python](https://img.shields.io/badge/python-3.10+-brightgreen.svg)](https://python.org)

Server ufficiale [Model Context Protocol (MCP)](https://modelcontextprotocol.io) per **[FiscoAI](https://fiscoai.it)** — la piattaforma AI di riferimento per il diritto tributario, contabile e societario italiano.

Questo server permette a client AI come **Claude Desktop**, **Cursor**, **Windsurf** e **ChatGPT** di interrogare in tempo reale oltre **350.000 atti normativi**, il TUIR (DPR 917/1986), il Decreto IVA (DPR 633/1972), le circolari e risposte a interpello dell'Agenzia delle Entrate, le Topic Directives specialistiche e lo scadenzario fiscale ufficiale con **zero allucinazioni**.

---

## 🚀 Installazione Rapida

### Metodo 1: Esecuzione istantanea con `uvx` (Consigliato)
Non richiede installazione preventiva:
```bash
uvx fiscoai-mcp
```

### Metodo 2: Installazione con `pip`
```bash
pip install fiscoai-mcp
fiscoai-mcp
```

---

## ⚙️ Configurazione Client

### 1. Claude Desktop
Aggiungi la configurazione al tuo file `claude_desktop_config.json`:
* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
* **Linux**: `~/.config/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "fiscoai": {
      "command": "uvx",
      "args": ["fiscoai-mcp"],
      "env": {
        "FISCOAI_API_KEY": "fsk_live_vostra_chiave_personale"
      }
    }
  }
}
```

### 2. Cursor IDE
In Cursor: **Settings** -> **Features** -> **MCP Servers** -> **Add New MCP Server**:
* **Name**: `fiscoai`
* **Type**: `command`
* **Command**: `uvx fiscoai-mcp`
* **Environment Variables**:
  * `FISCOAI_API_KEY`: `fsk_live_vostra_chiave_personale`

### 3. Connessione Remota via SSE (ChatGPT & Cloud Agents)
Se il tuo client supporta la connessione HTTP SSE remota (es. ChatGPT Plugin o agenti cloud):
* **SSE Endpoint**: `https://fiscoai.it/api/v1/mcp/sse/?api_key=fsk_live_vostra_chiave_personale`
* **Transport**: `sse`

---

## 🛠️ Strumenti (Tools) Disponibili

| Tool | Descrizione | Parametri |
| :--- | :--- | :--- |
| `cerca_normativa` | Cerca atti, leggi, decreti, circolari e prassi tributaria nel database ufficiale FiscoAI. | `query` (str, obbligatorio), `tipo_atto` (str), `anno` (int), `ente` (str), `solo_vigenti` (bool), `limit` (int) |
| `leggi_articolo_vigente` | Restituisce il testo esatto comma per comma di un articolo normativo con stato di vigenza e Topic Directives associate. | `atto` (es. "tuir", "dpr-917-1986", "iva", "statuto-contribuente"), `numero_articolo` (es. "51", "108") |
| `verifica_prassi_tributaria` | Recupera circolari, risoluzioni, risposte a interpello di Agenzia Entrate, MEF o INPS. | `argomento` (str, obbligatorio), `tipo` ("circolare", "risoluzione", "interpello"), `anno` (int), `ente` (str) |
| `consulta_scadenzario` | Restituisce le scadenze e gli adempimenti tributari ufficiali con i codici tributo Modello F24. | `mese` (int), `anno` (int), `destinatari` ("professionisti", "imprese", "tutti"), `categoria` |
| `parere_fiscale_esperto` | Interroga il motore Expert RAG con Claude Sonnet e Topic Directives per analisi normative approfondite anti-allucinazione. | `quesito` (str, obbligatorio), `include_fonti` (bool), `ambito` ("auto", "IT", "EU") |
| `dettaglio_documento` | Mostra la scheda dettagliata di un atto normativo con sommario, inquadramento sistematico e indice articoli. | `doc_id` (str, obbligatorio: es. "tuir", "dpr-917-1986", UUID) |

---

## 📝 Modelli di Prompt Inclusi

1. `redazione_parere_tributario`:
   Predispone la traccia per un inquadramento tributario d'impresa con inquadramento sistematico, verifica della prassi AdE e profili di rischio fiscale (Art. 10-bis L. 212/2000).
2. `verifica_conformita_fiscale`:
   Genera una checklist antirischio su operazioni straordinarie, deduzioni o agevolazioni, verificando vigenza e rischi di contestazione per abuso del diritto.

---

## 🔑 Ottenere una Chiave API
Per generare la tua chiave API:
1. Accedi al tuo account su [fiscoai.it](https://fiscoai.it).
2. Vai su **Profilo** -> **Integrazioni & Chiavi API**.
3. Seleziona il tuo piano e copia il token `fsk_live_...`.

---

## 💬 Supporto & Contatti
Per informazioni, supporto tecnico o integrazioni:
- **Piattaforma**: [fiscoai.it](https://fiscoai.it)
- **Email**: [info@fiscoai.it](mailto:info@fiscoai.it)
- **Guida alle integrazioni**: [fiscoai.it/integrazioni-ai](https://fiscoai.it/integrazioni-ai/)

---

## 📄 Licenza
Proprietà esclusiva di FiscoAI / Solutica Solutions. Tutti i diritti riservati.
