Find Direct Flights to a Destination
search_flightsDirect flights observed landing at the airports that serve a place over the latest season, one row per origin and destination airport with every airline on that pair folded together. It names no airline and no price and is not a timetable or a booking: a row shows that passenger airlines' aircraft land there on that pattern, not that a seat is for sale. It covers direct flights only: when none comes from the guest's origin, say that connecting flights through other airports may exist and are not listed here. airports are the airports the place is served by, best first. For one place they carry drive_minutes and drive_km by car where known; for an area there is no drive time, because it differs per place (get_location_details gives it per place). ferry true means the drive crosses by ferry; when any airport you give has it, say once that ferries run on schedules and some are seasonal, so the guest checks the crossing before booking flights. Per flight: from/from_name the origin airport, to the destination, weekdays the days it lands, arrivals the landing times in local time at the destination, km the distance between the two airports. year_round true means all year; otherwise season_start is the first landing of the season, season_end the last landing if the route had stopped, and season_end_last_year the date it stopped the year before. A date that is absent is not known; never state one. total_matching counts all flights; the rows are the first limit, in the order of airports, then most flown. Which airport to fly into for a place comes from get_location_details; call this tool with from when the guest asks about flights from a place.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_flights"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | No | The guest's departure: the ICAO codes of every airport serving their departure city, comma-separated (resolve a city or an IATA code to ICAO yourself). Only flights from those airports are returned, by the order of `airports`, then most flown; when none match, the list is empty, never flights from another origin. | |
| limit | No | ||
| location | No | Place the guest wants to reach, as the guest says it. Resolved to a real place; if it resolves to nothing you get `location_unresolved` and no flights, never flights somewhere else. | |
| location_id | No | Location id from an earlier search_locations or get_location_details result, used instead of `location`. |