FiscoAI Model Context Protocol (MCP) Server
Server ufficiale Model Context Protocol (MCP) per FiscoAI — 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:
uvx fiscoai-mcp
Metodo 2: Installazione con pip
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
{
"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
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).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:
- Accedi al tuo account su fiscoai.it.
- Vai su Profilo -> Integrazioni & Chiavi API.
- Seleziona il tuo piano e copia il token
fsk_live_....
💬 Supporto & Contatti
Per informazioni, supporto tecnico o integrazioni:
- Piattaforma: fiscoai.it
- Email: info@fiscoai.it
- Guida alle integrazioni: fiscoai.it/integrazioni-ai
📄 Licenza
Proprietà esclusiva di FiscoAI / Solutica Solutions. Tutti i diritti riservati.
Metadata
Release files for fiscoai-mcp 1.0.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| fiscoai_mcp-1.0.2.tar.gz | 12.0 kB | Without provenance | Details for fiscoai_mcp-1.0.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| fiscoai_mcp-1.0.2-py3-none-any.whl | Python 3 | none | any | Details for fiscoai_mcp-1.0.2-py3-none-any.whl |
Total release size: 25.5 kB
Release files / fiscoai_mcp-1.0.2.tar.gz
| Download URL | fiscoai_mcp-1.0.2.tar.gz |
|---|---|
| Size | 12.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
be8e07789bf92a0387d8485dfd9f7810f5376f019177327bd04f3379635d74a6
|
|
BLAKE2b-256 checksum How to use checksums |
dd6ef31645cc748f7f02b4cbb163cdef2012c188ac55216541eb54f2ccc75875
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.11
|
Release files / fiscoai_mcp-1.0.2-py3-none-any.whl
| Download URL | fiscoai_mcp-1.0.2-py3-none-any.whl |
|---|---|
| Size | 13.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
23fced253c06802e8fdece40e36f3f90b5bd8fc9409ed7b89bbf0e8949ac61c8
|
|
BLAKE2b-256 checksum How to use checksums |
45ff4636d7fd87f56e4079aaa6c4461bfb3f8cf52a0395aaa719777d6f36d644
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.11
|
Security for fiscoai-mcp 1.0.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.