get_multi_city_flights
Find multi-city flight itineraries for complex trips with multiple stops, generating search results or direct links to Google Flights.
Instructions
Fetches multi-city/multi-stop itineraries for complex trip planning.
⚠️ IMPORTANT: Multi-city flight scraping is not fully supported by the underlying fast-flights
library. This function will generate a valid Google Flights URL with your search parameters,
but may not be able to parse the results. If parsing fails, you'll receive a direct link to
view the flights on Google Flights.
💡 RECOMMENDATION FOR AI AGENTS: Instead of using this function, consider using the
get_one_way_flights() function multiple times (once for each leg of the journey) and
combining the results. This approach is more reliable and provides detailed flight
information for each segment, which you can then present together as a complete itinerary.
Args:
flight_segments: JSON string of flight segments. Each segment should have "date", "from", and "to" fields.
Example: '[{"date": "2025-07-01", "from": "SFO", "to": "NYC"}, {"date": "2025-07-05", "from": "NYC", "to": "MIA"}, {"date": "2025-07-10", "from": "MIA", "to": "SFO"}]'
adults: Number of adult passengers (default: 1).
seat_type: Fare class (e.g., "economy", "business", default: "economy").
return_cheapest_only: If True, returns only the cheapest option (default: False).
Example Args:
{"flight_segments": '[{"date": "2025-07-01", "from": "SFO", "to": "NYC"}, {"date": "2025-07-05", "from": "NYC", "to": "MIA"}]'}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flight_segments | Yes | ||
| adults | No | ||
| seat_type | No | economy | |
| return_cheapest_only | No | ||
| max_results | No | ||
| compact_mode | No |