VOD – Venice Open DataCollega la tua AI ai dati di Venezia
MCP

Collega la tua AI a VOD

VOD espone 46 dataset su Venezia e la laguna tramite MCP (Model Context Protocol), lo standard aperto con cui gli assistenti AI si collegano a fonti esterne. Una volta collegato, puoi chiedere alla tua AI della marea, dei pollini, delle farmacie vicine o della fibra in una calle: risponde con i dati di VOD, citando fonte, licenza e natura del dato.

Indirizzo del server

https://venice-open-data.vercel.app/api/mcp

Sola lettura, nessun account e nessuna chiave. Trasporto Streamable HTTP.

Claude (web e app)

Impostazioni → Connettori → Aggiungi connettore personalizzato, poi incolla l’indirizzo. Disponibile nei piani che supportano i connettori personalizzati.

https://venice-open-data.vercel.app/api/mcp

ChatGPT

Nelle impostazioni di app e connettori attiva la modalità sviluppatore, crea un connettore e incolla l’indirizzo (autenticazione: nessuna).

https://venice-open-data.vercel.app/api/mcp

Claude Code

Da terminale, nella cartella del tuo progetto:

claude mcp add --transport http vod https://venice-open-data.vercel.app/api/mcp

Cursor, VS Code e altri client

Aggiungi il server al file di configurazione MCP del client:

{
  "mcpServers": {
    "vod": {
      "url": "https://venice-open-data.vercel.app/api/mcp"
    }
  }
}

Skill “Venice Open Data” per Claude

La skill insegna alla tua AI come usare bene i dati di VOD: quale dataset scegliere, come cercare vicino a un luogo, come distinguere misure, previsioni ed elenchi da verificare, e come citare le fonti. Contiene anche uno script (Python, senza dipendenze) che interroga VOD senza bisogno del connettore. Funziona insieme al server MCP oppure da sola.

Scarica la skill (ZIP)
  • • Claude.ai e app desktop: Impostazioni → Funzionalità → Skill → Carica skill, scegli lo ZIP (serve l’esecuzione di codice attiva per usare lo script).
  • • Claude Code: estrai lo ZIP in ~/.claude/skills/ (oppure nella cartella .claude/skills/ del tuo progetto), come nel comando qui sotto.
  • • Da terminale, senza AI: python venice-open-data/scripts/vod.py query pharmacies --near 45.4380,12.3358 --radius 500
curl -L -o vod-skill.zip https://venice-open-data.vercel.app/downloads/venice-open-data-skill.zip && unzip vod-skill.zip -d ~/.claude/skills/

Domande da provare

  • “Com’è la marea oggi a Venezia e quando è previsto il prossimo picco?”
  • “Trovami farmacie e defibrillatori entro 500 metri da Rialto.”
  • “Che pollini ci sono a Venezia in questo periodo, misurati e previsti?”
  • “C’è la fibra FTTH vicino a Campo Santa Margherita?”

Dataset disponibili (46)

