Tripdesk

Tools

15 typed tools. Generated from the running registry, so this page cannot drift from what is actually served. All of them only read, except one that sends a group enquiry once the traveller confirms it. Nothing books or pays.

egf

egf_prepare_group_quote quote → whatsapp handoff read-only

Prepares an enquiry for negotiated airfare for ten or more travellers flying together, with names supplied later. Group fares are negotiated for the whole party and not sold online, so no price is returned. Returns the enquiry exactly as it would be sent, a confirmation token that egf_send_group_quote accepts to send it, and a WhatsApp link for sending it by hand. Files nothing. Returns a `handoff` with a link or a message for a human desk, and a `ref`. Show the traveller the reference.

13 arguments
NameTypeRequiredDescription
origin array yes One or more departure airport IATA codes, e.g. ['BTS','VIE']
destination array yes One or more arrival airport IATA codes
departure_date string yes Outbound date, YYYY-MM-DD
return_date optional Return date; omit for one way
adults integer Travellers aged 18 and over
youths integer Travellers aged 12 to 17
children integer Travellers aged 2 to 11
infants integer Under 2, travelling on a lap
cabin_class string
date_flexibility_days integer
group_name optional Who is travelling, e.g. 'Trnava choir'
note optional Anything the desk should know
market string

egf_search_flights read-only

EasyGroupFlights: Ordinary flight search for a party of nine or fewer. Ten or more travellers together is a group fare, which egf_prepare_group_quote handles.

5 arguments
NameTypeRequiredDescription
origin string yes Departure airport, IATA code, e.g. VIE.
destination string yes Arrival airport, IATA code, e.g. BCN.
departureDate string yes Outbound date, YYYY-MM-DD.
returnDate string Return date, YYYY-MM-DD. Omit for one way.
passengers integer How many people are travelling. 10 or more is a group — use request_group_quote.

egf_send_group_quote

Sends a group airfare enquiry to the EasyGroupFlights desk, where a person replies by email, usually within a few hours. Accepts only a confirmation token from egf_prepare_group_quote, so the enquiry sent is exactly the one prepared, plus the traveller's own email and phone. Files an enquiry; does not book or pay. This deployment is in test mode: nothing is sent, and the result shows the enquiry that would have been.

5 arguments
NameTypeRequiredDescription
confirmation string yes The token egf_prepare_group_quote returned for this enquiry
email string yes The traveller's own email address. The desk replies to it.
phone string yes The traveller's own phone number, with country code, e.g. +421 900 123 456
first_name optional The traveller's first name
last_name optional The traveller's last name

egf_service_info read-only

EasyGroupFlights: How group airfare works: who qualifies, how a group fare differs from a public ticket, and what happens after an enquiry. Submits nothing.

1 argument
NameTypeRequiredDescription
market string Which market to describe. Defaults to en.

utility

fx_convert read-only

Convert an amount between currencies at the latest European Central Bank reference rate. Indicative, not a dealing rate.

3 arguments
NameTypeRequiredDescription
amount number
base string
target string yes

geo_find_place read-only

Look up coordinates and timezone for a town, city or region. Use this first when you only have a place name and need coordinates for a weather lookup.

3 arguments
NameTypeRequiredDescription
place string yes Town, city or region name, e.g. 'Bratislava'
country_code optional Optional ISO-3166 alpha-2 filter, e.g. 'SK'
limit integer

holidays_public read-only

Public holidays for a country and year. Useful for warning a traveller that offices, banks or transport will be closed.

2 arguments
NameTypeRequiredDescription
country_code string yes ISO-3166 alpha-2, e.g. 'SK'
year integer yes

time_local read-only

Current local time and UTC offset for an IANA timezone.

1 argument
NameTypeRequiredDescription
timezone string yes IANA timezone name, e.g. 'Europe/Bratislava'

weather_forecast read-only

Daily forecast for up to 16 days at a latitude and longitude. Call geo_find_place first if you only have a place name.

3 arguments
NameTypeRequiredDescription
latitude number yes
longitude number yes
days integer Forecast days from today

directory

list_products read-only

List the travel products on this gateway and the tool to call for each. Pass a product id for detail: what it does, when not to use it, who answers and how. Product ids: utility, sos, egf, router. Third-party servers are in travel_catalog_search instead.

1 argument
NameTypeRequiredDescription
product optional A product id from the list, for full detail. Omit it to get the list.

router

recommend_for_job read-only

Describe a travel job in plain words and get back which tools to call and with what arguments. Suggests only; it calls nothing. If you can read the tool schemas yourself, prefer that over this.

1 argument
NameTypeRequiredDescription
job string yes What the traveller wants, in plain words, e.g. '22 people from Bratislava to Paris in November'

sos

sos_advise_disruption read-only

Advise on a delayed, cancelled or overbooked flight: the passenger's immediate steps, re-routing rights, and the EC261 compensation band that applies. Names an amount; never files a claim and never rebooks.

10 arguments
NameTypeRequiredDescription
origin string yes Departure airport IATA code, e.g. 'BTS'
destination string yes Arrival airport IATA code, e.g. 'CDG'
issue string
delay_hours number Hours late at the FINAL destination, not at departure
notice_days optional For a cancellation: days of notice the airline gave
departed_eu boolean Did the flight depart from an EU/UK/EEA airport?
eu_carrier boolean Is the operating airline EU/UK based?
destination_in_eu optional Is the arrival airport inside the EU/EEA/UK/CH? Decides the 1,500 km+ band. Inferred from the airport code when it is one we know.
distance_km optional Great-circle distance. Computed from the airport codes when known.
cause optional Airline's stated reason, if any

catalogue

travel_catalog_categories read-only

List catalogue categories, how many servers each holds, and how many are answering.

travel_catalog_get read-only

Full detail on one catalogued server: status, what it needs to authenticate, known caveats, install lines, and working alternatives if it is currently down.

1 argument
NameTypeRequiredDescription
id string yes Catalogue id, from travel_catalog_search

travel_catalog_search read-only

Find vetted third-party travel MCP servers by job or category, with the result of our own scheduled probe and copy-paste install lines. These are pointed to, not proxied: install what you need directly. Use this when the traveller needs something this gateway does not offer.

5 arguments
NameTypeRequiredDescription
query optional Free text, e.g. 'hotel rates' or 'visa'
category optional One of: group-travel, flights-search, flights-booking, hotels, split-stay, rail, activities-tours, visa-docs, disruption-claims, ground-ancillaries
official_only boolean Only servers published by the vendor whose data they serve
include_down boolean Include servers that failed their last checks
limit integer