Gondola Award Travel Search

Official39 toolsLive

by gondola-ai · JavaScript

Compare cash vs points on hotels, flights, and cars. Checkout supported hotels and rental cars.

ai.gondola/gondola — Travel Award Search MCP Server

The ai.gondola/gondola MCP server provides travel award search that compares cash prices versus points for hotels, flights, and rental cars. It supports cents-per-point valuation, loyalty balance tracking, rate alerts, and direct booking from an AI client. It is positioned as a points-and-miles tool spanning multiple categories.

🛠️ Key Features

Compare cash vs points for hotels, flights, and cars
Cents-per-point valuations
Loyalty balance tracking
Rate alerts
Direct booking
Tool catalog size: 38 tools

🚀 Use Cases

Find hotel, flight, and car deals using points
Evaluate whether cash or points is the better value
Monitor loyalty balances and price/rate changes

⚡ Developer Benefits

Aligned with Model Context Protocol (MCP)
Topics include model-context-protocol and mcp for developer discovery
Designed for integration from an AI client using a tool set of 38

⚠️ Limitations

Described scope is limited to hotels, flights, and rental cars, with award comparisons (cash vs points)

Topics

award-travelclaudeflightshotelsloyaltymcpmilesmodel-context-protocolpointstravelgemini-cli-extension

Captured live from the server via tools/list.

book_hotel

Book a hotel room using a rate from get_hotel_rates. Requires guest details and a saved payment method. Use get_payment_methods to find the payment ID. The gondola_rate_id comes from the room rates returned by get_hotel_rates.

Parameters9

email_address	string	optional	Guest's email for confirmation.
family_name	string	optional	Guest's last name (minimum 2 characters).
given_name	string	optional	Guest's first name.
gondola_rate_id	integer	required	The rate ID from get_hotel_rates room rates.
loyalty_account_id	string	optional	Optional loyalty account ID to earn points and elite credit on this stay. Use the Member Number from get_loyalty_accounts that matches the booked hotel's chain (e.g. the World of Hyatt account for a Hyatt property).
payment_id	string	required	Payment method ID from get_payment_methods.
phone_number	string	optional	Guest's phone number with country code (e.g. "+1-555-123-4567").
special_request	string	optional	Optional special request (e.g. "high floor", "late check-in").
travel_profile_id	string	optional	Optional travel profile ID from get_travel_profiles. Prefills any guest details that were not passed explicitly.

Raw schema

{
  "type": "object",
  "properties": {
    "email_address": {
      "description": "Guest's email for confirmation.",
      "type": "string"
    },
    "family_name": {
      "description": "Guest's last name (minimum 2 characters).",
      "type": "string"
    },
    "given_name": {
      "description": "Guest's first name.",
      "type": "string"
    },
    "gondola_rate_id": {
      "description": "The rate ID from get_hotel_rates room rates.",
      "type": "integer"
    },
    "loyalty_account_id": {
      "description": "Optional loyalty account ID to earn points and elite credit on this stay. Use the Member Number from get_loyalty_accounts that matches the booked hotel's chain (e.g. the World of Hyatt account for a Hyatt property).",
      "type": "string"
    },
    "payment_id": {
      "description": "Payment method ID from get_payment_methods.",
      "type": "string"
    },
    "phone_number": {
      "description": "Guest's phone number with country code (e.g. \"+1-555-123-4567\").",
      "type": "string"
    },
    "special_request": {
      "description": "Optional special request (e.g. \"high floor\", \"late check-in\").",
      "type": "string"
    },
    "travel_profile_id": {
      "description": "Optional travel profile ID from get_travel_profiles. Prefills any guest details that were not passed explicitly.",
      "type": "string"
    }
  },
  "required": [
    "gondola_rate_id",
    "payment_id"
  ]
}

book_vehicle

Book a rental vehicle from a search result. Requires a Gondola account and a saved payment method (use get_payment_methods to find the payment ID). The vendor_code, rate_code, acriss_code, and search_id all come from search_vehicles results.

Parameters11

acriss_code	string	required	ACRISS vehicle classification code from search results.
email_address	string	required	Renter's email for confirmation.
family_name	string	required	Renter's last name.
given_name	string	required	Renter's first name.
loyalty_account_id	string	optional	Optional loyalty account ID to earn points on this rental.
payment_id	string	required	Payment method ID from get_payment_methods.
phone_number	string	required	Renter's phone number with country code (e.g. "+1-555-123-4567").
pickup_location	string	optional	Optional pickup airport IATA code of the selected vehicle. Pass through whatever pickup_location the search returned for this vehicle to disambiguate metro fanouts (e.g. JFK vs LGA in NYC).
rate_code	string	required	Rate code of the selected vehicle from search results.
search_id	string	required	Search ID from search_vehicles.
vendor_code	string	required	Vendor code from search results (e.g. "ZE" for Hertz).

Raw schema

{
  "type": "object",
  "properties": {
    "acriss_code": {
      "description": "ACRISS vehicle classification code from search results.",
      "type": "string"
    },
    "email_address": {
      "description": "Renter's email for confirmation.",
      "type": "string"
    },
    "family_name": {
      "description": "Renter's last name.",
      "type": "string"
    },
    "given_name": {
      "description": "Renter's first name.",
      "type": "string"
    },
    "loyalty_account_id": {
      "description": "Optional loyalty account ID to earn points on this rental.",
      "type": "string"
    },
    "payment_id": {
      "description": "Payment method ID from get_payment_methods.",
      "type": "string"
    },
    "phone_number": {
      "description": "Renter's phone number with country code (e.g. \"+1-555-123-4567\").",
      "type": "string"
    },
    "pickup_location": {
      "description": "Optional pickup airport IATA code of the selected vehicle. Pass through whatever pickup_location the search returned for this vehicle to disambiguate metro fanouts (e.g. JFK vs LGA in NYC).",
      "type": "string"
    },
    "rate_code": {
      "description": "Rate code of the selected vehicle from search results.",
      "type": "string"
    },
    "search_id": {
      "description": "Search ID from search_vehicles.",
      "type": "string"
    },
    "vendor_code": {
      "description": "Vendor code from search results (e.g. \"ZE\" for Hertz).",
      "type": "string"
    }
  },
  "required": [
    "search_id",
    "vendor_code",
    "rate_code",
    "acriss_code",
    "given_name",
    "family_name",
    "email_address",
    "phone_number",
    "payment_id"
  ]
}

cancel_vehicle_booking

Cancel an existing vehicle booking by its Gondola booking ID. Use this when a user wants to cancel a rental they previously booked.

Parameters2

booking_id	string	required	The Gondola booking ID (confirmation number) of the vehicle booking.
confirm	boolean	optional	Set true only after the user has seen the cancellation terms from the preview call and agreed.

Raw schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "description": "The Gondola booking ID (confirmation number) of the vehicle booking.",
      "type": "string"
    },
    "confirm": {
      "default": false,
      "description": "Set true only after the user has seen the cancellation terms from the preview call and agreed.",
      "type": "boolean"
    }
  },
  "required": [
    "booking_id"
  ]
}

compare_rates

