italy-opendata-mcp

Name: Italy OpenData
Author: stucchi

MCP server exposing Italian open data (municipalities, provinces, regions, postal codes, coordinates, geographic data) through simple, developer-friendly tools.

Features

7 MCP tools to navigate the Italian administrative hierarchy
Official sources: ISTAT and ANPR where available
Lazy download: data is fetched on first use and cached locally (~1.8 MB SQLite)
Offline after first use: all queries are local
No Docker: installable via uvx or pip, starts and stops with Claude

Data sources

Data	Source	Type
Municipalities, provinces, regions, ISTAT codes	ISTAT	Official
Resident population	ANPR	Official (daily updates)
Surface area, altitude, altimetric zone	ISTAT	Official
Postal codes (CAP)	comuni-json	Community (no official source available)
Centroid coordinates	opendatasicilia	Community (no official source available)

Installation

bash

uvx italy-opendata-mcp

Usage in .mcp.json

json

{
  "mcpServers": {
    "italy-opendata": {
      "command": "uvx",
      "args": ["italy-opendata-mcp"]
    }
  }
}

From source

bash

git clone https://github.com/stucchi/italy-opendata-mcp.git
cd italy-opendata-mcp
uv venv && uv pip install -e .

Tools

list_regioni()  →  list_province(regione="Lombardia")  →  list_comuni(provincia="MI")

Tool	Parameters	Description
`list_regioni`	—	All 20 regions with municipality count and population
`list_province`	`regione?`	Provinces with optional region filter
`list_comuni`	`regione?`, `provincia?`, `limit?`	Municipalities with optional filters (default 400 results)

Search

Tool	Parameters	Description
`get_comune`	`nome_o_codice`	Full details of a municipality by name or ISTAT code
`get_by_cap`	`cap`	Find municipalities associated with a postal code

Data management

Tool	Parameters	Description
`refresh_dataset`	`force?`	Re-download data from sources
`datasets_status`	—	Local cache status

Available fields per municipality

Each municipality includes:

Registry: name, ISTAT code, cadastral code, province abbreviation, province, region
Demographics: population (ANPR, daily updates)
Geography: latitude, longitude, surface area (km²), altitude (m), altimetric zone
Classification: coastal, island, urbanization degree
Postal: list of associated CAP codes

Example output

> get_comune("Roma")

{
  "codice_istat": "058091",
  "nome": "Roma",
  "codice_catastale": "H501",
  "popolazione": 2802399,
  "superficie_kmq": 1288.19,
  "altitudine": 20,
  "zona_altimetrica": "Pianura",
  "litoraneo": 1,
  "latitudine": 41.89332,
  "longitudine": 12.482932,
  "sigla_provincia": "RM",
  "provincia": "Roma",
  "regione": "Lazio",
  "cap": ["00118", "00119", "00120", ...]
}