About Italy OpenData
Italy OpenData is an MCP server in the Maps category: italian open data: municipalities, provinces, regions, postal codes, coordinates.
Install
uvx italy-opendata-mcppip install italy-opendata-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (3)
list_comuni`regione?`, `provincia?`, `limit?`
Parameters not published.
list_province`regione?`
Parameters not published.
list_regioni—
Parameters not published.
Ask AI
Ask AI about Italy OpenData
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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
uvxorpip, 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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.