Skip to main content

FiscoAI Model Context Protocol (MCP) Server

Version MCP Protocol Python

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

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


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

Source distribution for fiscoai-mcp 1.0.2
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)

Table of built distributions (wheels) for fiscoai-mcp 1.0.2
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

1.0.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page