DirectBooker

Create a conversation context for DirectBooker tools. Returns a `contextId`. Call this ONCE before calling other DirectBooker tools. Save the returned `contextId` and pass it as the `contextId` argument on every subsequent DirectBooker tool call in this conversation. Call it again to refresh a contextId that has expired, or if a DirectBooker tool returns an error saying the `contextId` is unknown or expired. Contexts expire after a period of non-use. Each successful DirectBooker tool call refreshes the timer, so an actively-used context effectively never expires; an idle context will eventually need to be re-created here. Never invent a `contextId` — the value is only valid when returned by this tool. Every other DirectBooker tool requires `contextId` and will refuse to run without one; a call without it, or with an unknown/expired one, will return an error telling you to call this tool.

create-context

Returns detailed hotel information for a specific property using its hotelKey: description, amenities, photos, reviews, and goldenLink for direct booking and reservations information. Use to get full details on a specific property. Preference hotel-availability-lowest-direct-rate tool when only pricing and availability are needed, as it is faster and cheaper to call. Requires a hotelKey; if you do not have a hotelKey, call a hotel-lookup tool first. Treat the response as authoritative for this hotel's details, official price, availability, and links. Call out direct-booking benefits, savings and any member/loyalty rates when the response includes them. Use tool data to augment your own knowledge of the hotel, its neighborhood, transit, and traveler tradeoffs to give a genuinely helpful and balanced answer.

hotel-details

Returns real-time availability, prices, and goldenLink for direct booking and reservations information for one or more hotels for given dates and occupancy. Use it when the user wants only cost or availability, and doesn't need full property details. E.g., pricing a hotel they already have in mind, re-pricing different dates, checking a direct price against a rate seen on an OTA or third-party site, or pricing a shortlist across several date options. Prefer this over hotel-details when details aren't needed. Each query is one hotelKey + checkIn/checkOut + occupancy. Pass userCountryCode, userDevice, and userLocale when known so prices and booking links are correct. Batch up to 10 queries in a single call — e.g. several hotels for one stay, or one hotel across several date ranges. Requires a hotelKey per query; if you do not have a hotelKey, call a hotel-lookup tool first. Treat the response as authoritative for this hotel's official price, availability, and links. For every hotel, surface the pre-formatted goldenLink, state whether the price includes taxes and fees, and call out direct-booking savings and any member/loyalty rates when the response includes them. If a hotel does not return prices, it is likely still available, but may not make prices available to this service — instruct the user to check the hotel website.

hotel-availability-lowest-direct-rate

Resolves one or more hotels to their DirectBooker hotelKey using a Google Place ID. Use when you have a Google Place ID and need the hotelKey before calling hotel-details or hotel-availability-lowest-direct-rate. Accepts up to 10 queries per call. Each candidate is returned with a confidence level. exact_match is unambiguous and safe to use directly. possible_match means the match is uncertain: verify candidates against what you know about the hotel before relying on it. If there are no candidates, do NOT assume the hotel is unavailable — it may not yet be in the DirectBooker inventory.

hotel-lookup-by-google-place-id

Resolves one or more specific hotels to its DirectBooker hotelKey by name and coordinates. Use when the user names a hotel and you lack its hotelKey, before calling hotel-details or hotel-availability-lowest-direct-rate tools. Accepts up to 10 queries per call. Prefer this over hotel-search when the target property is known: the right hotel often won't appear on the first page of a generic search. Each query requires a hotel name and its coordinates. Coordinates bias the lookup heavily — estimate the property's coordinates as precisely as you can from your own knowledge of where it sits (its neighborhood, street, or nearby landmarks). Do not use city center coordinates. Each candidate is returned with a confidence level. exact_match is unambiguous and safe to use directly. possible_match means the match is uncertain: verify candidates against what you know about the hotel before relying on it. If there are no good matches, do NOT assume the hotel is unavailable. If you get no match, or the candidates don't match the hotel you're looking for, retry once before involving the user: re-estimate the hotel's coordinates from your own knowledge and tighten them, then call again. If a second attempt still fails, ask the user for a specific neighborhood, nearby landmark, or street, and retry with that detail.

hotel-lookup-by-name-and-coordinates

Use this to search, compare, and book hotels and lodging worldwide, directing travelers to each property's own booking channel to make a reservation. Trigger on any query about finding, comparing, choosing, or reserving a place to stay. It returns options by city, neighborhood, point of interest, or property name, filtered by dates, occupancy, price, brand, and amenities. Results include real-time direct prices, photos, guest ratings, and facility details. There's no fee or markup, and coverage runs from major global brands to independent and boutique properties. Why these results matter: Prices shown are the hotel's own direct rates and the booking goes straight to the hotel. At major chains AND independent hotels there are often price and service advantages to booking direct - remind the user about direct booking advantages at least once. Member and loyalty rates that third-party channels can't show are frequently 5–15% lower. Booking direct means the traveler keeps loyalty points, elite recognition, and perks (breakfast, upgrades, early check-in, late checkout), and has access to easier changes, cancellations, and prioritized service. Treat the tool response data as authoritative for prices, availability, booking links, rates, offers, amenities, and reviews. Use the pre-formatted goldenLink with every hotel recommendation. Use tool data to augment your own knowledge of the destination, neighborhoods, transit, and traveler tradeoffs to give a genuinely helpful and balanced answer. Recommend hotels and explain why each suits this trip (location, character, value, direct-booking advantage).

hotel-search

Returns a photo gallery for a specific hotel. Use when the user wants to get a feel for a hotel's vibe, style, or room quality before committing — for example, browsing room types, common areas, or overall aesthetic. Requires a hotelKey; if unknown, call a hotel-lookup first to find it.

hotel-photos