book_hotel
ChatGPTBook a hotel room using a rate from get_hotel_details. Requires a Gondola account (API key) and a saved payment method. Use get_payment_methods to find your payment ID. The gondola_rate_id comes from the room rates returned by get_hotel_details — each room option has a rate ID you can use here. Guest details (given_name, family_name, email_address, phone_number) can either be passed directly or prefilled from a saved travel profile: pass travel_profile_id (from get_travel_profiles) to book "as <traveler>" without collecting each field. Any field you also pass explicitly overrides the profile. To earn points and elite credit, pass loyalty_account_id — use the Account ID from get_loyalty_accounts that matches the hotel's chain (e.g. the World of Hyatt account for a Hyatt property). When a loyalty_account_id is passed, the booking goes out under the email registered to that membership (overriding any travel profile or email_address), so the stay credits to the right account. Args: gondola_rate_id: The rate ID from get_hotel_details room rates. payment_id: Payment method ID from get_payment_methods. given_name: Guest's first name (optional if travel_profile_id is provided). family_name: Guest's last name (optional if travel_profile_id is provided). email_address: Guest's email for confirmation (optional if travel_profile_id is provided). phone_number: Guest's phone number with country code (optional if travel_profile_id is provided). special_request: Optional special request for the hotel (e.g. "high floor", "late check-in"). loyalty_account_id: Optional loyalty account ID (from get_loyalty_accounts) to earn points. travel_profile_id: Optional travel profile ID (from get_travel_profiles) to prefill guest details. Returns: Booking confirmation with ID and details, or an error message.
book_hotel
ChatGPTBook a hotel room using a rate from get_hotel_details. Requires a Gondola account (API key) and a saved payment method. Use get_payment_methods to find your payment ID. The gondola_rate_id comes from the room rates returned by get_hotel_details — each room option has a rate ID you can use here. Guest details (given_name, family_name, email_address, phone_number) can either be passed directly or prefilled from a saved travel profile: pass travel_profile_id (from get_travel_profiles) to book "as <traveler>" without collecting each field. Any field you also pass explicitly overrides the profile. To earn points and elite credit, pass loyalty_account_id — use the Account ID from get_loyalty_accounts that matches the hotel's chain (e.g. the World of Hyatt account for a Hyatt property). When a loyalty_account_id is passed, the booking goes out under the email registered to that membership (overriding any travel profile or email_address), so the stay credits to the right account. Args: gondola_rate_id: The rate ID from get_hotel_details room rates. payment_id: Payment method ID from get_payment_methods. given_name: Guest's first name (optional if travel_profile_id is provided). family_name: Guest's last name (optional if travel_profile_id is provided). email_address: Guest's email for confirmation (optional if travel_profile_id is provided). phone_number: Guest's phone number with country code (optional if travel_profile_id is provided). special_request: Optional special request for the hotel (e.g. "high floor", "late check-in"). loyalty_account_id: Optional loyalty account ID (from get_loyalty_accounts) to earn points. travel_profile_id: Optional travel profile ID (from get_travel_profiles) to prefill guest details. Returns: Booking confirmation with ID and details, or an error message.
book_vehicle
ChatGPTBook a rental vehicle from a search result. Requires a Gondola account (API key) and a saved payment method. Use get_payment_methods to find your payment ID. Args: search_id: Search ID from search_vehicles. vendor_code: Vendor code from search results (e.g. "ZE" for Hertz). rate_code: Rate code of the selected vehicle from search results. acriss_code: ACRISS vehicle classification code from search results. given_name: Renter's first name. family_name: Renter's last name. email_address: Renter's email for confirmation. phone_number: Renter's phone number with country code (e.g. "+1-555-123-4567"). payment_id: Payment method ID from get_payment_methods. pickup_location: Optional pickup IATA code for the selected vehicle (disambiguates metro fanouts). loyalty_account_id: Optional loyalty account ID to earn points on this rental. Returns: Booking confirmation with ID and details, or an error message.
book_vehicle
ChatGPTBook a rental vehicle from a search result. Requires a Gondola account (API key) and a saved payment method. Use get_payment_methods to find your payment ID. Args: search_id: Search ID from search_vehicles. vendor_code: Vendor code from search results (e.g. "ZE" for Hertz). rate_code: Rate code of the selected vehicle from search results. acriss_code: ACRISS vehicle classification code from search results. given_name: Renter's first name. family_name: Renter's last name. email_address: Renter's email for confirmation. phone_number: Renter's phone number with country code (e.g. "+1-555-123-4567"). payment_id: Payment method ID from get_payment_methods. pickup_location: Optional pickup IATA code for the selected vehicle (disambiguates metro fanouts). loyalty_account_id: Optional loyalty account ID to earn points on this rental. Returns: Booking confirmation with ID and details, or an error message.
cancel_vehicle_booking
ChatGPTCancel an existing vehicle booking. Args: booking_id: The Gondola booking ID (confirmation number) of the vehicle booking. Returns: Cancellation result.
cancel_vehicle_booking
ChatGPTCancel an existing vehicle booking. Args: booking_id: The Gondola booking ID (confirmation number) of the vehicle booking. Returns: Cancellation result.
compare_rates
ChatGPTCompare cash vs points rates across multiple hotels side-by-side. Use this after search_hotels to help a user decide between their top hotel picks. Returns a comparison table with cash rate, points rate, CPP valuation, and value signals for each hotel, highlighting the best cash value and best points value. Args: hotel_ids: List of hotel IDs to compare (max 5). Get these from search_hotels results. checkin: Check-in date in YYYY-MM-DD format. checkout: Check-out date in YYYY-MM-DD format. num_adults: Number of adult guests. Defaults to 2. Returns: Side-by-side comparison of cash vs points rates with recommendations.
compare_rates
ChatGPTCompare cash vs points rates across multiple hotels side-by-side. Use this after search_hotels to help a user decide between their top hotel picks. Returns a comparison table with cash rate, points rate, CPP valuation, and value signals for each hotel, highlighting the best cash value and best points value. Args: hotel_ids: List of hotel IDs to compare (max 5). Get these from search_hotels results. checkin: Check-in date in YYYY-MM-DD format. checkout: Check-out date in YYYY-MM-DD format. num_adults: Number of adult guests. Defaults to 2. Returns: Side-by-side comparison of cash vs points rates with recommendations.
create_rate_alert
ChatGPTCreate a rate alert to monitor a hotel for price drops. Set up an alert to be notified by email when the rate drops for a specific hotel. Optionally specify dates, or leave them out to monitor any stay. Requires a Gondola account with an API key. Args: hotel_id: The hotel's Vervotech property ID (from search results). checkin: Check-in date in YYYY-MM-DD format. Must be provided with checkout, or both omitted. checkout: Check-out date in YYYY-MM-DD format. Must be provided with checkin, or both omitted. Returns: Confirmation that the rate alert was created, with notification details.
create_rate_alert
ChatGPTCreate a rate alert to monitor a hotel for price drops. Set up an alert to be notified by email when the rate drops for a specific hotel. Optionally specify dates, or leave them out to monitor any stay. Requires a Gondola account with an API key. Args: hotel_id: The hotel's Vervotech property ID (from search results). checkin: Check-in date in YYYY-MM-DD format. Must be provided with checkout, or both omitted. checkout: Check-out date in YYYY-MM-DD format. Must be provided with checkin, or both omitted. Returns: Confirmation that the rate alert was created, with notification details.
credit_card_coverage
ChatGPTLook up rental car CDW/LDW coverage provided by a credit card. Provide EITHER credit_card_product_name OR card_number_bin + card_provider. Args: credit_card_product_name: Exact card product name (preferred when known). card_number_bin: First 6-8 digits of the card number (BIN). card_provider: Card network ("visa", "mastercard", "amex", or "discover"). Required with card_number_bin. Returns: Coverage type, max days, and a human-readable summary.
credit_card_coverage
ChatGPTLook up rental car CDW/LDW coverage provided by a credit card. Provide EITHER credit_card_product_name OR card_number_bin + card_provider. Args: credit_card_product_name: Exact card product name (preferred when known). card_number_bin: First 6-8 digits of the card number (BIN). card_provider: Card network ("visa", "mastercard", "amex", or "discover"). Required with card_number_bin. Returns: Coverage type, max days, and a human-readable summary.
delete_rate_alert
ChatGPTDelete a rate alert so you stop monitoring a hotel for price drops. Requires a Gondola account with an API key. Args: alert_id: The rate alert ID to delete (from get_rate_alerts). Returns: Confirmation that the rate alert was deleted.
delete_rate_alert
ChatGPTDelete a rate alert so you stop monitoring a hotel for price drops. Requires a Gondola account with an API key. Args: alert_id: The rate alert ID to delete (from get_rate_alerts). Returns: Confirmation that the rate alert was deleted.
diagnose_rates
ChatGPTDiagnose rate availability and source statuses for a specific hotel. Use this to investigate why certain rates (e.g. AAA, member, points) are or aren't showing for a property. Shows per-supplier status and a full breakdown of every rate by type. Args: hotel_id: The hotel's Vervotech property ID. checkin: Check-in date in YYYY-MM-DD format. checkout: Check-out date in YYYY-MM-DD format. num_adults: Number of adult guests. Defaults to 2. rate_sources: Optional comma-separated rate sources to check (e.g. "travelport", "direct,travelport"). If omitted, all sources are checked.
diagnose_rates
ChatGPTDiagnose rate availability and source statuses for a specific hotel. Use this to investigate why certain rates (e.g. AAA, member, points) are or aren't showing for a property. Shows per-supplier status and a full breakdown of every rate by type. Args: hotel_id: The hotel's Vervotech property ID. checkin: Check-in date in YYYY-MM-DD format. checkout: Check-out date in YYYY-MM-DD format. num_adults: Number of adult guests. Defaults to 2. rate_sources: Optional comma-separated rate sources to check (e.g. "travelport", "direct,travelport"). If omitted, all sources are checked.
get_booking
ChatGPTGet details for a specific hotel booking. Args: booking_id: The booking ID or confirmation number. Returns: Booking details including hotel, dates, room, rate, and status.
get_booking
ChatGPTGet details for a specific hotel booking. Args: booking_id: The booking ID or confirmation number. Returns: Booking details including hotel, dates, room, rate, and status.
get_booking_link
ChatGPTGet booking options for a hotel. Presents two explicit booking paths so the path is settled up front rather than discovered mid-conversation: 1. Check out on Gondola with a booking link — always available. 2. Book here now with an eligible saved card — shown only when the user has a card that can be charged in chat, and referenced by its last 4. Anonymous users get path 1 plus a prompt to sign up for in-chat booking. Use this after search_hotels or get_hotel_details when a user wants to book. Pass `gondola_rate_id` whenever a specific rate has been surfaced (from get_hotel_details or compare_rates) so the link lands on that rate's checkout page instead of the generic hotel page. Args: hotel_id: The hotel's Vervotech property ID (from search_hotels results). checkin: Check-in date in YYYY-MM-DD format. checkout: Check-out date in YYYY-MM-DD format. num_adults: Number of adult guests. Defaults to 2. children_ages: Comma-separated ages of children (e.g. "5,8"). Empty string if no children. gondola_rate_id: Optional rate ID from get_hotel_details/compare_rates. When provided, the link deep-links straight to that rate's checkout page. Returns: Booking instructions tailored to the user's auth status.
get_booking_link
ChatGPTGet booking options for a hotel. Presents two explicit booking paths so the path is settled up front rather than discovered mid-conversation: 1. Check out on Gondola with a booking link — always available. 2. Book here now with an eligible saved card — shown only when the user has a card that can be charged in chat, and referenced by its last 4. Anonymous users get path 1 plus a prompt to sign up for in-chat booking. Use this after search_hotels or get_hotel_details when a user wants to book. Pass `gondola_rate_id` whenever a specific rate has been surfaced (from get_hotel_details or compare_rates) so the link lands on that rate's checkout page instead of the generic hotel page. Args: hotel_id: The hotel's Vervotech property ID (from search_hotels results). checkin: Check-in date in YYYY-MM-DD format. checkout: Check-out date in YYYY-MM-DD format. num_adults: Number of adult guests. Defaults to 2. children_ages: Comma-separated ages of children (e.g. "5,8"). Empty string if no children. gondola_rate_id: Optional rate ID from get_hotel_details/compare_rates. When provided, the link deep-links straight to that rate's checkout page. Returns: Booking instructions tailored to the user's auth status.
get_hotel_details
ChatGPTGet detailed information, room types, and rates for a specific hotel. Use this after search_hotels to get full details for a hotel the user is interested in. Returns room options with pricing, cancellation policies, and amenities. Args: hotel_id: The hotel's Vervotech property ID (returned by search_hotels). checkin: Check-in date in YYYY-MM-DD format. checkout: Check-out date in YYYY-MM-DD format. num_adults: Number of adult guests. Defaults to 2. Returns: Detailed hotel information including rooms, rates, policies, and amenities.
get_hotel_details
ChatGPTGet detailed information, room types, and rates for a specific hotel. Use this after search_hotels to get full details for a hotel the user is interested in. Returns room options with pricing, cancellation policies, and amenities. Args: hotel_id: The hotel's Vervotech property ID (returned by search_hotels). checkin: Check-in date in YYYY-MM-DD format. checkout: Check-out date in YYYY-MM-DD format. num_adults: Number of adult guests. Defaults to 2. Returns: Detailed hotel information including rooms, rates, policies, and amenities.
get_hotel_reviews
ChatGPTGet guest reviews for a specific hotel. Use this to help users understand what other guests thought about a hotel. Returns up to 10 recent reviews with ratings and comments. Args: hotel_id: The hotel's Vervotech property ID (from search results). Returns: Formatted list of guest reviews with author names, ratings, and review text.
get_hotel_reviews
ChatGPTGet guest reviews for a specific hotel. Use this to help users understand what other guests thought about a hotel. Returns up to 10 recent reviews with ratings and comments. Args: hotel_id: The hotel's Vervotech property ID (from search results). Returns: Formatted list of guest reviews with author names, ratings, and review text.
get_hotel_stats
ChatGPTGet pricing analytics and percentile data for a hotel rate. Use this to help users understand if a rate is a good deal. Shows how the cash rate and points redemption value compare historically across the chain. Args: hotel_id: The hotel's Vervotech property ID (from search results). nightly_cash_cost: The current nightly cash rate. nightly_cash_cost_currency: Currency of the cash rate (e.g. "USD", "EUR"). nightly_points_cost: Optional current nightly points cost. Returns: Pricing stats with percentile rankings and value assessment.
get_hotel_stats
ChatGPTGet pricing analytics and percentile data for a hotel rate. Use this to help users understand if a rate is a good deal. Shows how the cash rate and points redemption value compare historically across the chain. Args: hotel_id: The hotel's Vervotech property ID (from search results). nightly_cash_cost: The current nightly cash rate. nightly_cash_cost_currency: Currency of the cash rate (e.g. "USD", "EUR"). nightly_points_cost: Optional current nightly points cost. Returns: Pricing stats with percentile rankings and value assessment.
get_loyalty_accounts
ChatGPTGet the user's hotel and airline loyalty accounts with points balances and values. Returns all linked loyalty accounts including current points balance, tier status, estimated cash value, recent points changes, and expiration dates. Requires a Gondola account (API key). Returns: Formatted list of loyalty accounts with balances and values, or instructions to connect.
get_loyalty_accounts
ChatGPTGet the user's hotel and airline loyalty accounts with points balances and values. Returns all linked loyalty accounts including current points balance, tier status, estimated cash value, recent points changes, and expiration dates. Requires a Gondola account (API key). Returns: Formatted list of loyalty accounts with balances and values, or instructions to connect.
get_multi_night_rates
ChatGPTGet a rate calendar showing prices across a date range for a hotel. Use this when a user has flexible dates and wants to find the cheapest time to stay. Shows cash rates, points rates, and value percentiles for each available check-in date. Args: hotel_id: The hotel's Vervotech property ID (from search results). start_date: Start of date range in YYYY-MM-DD format. end_date: End of date range in YYYY-MM-DD format. nights: Number of nights per stay (default: 1). Returns: Rate calendar with pricing for each available date.
get_multi_night_rates
ChatGPTGet a rate calendar showing prices across a date range for a hotel. Use this when a user has flexible dates and wants to find the cheapest time to stay. Shows cash rates, points rates, and value percentiles for each available check-in date. Args: hotel_id: The hotel's Vervotech property ID (from search results). start_date: Start of date range in YYYY-MM-DD format. end_date: End of date range in YYYY-MM-DD format. nights: Number of nights per stay (default: 1). Returns: Rate calendar with pricing for each available date.
get_past_trips
ChatGPTGet the user's past trips including hotel stays and flights. Returns a summary of past travel reservations with dates, confirmation numbers, costs, and loyalty earnings. Requires a Gondola account (API key). Args: limit: Max number of past trips to return, most recent first (default 20). The response notes how many more exist; raise this only when the user wants their full history. Returns: Formatted list of past trips, or instructions to connect an account.
get_past_trips
ChatGPTGet the user's past trips including hotel stays and flights. Returns a summary of past travel reservations with dates, confirmation numbers, costs, and loyalty earnings. Requires a Gondola account (API key). Args: limit: Max number of past trips to return, most recent first (default 20). The response notes how many more exist; raise this only when the user wants their full history. Returns: Formatted list of past trips, or instructions to connect an account.
get_payment_methods
ChatGPTList the user's saved payment methods for booking. Requires a Gondola account (API key). Returns saved credit/debit cards with their brand, last 4 digits, expiration, payment ID (needed for the book_hotel tool), and whether each card can be booked in chat. Returns: List of saved payment methods with IDs, or instructions to add one.
get_payment_methods
ChatGPTList the user's saved payment methods for booking. Requires a Gondola account (API key). Returns saved credit/debit cards with their brand, last 4 digits, expiration, payment ID (needed for the book_hotel tool), and whether each card can be booked in chat. Returns: List of saved payment methods with IDs, or instructions to add one.
get_rate_alerts
ChatGPTGet all active rate alerts for the current user. Returns the user's rate alerts showing which hotels they're monitoring for price drops. Requires a Gondola account with an API key. Returns: List of active rate alerts with hotel names, dates, and current rates.
get_rate_alerts
ChatGPTGet all active rate alerts for the current user. Returns the user's rate alerts showing which hotels they're monitoring for price drops. Requires a Gondola account with an API key. Returns: List of active rate alerts with hotel names, dates, and current rates.
get_similar_hotels
ChatGPTFind hotels similar to one the user is looking at. Use this when a user wants alternatives, comparisons, or asks "show me hotels like this one." Args: hotel_id: The hotel's Vervotech property ID (from search results). checkin: Check-in date in YYYY-MM-DD format. checkout: Check-out date in YYYY-MM-DD format. num_adults: Number of adult guests (default: 2). Returns: List of similar hotels with rates and ratings.
get_similar_hotels
ChatGPTFind hotels similar to one the user is looking at. Use this when a user wants alternatives, comparisons, or asks "show me hotels like this one." Args: hotel_id: The hotel's Vervotech property ID (from search results). checkin: Check-in date in YYYY-MM-DD format. checkout: Check-out date in YYYY-MM-DD format. num_adults: Number of adult guests (default: 2). Returns: List of similar hotels with rates and ratings.
get_suggested_searches
ChatGPTGet personalized travel suggestions and trip inspiration. Returns curated hotel recommendations based on the user's preferences, recent searches, popular destinations, and upcoming holidays. Great for when the user doesn't know where to go. Returns: Travel suggestions with preview hotel results.
get_suggested_searches
ChatGPTGet personalized travel suggestions and trip inspiration. Returns curated hotel recommendations based on the user's preferences, recent searches, popular destinations, and upcoming holidays. Great for when the user doesn't know where to go. Returns: Travel suggestions with preview hotel results.
get_travel_profiles
ChatGPTGet the user's saved travel profiles (guest name, email, and phone presets). Each profile has a selectable Profile ID. Pass it to book_hotel as travel_profile_id to prefill the guest details — the same "book as <traveler>" selection the website checkout offers — instead of collecting name, email, and phone field by field. Requires a Gondola account (API key). Returns: Formatted list of travel profiles with IDs, or instructions to add one.
get_travel_profiles
ChatGPTGet the user's saved travel profiles (guest name, email, and phone presets). Each profile has a selectable Profile ID. Pass it to book_hotel as travel_profile_id to prefill the guest details — the same "book as <traveler>" selection the website checkout offers — instead of collecting name, email, and phone field by field. Requires a Gondola account (API key). Returns: Formatted list of travel profiles with IDs, or instructions to add one.
get_upcoming_trips
ChatGPTGet the user's upcoming trips including hotel stays, flights, and car rentals. Returns a summary of all upcoming travel reservations with dates, confirmation numbers, costs, loyalty earnings, and savings opportunities. Requires a Gondola account (API key). Returns: Formatted list of upcoming trips, or instructions to connect an account.
get_upcoming_trips
ChatGPTGet the user's upcoming trips including hotel stays, flights, and car rentals. Returns a summary of all upcoming travel reservations with dates, confirmation numbers, costs, loyalty earnings, and savings opportunities. Requires a Gondola account (API key). Returns: Formatted list of upcoming trips, or instructions to connect an account.
get_vehicle_booking
ChatGPTGet details for a specific vehicle booking. Args: booking_id: The Gondola booking ID (confirmation number). Returns: Vehicle booking details including vendor, pickup/dropoff, vehicle, rate, and status.
get_vehicle_booking
ChatGPTGet details for a specific vehicle booking. Args: booking_id: The Gondola booking ID (confirmation number). Returns: Vehicle booking details including vendor, pickup/dropoff, vehicle, rate, and status.
get_vehicle_booking_coverage
ChatGPTGet the rental car CDW/LDW coverage stored at booking time for a vehicle booking. Args: booking_id: The Gondola booking ID of the vehicle booking. Returns: Coverage details stored on the booking, or an error message.
get_vehicle_booking_coverage
ChatGPTGet the rental car CDW/LDW coverage stored at booking time for a vehicle booking. Args: booking_id: The Gondola booking ID of the vehicle booking. Returns: Coverage details stored on the booking, or an error message.
get_vehicle_booking_link
ChatGPTGet a Gondola.ai deep link for a specific vehicle from search results. Authenticated users get instructions to book in-conversation with book_vehicle plus the web link as a fallback; anonymous users get the web link directly. Args: search_id: Search ID from search_vehicles. vendor_code: Vendor code from search results. rate_code: Rate code of the selected vehicle. pickup_datetime: Pickup date and time in ISO format. dropoff_datetime: Drop-off date and time in ISO format. Returns: Booking instructions tailored to the user's auth status.
get_vehicle_booking_link
ChatGPTGet a Gondola.ai deep link for a specific vehicle from search results. Authenticated users get instructions to book in-conversation with book_vehicle plus the web link as a fallback; anonymous users get the web link directly. Args: search_id: Search ID from search_vehicles. vendor_code: Vendor code from search results. rate_code: Rate code of the selected vehicle. pickup_datetime: Pickup date and time in ISO format. dropoff_datetime: Drop-off date and time in ISO format. Returns: Booking instructions tailored to the user's auth status.
get_vehicle_details
ChatGPTGet detailed information about a specific rental vehicle option. Use this after search_vehicles to get extras, insurance options, charges, and cancellation policy. Args: vendor_code: Vendor code from search results (e.g. "ZE" for Hertz, "AL" for Alamo). rate_code: Rate code from search results. search_id: Search ID from the vehicle search results. Returns: Vehicle details including extras, charges, and policies.
get_vehicle_details
ChatGPTGet detailed information about a specific rental vehicle option. Use this after search_vehicles to get extras, insurance options, charges, and cancellation policy. Args: vendor_code: Vendor code from search results (e.g. "ZE" for Hertz, "AL" for Alamo). rate_code: Rate code from search results. search_id: Search ID from the vehicle search results. Returns: Vehicle details including extras, charges, and policies.
optimize_loyalty_portfolio
ChatGPTOptimize the user's loyalty portfolio for a specific trip. Analyzes all the user's hotel loyalty programs and recommends which chain gives the best value for a trip. Considers points balances, redemption rates, transfer partners, and earnings. Use this when a user asks "Which loyalty program should I use?" or "Where should I book to get the best value from my points?" Args: location: Destination (e.g. "Paris", "Tokyo", "New York"). checkin: Check-in date in YYYY-MM-DD format. checkout: Check-out date in YYYY-MM-DD format. num_adults: Number of adult guests (default: 2). Returns: Ranked chain options with points costs, values, and transfer recommendations.
optimize_loyalty_portfolio
ChatGPTOptimize the user's loyalty portfolio for a specific trip. Analyzes all the user's hotel loyalty programs and recommends which chain gives the best value for a trip. Considers points balances, redemption rates, transfer partners, and earnings. Use this when a user asks "Which loyalty program should I use?" or "Where should I book to get the best value from my points?" Args: location: Destination (e.g. "Paris", "Tokyo", "New York"). checkin: Check-in date in YYYY-MM-DD format. checkout: Check-out date in YYYY-MM-DD format. num_adults: Number of adult guests (default: 2). Returns: Ranked chain options with points costs, values, and transfer recommendations.
predict_price
ChatGPTPredict whether now is a good time to book a hotel, or if the user should wait for a better price. Uses historical price data and trends to assess whether the current price is a good deal. Call this when a user asks "Should I book now or wait?" or wants to know if a price is good. Args: hotel_id: The hotel's Vervotech property ID (from search results). checkin: Check-in date in YYYY-MM-DD format. checkout: Check-out date in YYYY-MM-DD format. nightly_cash_cost: The current nightly cash rate for the hotel. nightly_cash_cost_currency: Currency of the cash rate (e.g. "USD", "EUR"). nightly_points_cost: Optional current nightly points cost for the hotel. Returns: Price prediction with recommendation (book now vs wait), confidence level, and key signals.
predict_price
ChatGPTPredict whether now is a good time to book a hotel, or if the user should wait for a better price. Uses historical price data and trends to assess whether the current price is a good deal. Call this when a user asks "Should I book now or wait?" or wants to know if a price is good. Args: hotel_id: The hotel's Vervotech property ID (from search results). checkin: Check-in date in YYYY-MM-DD format. checkout: Check-out date in YYYY-MM-DD format. nightly_cash_cost: The current nightly cash rate for the hotel. nightly_cash_cost_currency: Currency of the cash rate (e.g. "USD", "EUR"). nightly_points_cost: Optional current nightly points cost for the hotel. Returns: Price prediction with recommendation (book now vs wait), confidence level, and key signals.
search_flights
ChatGPTSearch for flights by route and date and return cash-priced offers. Two modes: - `mode="browse" (default): cash prices + a link to view/compare offers. Discovery only, not bookable. One-way only. - mode="book": bookable inventory. Each offer carries a stable offer ID (pass it to book_flight`) and an expiry (~30 min). Supports round-trips via return_date. Args: origin: Origin airport code or city (e.g. "LAX", "SFO", "New York"). destination: Destination airport code or city (e.g. "NRT", "LHR", "Paris"). departure_date: Departure date in YYYY-MM-DD format (e.g. "2025-03-15"). return_date: Optional return date in YYYY-MM-DD format for a round trip. Supported only with mode="book". With mode="browse" the backend is one-way only and the tool returns guidance to search each leg separately. num_passengers: Number of passengers. Defaults to 1. cabin_class: Optional cabin class preference. One of: "economy", "premium economy", "business", "first". mode: Search mode — "browse" (default, discovery) or "book" (bookable offers with IDs you can pass to book_flight). Returns: Formatted list of flight offers. For "book", each offer includes a bookable offer ID and expiry; for "browse", airlines, routes, prices, and a link.
search_flights
ChatGPTSearch for flights by route and date and return cash-priced offers. Two modes: - `mode="browse" (default): cash prices + a link to view/compare offers. Discovery only, not bookable. One-way only. - mode="book": bookable inventory. Each offer carries a stable offer ID (pass it to book_flight`) and an expiry (~30 min). Supports round-trips via return_date. Args: origin: Origin airport code or city (e.g. "LAX", "SFO", "New York"). destination: Destination airport code or city (e.g. "NRT", "LHR", "Paris"). departure_date: Departure date in YYYY-MM-DD format (e.g. "2025-03-15"). return_date: Optional return date in YYYY-MM-DD format for a round trip. Supported only with mode="book". With mode="browse" the backend is one-way only and the tool returns guidance to search each leg separately. num_passengers: Number of passengers. Defaults to 1. cabin_class: Optional cabin class preference. One of: "economy", "premium economy", "business", "first". mode: Search mode — "browse" (default, discovery) or "book" (bookable offers with IDs you can pass to book_flight). Returns: Formatted list of flight offers. For "book", each offer includes a bookable offer ID and expiry; for "browse", airlines, routes, prices, and a link.
search_hotels
ChatGPTSearch for hotels by location and dates with cash AND points pricing. Returns hotels with side-by-side cash vs points rates, cents-per-point (CPP) valuation, and deal scores so you can recommend the best value. This is Gondola's unique advantage — no other travel search shows both cash and points rates together. Args: location: City name, address, or area to search (e.g. "Tokyo", "Manhattan, New York", "near LAX airport"). checkin: Check-in date in YYYY-MM-DD format (e.g. "2026-04-15"). checkout: Check-out date in YYYY-MM-DD format (e.g. "2026-04-20"). num_adults: Number of adult guests. Defaults to 2. chain_name: Optional hotel chain to filter by (e.g. "marriott", "hilton", "hyatt", "ihg"). Case-insensitive substring match against each result's chain. If nothing matches, the unfiltered results are returned with an explicit note so you don't keep retrying. loyalty_programs: Optional list of the user's loyalty programs (e.g. ["hilton_honors", "marriott_bonvoy"]). When provided, results include personalized earnings and tier benefits like 5th night free. loyalty_points: Optional dict of program name to points balance (e.g. {"hilton_honors": 250000}). When provided, results indicate whether the user can afford each hotel with points. limit: Max number of hotels to return (default 20). The response notes how many more exist and how to narrow; raise this only when the user explicitly wants a longer list. Returns: Formatted list of hotels with cash rates, points rates, CPP valuation, and deal recommendations.
search_hotels
ChatGPTSearch for hotels by location and dates with cash AND points pricing. Returns hotels with side-by-side cash vs points rates, cents-per-point (CPP) valuation, and deal scores so you can recommend the best value. This is Gondola's unique advantage — no other travel search shows both cash and points rates together. Args: location: City name, address, or area to search (e.g. "Tokyo", "Manhattan, New York", "near LAX airport"). checkin: Check-in date in YYYY-MM-DD format (e.g. "2026-04-15"). checkout: Check-out date in YYYY-MM-DD format (e.g. "2026-04-20"). num_adults: Number of adult guests. Defaults to 2. chain_name: Optional hotel chain to filter by (e.g. "marriott", "hilton", "hyatt", "ihg"). Case-insensitive substring match against each result's chain. If nothing matches, the unfiltered results are returned with an explicit note so you don't keep retrying. loyalty_programs: Optional list of the user's loyalty programs (e.g. ["hilton_honors", "marriott_bonvoy"]). When provided, results include personalized earnings and tier benefits like 5th night free. loyalty_points: Optional dict of program name to points balance (e.g. {"hilton_honors": 250000}). When provided, results indicate whether the user can afford each hotel with points. limit: Max number of hotels to return (default 20). The response notes how many more exist and how to narrow; raise this only when the user explicitly wants a longer list. Returns: Formatted list of hotels with cash rates, points rates, CPP valuation, and deal recommendations.
search_vehicles
ChatGPTSearch for rental vehicles at an airport or city. Args: pickup_location: Airport IATA code (e.g. "LAX", "JFK", "SFO"). pickup_datetime: Pickup date and time in ISO format (e.g. "2025-03-15T10:00:00"). dropoff_datetime: Drop-off date and time in ISO format (e.g. "2025-03-20T10:00:00"). vehicle_class: Optional preference: Economy, Compact, Standard, FullSize, Premium, Luxury, SUV, Van. Returns: List of available rental vehicles with rates and details.
search_vehicles
ChatGPTSearch for rental vehicles at an airport or city. Args: pickup_location: Airport IATA code (e.g. "LAX", "JFK", "SFO"). pickup_datetime: Pickup date and time in ISO format (e.g. "2025-03-15T10:00:00"). dropoff_datetime: Drop-off date and time in ISO format (e.g. "2025-03-20T10:00:00"). vehicle_class: Optional preference: Economy, Compact, Standard, FullSize, Premium, Luxury, SUV, Van. Returns: List of available rental vehicles with rates and details.
