Search Flights
search_flightsSearch flights between any two cities worldwide on Go2Trip. Returns a curated set of options, each tagged with one or more categories:
best: the engine's recommended balance of price, total duration, and stops.
cheapest: lowest total price.
fastest: shortest total travel time. The categories overlap — a single flight can be both best and cheapest. Each option includes price, total durations, layovers, its
categories, and a direct booking link on the Go2Trip site for the chosenmarket. Options may includeseats_remaining— the number of seats left in this booking class at this price; values of 4 or fewer indicate limited availability.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"origin": "<origin>",
"destination": "<destination>",
"departure_date": "<departure_date>"
},
"name": "search_flights"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| adults | No | Number of adult passengers (0–9) | |
| market | No | Go2Trip country site to search and book on: 'uk' (United Kingdom), 'ae' (United Arab Emirates), 'qa' (Qatar), 'au' (Australia), 'cy' (Cyprus), 'cz' (Czech Republic), 'gr' (Greece), 'mt' (Malta) or 'sk' (Slovakia). Use the site of the user's country of residence when the conversation makes it clear and it is one of these; otherwise use 'uk'. Prices come back in that site's currency and the booking link opens on that site. | uk |
| origin | Yes | 3-letter IATA city or airport code (e.g. 'TLV', 'LON', 'MAD') | |
| infants | No | Number of infant passengers (0–9) | |
| seniors | No | Number of senior passengers (0–9) | |
| children | No | Number of child passengers (0–9) | |
| language | No | Language for the interactive results widget. English only. | en |
| destination | Yes | 3-letter IATA city or airport code (e.g. 'TLV', 'LON', 'MAD') | |
| return_date | No | Return date for round trips (YYYY-MM-DD). Omit for one-way. | |
| flight_class | No | Cabin class: tour (economy), tourPlus (premium economy), business, or first | tour |
| departure_date | Yes | Departure date in YYYY-MM-DD format |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The search parameters, with defaults applied | |
| total | Yes | Total matches found, which may exceed `flights.length` | |
| flights | Yes | Matching options, capped at 30 |