# SuoloData MCP — agenti e skill per il consumo di suolo (L2)

Interfaccia **open source** per assistenti AI (Claude, Cursor, ecc.) sul consumo di suolo
italiano: glossario, fonti canoniche, skill e (fase 2) server MCP read-only.

Complementa [suolodata-opendata](https://github.com/l-decristofaro32/suolodata-opendata) (CSV L1)
e il sito [suolodata.it](https://suolodata.it). **Non** sostituisce ISPRA/SNPA né atti urbanistici.

## Relazione con gli altri repo SuoloData

| Repo | Ruolo |
|------|--------|
| [SuoloData](https://github.com/l-decristofaro32/SuoloData) | Monorepo privato: ETL, sito, export |
| [suolodata-opendata](https://github.com/l-decristofaro32/suolodata-opendata) | **L1** — CSV nazionale |
| **suolodata-mcp** (questo) | **L2** — skill, glossario, MCP |
| [suolodata-ai-lab](https://github.com/l-decristofaro32/suolodata-ai-lab) | R&D agente (SQL, RAG, eval) — **non** duplicare |

Vedi [`docs/AI-LAB.md`](docs/AI-LAB.md) per il confine con AI Lab.

## Stato (v0)

| Componente | Stato |
|------------|--------|
| Glossario (`glossary/terms.yaml`) | ✓ |
| Fonti canoniche (`sources/canonical.yaml`) | ✓ |
| Skill `consumo-suolo-it` | ✓ |
| Audit semantico dati.gov.it | bozza |
| Server MCP (tool su CSV L1 / API) | ✓ v0.2 |

## Installazione skill

Con [skills.sh](https://skills.sh) (ecosistema [Agent Skills](https://agentskills.io)):

```bash
npx skills add github:l-decristofaro32/suolodata-mcp --skill consumo-suolo-it
```

In Cursor: copia `skills/consumo-suolo-it/` in `.cursor/skills/` del progetto.

## Server MCP

Installazione e configurazione Claude/Cursor: [`docs/MCP-SETUP.md`](docs/MCP-SETUP.md).

```bash
pip install -e .
suolodata-mcp   # stdio MCP server
```

Tool principali: `search_municipality`, `get_municipality_series`, `get_available_years`, `get_glossary`.

## Cosa fa la skill

1. Classifica la domanda (stock, flusso netto, confronto comuni, NRL, ecc.)
2. Sceglie la **fonte canonica** (CSV L1 SuoloData o ISPRA ufficiale)
3. Evita omonimie su dati.gov.it (“consumo del suolo” = catasto ≠ monitoraggio SNPA)
4. Risponde con citazione ISPRA + ISTAT + SuoloData e disclaimer

## Licenze

- Codice (futuro MCP): MIT
- Testi, glossario, skill: CC BY 4.0 (come L1)
- Dati: vedi [suolodata-opendata](https://github.com/l-decristofaro32/suolodata-opendata) e fonti ISPRA/ISTAT

## Sviluppo

Sorgente mantenuta nel monorepo SuoloData (`suolodata-mcp/`) e pubblicata qui.
Per contribuire: issue o PR su questo repository.

## Riferimenti

- Metodologia: https://suolodata.it/metodologia
- Modello MCP: [ondata/istat_mcp_server](https://github.com/ondata/istat_mcp_server)
- CKAN Italia: [ondata/ckan-mcp-server](https://github.com/ondata/ckan-mcp-server)