Compare cash vs points rates and render a side-by-side rate_comparison widget for one or more hotels. Use this whenever the user is making a cash-vs-points decision — whether focused on a single hotel ("compare cash and points at Park Hyatt Tokyo") or weighing top picks against each other ("which of these is the best points redemption?"). Pass an array of one to five hotel_ids resolved from search_hotels. Returns cash rate, points rate, CPP valuation, and deal scores per hotel.

Parameters4

checkin	string	required	Check-in date in YYYY-MM-DD format.
checkout	string	required	Check-out date in YYYY-MM-DD format.
hotel_ids	array	required	Array of one to five hotel IDs to compare. A single-element array is valid when the user is focused on one hotel. Get these from search_hotels results.
num_adults	integer	optional	Number of adult guests.

Raw schema

{
  "type": "object",
  "properties": {
    "checkin": {
      "description": "Check-in date in YYYY-MM-DD format.",
      "type": "string"
    },
    "checkout": {
      "description": "Check-out date in YYYY-MM-DD format.",
      "type": "string"
    },
    "hotel_ids": {
      "description": "Array of one to five hotel IDs to compare. A single-element array is valid when the user is focused on one hotel. Get these from search_hotels results.",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "num_adults": {
      "default": 2,
      "description": "Number of adult guests.",
      "type": "integer"
    }
  },
  "required": [
    "hotel_ids",
    "checkin",
    "checkout"
  ]
}

create_rate_alert

Create a rate alert to monitor a hotel for price drops. The user will be notified by email when the rate drops. Optionally specify dates, or leave them out to monitor any two-night stay.

Parameters3

checkin	string	optional	Optional check-in date in YYYY-MM-DD format.
checkout	string	optional	Optional check-out date in YYYY-MM-DD format.
hotel_id	integer	required	The hotel's Vervotech property ID (from search results).

Raw schema

{
  "type": "object",
  "properties": {
    "checkin": {
      "description": "Optional check-in date in YYYY-MM-DD format.",
      "type": "string"
    },
    "checkout": {
      "description": "Optional check-out date in YYYY-MM-DD format.",
      "type": "string"
    },
    "hotel_id": {
      "description": "The hotel's Vervotech property ID (from search results).",
      "type": "integer"
    }
  },
  "required": [
    "hotel_id"
  ]
}

credit_card_coverage

Look up rental car CDW/LDW (collision damage waiver / loss damage waiver) coverage provided by a credit card. Useful before booking — tells the user whether they can decline the rental company's expensive insurance. Provide EITHER credit_card_product_name (exact card match) OR card_number_bin + card_provider (network-tier-based lookup).

Parameters3

card_number_bin	string	optional	First 6-8 digits of the card number (BIN). Used with card_provider for network-tier-based lookup when the exact product name isn't known.
card_provider	string	optional	Card network: "visa", "mastercard", "amex", or "discover". Required with card_number_bin.
credit_card_product_name	string	optional	Exact card product name (e.g. "Chase Sapphire Preferred", "American Express Platinum"). Preferred when known.

Raw schema

{
  "type": "object",
  "properties": {
    "card_number_bin": {
      "description": "First 6-8 digits of the card number (BIN). Used with card_provider for network-tier-based lookup when the exact product name isn't known.",
      "type": "string"
    },
    "card_provider": {
      "description": "Card network: \"visa\", \"mastercard\", \"amex\", or \"discover\". Required with card_number_bin.",
      "type": "string"
    },
    "credit_card_product_name": {
      "description": "Exact card product name (e.g. \"Chase Sapphire Preferred\", \"American Express Platinum\"). Preferred when known.",
      "type": "string"
    }
  },
  "required": []
}

delete_rate_alert

Delete a rate alert to stop monitoring a hotel for price drops.

Parameters1

alert_id

integer

required

The rate alert ID to delete (from get_rate_alerts).

Raw schema

{
  "type": "object",
  "properties": {
    "alert_id": {
      "description": "The rate alert ID to delete (from get_rate_alerts).",
      "type": "integer"
    }
  },
  "required": [
    "alert_id"
  ]
}

diagnose_rates

Diagnose rate availability and per-supplier statuses for a specific hotel. Use this when a power user asks why certain rates aren't showing (e.g. "why is there no AAA rate?" or "is this hotel mapped to Travelport?"). Returns per-source status and a full breakdown of every rate by type. Diagnostic — not for casual recommendations.

Parameters5

checkin	string	required	Check-in date in YYYY-MM-DD format.
checkout	string	required	Check-out date in YYYY-MM-DD format.
hotel_id	integer	required	The hotel's Vervotech property ID.
num_adults	integer	optional	Number of adult guests.
rate_sources	string	optional	Optional comma-separated list of rate sources to check (e.g. "travelport", "direct,travelport"). Omit to check all sources.

Raw schema

{
  "type": "object",
  "properties": {
    "checkin": {
      "description": "Check-in date in YYYY-MM-DD format.",
      "type": "string"
    },
    "checkout": {
      "description": "Check-out date in YYYY-MM-DD format.",
      "type": "string"
    },
    "hotel_id": {
      "description": "The hotel's Vervotech property ID.",
      "type": "integer"
    },
    "num_adults": {
      "default": 2,
      "description": "Number of adult guests.",
      "type": "integer"
    },
    "rate_sources": {
      "description": "Optional comma-separated list of rate sources to check (e.g. \"travelport\", \"direct,travelport\"). Omit to check all sources.",
      "type": "string"
    }
  },
  "required": [
    "hotel_id",
    "checkin",
    "checkout"
  ]
}

get_booking

Get details for a hotel booking made through Gondola, using the Gondola booking ID shown as "Gondola booking" by get_upcoming_trips and get_past_trips. Returns hotel name, dates, room type, rate, status, and cancellation policy. A hotel or airline confirmation number will not resolve. Reservations Gondola imported from email have no Gondola booking ID; get_upcoming_trips and get_past_trips already return their full detail, so answer from those instead of calling this.

Parameters1

booking_id

string

required

The Gondola booking ID, as shown by get_upcoming_trips or get_past_trips. Not a hotel or provider confirmation number.

Raw schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "description": "The Gondola booking ID, as shown by get_upcoming_trips or get_past_trips. Not a hotel or provider confirmation number.",
      "type": "string"
    }
  },
  "required": [
    "booking_id"
  ]
}

get_booking_link

Get a booking link for a hotel on Gondola. Use this when a user wants to book a specific hotel. Returns a URL to the hotel's booking page with dates pre-filled. Pass gondola_rate_id when a specific rate is known so the link deep-links straight to that rate's checkout page.

Parameters5

checkin	string	required	Check-in date in YYYY-MM-DD format.
checkout	string	required	Check-out date in YYYY-MM-DD format.
gondola_rate_id	integer	optional	Optional rate ID from get_hotel_rates or compare_rates. When provided, the link deep-links straight to that rate's checkout page instead of the generic hotel page.
hotel_id	integer	required	The hotel's Vervotech property ID.
num_adults	integer	optional	Number of adult guests.

Raw schema

