# indicepa-domicili-mcp

Connettore MCP per **verificare i domicili digitali (PEC) delle pubbliche
amministrazioni italiane** prima di spedire un atto.

La regola che implementa: gli indirizzi si riscontrano su IndicePA, non si
ricostruiscono. Se un indirizzo non c'e', il connettore dice che non c'e' —
non restituisce mai il risultato piu' somigliante al posto di quello cercato.

## Come si usa

Endpoint MCP: `https://indicepa-domicili-mcp.vercel.app/api/mcp`

Da aggiungere nell'app Claude come connettore personalizzato. Pagina di prova
delle stesse ricerche, senza connettore: https://indicepa-domicili-mcp.vercel.app

Tre strumenti:

- `ipa_verifica_pec(indirizzo)` - ricerca inversa: di quale ente e di quale AOO
  e' un indirizzo PEC. Confronto esatto; se non c'e' riscontro lo dice.
- `ipa_cerca_ente(denominazione | codice_fiscale | codice_IPA)` - per arrivare
  all'ente partendo dal nome.
- `ipa_aoo(codice_IPA)` - tutte le aree organizzative omogenee di
  un'amministrazione, per scegliere l'ufficio giusto.

Ogni risposta riporta la data di aggiornamento del dataset e una stringa di
provenienza pronta da citare.

## Dati

Dataset **Domicili digitali** di AgID, risorsa XLSX (aggiornata quotidianamente):
https://indicepa.gov.it/ipa-dati/dataset/domicili-digitali

Attenzione: la risorsa JSON dello stesso dataset **non sono i dati**, e' il
descrittore di schema.

Ogni risposta del connettore riporta la data di aggiornamento del dataset e una
stringa di provenienza pronta da citare in un atto.

## Aggiornamento

Il progetto Vercel e' collegato a questo repository: il commit settimanale con i
dati nuovi fa ripartire il deploy da solo, senza interventi.

`.github/workflows/refresh-dati.yml` rigira `scripts/build_data.py` ogni lunedi'
e committa `data/` se qualcosa e' cambiato. La cronologia dei commit e' anche
l'archivio storico: dimostra cosa diceva IndicePA a una certa data.

Lo script si ferma senza scrivere nulla se le colonne del dataset cambiano o se
il download risulta troncato.

Per rigenerare i dati a mano:

    pip install -r requirements.txt
    python scripts/build_data.py

## Licenza e attribuzione

I dati provengono da IndicePA e sono distribuiti dall'**Agenzia per l'Italia
Digitale (AgID)** con licenza [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
Chiunque riusi questo repository o il connettore deve mantenere l'attribuzione ad AgID.

Il codice e' rilasciato con licenza MIT.