search_stays
Search ZMRM vacation rentals (zimmers, villas, apartments; Hebrew: צימר, וילה, דירת נופש, נופש, חופשה) in Israel for exact dates and guests. Returns up to 10 stays with an exact total price in ILS agorot for the whole stay, or "on request" where a live supplier quote is needed. Show the url to the user; it opens the stay with these dates and guests filled in (page_url is the plain stay page, for citation). Every quote carries priced_at and valid_until (advisory, not a hold). The answer also lists payment_methods and a payment_note, once; vouchers (including the Cal reservist voucher, שובר מילואים) and gift cards apply to ILS checkouts only. Club-card discounts apply to ILS checkouts only and are applied at payment; if the guest asks about a club or benefit card, call get_search_options, which lists the customer clubs (names only, no rate). Use get_booking_link to re-price before the guest pays. If the price of the first stay cannot be checked, the PRICING_UNAVAILABLE error carries details.retry_cursor: pass it as cursor to retry once; an error without retry_cursor is final. Empty results with a non-null next_cursor mean more stays may exist: call again with the cursor and do not report "no stays". Read-only: nothing is booked or held.
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": {
"check_in": "<check_in>",
"check_out": "<check_out>",
"adults": "<adults>"
},
"name": "search_stays"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| near | No | Only stays within radius_km of a point, e.g. near a landmark or the guest's location. | |
| pets | No | True when the guests bring a pet; it is filled into the stay link. It does not filter results: check house_rules.pets_allowed in get_stay. | |
| agent | No | Your client's name (e.g. "chatgpt", "claude"), used only to attribute the visit; optional. | |
| limit | No | How many stays to return, 1 to 10. Defaults to 5. | |
| adults | Yes | Number of adult guests (at least 1). | |
| cursor | No | next_cursor (or details.retry_cursor) from the previous answer, to get the next page of the same search. Keep every other argument unchanged. | |
| locale | No | Language of the returned names and of the stay links (he, en, fr, es, de, it, ru, ar). Defaults to he. | |
| infants | No | Number of infants. Defaults to 0. | |
| category | No | Only stays of this category (e.g. zimmers or villas); a category slug from get_search_options. | |
| check_in | Yes | Arrival day, YYYY-MM-DD (Israel time). Today or later. | |
| children | No | Number of children, not counting infants. Defaults to 0. | |
| currency | No | Also show the price converted to EUR or USD (approximate). Prices are always quoted in ILS agorot; omit for ILS only. | |
| amenities | No | Only stays that have every one of these amenities (e.g. pool, jacuzzi); up to 10 amenity slugs from get_search_options. | |
| check_out | Yes | Departure day, YYYY-MM-DD, after check_in. get_search_options gives the longest stay (max_nights). | |
| city_slug | No | Only stays in this city; a city slug from get_search_options. | |
| region_slug | No | Region to search: a top-level region (north, south or center) or a sub-region slug. An unrecognised slug is refused with INVALID_INPUT and suggestions; call get_search_options for the valid slugs. | |
| max_total_agorot | No | Budget for the whole stay in ILS agorot (100 agorot = 1 ILS), e.g. 150000 for 1,500 ILS. Stays priced above it are left out. |