tideMarea a Venezia: livello misurato, previsione e MOSEtempo realeCC BY-SA 3.0 – dati redistribuiti da VOD; la scheda del dataset indica CC BY
weather_stationsStazioni meteo-marine (vento, onde, aria) e METARtempo realeCPSM: CC BY-SA 3.0 – dati redistribuiti da VOD; la scheda del dataset indica CC BY; NOAA: Pubblico dominio (US Government)
wind_forecastVento previsto su griglia (9×9 punti)previsioneCC BY 4.0 – Weather data by Open-Meteo.com
air_qualityQualità dell’aria: medie annue ARPAV e previsione oraria CAMSdataset ufficialeARPAV: CC BY 4.0; Copernicus CAMS: CC BY 4.0 – Copernicus Atmosphere Monitoring Service / Open-Meteo.com
pollenPollini: previsione CAMS e calendario misurato ARPAVprevisioneCopernicus CAMS: CC BY 4.0 – Copernicus Atmosphere Monitoring Service / Open-Meteo.com; ARPAV: CC BY 4.0
lagoon_probesSonde ARPAV della lagunadataset ufficialeCC BY 4.0
marine_platformPiattaforma oceanografica Acqua Alta e stazioni marinetempo realeCPSM: CC BY-SA 3.0 – dati redistribuiti da VOD; la scheda del dataset indica CC BY; Open-Meteo Marine: CC BY 4.0
public_transport_stopsFermate ACTV (vaporetti, bus, tram)dataset ufficialeCC BY
bus_stopsFermate bus ACTV (tutte)dataset ufficialeCC BY
actv_noticesAvvisi di servizio ACTV in corsotempo realeContenuti ACTV, citati con link alla fonte
flixbusCorse FlixBus per Venezia (oggi)dataset ufficialeODbL 1.0 – © FlixMobility
realtime_vehiclesPosizioni reali dei mezzi ACTV (GTFS-RT)tempo realeOpen Data Real Time ACTV (catalogo dei dati ACTV)
service_nowServizio ACTV adesso per lineatempo realeOpen Data Real Time ACTV (catalogo dei dati ACTV)
last_departuresUltime partenze del giorno dalle fermate della navigazionedataset ufficialeCC BY
schedule_speedVelocità richiesta dall’orario e limiti di velocitàdataset ufficialeACTV: CC BY; OpenStreetMap: ODbL 1.0 – © OpenStreetMap contributors; Limiti di velocità: Atti pubblici
alilaguna_boatsBarche Alilaguna simulate dall’orariosimulatoNon dichiarata: citare la fonte
pharmaciesFarmacieOpenStreetMapODbL 1.0 – © OpenStreetMap contributors
defibrillatorsDefibrillatori (DAE)OpenStreetMapODbL 1.0 – © OpenStreetMap contributors
drinking_fountainsFontanelle pubblicheOpenStreetMapVenice Tap Water: Uso con citazione della fonte; OpenStreetMap: ODbL 1.0 – © OpenStreetMap contributors
recycling_centresEcocentri (ingombranti)OpenStreetMapODbL 1.0 – © OpenStreetMap contributors
librariesBibliotecheOpenStreetMapODbL 1.0 – © OpenStreetMap contributors
parkingsParcheggi con almeno 100 postiOpenStreetMapODbL 1.0 – © OpenStreetMap contributors
ev_chargingColonnine di ricaricaOpenStreetMapODbL 1.0 – © OpenStreetMap contributors
wifi_hotspotsHotspot Wi-Fi del Comunedataset ufficialeCC BY
monumental_treesAlberi monumentaliOpenStreetMapODbL 1.0 – © OpenStreetMap contributors
wellheadsVere da pozzoelenco curatoODbL 1.0 – © OpenStreetMap contributors
channel_markersBriccole e segnalamenti della lagunaOpenStreetMapODbL 1.0 – © OpenStreetMap contributors
canalsCanali e riiOpenStreetMapODbL 1.0 – © OpenStreetMap contributors
fiber_coverageCopertura della rete fissa (FTTH, FTTC, ADSL)dataset ufficialeCC BY 4.0 – citare «BroadbandMap di Agcom»
public_worksOpere pubbliche del Comunedataset ufficialeCC BY
parksParchi, giardini e aree giochiOpenStreetMapODbL 1.0 – © OpenStreetMap contributors
nauticalNautica e ormeggiOpenStreetMapODbL 1.0 – © OpenStreetMap contributors
sportsSport e spazi per allenarsiOpenStreetMapCAMPO: CC BY 4.0; OpenStreetMap: ODbL 1.0 – © OpenStreetMap contributors
wifi_venuesWi-Fi in hotel, bar e luoghi pubbliciOpenStreetMapODbL 1.0 – © OpenStreetMap contributors
city_ordersOrdinanze temporanee del Comune (canali, lavori, viabilità, ambiente)tempo realeAtti pubblici
fuel_pricesDistributori di carburante e prezzidataset ufficialeIODL 2.0 – Ministero delle Imprese e del Made in Italy
lora_gatewaysGateway LoRaWAN online (The Things Network)tempo realeDati pubblicati dai proprietari – tramite Packet Broker (The Things Network)
public_works_bdapOpere pubbliche in corso del Comune (Monitoraggio Opere Pubbliche)dataset ufficialeCC BY
house_numbersNumeri civici del centro storicoOpenStreetMapODbL 1.0 – © OpenStreetMap contributors
censusResidenti, famiglie e abitazioni per sestiere, isola e municipalitàdataset ufficialeCC BY 4.0
tourismTurismo e popolazione dei comuni della lagunadataset ufficialeCC BY 4.0
accommodationsLocazioni brevi (Inside Airbnb) e pressione abitativa per sestiere, isola e terrafermadataset ufficialeInside Airbnb: CC BY 4.0 – Inside Airbnb; ISTAT: CC BY 4.0
bdsr_cinAnagrafica Strutture Ricettive e Codice Identificativo Nazionale (BDSR)dataset ufficialeDati pubblicati dalla PA senza licenza espressa: art. 52 c. 2 CAD (riuso citando la fonte) – Ministero del Turismo – BDSR
municipal_profileProfilo socio-economico dei comuni della lagunadataset ufficialeCC BY 4.0
buildingsEdifici del centro storico e delle isole (sagome OpenStreetMap, date e architetti Wikidata)dataset ufficialeODbL 1.0 – © OpenStreetMap contributors
sources_statusStato delle fontitempo realeCalcolo di VOD su dati aperti

Server MCP complementari

Per indicatori ufficiali su qualsiasi comune italiano puoi collegare anche questo server. VOD non lo interroga al posto tuo: la tua AI li usa entrambi, ognuno con le sue fonti.

Cruscotto Italia (AgID)Demografia, redditi, SIOPE, PNRR, opere pubbliche, scuole, sanità e turismo per ogni comune. Sequenza consigliata: search_comune, poi comune_kpi.
https://cruscotto-italia-mcp.agid.workers.dev/mcp

Buone pratiche per script e integrazioni

  • • Invia uno User-Agent riconoscibile con il nome del progetto e un contatto.
  • • Dopo una risposta 429 o 503 aspetta il tempo indicato in Retry-After prima di riprovare, con attese crescenti.
  • • Per scaricare molti dati usa l’API REST https://venice-open-data.vercel.app/api/datasets/<id> (fino a 100 voci per pagina) invece di tante chiamate MCP.
  • • Per sapere se una fonte è disponibile e aggiornata usa https://venice-open-data.vercel.app/api/health, non gli strumenti sui dati.

Come funziona

• Il server è in sola lettura: nessuno strumento modifica dati o accetta URL, query SQL o file.

• VOD riceve solo i parametri delle ricerche che la tua AI decide di fare (dataset, testo, zona), non le tue conversazioni, e non li archivia. La tua AI e il suo fornitore restano soggetti alle loro condizioni.

• Ogni risposta riporta fonte, licenza, natura del dato e avvertenze: chiedi alla tua AI di citarle e verifica le informazioni importanti alla fonte.

• Limite di 60 richieste al minuto per proteggere le fonti esterne. Per emergenze chiama il 112: i dati non sostituiscono i servizi ufficiali.