Io.Github.Stucchi/Italy Opendata

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

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

Search

Data management

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:

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

Data coverage

License

MIT