Title97/100
Find hotel rooms with a jacuzzi or hot tub
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Find hotels where a named room type has its own jacuzzi, whirlpool or hot tub inside the room, in a city, town, state, province, UK nation, or around a point. Returns each hotel with the exact room to book, the tub type, room extras (fireplace, tub for two, heart-shaped, pets), Google rating, the date and source of the last check, and its tubroom.com page. Best rated first, or nearest first for a point search.
The description explains the capability, when to use it, and what to expect.
Inputs94/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
place
Where the user wants to stay, as they said it: a city or town ("Gatlinburg", "Pigeon Forge, TN", "Toronto"), a US state, Canadian province or UK nation ("Ohio", "Ontario", "Wales"), or a country. Add the state after a comma when a city name is shared. Omit it for a search around a point.
Clear enough to supply this argument.
lat
Latitude of a spot the user wants to stay near (a venue, attraction or address), for example 35.7143 for downtown Gatlinburg. Send it together with lng instead of place.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
lng
Longitude of the same spot, for example -83.5102. Send it together with lat.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
radius_miles
How far from the lat/lng spot the user is willing to stay, in miles. Ignored for a place search.
Clear enough to supply this argument.
tub_type
Set only when the user names a specific kind of tub; hotels label the same jetted tub differently, so leaving it out finds more rooms.
Clear enough to supply this argument.
features
Room extras the user asked for, such as a fireplace in the room or bringing a dog. A hotel is returned only when it has every extra listed. romantic means a source states a tub for two, a fireplace, a heart-shaped tub or a honeymoon room.
Clear enough to supply this argument.
min_rating
Lowest Google guest rating the user will accept, for example 4.0 for well-reviewed hotels only.
Clear enough to supply this argument.
limit
How many hotels to show the user. The total count is returned either way.
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"title": "Find hotel rooms with a jacuzzi or hot tub",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Output schema91/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"required": [
"place",
"total",
"hotels",
"credit"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "Extra guidance: other places with the same name, or nearest covered places when nothing matched."
},
"place": {
"type": "string",
"description": "The place the search resolved to, or the point searched."
},
"total": {
"type": "integer",
"description": "How many hotels matched before the limit."
},
"credit": {
"type": "string",
"description": "Attribution line to show with the answer."
},
"hotels": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"room_to_book",
"tub",
"checked",
"page"
],
"properties": {
"lat": {
"type": "number",
"description": "Latitude."
},
"lng": {
"type": "number",
"description": "Longitude."
},
"tub": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tub types stated for that room."
},
"list": {
"type": "string",
"description": "The Tubroom city or area list it belongs to."
},
"name": {
"type": "string",
"description": "Hotel name."
},
"page": {
"type": "string",
"description": "The hotel page on tubroom.com, with dates and booking. Give this link to the user."
},
"town": {
"type": "string",
"description": "Town or suburb the hotel is in."
},
"suite": {
"type": "boolean",
"description": "The tub room is a suite."
},
"region": {
"type": "string",
"description": "US state code, Canadian province code, or UK nation."
},
"address": {
"type": [
"string",
"null"
],
"description": "Street address."
},
"checked": {
"type": "string",
"description": "Date (YYYY-MM-DD) the tub room was last confirmed."
},
"country": {
"type": "string",
"description": "US, CA or GB."
},
"romantic": {
"type": "array",
"items": {
"type": "string"
},
"description": "Why the room counts as romantic, from what a source states (empty if none)."
},
"city_page": {
"type": "string",
"description": "The full city or area list on tubroom.com."
},
"fireplace": {
"type": "boolean",
"description": "A source places a fireplace in the tub room."
},
"distance_km": {
"type": "number",
"description": "Distance from the searched point in km (point searches only)."
},
"confirmed_on": {
"type": "string",
"description": "Where the tub room was confirmed (hotel website, chain site, OTA)."
},
"pets_allowed": {
"type": "boolean",
"description": "Google Hotels lists pets as allowed at the hotel."
},
"room_to_book": {
"type": "string",
"description": "The named room type that has the tub. Book this room, not a standard room."
},
"confirmed_url": {
"type": [
"string",
"null"
],
"description": "Link to that source."
},
"google_rating": {
"type": [
"number",
"null"
],
"description": "Google rating out of 5, or null."
},
"distance_miles": {
"type": "number",
"description": "Distance from the searched point in miles (point searches only)."
},
"two_person_tub": {
"type": "boolean",
"description": "A source says the tub is sized for two."
},
"heart_shaped_tub": {
"type": "boolean",
"description": "The tub is heart-shaped."
}
},
"description": "One hotel with a tub room, as listed on tubroom.com."
},
"description": "Matching hotels, best first."
},
"list_page": {
"type": [
"string",
"null"
],
"description": "The tubroom.com page with the full list for this place, when there is one."
}
}
}