| find_airportA | Resolve a city name or airport name into IATA airport codes.
Use this FIRST when you don't know the IATA code to pass to search_flights.
Args:
query: City, airport name, IATA code or country (e.g. "Barcelone", "Nice", "JFK")
limit: Max results (default 8)
|
| find_airports_nearA | Find airports near a geographic coordinate, sorted by distance.
Useful for geolocated departure-airport selection.
Args:
lat: Latitude in decimal degrees
lon: Longitude in decimal degrees
radius_km: Search radius in kilometers (default 150)
limit: Max results (default 8)
|
| search_flightsA | Search Google Flights for the best prices.
Tries multiple departure airports (default: Nice NCE, Marseille MRS).
All airports must be IATA codes. If you only know a city name, call find_airport
(or find_airports_near) first to resolve it.
Args:
to_airport: IATA destination code(s), comma-separated for multi-airport cities (e.g. "BCN" or "LHR,LGW,STN")
departure_date: Departure date YYYY-MM-DD
return_date: Return date YYYY-MM-DD (empty for one-way)
from_airports: Comma-separated IATA departure codes (default: NCE,MRS)
adults: Number of adults (default 2)
children: Number of children (default 2)
infants_in_seat: Infants with seat (default 0)
infants_on_lap: Infants on lap (default 0)
seat: Seat class: economy, premium-economy, business, first
max_stops: Max stops: -1 = no limit (default), 0 = direct only, 1 = max one stop
airlines: Comma-separated IATA airline codes to restrict to (e.g. "AF,U2"); empty = all
currency: ISO currency code (default EUR)
language: Language code (default fr)
|
| search_multi_cityC | Search multi-city flights on Google Flights.
Args:
legs: JSON array of legs, e.g. [{"from":"NCE","to":"BCN","date":"2026-08-01"},{"from":"BCN","to":"LIS","date":"2026-08-08"}]
adults: Number of adults
children: Number of children
seat: Seat class
max_stops: Max stops per leg: -1 = no limit (default), 0 = direct only
currency: ISO currency code (default EUR)
language: Language code (default fr)
|
| search_flexible_datesA | Find the cheapest departure day over a date range. Ideal for flexible holiday planning.
Runs one search per candidate date (throttled) — keep ranges reasonable.
Args:
to_airport: IATA destination code
date_from: Earliest departure date YYYY-MM-DD
date_to: Latest departure date YYYY-MM-DD
from_airports: Comma-separated IATA departure codes (default: NCE,MRS)
trip_length_days: 0 = one-way (default); >0 = round-trip with return = departure + N days
weekends_only: If true, only consider Friday/Saturday departures
adults: Number of adults
children: Number of children
seat: Seat class
max_stops: -1 = no limit (default), 0 = direct only
airlines: Comma-separated IATA airline codes to restrict to; empty = all
currency: ISO currency code (default EUR)
language: Language code (default fr)
|
| compare_destinationsA | Compare the cheapest price to several destinations from the same departure airport(s).
Great for "where can we go cheaply" inspiration searches. One search per destination (throttled).
Args:
to_airports: Comma-separated IATA destination codes (e.g. "BCN,LIS,TFS")
departure_date: Departure date YYYY-MM-DD
return_date: Return date YYYY-MM-DD (empty for one-way)
from_airports: Comma-separated IATA departure codes (default: NCE,MRS)
adults: Number of adults
children: Number of children
seat: Seat class
max_stops: -1 = no limit (default), 0 = direct only
airlines: Comma-separated IATA airline codes to restrict to; empty = all
currency: ISO currency code (default EUR)
language: Language code (default fr)
|
