Search flights
mb_search_flightsSearch bookable flights by origin, destination, and date, then compare fares, remaining seats, baggage, and schedules; filter by cabin, airline, direct routes, and departure time.
Instructions
Search flights for a date: every bookable flight with price, seats left, baggage and times.
price_toman is one adult's fare (taxes included); total_toman the whole party. Domestic round
trips come back as two lists (outbound, return); international ones as packages priced
for both ways. Unpriced flights are only counted in not_on_sale. Next: mb_flight_fare_details
with the flight_id; to pick the day first, mb_flight_price_calendar.
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>",
"date": "<date>"
},
"name": "mb_search_flights"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | Gregorian date YYYY-MM-DD. | |
| sort | No | Order of the flights. | cheapest |
| cabin | No | Cabin class filter. | any |
| limit | No | Max flights per list. | |
| adults | No | Adults (12+). | |
| origin | Yes | IATA airport or city code from mb_find_place(mode='flight'), e.g. 'THR', 'MHD', 'ISTALL' (all Istanbul airports). | |
| infants | No | Infants (under 2). | |
| airlines | No | Only these airline codes, e.g. ['IR', 'W5']. | |
| children | No | Children (2-11). | |
| destination | Yes | IATA airport or city code from mb_find_place(mode='flight'), e.g. 'THR', 'MHD', 'ISTALL' (all Istanbul airports). | |
| direct_only | No | Only flights without a connection. | |
| return_date | No | Return date YYYY-MM-DD; omit for one-way. | |
| depart_after | No | Local time HH:MM, e.g. '06:00'. | |
| depart_before | No | Local time HH:MM, e.g. '06:00'. |