{
  "type": "object",
  "properties": {
    "checkin": {
      "description": "Check-in date in YYYY-MM-DD format.",
      "type": "string"
    },
    "checkout": {
      "description": "Check-out date in YYYY-MM-DD format.",
      "type": "string"
    },
    "gondola_rate_id": {
      "description": "Optional rate ID from get_hotel_rates or compare_rates. When provided, the link deep-links straight to that rate's checkout page instead of the generic hotel page.",
      "type": "integer"
    },
    "hotel_id": {
      "description": "The hotel's Vervotech property ID.",
      "type": "integer"
    },
    "num_adults": {
      "default": 2,
      "description": "Number of adult guests.",
      "type": "integer"
    }
  },
  "required": [
    "hotel_id",
    "checkin",
    "checkout"
  ]
}

get_flight_credits

Get the user's active airline flight credits, eCredits, travel funds, vouchers, and travel-bank balances. Returns the airline, remaining usable amount, currency, credit type, and expiration date when known. Use this whenever the user asks whether they have unused airline money, credits from cancelled flights, or travel vouchers. Credit numbers and confirmation numbers are deliberately not exposed.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

get_flight_points

Collect award (miles/points) pricing for a flight search that reported pending_sources. Call this after search_flights when you set points: true and the response came back with pending_sources — those are the loyalty programs still being scraped. Returns per-program results: cash itineraries paired with their award price and cents-per-point, plus award-only itineraries the cash search did not surface. A program reporting "timeout" has no answer yet and can be asked again; "no_results" means that program genuinely has no award availability on this route.

Parameters3

departure_date	string	required	The departure date of that search, YYYY-MM-DD. The same value you passed to search_flights.
pending_sources	array	optional	The pending_sources from that search_flights response, passed back unchanged. Without it every supported program is polled, including ones that were never searched.
search_id	string	required	The search_id returned by the search_flights call.

Raw schema

{
  "type": "object",
  "properties": {
    "departure_date": {
      "description": "The departure date of that search, YYYY-MM-DD. The same value you passed to search_flights.",
      "type": "string"
    },
    "pending_sources": {
      "description": "The pending_sources from that search_flights response, passed back unchanged. Without it every supported program is polled, including ones that were never searched.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "search_id": {
      "description": "The search_id returned by the search_flights call.",
      "type": "string"
    }
  },
  "required": [
    "search_id",
    "departure_date"
  ]
}

get_free_night_credits

Get the user's free night certificates — the award nights earned from credit cards and elite status, such as a Marriott Free Night Award, a World of Hyatt free night, a Hilton free night reward, an IHG reward night, or a Wyndham Go Free night. Returns each certificate's program, how many remain, what it covers (a points ceiling, a hotel category range, or any standard room), when it expires, and whether a points top-up is allowed. These are distinct from points balances — a user can hold zero points and still have a certificate — so use this rather than get_loyalty_accounts whenever the user asks about certificates, free nights, or award nights (e.g. "do I have any free night certs?", "when does my Bonvoy free night expire?"). Certificates expire unused, so surface a near expiration proactively. This tool does not evaluate whether a particular hotel falls under a certificate's ceiling; don't infer coverage for a specific property from the cap.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

get_hotel_details

Get stored property information for a specific hotel: address, chain and brand, property type, star and guest ratings, all-inclusive and adults-only flags, themes, description, check-in and check-out times and instructions, amenities, photo links, room types with beds, size, max adults, and views, policies, and fees. Content only, with no dates or availability. Long lists are capped and end with a '+N more' count, so an amenity missing here may still exist. Use this after search_hotels when the traveler wants to learn more about a property; use get_hotel_rates for prices.

Parameters1

hotel_id

integer

required

The hotel's Vervotech property ID (returned by search_hotels).

Raw schema

{
  "type": "object",
  "properties": {
    "hotel_id": {
      "description": "The hotel's Vervotech property ID (returned by search_hotels).",
      "type": "integer"
    }
  },
  "required": [
    "hotel_id"
  ]
}

get_hotel_rates

Get live room rates for one hotel and stay window. Rooms are grouped by type (up to 12 shown) with up to three rates each: the cheapest non-refundable, cheapest refundable, and cheapest points award, with nightly and total price, cancellation terms, points earned, and the rate_id that get_booking_link and book_hotel accept as gondola_rate_id. Other rate variants are collapsed into a count. Only rates Gondola can book itself (direct and GDS sources) are shown; rooms with rates from other suppliers only are omitted. Rates arrive from several sources, so a result may say rates are still loading; call again in a few seconds before concluding a room, points rate, or non-refundable rate is unavailable. Past stay dates return a notice instead of rates. Use this after search_hotels when the traveler wants availability or booking options.

Parameters4

checkin	string	required	Check-in date in YYYY-MM-DD format.
checkout	string	required	Check-out date in YYYY-MM-DD format.
hotel_id	integer	required	The hotel's Vervotech property ID (returned by search_hotels).
num_adults	integer	optional	Number of adult guests.

Raw schema

{
  "type": "object",
  "properties": {
    "checkin": {
      "description": "Check-in date in YYYY-MM-DD format.",
      "type": "string"
    },
    "checkout": {
      "description": "Check-out date in YYYY-MM-DD format.",
      "type": "string"
    },
    "hotel_id": {
      "description": "The hotel's Vervotech property ID (returned by search_hotels).",
      "type": "integer"
    },
    "num_adults": {
      "default": 2,
      "description": "Number of adult guests.",
      "type": "integer"
    }
  },
  "required": [
    "hotel_id",
    "checkin",
    "checkout"
  ]
}

get_hotel_reviews

Get guest reviews for a specific hotel. Use this to help a user understand what other guests thought about a property — common complaints, recurring praise, recent service issues. Returns up to 10 recent reviews with ratings and comments.

Parameters1

hotel_id

integer

required

The hotel's Vervotech property ID (from search_hotels results).

Raw schema

{
  "type": "object",
  "properties": {
    "hotel_id": {
      "description": "The hotel's Vervotech property ID (from search_hotels results).",
      "type": "integer"
    }
  },
  "required": [
    "hotel_id"
  ]
}

get_hotel_stats

Get pricing percentile context for a specific hotel. Returns where the current rate falls relative to the property's typical pricing (e.g. "this rate is in the 20th percentile — cheaper than 80% of historical observations"). Use this to add objective context to recommendations.

Parameters4

hotel_id	integer	required	The hotel's Vervotech property ID.
nightly_cash_cost	number	required	The current all-in nightly cash rate from search_hotels (stay total, including included taxes and fees, divided by nights).
nightly_cash_cost_currency	string	required	Currency of the cash cost (e.g. "USD").
nightly_points_cost	integer	optional	Optional current nightly points rate to additionally score.

Raw schema

{
  "type": "object",
  "properties": {
    "hotel_id": {
      "description": "The hotel's Vervotech property ID.",
      "type": "integer"
    },
    "nightly_cash_cost": {
      "description": "The current all-in nightly cash rate from search_hotels (stay total, including included taxes and fees, divided by nights).",
      "type": "number"
    },
    "nightly_cash_cost_currency": {
      "description": "Currency of the cash cost (e.g. \"USD\").",
      "type": "string"
    },
    "nightly_points_cost": {
      "description": "Optional current nightly points rate to additionally score.",
      "type": "integer"
    }
  },
  "required": [
    "hotel_id",
    "nightly_cash_cost",
    "nightly_cash_cost_currency"
  ]
}

