{
  "markdown": "# italy-opendata-mcp\n\nMCP server exposing Italian open data (municipalities, provinces, regions, postal codes, coordinates, geographic data) through simple, developer-friendly tools.\n\n## Features\n\n- **7 MCP tools** to navigate the Italian administrative hierarchy\n- **Official sources**: ISTAT and ANPR where available\n- **Lazy download**: data is fetched on first use and cached locally (~1.8 MB SQLite)\n- **Offline after first use**: all queries are local\n- **No Docker**: installable via `uvx` or `pip`, starts and stops with Claude\n\n## Data sources\n\n| Data | Source | Type |\n|------|--------|------|\n| Municipalities, provinces, regions, ISTAT codes | [ISTAT](https://www.istat.it/classificazione/codici-dei-comuni-delle-province-e-delle-regioni/) | Official |\n| Resident population | [ANPR](https://github.com/italia/anpr-opendata) | Official (daily updates) |\n| Surface area, altitude, altimetric zone | [ISTAT](https://www.istat.it/classificazione/principali-statistiche-geografiche-sui-comuni/) | Official |\n| Postal codes (CAP) | [comuni-json](https://github.com/matteocontrini/comuni-json) | Community (no official source available) |\n| Centroid coordinates | [opendatasicilia](https://github.com/opendatasicilia/comuni-italiani) | Community (no official source available) |\n\n## Installation\n\n```bash\nuvx italy-opendata-mcp\n```\n\n## Usage in .mcp.json\n\n```json\n{\n  \"mcpServers\": {\n    \"italy-opendata\": {\n      \"command\": \"uvx\",\n      \"args\": [\"italy-opendata-mcp\"]\n    }\n  }\n}\n```\n\n### From source\n\n```bash\ngit clone https://github.com/stucchi/italy-opendata-mcp.git\ncd italy-opendata-mcp\nuv venv && uv pip install -e .\n```\n\n## Tools\n\n### Hierarchical navigation\n\n```\nlist_regioni()  →  list_province(regione=\"Lombardia\")  →  list_comuni(provincia=\"MI\")\n```\n\n| Tool | Parameters | Description |\n|------|------------|-------------|\n| `list_regioni` | — | All 20 regions with municipality count and population |\n| `list_province` | `regione?` | Provinces with optional region filter |\n| `list_comuni` | `regione?`, `provincia?`, `limit?` | Municipalities with optional filters (default 400 results) |\n\n### Search\n\n| Tool | Parameters | Description |\n|------|------------|-------------|\n| `get_comune` | `nome_o_codice` | Full details of a municipality by name or ISTAT code |\n| `get_by_cap` | `cap` | Find municipalities associated with a postal code |\n\n### Data management\n\n| Tool | Parameters | Description |\n|------|------------|-------------|\n| `refresh_dataset` | `force?` | Re-download data from sources |\n| `datasets_status` | — | Local cache status |\n\n## Available fields per municipality\n\nEach municipality includes:\n\n- **Registry**: name, ISTAT code, cadastral code, province abbreviation, province, region\n- **Demographics**: population (ANPR, daily updates)\n- **Geography**: latitude, longitude, surface area (km²), altitude (m), altimetric zone\n- **Classification**: coastal, island, urbanization degree\n- **Postal**: list of associated CAP codes\n\n## Example output\n\n```\n> get_comune(\"Roma\")\n\n{\n  \"codice_istat\": \"058091\",\n  \"nome\": \"Roma\",\n  \"codice_catastale\": \"H501\",\n  \"popolazione\": 2802399,\n  \"superficie_kmq\": 1288.19,\n  \"altitudine\": 20,\n  \"zona_altimetrica\": \"Pianura\",\n  \"litoraneo\": 1,\n  \"latitudine\": 41.89332,\n  \"longitudine\": 12.482932,\n  \"sigla_provincia\": \"RM\",\n  \"provincia\": \"Roma\",\n  \"regione\": \"Lazio\",\n  \"cap\": [\"00118\", \"00119\", \"00120\", ...]\n}\n```\n\n## Cache\n\nData is saved locally on first use:\n\n| OS | Path |\n|----|------|\n| macOS / Linux | `~/.cache/italy-opendata-mcp/italia.db` |\n| Windows | `%LOCALAPPDATA%\\italy-opendata-mcp\\italia.db` |\n\nTo refresh data, use `refresh_dataset(force=True)`.\n\n## Data coverage\n\n| | Count |\n|---|---|\n| Regions | 20 |\n| Provinces | 107 |\n| Municipalities | 7,896 |\n| With population | 7,896 |\n| With coordinates | 7,889 |\n| With geographic data | 7,519 |\n| With postal codes | 7,887 |\n\n## License\n\nMIT\n\n<!-- mcp-name: io.github.stucchi/italy-opendata -->\n",
  "bytes": 3936,
  "sha": "18ff26f3cbed612a6335959c17cae68364742c0cb12854cd52418a490da4d90f",
  "repo_slug": "stucchi/italy-opendata-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_stucchi_italy_opendata_46f7b280/readme"
}