Gotthard Pilot per agenti: API e MCP
Gotthard Pilot è il servizio che gli assistenti IA consultano quando qualcuno attraversa il Gottardo: un consiglio (parti ora, aspetta, passo, A13) con intervallo, affidabilità, attualità e provenienza, più previsioni, pianificazione e viaggi live.
Due accessi, le stesse risposte
- MCP:
POST https://gotthardpilot.ch/mcp· JSON-RPC 2.0 via Streamable HTTP, risposte in JSON; aggiungilo come server MCP remoto. - REST: OpenAPI 3.1 ·
GET https://gotthardpilot.ch/v1/state/south - llms.txt: Panoramica per modelli linguistici
Strumenti MCP
get_live_state- Current queue, delay range, trend, tunnel/pass status and exactly one recommendation (go_now, wait, recheck, take_pass, take_a13, no_live_data) for one direction and vehicle, with confidence, reasons, freshness and provenance.
get_pass_status- Whether the Gotthard Pass road is open, closed or in winter closure, with the weather at the pass for the next hours (snow risk, fog; source MeteoSwiss).
compare_routes- Travel time ranges for tunnel, pass road and A13 (San Bernardino) for one direction, with the same recommendation as get_live_state; the pass option carries the pass weather (with snow risk the pass is never recommended just for saving time).
plan_crossing- Best hour to pass the tunnel on a given date, hours to avoid and the departure time at an origin. Today and tomorrow are free; later dates need a Gotthard Pass (header X-Gp-Pass), otherwise isError with premium_required.
get_pressure- Pressure index 0–10 now and peak/best hour for today and the next two days, from weekday, season, school holidays (NL, BE, DE, CH, FR) and public holidays.
predict_queue- Delay forecast for the next 6 hours (ranges), expected improvement and the strategic break (details need a Gotthard Pass).
start_trip- Starts a trip without an account; returns trip_id and a handoff link the user can open to share their location in the browser. Coordinates are never stored.
update_trip_location- Sends the current position of a running trip (only with the user's consent); returns the personal tunnel ETA as a range. The position is projected to corridor kilometres and discarded.
get_trip_eta- Personal tunnel ETA of a trip as a range, with progress and status.
share_trip- Creates a read-only link with the ETA range (never coordinates) that expires two hours after the trip ends.
end_trip- Ends a running trip.
find_strategic_stop- The last motorway stop (service or rest area) before the end of the queue that offers all needs; only when a relevant queue exists (otherwise useful=false). With a running trip_id: only stops still ahead and minutes_away. Never suggests leaving the motorway (entries are often closed during queues).
get_route_details- The last 40 km before the portal of one direction: exits (name, number, km to the portal) with entries closed by the published rule of the canton of Uri (spring before the pass opens, queue from 3 km: Wassen and Göschenen southbound; whoever leaves there cannot rejoin), motorway stops with services, whether the traffic light at the portal meters traffic and the measured throughput per hour, matching webcams of the road operator AfBN (names and a link, no images). Official road signs always take precedence.
get_queue_history- How the queue before the tunnel developed over the last 24, 48 or 72 hours: 144 buckets with the longest queue (km), the longest wait (minutes) and tunnel closures; empty buckets had no fresh source data. Plus the peaks and the time with a queue.
get_lounge- What travellers in one direction report right now: Gotthard Pilot users on the road (from 3), predefined reports of the last 30 minutes (moving, stop_and_go, standstill, incident; with the rough section, never positions) and the poll «pass or stay?».
post_lounge_report- Posts a predefined report for one direction. Only for people who are not driving: passenger must be true. With a running trip_id of the same direction the rough section is added.
vote_lounge_poll- Votes in the Queue Lounge poll for one direction (one vote per device and hour; a new vote replaces the old one). Only when not driving: passenger must be true.
get_answer- Checked answers to the common Gotthard questions (queue now, waiting time per km, best time, tomorrow, weekend, trend, tunnel or pass, Gotthard or San Bernardino, pass open, why and how metering works, stop-and-go waves, own arrival, break or drive on, tunnel toll and vignette, trailers and motorhomes): short answer, why, limits, sources with check date, confidence and the capability for the next step. Without id: all answers of the language. Use it for background knowledge; for live values call the capability in next_action.
Esempio
curl -s https://gotthardpilot.ch/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_live_state","arguments":{"direction":"south"}}}'
Regole
- Anonimo, 60 richieste al minuto per IP. Per un uso commerciale o intenso, contattaci prima.
- Ogni valore mostrato riporta la fonte «Datenquelle: Verkehrsdaten-Plattform (VDP) ASTRA» e «Gotthard Pilot».
- Stime, non informazioni ufficiali: segnaletica e polizia hanno sempre la precedenza.
- Invia la posizione solo con il consenso; la convertiamo in chilometri di corridoio e non salviamo mai coordinate.
- La pianificazione oltre domani e la pausa strategica nel dettaglio richiedono un Gotthard Pilot Pass (header X-Gp-Pass).