Dati ISTAT per il vostro agente

Presentazione

Questo server MCP (Model Context Protocol) permette a un client compatibile di accedere ai dati statistici dell’ISTAT, l’Istituto nazionale di statistica, tramite l’API REST SDMX. Espone otto strumenti: scoperta dei dataset, struttura, vincoli, descrizioni delle liste di codici, concetti, dati in formato TSV, diagnostica della cache e codici territoriali.

Il server mantiene una cache in memoria e su disco, limita le chiamate a quattro al minuto con una coda e ripete le richieste dopo un errore temporaneo. Nel repository c’è anche una skill che guida il modello passo dopo passo, oltre a una modalità HTTP con Dockerfile e chart Helm.

Punti di forza

• Otto strumenti MCP: scoperta dei dataset, struttura, vincoli, descrizioni delle liste di codici, concetti, dati, diagnostica della cache e codici territoriali (REF_AREA).
• Percorso consigliato in tre passi: discover_dataflows, poi get_constraints, infine get_data con i filtri sulle dimensioni.
• Doppia cache (memoria e disco, durate configurabili) e limite di quattro chiamate al minuto verso l’API dell’ISTAT.
• Skill SKILL.md inclusa in skills/istat-mcp, che il README consiglia di installare per ridurre errori e chiamate inutili.
• Configurazione documentata per Claude Desktop, Claude Code, Gemini CLI, VS Code e Codex CLI, più una modalità HTTP opzionale con Docker e Helm.

Per chi

Per chi vuole che un assistente IA risponda partendo dalle statistiche pubblicate dall’ISTAT (il README cita ad esempio popolazione e agricoltura) senza chiamare a mano l’API SDMX. Servono competenze tecniche di base (Python, configurazione di un client MCP).

Installazione

Clonare il repository, creare l’ambiente con uv (o pip; serve Python 3.11 o superiore), poi dichiarare il server nella configurazione del client MCP indicando l’interprete della cartella .venv. Il README consiglia anche di installare la skill inclusa.

git clone https://github.com/ondata/istat_mcp_server.git

uv sync

claude mcp add -s user istat -- "/path/to/istat_mcp_server/.venv/bin/python" -m istat_mcp_server

Leggete il README su GitHub

Punti di attenzione

• Il README precisa che non ci sono versioni rilasciate: ciò che viene integrato in main è ciò che gli utenti installano.
• Il server effettua al massimo quattro chiamate al minuto verso l’API dell’ISTAT, con coda; alcune risposte sui vincoli possono essere lente (timeout configurabile).
• Gli esempi di configurazione devono usare l’interprete della cartella .venv creata durante l’installazione; un python3 generico nel PATH di solito non riesce a importare il pacchetto.

Utilizzabile da un agente?

Pronto per un agente

Il repository è un server MCP e include una skill SKILL.md in skills/istat-mcp. Il README riporta esempi di configurazione per Claude Desktop, Claude Code, Gemini CLI, VS Code e Codex CLI. Nessun AGENTS.md né CLAUDE.md alla radice.