get_loyalty_accounts

Get the user's loyalty program memberships and current point balances. Use this to personalize recommendations (e.g. "with 120k Bonvoy points, this Sheraton is a great points redemption") and to suggest portfolio optimizations. This covers points balances and elite tiers only — free night certificates are tracked separately and are NOT returned here; use get_free_night_credits for those.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

get_multi_night_rates

Get a rate calendar for a hotel over a date range so you can recommend the cheapest nights. Use this when a user has flexible dates (e.g. "any week in May"). Returns per-checkin-date nightly rates so you can identify Tuesdays-are-30%-cheaper patterns.

Parameters4

end_date	string	required	Latest check-out date in YYYY-MM-DD format.
hotel_id	integer	required	The hotel's Vervotech property ID.
nights	integer	optional	Number of nights for each candidate stay.
start_date	string	required	Earliest check-in date in YYYY-MM-DD format.

Raw schema

{
  "type": "object",
  "properties": {
    "end_date": {
      "description": "Latest check-out date in YYYY-MM-DD format.",
      "type": "string"
    },
    "hotel_id": {
      "description": "The hotel's Vervotech property ID.",
      "type": "integer"
    },
    "nights": {
      "default": 1,
      "description": "Number of nights for each candidate stay.",
      "type": "integer"
    },
    "start_date": {
      "description": "Earliest check-in date in YYYY-MM-DD format.",
      "type": "string"
    }
  },
  "required": [
    "hotel_id",
    "start_date",
    "end_date"
  ]
}

get_past_trips

Get the user's past hotel stays and flights. Use this to answer travel-history questions and make recommendations grounded in behavior (e.g. "you loved the Park Hyatt last year", "you've flown United six times this year", "what seats have I taken before?", or "what is my favorite airplane seat?"). Returns past hotels and flights with dates, confirmation numbers, status, costs, loyalty programs, routes, airlines, ticket class, miles redeemed, and historical flight seat assignments when Gondola parsed real row+letter seats from airline emails. Opens with a Patterns block summarising the WHOLE history (aisle/window/middle seat mix, airline share, top routes, hotel chains, recorded spend), then one page of individual reservations newest first. For favorite-seat, aisle/window, side-of-plane, seat-letter, or preferred-row questions, read the Patterns block rather than tallying rows yourself, and do not say seat data is unavailable until this tool has been checked. Pass page=2, 3, ... to walk further back through the reservation list.

Parameters2

limit	integer	optional	Reservations per page. The Patterns block always covers the whole history regardless of this value.
page	integer	optional	1-based page of past reservations, newest first. Increment to walk further back through the history.

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 50,
      "description": "Reservations per page. The Patterns block always covers the whole history regardless of this value.",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "page": {
      "default": 1,
      "description": "1-based page of past reservations, newest first. Increment to walk further back through the history.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": []
}

get_payment_methods

List the user's saved payment methods for booking. Returns saved credit/debit cards with their payment IDs, needed for the book_hotel tool.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

get_rate_alerts

Get all active rate alerts for the current user. Returns which hotels the user is monitoring for price drops.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

get_similar_hotels

Find hotels similar to a given hotel. Use this for branching exploration after a search (e.g. user likes the Park Hyatt Tokyo but wants a cheaper alternative — find similar properties). Pass destination when the alternatives should be in a different city. Returns properties matched by hotel attributes and amenities, with current rates.

Parameters5

checkin	string	required	Check-in date in YYYY-MM-DD format.
checkout	string	required	Check-out date in YYYY-MM-DD format.
destination	string	optional	Optional destination city or place for cross-city alternatives.
hotel_id	integer	required	The seed hotel's Vervotech property ID.
num_adults	integer	optional	Number of adult guests.

Raw schema

{
  "type": "object",
  "properties": {
    "checkin": {
      "description": "Check-in date in YYYY-MM-DD format.",
      "type": "string"
    },
    "checkout": {
      "description": "Check-out date in YYYY-MM-DD format.",
      "type": "string"
    },
    "destination": {
      "description": "Optional destination city or place for cross-city alternatives.",
      "type": "string"
    },
    "hotel_id": {
      "description": "The seed hotel's Vervotech property ID.",
      "type": "integer"
    },
    "num_adults": {
      "default": 2,
      "description": "Number of adult guests.",
      "type": "integer"
    }
  },
  "required": [
    "hotel_id",
    "checkin",
    "checkout"
  ]
}

get_suggested_searches

Get personalized travel suggestions and trip inspiration for the current user. Returns curated hotel recommendations grounded in the user's preferences, recent searches, popular destinations, and upcoming holidays. Great for open-ended prompts like "where should I go?" or "any trip ideas for next month?".

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

get_suite_upgrade_credits

Get the user's active suite upgrade awards and certificates across loyalty programs. Returns the program, award type, remaining count, and expiration date. Use this whenever the user asks about suite upgrades, Nightly Upgrade Awards, Suite Upgrade Awards, Confirmable Upgrade Rewards, or IHG suite upgrades. These awards are separate from free-night certificates and points balances.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

get_travel_profiles

Get the user's saved travel profiles — guest name, email, and phone presets. Each profile has a selectable ID you can pass to book_hotel as travel_profile_id to prefill the guest details, mirroring the website checkout where the user picks a saved traveler instead of typing each field. Use this before booking so you can offer "book as <traveler>" in one step.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

get_traveler_context

Get the user's saved travel context: loyalty programs and elite tiers, home airport, preferred airlines and cabin, preferred hotel chains, typical trip patterns (business vs leisure, budgets, frequent destinations), plus any preferences they've stated or that have been learned from past conversations. Call this once at the start of a travel or planning session and weigh it when recommending hotels, flights, or cars — it is the single best source of who this traveler is. For raw evidence from actual past reservations, routes, hotels, airlines, or flight seats, use get_past_trips.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

get_upcoming_trips

Get the user's upcoming hotel, flight, and rental car reservations. Use this to ground recommendations in real plans (e.g. "your Tokyo trip is May 15-20, want me to find restaurants?"), check upcoming confirmation numbers, or answer what flights/cars/hotels are already booked. Returns dates, confirmation numbers, status, costs/rates, loyalty programs and earnings, savings/AutoSave signals, flight segment details, ticket class, miles redeemed, refundability/cancellation timing, and seat assignments when Gondola has parsed real row+letter seats from airline emails.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

get_vehicle_booking

Get details for a specific vehicle booking by its Gondola booking ID. Returns vendor, pickup/dropoff locations and times, vehicle class, rate, and status. Use when a user asks about a rental they've already booked (e.g. "what time is my pickup?", "where do I pick up my Hertz rental?").

Parameters1

booking_id

string

required

The Gondola booking ID, as shown by get_upcoming_trips or get_past_trips. Not a rental confirmation number from the vendor.

Raw schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "description": "The Gondola booking ID, as shown by get_upcoming_trips or get_past_trips. Not a rental confirmation number from the vendor.",
      "type": "string"
    }
  },
  "required": [
    "booking_id"
  ]
}

get_vehicle_booking_coverage

Get the rental car CDW/LDW coverage that was stored at booking time for a specific vehicle booking. Use this after a booking to remind the user what coverage their card provides on this rental.

