GOTTHARD PILOT

Gotthard Pilot voor agents: API en MCP

Gotthard Pilot is de dienst die AI-assistenten raadplegen als iemand door de Gotthard rijdt: één advies (nu rijden, wachten, pas, A13) met bandbreedte, betrouwbaarheid, actualiteit en herkomst, plus verwachtingen, planning en live-ritten.

Twee toegangen, dezelfde antwoorden

MCP-tools

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.

Voorbeeld

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"}}}'

Regels