Search hotels
search_hotelsHotels in a city or district, each with the link to book on the hotel's own website, its rating, stars and a short description. Use when the user asks where to stay somewhere, for hotels in a place, or for hotels with a pool, parking, pets allowed or a star rating. Districts, regions and spellings resolve to their city ("Shinjuku", "Badung Regency", "Marrakesh", "Roma"). City names repeat across countries, so country changes the answer ("Brisbane" alone is the one in California). Where the directory lists nothing, the result is covered: false with covered places instead. For one named hotel, use get_hotel.
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": {
"city": "<city>"
},
"name": "search_hotels"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | Yes | City, neighbourhood or district name, e.g. "Paris", "Shinjuku". | |
| limit | No | Default 5, max 20. | |
| stars | No | Star class filter. Note: 84% of the directory has no published star class, so this hides most hotels — prefer sorting by rating. | |
| client | No | Optional: your product or agent name, e.g. "Claude". Not used by the tool; recorded only for the public count of which assistants use the directory. | |
| country | No | Country name or ISO code, e.g. "Australia" or "AU". Disambiguates repeated city names. | |
| sort_by | No | Default: rating. | |
| amenities | No | Only hotels whose own website mentions all of these. Read from hotel sites, which covers about a quarter of the directory, so an empty result means "not mentioned", not "not available". |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| total | Yes | ||
| hotels | Yes | ||
| covered | Yes | ||
| guidance | No | ||
| widened_to | No | ||
| alternatives | No | ||
| searched_instead | No |