Search hotels with live prices
search_hotelsSearch hotels and resorts in a destination (city, region or resort area) with LIVE prices for the dates and party. Prices are totals for the whole stay in USD, taxes and fees included. Returns up to 15 hotels (cheapest first, or best-rated with sort=rating), with ids for 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": {
"destination": "<destination>",
"checkin": "<checkin>",
"checkout": "<checkout>"
},
"name": "search_hotels"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | price = cheapest first; rating = best guest rating first | price |
| rooms | No | Number of rooms; adults/children are split across them | |
| adults | No | ||
| checkin | Yes | YYYY-MM-DD | |
| checkout | Yes | YYYY-MM-DD | |
| min_stars | No | Only hotels with at least this star rating | |
| destination | Yes | e.g. 'Cancun', 'Punta Cana', 'Maui', 'Riviera Maya' | |
| children_ages | No | Ages of children, if any | |
| all_inclusive_only | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hotels | Yes | ||
| summary | Yes |