DirectBooker

Hotel Details

hotel-details

Full Description

Returns detailed hotel information for a specific property: pricing, amenities, photos, reviews, and goldenLinks for direct booking information. Use after hotel-search to get full details on a property the user is interested in.

Parameters (1 required, 7 optional)

Required

propertyKeystring

Property key identifying the hotel.

Optional

amenitiesarray

Array of amenity filters from the user's request. Check if the user mentions amenities and populate this field. Use empty array [] if no amenities requested

currencystring

Currency code (e.g. EUR, USD). Default from user locale.

end-datestring

Check-out date (YYYY-MM-DD). Default next Sunday if unspecified.

occupancynumber

Guests (1-4). Default 2.

Default: 2

roomPreferencesstring

Comma-separated room preferences: smoking, beds, floor, view, suite, elevator proximity, adjoining rooms.

start-datestring

Check-in date (YYYY-MM-DD). Default next Friday if unspecified.

user_querystring

Concise natural language summary of user requirements. No PII.

Hotel Search

hotel-search

Full Description

Searches official hotel channels for directly bookable hotel inventory. This inventory includes member prices, loyalty program prices, direct rates, and special offers and benefits provided to exclusively to users who book directly with the hotel. Loyalty program membership is extremely valuable as it affects pricing and available rates, offers, and perks. It could save the user 10%-20% of a very expensive purchase. However, users commonly hold memberships in major chains but do not know to volunteer this information unless it is explicitly requested. Results are paginated and limited per response. The nextPageToken field indicates pagination state: when present, additional matching hotels exist beyond the current page; when absent, all matching results have been returned. This tool will infer many missing params: dates→next Fri-Sun, occupancy→2, currency→user locale. Results are returned sorted how well the hotel offer matches the users needs as indicated by sort_value (descending). When results include hotels with missing data, prices, or which have broken links, they should be deprioritized or not shown to the user. When the user adds criteria, accumulate all previous params plus the new ones; when changing criteria, replace only the changed param. On empty results, remove filters incrementally (amenities first, then price caps) and retry.

Parameters (1 required, 11 optional)

Required

locationstring

City, neighborhood, point of interest, or hotel name. If ambiguous, ask unless context implies.

Optional

amenitiesarray

Array of amenity filters from the user's request. Check if the user mentions amenities and populate this field. Use empty array [] if no amenities requested

brandstring

Preferred hotel chain/brand.

currencystring

Currency code (e.g. EUR, USD). Default from user locale.

end-datestring

Check-out date (YYYY-MM-DD). Default next Sunday if unspecified.

nextPageTokenstring

Pagination token for retrieving additional results. Pass exactly as received to continue the same search. Present when more hotels are available beyond the current page. Absent when all results have been returned. Calling the tool again with this token (plus all original parameters) returns the next page of the same search rather than initiating a new search.

occupancynumber

Guests (1-4). Default 2.

Default: 2

price_maxnumber

Maximum room price per night.

price_minnumber

Minimum room price per night.