Gondola

Search 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

Get 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

Compare 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 a

Get 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 u

Book 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

List 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

Get 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.

Create 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

Delete 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.

Get 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: Formatt

Get 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 firs

Get 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:

Get the user's free night certificates (award nights) across loyalty programs. Returns each certificate's program, how many remain, what it covers, when it expires, and whether a points top-up is allowed. Requires a Gondola account (API key). Returns: Formatted list of fre

Predict 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

Get 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 resu

Get 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

Find 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. che

Analyze the user's whole loyalty portfolio and surface the highest-value actions. Trip-independent. Looks across every loyalty program the user holds — plus the transferable card currencies (Amex, Chase, Bilt, etc.) that can feed hotel programs — and reports points expiring soon (ranked

Search for flights by route and date and return cash-priced options. Results are ranked for the traveler by the search backend — weighing their airline loyalty/status and travel history alongside flight quality — and returned 10 per page. To see more options, call again with ``page=2``,

Search 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-

Get 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

Book 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 Her

Cancel an existing vehicle booking. Args: booking_id: The Gondola booking ID (confirmation number) of the vehicle booking. Returns: Cancellation result.

Get 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 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.

Look 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 (B

Get 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 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

Get 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 prev

Get 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.

Diagnose 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

Get 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

Get the user's saved travel context to personalize recommendations. Returns the user's loyalty programs and elite tiers, home airport, preferred airlines and cabin, preferred hotel chains, typical trip patterns (business vs leisure, budgets, frequent destinations), and any preferences t

Save a learned travel preference or experience to the user's traveler profile. Use when the user shares a durable preference, like, dislike, or trip experience that should inform future recommendations — "Always takes a window seat", "Prefers boutique hotels over chains", "Vegetarian".