Parameters1

booking_id

string

required

The Gondola booking ID of the vehicle booking.

Raw schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "description": "The Gondola booking ID of the vehicle booking.",
      "type": "string"
    }
  },
  "required": [
    "booking_id"
  ]
}

get_vehicle_booking_link

Get a Gondola.ai deep link for a specific vehicle from search results. Use this to share a booking page URL the user can complete on the web, or as a fallback when in-conversation booking via book_vehicle is unavailable. Returns a Gondola checkout link for the selected vehicle; the traveler completes the reservation there. In-conversation booking via book_vehicle is partner-only.

Parameters5

dropoff_datetime	string	required	Drop-off date and time in ISO format (e.g. "2025-03-20T10:00:00").
pickup_datetime	string	required	Pickup date and time in ISO format (e.g. "2025-03-15T10:00:00").
rate_code	string	required	Rate code of the selected vehicle.
search_id	string	required	Search ID from search_vehicles.
vendor_code	string	required	Vendor code from search results.

Raw schema

{
  "type": "object",
  "properties": {
    "dropoff_datetime": {
      "description": "Drop-off date and time in ISO format (e.g. \"2025-03-20T10:00:00\").",
      "type": "string"
    },
    "pickup_datetime": {
      "description": "Pickup date and time in ISO format (e.g. \"2025-03-15T10:00:00\").",
      "type": "string"
    },
    "rate_code": {
      "description": "Rate code of the selected vehicle.",
      "type": "string"
    },
    "search_id": {
      "description": "Search ID from search_vehicles.",
      "type": "string"
    },
    "vendor_code": {
      "description": "Vendor code from search results.",
      "type": "string"
    }
  },
  "required": [
    "search_id",
    "vendor_code",
    "rate_code",
    "pickup_datetime",
    "dropoff_datetime"
  ]
}

get_vehicle_details

Get detailed information about a specific rental vehicle option. Use this after search_vehicles to get extras, insurance options, charges, and cancellation policy for the vehicle the user wants to book.

Parameters7

acriss_code	string	optional	ACRISS code from the selected vehicle result; pass it through to disambiguate classes.
desk_kind	string	optional	Desk classification from the selected vehicle result, when present.
pickup_location	string	optional	Pickup location from the selected vehicle result; pass it through for metro searches.
rate_code	string	required	Rate code from search results.
search_id	string	required	Search ID from the vehicle search results.
vendor_code	string	required	Vendor code from search results (e.g. "ZE" for Hertz, "AL" for Alamo).
vendor_location_id	string	optional	Vendor desk identifier from the selected vehicle result, when present.

Raw schema

{
  "type": "object",
  "properties": {
    "acriss_code": {
      "description": "ACRISS code from the selected vehicle result; pass it through to disambiguate classes.",
      "type": "string"
    },
    "desk_kind": {
      "description": "Desk classification from the selected vehicle result, when present.",
      "type": "string"
    },
    "pickup_location": {
      "description": "Pickup location from the selected vehicle result; pass it through for metro searches.",
      "type": "string"
    },
    "rate_code": {
      "description": "Rate code from search results.",
      "type": "string"
    },
    "search_id": {
      "description": "Search ID from the vehicle search results.",
      "type": "string"
    },
    "vendor_code": {
      "description": "Vendor code from search results (e.g. \"ZE\" for Hertz, \"AL\" for Alamo).",
      "type": "string"
    },
    "vendor_location_id": {
      "description": "Vendor desk identifier from the selected vehicle result, when present.",
      "type": "string"
    }
  },
  "required": [
    "vendor_code",
    "rate_code",
    "search_id"
  ]
}

optimize_loyalty_portfolio

Analyze the user's entire loyalty portfolio and surface the highest-value actions: points expiring soon (ranked by value at risk), the best transfer opportunities from their transferable card currencies (Amex, Chase, Bilt, etc.) into hotel programs, and their largest balances. Takes no arguments — it works across the whole portfolio, not a single trip. Use this when the user asks how to make the most of their points, what's expiring, or where they can transfer. To choose where to book a SPECIFIC trip, use search_hotels / compare_rates instead.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

predict_price

Predict whether the current rate at a hotel is a good deal based on historical price trends. Use this when the user is debating booking now vs. waiting. Returns a confidence-scored label (e.g. "book now", "wait", "prices typically rise") with supporting signals and price history.

Parameters6

checkin	string	required	Check-in date in YYYY-MM-DD format.
checkout	string	required	Check-out date in YYYY-MM-DD format.
hotel_id	integer	required	The hotel's Vervotech property ID.
nightly_cash_cost	number	required	The current all-in nightly cash rate from search_hotels (stay total, including included taxes and fees, divided by nights).
nightly_cash_cost_currency	string	required	Currency of the cash cost (e.g. "USD", "EUR").
nightly_points_cost	integer	optional	Optional current nightly points rate.

Raw schema

{
  "type": "object",
  "properties": {
    "checkin": {
      "description": "Check-in date in YYYY-MM-DD format.",
      "type": "string"
    },
    "checkout": {
      "description": "Check-out date in YYYY-MM-DD format.",
      "type": "string"
    },
    "hotel_id": {
      "description": "The hotel's Vervotech property ID.",
      "type": "integer"
    },
    "nightly_cash_cost": {
      "description": "The current all-in nightly cash rate from search_hotels (stay total, including included taxes and fees, divided by nights).",
      "type": "number"
    },
    "nightly_cash_cost_currency": {
      "description": "Currency of the cash cost (e.g. \"USD\", \"EUR\").",
      "type": "string"
    },
    "nightly_points_cost": {
      "description": "Optional current nightly points rate.",
      "type": "integer"
    }
  },
  "required": [
    "hotel_id",
    "checkin",
    "checkout",
    "nightly_cash_cost",
    "nightly_cash_cost_currency"
  ]
}

search_events

Search for live events by artist, team, show, or event name. Returns factual event discovery details in provider order, including dates, venue, status, optional approximate listed price range, and the canonical event page. Prices are provider-supplied discovery metadata, not live offers. Use page=0 first and increment page when more results are available. An artist keyword is resolved to that performer and the search is pinned to them, so tribute and club nights that borrow a famous name do not crowd out real tour dates. Many place and word names are also band names (Boston, Chicago, Kansas), so if the response names a performer the user did not mean, search again with match_artist=false rather than concluding nothing is happening. When the resolved performer is the one intended and no events are listed, they have no dates matching that search: do not present namesake events as theirs. When price_precision is "rank_only" the provider withheld amounts but the ordering is exact, so cite the rank against price_ranked_total ("5th cheapest of 9") and link to the event page for the current price. Never state, estimate, or infer a dollar amount in that case.

Parameters14

