Search hotels
mb_search_hotelsSearch hotels with free rooms in an Iranian city for your dates and compare the cheapest room prices for the whole stay, filtering by stars, amenities, type, breakfast, and refundability.
Instructions
Hotels and stays with a free room in a city for the dates, with the cheapest room price for the whole stay.
price_toman is the cheapest room for all nights (one room, after discount); cheapest_room_sleeps is how many that room sleeps (often 1). Guest count does not change prices: pick a fitting room with mb_hotel_rooms(guests=...). Next: mb_hotel, mb_hotel_rooms, mb_hotel_calendar.
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>",
"check_in": "<check_in>",
"check_out": "<check_out>"
},
"name": "mb_search_hotels"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | Yes | City slug from mb_find_place(mode='hotel'), e.g. 'mashhad' or 'kish'. | |
| sort | No | Order; rating is the site's default. | rating |
| limit | No | Max hotels. | |
| check_in | Yes | Check-in date YYYY-MM-DD. | |
| amenities | No | Persian words, each matching an amenity title, e.g. ['استخر'] (pool), ['پارکینگ']. | |
| check_out | Yes | Check-out date YYYY-MM-DD (1 to 30 nights). | |
| min_stars | No | Only hotels with at least this many stars, e.g. 4. | |
| hotel_type | No | Kind of stay. | any |
| breakfast_only | No | Only stays whose cheapest room includes breakfast. | |
| refundable_only | No | Only refundable stays. | |
| max_price_per_night_toman | No | Highest price per night for one room in Toman, e.g. 3000000. |