Gotthard Pilot pour les agents : API et MCP
Gotthard Pilot est le service que consultent les assistants IA quand quelqu'un passe le Gothard : une décision (partir, attendre, col, A13) avec fourchette, fiabilité, fraîcheur et provenance, plus prévisions, planification et trajets en direct.
Deux accès, les mêmes réponses
- MCP:
POST https://gotthardpilot.ch/mcp· JSON-RPC 2.0 via Streamable HTTP, réponses en JSON ; ajoutez-le comme serveur MCP distant. - REST: OpenAPI 3.1 ·
GET https://gotthardpilot.ch/v1/state/south - llms.txt: Aperçu pour les modèles de langage
Outils 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.
Exemple
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"}}}'
Règles
- Anonyme, 60 requêtes par minute et par IP. Pour un usage commercial ou intensif, contactez-nous d'abord.
- Chaque valeur affichée porte la source «Datenquelle: Verkehrsdaten-Plattform (VDP) ASTRA» et «Gotthard Pilot».
- Des estimations, pas des informations officielles : la signalisation et la police priment toujours.
- N'envoyez une position qu'avec le consentement ; nous la convertissons en kilomètres de corridor et ne stockons jamais de coordonnées.
- La planification au-delà de demain et la pause stratégique en détail nécessitent un Gotthard Pilot Pass (en-tête X-Gp-Pass).