Italy Open Data

Provides access to Italian administrative data from ISTAT, ANPR, and other sources through MCP-compatible tools for hierarchical navigation and search.

other

0

GitHub Stars

other

Language

3 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can access Italian open data for municipalities, provinces, regions, postal codes, coordinates, and geographic data through a lightweight MCP server. It fetches data on first use, caches a compact local database, and enables offline queries entirely on your machine, making it ideal for development, data analysis, and offline workloads.

How to use

To run the Italy open data MCP server, install and start the server locally, then connect your MCP client to it using the provided server name. You will be able to list regions, provinces, and municipalities, search for a municipality by name or code, and lookup municipalities by postal codes. You can also refresh the dataset or check the cache status to understand what data is stored locally.

How to install

Prerequisites: you need Python and the uvx command line tool in your environment. You will also need Git to fetch the source if you want to install from source.

uvx italy-opendata-mcp

From source and development setup

If you prefer to install from source, clone the repository, set up a Python virtual environment, and install the package in editable mode.

git clone https://github.com/stucchi/italy-opendata-mcp.git
cd italy-opendata-mcp
uv venv && uv pip install -e .

Configuration and usage with an MCP client

The MCP server can be configured in your client by referencing its command and arguments. The recommended local runtime is to start the MCP server with uvx and provide the project name as the argument.

// Example local MCP server configuration in your client
{
  "mcpServers": {
    "italy-opendata": {
      "command": "uvx",
      "args": ["italy-opendata-mCP"]
    }
  }
}

Cache and data management

Data is stored locally after the first use in a lightweight SQLite database, enabling offline querying. The local cache can be refreshed to pull the latest data from official sources.

OS paths for the cache (example):
macOS / Linux: ~/.cache/italy-opendata-mcp/italia.db
Windows: %LOCALAPPDATA%\\italy-opendata-mcp\\italia.db

Data sources and coverage

The MCP server exposes data from official and community sources where available. Coverage includes regions, provinces, municipalities, demographic data, geographic attributes, postal codes, and coordinate centroids.

Available tools

list_regioni

List all 20 regions with municipality counts and population.

list_province

List provinces with an optional region filter.

list_comuni

List municipalities with optional region and province filters and an optional result limit (default 400).

get_comune

Return full details of a municipality by name or ISTAT code.

get_by_cap

Find municipalities associated with a postal code.

refresh_dataset

Re-download the dataset from official sources to refresh local data.

datasets_status

Show the status of the local dataset cache.