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

Italy OpenData

Quick Install