Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Italy Open Data

FreeNot checked

Italian open data for municipalities, provinces, regions, postal codes, and coordinates.

GitHubEmbed

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

from github.com/stucchi/italy-opendata-mcp

Install Italy Open Data in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install italy-open-data

Installs 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-mcp

Step-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

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