attraction_id	string	optional	Optional provider performer id. Pins results to that performer exactly.
classification	string	optional	Optional segment, genre, or subgenre.
end_date	string	optional	Latest local event date, YYYY-MM-DD.
include_unavailable	boolean	optional	Include cancelled and postponed events, excluded by default. Off-sale events are always returned, since they are real dates that are sold out or not yet on sale.
keyword	string	required	Artist, team, show, or event name.
limit	integer	optional
location	string	optional	Optional city, region, postal code, or natural-language location.
match_artist	boolean	optional	Resolve keyword to a canonical performer before searching. Set false for keywords that are not a performer, such as a genre, venue, or festival name.
max_price	number	optional	Only return events whose cheapest listing is at or below this amount. Requires sort=price, because only the price-ordering provider can filter on price; sending it with any other sort is rejected rather than silently ignored. There is no matching minimum: a price floor is not supported and must not be simulated.
page	integer	optional
radius	integer	optional
radius_unit	string	optional
sort	string	optional	Use "price" for any cheapest-first or budget question. It orders events by their cheapest listing exactly, and each event carries price_rank against price_ranked_total. It is served by a single provider that does no performer resolution, so match_artist has no effect with this sort, and combining it with attraction_id or include_unavailable is rejected rather than silently ignored.
start_date	string	optional	Earliest local event date, YYYY-MM-DD.

Raw schema

