Back to Browse

Italy Opendata MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Italian open data: municipalities, provinces, regions, postal codes, coordinates.

About

Italian open data: municipalities, provinces, regions, postal codes, coordinates.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 4 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry. Trust signals: trusted author (8/8 approved). 1 finding(s) downgraded by scanner intelligence.

7 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

database

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-stucchi-italy-opendata": {
      "args": [
        "italy-opendata-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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 uvx or pip, starts and stops with Claude

Data sources

DataSourceType
Municipalities, provinces, regions, ISTAT codesISTATOfficial
Resident populationANPROfficial (daily updates)
Surface area, altitude, altimetric zoneISTATOfficial
Postal codes (CAP)comuni-jsonCommunity (no official source available)
Centroid coordinatesopendatasiciliaCommunity (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")
ToolParametersDescription
list_regioniAll 20 regions with municipality count and population
list_provinceregione?Provinces with optional region filter
list_comuniregione?, provincia?, limit?Municipalities with optional filters (default 400 results)

Search

ToolParametersDescription
get_comunenome_o_codiceFull details of a municipality by name or ISTAT code
get_by_capcapFind municipalities associated with a postal code

Data management

ToolParametersDescription
refresh_datasetforce?Re-download data from sources
datasets_statusLocal 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:

OSPath
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
Regions20
Provinces107
Municipalities7,896
With population7,896
With coordinates7,889
With geographic data7,519
With postal codes7,887

License

MIT

Reviews

No reviews yet

Be the first to review this server!