Input schema (JSON)
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"destination"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1
},
"sort": {
"enum": [
"top-picks",
"distance",
"total",
"total-desc",
"reviews"
],
"type": "string",
"default": "top-picks",
"description": "Result order: top-picks, distance, total price ascending, total price descending, or guest reviews."
},
"rooms": {
"type": "integer",
"default": 1,
"maximum": 3,
"minimum": 1,
"description": "Number of rooms. Each room receives the default of 2 adults when adults is omitted."
},
"adults": {
"type": "integer",
"maximum": 16,
"minimum": 1,
"description": "Total adult guests. When omitted, Brek defaults to 2 adults per room."
},
"children": {
"type": "integer",
"maximum": 8,
"minimum": 0,
"description": "Total child guests; when omitted, uses childrenAges.length."
},
"currency": {
"type": "string",
"maxLength": 3,
"minLength": 3,
"description": "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": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Optional latitude when already known."
},
"timeZone": {
"type": "string",
"maxLength": 80,
"minLength": 3,
"description": "Optional IANA time-zone fallback for resolving relative stay dates; destination or property location takes precedence."
},
"amenities": {
"type": "array",
"items": {
"enum": [
"pool",
"parking",
"wifi",
"free-wifi",
"kitchen",
"fireplace",
"beachfront",
"washer",
"dryer",
"air-conditioning",
"tv",
"heating",
"family-friendly",
"kids-friendly",
"pet-friendly",
"hot-tub",
"free-breakfast",
"free-cancellation",
"laundry-in-unit",
"laundry-on-site",
"accessible",
"for-couples",
"solarium",
"long-term-deals",
"pay-over-time",
"accept-local"
],
"type": "string"
},
"maxItems": 12,
"description": "Amenities required in every result."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Optional longitude when already known."
},
"dateIntent": {
"enum": [
"tonight"
],
"type": "string",
"description": "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": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Required with checkoutDate unless the user explicitly requested tonight. Use YYYY-MM-DD."
},
"destination": {
"type": "string",
"maxLength": 160,
"minLength": 2,
"description": "City, neighborhood, airport, landmark, or other broad destination."
},
"starRatings": {
"type": "array",
"items": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"maxItems": 5,
"description": "Exact accepted hotel star classifications."
},
"user_locale": {
"type": "string",
"maxLength": 35,
"minLength": 2,
"description": "Optional traveler locale from the Claude client context, such as en-US. Omit if unavailable; do not infer it from the hotel destination."
},
"checkoutDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Required with checkinDate unless the user explicitly requested tonight. Use YYYY-MM-DD."
},
"childrenAges": {
"type": "array",
"items": {
"type": "integer",
"maximum": 17,
"minimum": 0
},
"default": [],
"maxItems": 8,
"description": "Age of every child at check-in. The array length must equal children."
},
"maximumPrice": {
"type": "number",
"description": "Maximum nightly price in the selected currency.",
"exclusiveMinimum": 0
},
"minimumPrice": {
"type": "number",
"minimum": 0,
"description": "Minimum nightly price in the selected currency."
},
"propertyTypes": {
"type": "array",
"items": {
"enum": [
"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"
],
"type": "string"
},
"maxItems": 12,
"description": "Accepted accommodation types, such as hotel, motel, resort, hostel, or apartment."
},
"minimumStarRating": {
"type": "number",
"maximum": 5,
"minimum": 1,
"description": "Minimum hotel star classification from 1 to 5; distinct from guest review score."
},
"minimumReviewScore": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Minimum guest review score out of 10; distinct from hotel star classification."
},
"user_location_city": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Optional approximate traveler city supplied by the Claude client. Omit if unavailable; this is not the hotel destination."
},
"freeCancellationOnly": {
"type": "boolean",
"default": false,
"description": "Whether results require free cancellation or refundable rates."
},
"user_location_region": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Optional traveler state or region supplied by the Claude client. Omit if unavailable; do not infer it from the hotel destination."
},
"user_location_country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "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": {
"type": "string",
"maxLength": 80,
"minLength": 3,
"description": "Optional IANA timezone of the traveler supplied by the Claude client. Omit if unavailable; this does not set the hotel's local stay dates."
}
},
"additionalProperties": false
}