{
  "type": "object",
  "properties": {
    "attraction_id": {
      "description": "Optional provider performer id. Pins results to that performer exactly.",
      "type": "string"
    },
    "classification": {
      "description": "Optional segment, genre, or subgenre.",
      "type": "string"
    },
    "end_date": {
      "description": "Latest local event date, YYYY-MM-DD.",
      "type": "string"
    },
    "include_unavailable": {
      "default": false,
      "description": "Include cancelled and postponed events, excluded by default. Off-sale events are always returned, since they are real dates that are sold out or not yet on sale.",
      "type": "boolean"
    },
    "keyword": {
      "description": "Artist, team, show, or event name.",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "location": {
      "description": "Optional city, region, postal code, or natural-language location.",
      "type": "string"
    },
    "match_artist": {
      "default": true,
      "description": "Resolve keyword to a canonical performer before searching. Set false for keywords that are not a performer, such as a genre, venue, or festival name.",
      "nullable": true,
      "type": "boolean"
    },
    "max_price": {
      "description": "Only return events whose cheapest listing is at or below this amount. Requires sort=price, because only the price-ordering provider can filter on price; sending it with any other sort is rejected rather than silently ignored. There is no matching minimum: a price floor is not supported and must not be simulated.",
      "exclusiveMinimum": 0,
      "type": "number"
    },
    "page": {
      "default": 0,
      "minimum": 0,
      "type": "integer"
    },
    "radius": {
      "maximum": 500,
      "minimum": 1,
      "type": "integer"
    },
    "radius_unit": {
      "default": "miles",
      "enum": [
        "miles",
        "km"
      ],
      "type": "string"
    },
    "sort": {
      "default": "relevance",
      "description": "Use \"price\" for any cheapest-first or budget question. It orders events by their cheapest listing exactly, and each event carries price_rank against price_ranked_total. It is served by a single provider that does no performer resolution, so match_artist has no effect with this sort, and combining it with attraction_id or include_unavailable is rejected rather than silently ignored.",
      "enum": [
        "relevance",
        "date",
        "distance",
        "price"
      ],
      "type": "string"
    },
    "start_date": {
      "description": "Earliest local event date, YYYY-MM-DD.",
      "type": "string"
    }
  },
  "required": [
    "keyword"
  ]
}

search_flights

Search for flights by route and date. Returns cash-priced options ranked for the traveler — weighing their airline loyalty/status and travel history alongside flight quality, not price alone — 10 options per page. Results are discovery-only and cannot be booked through Gondola. Call again with page=2, 3, ... to see more options if none of the first page fit. When you asked for points and the response comes back with pending_sources, award pricing is still being fetched: call get_flight_points with the same search_id and departure_date, passing those pending_sources back, to get it.

Parameters10

airlines	array	optional	Optional airline codes or names, e.g. ["UA"] or ["United"]. Filters the discovery results.
cabin_class	string	optional	Optional cabin class: "economy", "premium economy", "business", "first".
departure_date	string	required	Departure date in YYYY-MM-DD format.
destination	string	required	Destination airport code or city (e.g. "NRT", "LHR", "Paris").
max_stops	integer	optional	Optional maximum stops per direction. Use 0 for nonstop only.
num_passengers	integer	optional	Number of passengers.
origin	string	required	Origin airport code or city (e.g. "LAX", "SFO", "New York").
page	integer	optional	1-based results page, 10 options per page. Increment to see more options.
points	boolean	optional	Set true when the traveler asks about award pricing, miles, points, redeeming rewards, award availability, or comparing cash vs. points — including phrases like "include points", "show me miles", "how many points", or "use my [program] miles". Default false. When true, award prices arrive on a follow-up call to get_flight_points (not in this response), so you MUST call get_flight_points after this returns. One-way flights only.
return_date	string	optional	Optional return date in YYYY-MM-DD format for a round trip. Read the labels on the results: a price marked 'round trip' already covers both directions, while results split into separate outbound and return sections are one-way prices whose sum overstates the real round-trip fare.

Raw schema

{
  "type": "object",
  "properties": {
    "airlines": {
      "description": "Optional airline codes or names, e.g. [\"UA\"] or [\"United\"]. Filters the discovery results.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "cabin_class": {
      "description": "Optional cabin class: \"economy\", \"premium economy\", \"business\", \"first\".",
      "type": "string"
    },
    "departure_date": {
      "description": "Departure date in YYYY-MM-DD format.",
      "type": "string"
    },
    "destination": {
      "description": "Destination airport code or city (e.g. \"NRT\", \"LHR\", \"Paris\").",
      "type": "string"
    },
    "max_stops": {
      "description": "Optional maximum stops per direction. Use 0 for nonstop only.",
      "minimum": 0,
      "type": "integer"
    },
    "num_passengers": {
      "default": 1,
      "description": "Number of passengers.",
      "type": "integer"
    },
    "origin": {
      "description": "Origin airport code or city (e.g. \"LAX\", \"SFO\", \"New York\").",
      "type": "string"
    },
    "page": {
      "default": 1,
      "description": "1-based results page, 10 options per page. Increment to see more options.",
      "type": "integer"
    },
    "points": {
      "default": false,
      "description": "Set true when the traveler asks about award pricing, miles, points, redeeming rewards, award availability, or comparing cash vs. points — including phrases like \"include points\", \"show me miles\", \"how many points\", or \"use my [program] miles\". Default false. When true, award prices arrive on a follow-up call to get_flight_points (not in this response), so you MUST call get_flight_points after this returns. One-way flights only.",
      "type": "boolean"
    },
    "return_date": {
      "description": "Optional return date in YYYY-MM-DD format for a round trip. Read the labels on the results: a price marked 'round trip' already covers both directions, while results split into separate outbound and return sections are one-way prices whose sum overstates the real round-trip fare.",
      "type": "string"
    }
  },
  "required": [
    "origin",
    "destination",
    "departure_date"
  ]
}

search_hotels

Search for hotels by location and dates. Returns a list of matching hotels with cash and points rates and deal scores. To produce a focused cash-vs-points decision widget for a hotel the user is considering — for one or several top picks — follow up with compare_rates rather than narrating rates from search results. This tool searches one fixed stay window. If the user asks for a flexible window (for example, 2 nights between September 8 and 22), either ask which check-in date they prefer or pick one concrete window and explicitly tell the user why you chose it; do not silently default to the earliest possible dates. When the user wants date options, use get_multi_night_rates on the top hotel_ids after search_hotels to surface alternate check-in dates where available.

Parameters6

chain_name	string	optional	Optional hotel chain filter (e.g. "marriott", "hilton", "hyatt", "ihg"). Case-insensitive substring match against each result's chain. If no result matches, the unfiltered results are returned with an explicit note in the summary so you don't keep retrying with different chain values.
checkin	string	required	Check-in date in YYYY-MM-DD format.
checkout	string	required	Check-out date in YYYY-MM-DD format.
hotel_name	string	optional	Optional hotel name to boost to the top of results (e.g. "Conrad Las Vegas", "Park Hyatt Tokyo"). Use this when the user names a specific hotel — the matching property will be ranked first so you can pass its hotel_id to compare_rates without guessing. Case-insensitive substring match against the property name. Boosting (rather than filtering) preserves nearby alternatives the user may want to see.
location	string	required	City name, address, or area (e.g. "Tokyo", "Manhattan, New York", "near LAX airport").
num_adults	integer	optional	Number of adult guests.

Raw schema

{
  "type": "object",
  "properties": {
    "chain_name": {
      "description": "Optional hotel chain filter (e.g. \"marriott\", \"hilton\", \"hyatt\", \"ihg\"). Case-insensitive substring match against each result's chain. If no result matches, the unfiltered results are returned with an explicit note in the summary so you don't keep retrying with different chain values.",
      "type": "string"
    },
    "checkin": {
      "description": "Check-in date in YYYY-MM-DD format.",
      "type": "string"
    },
    "checkout": {
      "description": "Check-out date in YYYY-MM-DD format.",
      "type": "string"
    },
    "hotel_name": {
      "description": "Optional hotel name to boost to the top of results (e.g. \"Conrad Las Vegas\", \"Park Hyatt Tokyo\"). Use this when the user names a specific hotel — the matching property will be ranked first so you can pass its hotel_id to compare_rates without guessing. Case-insensitive substring match against the property name. Boosting (rather than filtering) preserves nearby alternatives the user may want to see.",
      "type": "string"
    },
    "location": {
      "description": "City name, address, or area (e.g. \"Tokyo\", \"Manhattan, New York\", \"near LAX airport\").",
      "type": "string"
    },
    "num_adults": {
      "default": 2,
      "description": "Number of adult guests.",
      "type": "integer"
    }
  },
  "required": [
    "location",
    "checkin",
    "checkout"
  ]
}

search_vehicles

Search for rental vehicles at an airport or city. Returns available cars sorted by price with vendor, class, and rate details.

Parameters4

dropoff_datetime	string	required	Drop-off date and time in ISO format (e.g. "2025-03-20T10:00:00").
pickup_datetime	string	required	Pickup date and time in ISO format (e.g. "2025-03-15T10:00:00").
pickup_location	string	required	Airport IATA code (e.g. "LAX", "JFK", "SFO").
vehicle_class	string	optional	Optional vehicle class preference: Economy, Compact, Standard, FullSize, Premium, Luxury, SUV, Van.

Raw schema

{
  "type": "object",
  "properties": {
    "dropoff_datetime": {
      "description": "Drop-off date and time in ISO format (e.g. \"2025-03-20T10:00:00\").",
      "type": "string"
    },
    "pickup_datetime": {
      "description": "Pickup date and time in ISO format (e.g. \"2025-03-15T10:00:00\").",
      "type": "string"
    },
    "pickup_location": {
      "description": "Airport IATA code (e.g. \"LAX\", \"JFK\", \"SFO\").",
      "type": "string"
    },
    "vehicle_class": {
      "description": "Optional vehicle class preference: Economy, Compact, Standard, FullSize, Premium, Luxury, SUV, Van.",
      "enum": [
        "Economy",
        "Compact",
        "Standard",
        "FullSize",
        "Premium",
        "Luxury",
        "SUV",
        "Van"
      ],
      "type": "string"
    }
  },
  "required": [
    "pickup_location",
    "pickup_datetime",
    "dropoff_datetime"
  ]
}

update_traveler_profile

Save a learned travel preference or experience to the user's traveler profile. Use when the user shares preferences, likes, dislikes, or trip experiences that should inform future recommendations. Examples: 'Prefers boutique hotels over chains', 'Always takes a window seat', 'Vegetarian — recommend plant-based restaurants', 'Hated ground floor rooms'. Don't save temporary logistics like 'my flight lands at 3pm'. Entries are appended, so saving one preference never overwrites another.

Parameters1

profile_entry

string

required

The preference or experience to save. Be specific and actionable. Good: 'Prefers ocean-view rooms'. Bad: 'Liked the hotel'.

Raw schema

{
  "type": "object",
  "properties": {
    "profile_entry": {
      "description": "The preference or experience to save. Be specific and actionable. Good: 'Prefers ocean-view rooms'. Bad: 'Liked the hotel'.",
      "type": "string"
    }
  },
  "required": [
    "profile_entry"
  ]
}

README.md9 KBView on GitHub

Gondola — Travel MCP Server & Claude Code Plugin

The travel MCP that shows cash and award rates side by side. Search hotels, flights, and rental cars across every major hotel chain and loyalty program — with cents-per-point valuations, loyalty balance tracking, rate alerts, and direct booking — right from your AI client.

Built for points and miles: unlike award-flight-only tools, Gondola covers hotels, flights, and cars, and puts the cash price and the award (points) price in one view so you can see exactly when a redemption beats cash.

Works with Claude Code, Codex, Cursor, Windsurf, VS Code, Claude Desktop, ChatGPT, Gemini CLI, and any MCP-compatible client. Learn more at gondola.ai/mcp.

Endpoint: https://mcp.gondola.ai/mcp (Streamable HTTP)
Auth: search & discovery work anonymously — no account, no API key. Personal tools (loyalty balances, trips, saved profiles) use standard MCP OAuth 2.1 with Dynamic Client Registration — your client signs you in on first use, no key to copy.
Tools: 31 across hotels, flights, rental cars, events, loyalty, and analytics.

Quick Install

Claude Code plugin (recommended)

Inside Claude Code:

code

/plugin marketplace add gondola-ai/gondola-mcp
/plugin install gondola

This adds the Gondola MCP server plus slash commands (/hotel-points, /award-flights, /worth-it, /optimize-points). On first use of a personal tool, your client opens gondola.ai to sign you in via OAuth — takes a few seconds, no API key.

Or add the MCP server directly (any client)

Search tools work anonymously; personal tools trigger an OAuth login on first call. No client needs an mcp-remote bridge — every client below supports remote Streamable HTTP natively.

Claude Code

bash

claude mcp add --transport http gondola https://mcp.gondola.ai/mcp

Codex CLI

bash

codex mcp add gondola --url https://mcp.gondola.ai/mcp

Or in ~/.codex/config.toml:

toml

[mcp_servers.gondola]
url = "https://mcp.gondola.ai/mcp"

Cursor — ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

json

{
  "mcpServers": {
    "gondola": { "url": "https://mcp.gondola.ai/mcp" }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json (note: serverUrl, not url):

json

{
  "mcpServers": {
    "gondola": { "serverUrl": "https://mcp.gondola.ai/mcp" }
  }
}

VS Code (Copilot / Agent mode)

bash

code --add-mcp '{"name":"gondola","type":"http","url":"https://mcp.gondola.ai/mcp"}'

Or .vscode/mcp.json (note: top-level key is servers):

json

{
  "servers": {
    "gondola": { "type": "http", "url": "https://mcp.gondola.ai/mcp" }
  }
}

Gemini CLI — install as an extension (bundles the server plus usage context):

bash

gemini extensions install https://github.com/gondola-ai/gondola-mcp

Or wire it up by hand in ~/.gemini/settings.json (note: httpUrl, not url):

json

{
  "mcpServers": {
    "gondola": { "httpUrl": "https://mcp.gondola.ai/mcp" }
  }
}

Claude Desktop — Settings → Connectors → Add custom connector → name gondola, URL https://mcp.gondola.ai/mcp. Leave the OAuth client fields and headers blank (DCR handles it).

ChatGPT — Settings → Connectors → Advanced → Developer mode, then Add custom connector → URL https://mcp.gondola.ai/mcp, auth = OAuth. (Anonymous search works pre-login; personal tools require the OAuth sign-in.)

What you can do

Ask naturally, or use the slash commands the plugin installs.

Compare cash vs. points for hotels

code

"Find hotels in Tokyo for March 3–7 and show cash vs points with cents-per-point"
"Is it worth using Bonvoy points for the Ritz in Maui that week, or pay cash?"
"Cheapest 5-night Hyatt stay in Lisbon on points in May"

code

/hotel-points Tokyo 2026-03-03 2026-03-07
/worth-it Ritz-Carlton Maui, 4 nights in March, Bonvoy

Search award + cash flights together

code

"Business class SFO to Tokyo in November — award and cash side by side"
"Cheapest way to fly JFK→LHR in points under 60k?"

code

/award-flights SFO HND 2026-11-10 business

Make your points work harder

code

"Where are my points worth the most right now?"
"I have 180k Amex points and 90k Bonvoy — best redemption for a beach trip in March?"

code

/optimize-points a beach trip in March

Signed-in users also get loyalty balances, upcoming/past trips, free-night certificates, saved traveler profiles, and rate alerts.

MCP tools (31)

Search & discovery tools are anonymous. Tools marked 🔒 use your account and require the one-time OAuth sign-in.

Booking is handled through Gondola's checkout: get_booking_link and get_vehicle_booking_link hand your client a direct link. Tools that charge a saved card from a tool call are not part of the self-serve surface — see Partner booking tools below.

Hotels

Tool	What it does
`search_hotels`	Find hotels with cash and award (points) rates.
`compare_rates`	Cash vs points side by side, with cents-per-point value.
`get_hotel_details`	Full detail for one property.
`get_multi_night_rates`	Per-night rate breakdown across a stay.
`get_similar_hotels`	Comparable properties to one you like.
`get_hotel_stats`	Rate/availability stats for a hotel.
`get_hotel_reviews`	Guest reviews.
`predict_price`	Price prediction for a stay.
`get_suggested_searches`	Suggested searches / inspiration.
`get_booking_link`	Direct booking link.

Flights

Tool	What it does
`search_flights`	Cash-priced flight search with booking links.

Events

Tool	What it does
`search_events`	Live events with venue, date, and listed-price detail.

Rental cars

Tool	What it does
`search_vehicles`	Search rental cars.
`get_vehicle_details`	Detail for one vehicle/offer.
`credit_card_coverage`	Check credit-card rental insurance coverage.
`get_vehicle_booking_coverage`	Coverage on a specific booking.
`get_vehicle_booking_link`	Direct booking link.
`get_vehicle_booking` 🔒	Retrieve a car booking.

Loyalty & analytics

Tool	What it does
`get_loyalty_accounts` 🔒	Your loyalty point balances.
`optimize_loyalty_portfolio` 🔒	Where your points are worth the most.
`get_free_night_credits` 🔒	Free-night certificates you hold.
`diagnose_rates`	Explain why a rate is what it is.

Trips, alerts & profile

Tool	What it does
`get_upcoming_trips` 🔒	Your upcoming trips.
`get_past_trips` 🔒	Your past trips.
`get_booking` 🔒	Retrieve a specific booking.
`get_rate_alerts` 🔒	Your rate alerts.
`create_rate_alert` 🔒	Create a rate alert.
`delete_rate_alert` 🔒	Delete a rate alert.
`get_travel_profiles` 🔒	Saved traveler profiles.
`update_traveler_profile` 🔒	Update a traveler profile.
`get_traveler_context` 🔒	Your traveler context/preferences.

Partner booking tools

Four tools place charges against a saved payment method or enumerate the cards that can be charged. They require the mcp:book scope, which is granted only to onboarded booking partners — a client that registers dynamically has it narrowed away at consent, so these tools are neither listed nor callable on a normal connection.

Tool	What it does
`book_hotel`	Book a hotel room against a saved payment method.
`book_vehicle`	Book a rental car against a saved payment method.
`cancel_vehicle_booking`	Cancel a car booking.
`get_payment_methods`	List saved payment methods available for booking.

Interested in partner access? Email support@gondola.ai.

Why Gondola

Cash and award, together. Every search shows the cash price beside the points price with a cents-per-point value — the "is this redemption worth it?" question, answered inline.
Every major chain + program, not a single airline or a single OTA.
Straight to checkout. Hotels and cars hand off a direct booking link, so you finish on Gondola rather than retyping the search somewhere else.
No API key. Anonymous search out of the box; OAuth only when you reach for your own data.

License

MIT — see LICENSE.

Install

Tools (39)

book_hotelbook_vehiclecancel_vehicle_bookingcompare_ratescreate_rate_alertcredit_card_coveragedelete_rate_alertdiagnose_rates

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.gondola.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "gondola": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.gondola.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

ai.gondola/gondola — Travel Award Search MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

book_hotel

book_vehicle

cancel_vehicle_booking

compare_rates

create_rate_alert

credit_card_coverage

delete_rate_alert

diagnose_rates

get_booking

get_booking_link

get_flight_credits

get_flight_points

get_free_night_credits

get_hotel_details

get_hotel_rates

get_hotel_reviews

get_hotel_stats

get_loyalty_accounts

get_multi_night_rates

get_past_trips

get_payment_methods

get_rate_alerts

get_similar_hotels

get_suggested_searches

get_suite_upgrade_credits

get_travel_profiles

get_traveler_context

get_upcoming_trips

get_vehicle_booking

get_vehicle_booking_coverage

get_vehicle_booking_link

get_vehicle_details

optimize_loyalty_portfolio

predict_price

search_events

search_flights

search_hotels

search_vehicles

update_traveler_profile

Gondola — Travel MCP Server & Claude Code Plugin

Quick Install

Claude Code plugin (recommended)

Or add the MCP server directly (any client)

What you can do

Compare cash vs. points for hotels

Search award + cash flights together

Make your points work harder

MCP tools (31)

Hotels

Flights

Events

Rental cars

Loyalty & analytics

Trips, alerts & profile

Partner booking tools

Why Gondola

Links

License

Install

Remote endpoint

Related servers