Google Flights MCP Server

Finds available round-trip flights within a specified date range.
Can optionally return only the cheapest flight found for each date pair.

⚠️ RATE LIMIT WARNING: This function makes multiple Google Flights scraping requests.
Each date pair combination = 1 request. The function is LIMITED to a MAXIMUM of 30
requests to prevent rate limiting and IP blocking.

Example request counts:
- 7 day range with 5-7 day stays: ~10-15 requests (Safe)
- 14 day range with no limits: ~105 requests (WILL BE REJECTED)
- 30 day range: ~465 requests (WILL BE REJECTED)

💡 TIP: Use min_stay_days and max_stay_days to reduce combinations.
Set return_cheapest_only=true for faster results.

Args:
    origin: Origin airport code (e.g., "DEN").
    destination: Destination airport code (e.g., "LAX").
    start_date_str: Start date of the search range (YYYY-MM-DD format).
    end_date_str: End date of the search range (YYYY-MM-DD format).
    min_stay_days: Minimum number of days for the stay (optional).
    max_stay_days: Maximum number of days for the stay (optional).
    adults: Number of adult passengers (default: 1).
    seat_type: Fare class (e.g., "economy", "business", default: "economy").
    max_stops: Maximum number of stops (0=direct, 1=one stop, 2=two stops, default: 2).
    return_cheapest_only: If True, returns only the cheapest flight for each date pair (default: False).
    max_results: Maximum number of results to return (default: 10). Set to 0 or -1 for unlimited.
    offset: Number of results to skip (for pagination, default: 0).
    compact_mode: If True, return only essential fields (saves ~40% tokens, default: False).
    limit: Maximum number of date pairs to process (for pagination, default: 20).

Example Args:
    {"origin": "JFK", "destination": "MIA", "start_date_str": "2025-09-10", "end_date_str": "2025-09-20", "min_stay_days": 5}
    {"origin": "JFK", "destination": "MIA", "start_date_str": "2025-09-10", "end_date_str": "2025-09-20", "min_stay_days": 5, "return_cheapest_only": true}