Search multiple Brek hotels
search_accommodationsSearches and compares multiple hotels in a city, neighborhood, airport, landmark, or other destination. Every search requires both checkinDate and checkoutDate, or dateIntent=tonight when the user explicitly asks for tonight. If the user supplied neither, ask for stay dates before calling; do not choose dates for them. Supports occupancy, price range, star rating, guest score, property types, amenities, cancellation preference, and sort order. Returns an ordered list with property IDs, hotel facts, wholesale prices or price bands, public-rate comparisons, and Brek links. For a follow-up by position or partial hotel name, match against the most recent relevant search list. If one hotel matches, copy its propertyId exactly into get_accommodation_details or get_accommodation_offers; never shorten, combine, or replace IDs with placeholders. If the ID is unavailable, pass hotelName and optional destination instead. If several hotels match, ask which hotel the user means. Intended for destination discovery and multi-hotel comparison; room-level offers for one property are not included.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"destination": "<destination>"
},
"name": "search_accommodations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| sort | No | Use top-picks for recommended, distance for nearest, total for price ascending, total-desc for price descending, and reviews for guest review score (not hotel stars). Aliases: price_low_to_high / total price ascending -> total; price_high_to_low / total price descending -> total-desc; rating / guest reviews -> reviews. Unknown sorting returns normal correction guidance. | top-picks |
| rooms | No | Whole-number room count from 1 to 3. Each room receives the default of 2 adults when adults is omitted. | |
| adults | No | Whole-number total adult count from 1 to 10 across all rooms. When omitted, Brek defaults to 2 adults per room. | |
| children | No | Whole-number total child count from 0 to 8; when omitted, uses childrenAges.length. | |
| currency | No | Only specify a currency when the traveler explicitly requests one. Otherwise omit it so Brek can use the visitor country, then locale, then USD. Supported: EUR, USD, INR, GBP, AUD, CAD, ARS, TRY, COP, CLP, SEK, MXN, IDR, BRL. | |
| latitude | No | Optional latitude when already known. | |
| timeZone | No | Optional IANA time-zone fallback for resolving relative stay dates; destination or property location takes precedence. | |
| amenities | No | Amenities required in every result. Only listed enum values are supported. All-inclusive is not a supported filter; never promise that results satisfy it. | |
| longitude | No | Optional longitude when already known. | |
| dateIntent | No | Use only when the user explicitly requests tonight. Resolves check-in as the current local date and check-out as the following date; otherwise provide both stay dates. | |
| checkinDate | No | Required with checkoutDate unless the user explicitly requested tonight. Use YYYY-MM-DD. | |
| destination | Yes | City, neighborhood, airport, landmark, or other broad destination. | |
| starRatings | No | Exact accepted hotel star classifications. | |
| user_locale | No | Optional traveler locale from the Claude client context, such as en-US. Omit if unavailable; do not infer it from the hotel destination. | |
| checkoutDate | No | Required with checkinDate unless the user explicitly requested tonight. Use YYYY-MM-DD. | |
| childrenAges | No | Whole-number ages from 0 to 17 for every child at check-in, up to 8 children. The array length must equal children. | |
| maximumPrice | No | Maximum nightly price in the selected currency. | |
| minimumPrice | No | Minimum nightly price in the selected currency. | |
| propertyTypes | No | Property category search. Supported canonical categories: hotel, motel, resort, hostel, apartment, apart-hotel, extended-stay, condo, studio, house, townhome, guesthouse, bed-and-breakfast, villa, cabin, cottage, campground, rv, estate, boat, chateau, hotel-suites, corporate-apartment, farm-house, lodge, barn, mobile-home, house-boat, castle, mas, tower, mill, building. Mappings: chalet -> cabin; inn -> hotel. These broader categories can contain other subtypes; explain the mapping and do not promise exact-subtype matches. Other unknown types return a normal unsupported-search explanation, not a tool error. | |
| minimumStarRating | No | Minimum hotel star classification from 1 to 5; distinct from guest review score. | |
| minimumReviewScore | No | Minimum guest review score out of 10; distinct from hotel star classification. | |
| user_location_city | No | Optional approximate traveler city supplied by the Claude client. Omit if unavailable; this is not the hotel destination. | |
| freeCancellationOnly | No | Whether results require free cancellation or refundable rates. | |
| user_location_region | No | Optional traveler state or region supplied by the Claude client. Omit if unavailable; do not infer it from the hotel destination. | |
| user_location_country | No | Optional two-letter traveler country supplied by the Claude client, such as US. Omit if unavailable; do not infer it from the hotel destination. | |
| user_location_timezone | No | Optional IANA timezone of the traveler supplied by the Claude client. Omit if unavailable; this does not set the hotel's local stay dates. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| total | Yes | ||
| search | Yes | ||
| status | No | ||
| message | No | ||
| totalPages | Yes | ||
| requiredInput | No | ||
| accommodations | Yes | ||
| filterMappings | No | ||
| priceDisclosure | Yes | ||
| unsupportedFilters | No |