italy-opendata-mcp

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

uvx italy-opendata-mcp

Usage in .mcp.json

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

From source

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

Tools

Hierarchical navigation

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", ...]
}

Cache

Data is saved locally on first use:

OS	Path
macOS / Linux	~/.cache/italy-opendata-mcp/italia.db
Windows	%LOCALAPPDATA%\italy-opendata-mcp\italia.db

To refresh data, use refresh_dataset(force=True).

Data coverage

	Count
Regions	20
Provinces	107
Municipalities	7,896
With population	7,896
With coordinates	7,889
With geographic data	7,519
With postal codes	7,887

License

MIT