Skip to main content
Glama
francy2222

indicepa-domicili-mcp

by francy2222

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.

Related MCP server: Schema.gov.it MCP Server

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. Chiunque riusi questo repository o il connettore deve mantenere l'attribuzione ad AgID.

Il codice e' rilasciato con licenza MIT.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Enables AI agents to semantically explore and analyze the Italian government data catalog (schema.gov.it), including ontologies, vocabularies, datasets, and data quality checks.
    47
    9
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables searching, inspecting, and downloading Italian public tender notices from the ANAC Pubblicità Legale platform, supporting offset and cursor pagination, reference data lookup, and safe third-party document retrieval.
    -