Italy Open Data
FreeNot checkedItalian open data for municipalities, provinces, regions, postal codes, and coordinates.
About
Italian open data for municipalities, provinces, regions, postal codes, and coordinates.
README
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
Install Italy Open Data in Claude Desktop, Claude Code & Cursor
unyly install italy-open-dataInstalls into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.
First time? Get the CLI: curl -fsSL https://unyly.org/install | sh
Or configure manually
Run in your terminal:
claude mcp add italy-open-data -- uvx italy-opendata-mcpStep-by-step: how to install Italy Open Data
FAQ
Is Italy Open Data MCP free?
Yes, Italy Open Data MCP is free — one-click install via Unyly at no cost.
Does Italy Open Data need an API key?
No, Italy Open Data runs without API keys or environment variables.
Is Italy Open Data hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Italy Open Data in Claude Desktop, Claude Code or Cursor?
Open Italy Open Data on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectAmap Maps Mcp Server
MCP server for using the AMap Maps API
by duxiaohuiSupabase
Database, auth and storage
by SupabaseEverything
Reference / test server with prompts, resources, and tools.
Git
Tools to read, search, and manipulate Git repositories.
Sequential Thinking
Dynamic and reflective problem-solving through thought sequences.
Time
Time and timezone conversion capabilities.
Compare Italy Open Data with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs
