Search availability
search_availabilityWHEN: use it whenever the traveller asks "what do you have from X to Y for N people" or shows date flexibility. WHAT IT RETURNS: matches[] with one entry per available category (G1..G6, G4B) ordered by total price, including name, zone (beach/city), bedrooms, m², highlights, location summary, photos, total/nightly EUR price (public rate, no discount code) and a booking_url with dates+pax prefilled. Also alternatives[] (up to 6, each with reason like "same dates, other category" or "2 days earlier, same category") when matches are empty or flexible_days > 0, minimum_stay_only[] for categories that would be available with a longer stay, no_results_reason when nothing applies, and trust (rating 9.4/10, 320+ Booking reviews, cheaper than Booking.com, Stripe payment, 14-day free cancellation, languages supported). Direct prices are BELOW Booking.com for the same dates. FLEXIBLE PARAMETERS: flexible_days (0–3, default 0) shifts the check-in by ±N days to broaden alternatives; budget_eur filters matches and alternatives by TOTAL EUR; zone ("beach" | "city" | "any", default "any"); min_bedrooms (default 1 — a sofa bed does not count). EXAMPLE: {"check_in":"2027-05-22","check_out":"2027-05-27","adults":4,"flexible_days":2,"budget_eur":900,"zone":"beach","min_bedrooms":2}.
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_availability"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zone | No | Filter by zone: beach = La Patacona (G1..G5, G4B); city = Valencia city (G6); any = both (default). | |
| adults | Yes | Number of adults. | |
| check_in | Yes | Arrival date (YYYY-MM-DD, Europe/Madrid). | |
| children | No | Optional list of children ages. Only the count is used to size the property. | |
| language | No | Response language. Defaults to en if omitted or unsupported. | |
| check_out | Yes | Departure date (YYYY-MM-DD, Europe/Madrid); must be strictly after check_in. | |
| budget_eur | No | Max TOTAL price in EUR for the whole stay. Filters both matches and alternatives. | |
| min_bedrooms | No | Minimum number of bedrooms (1 by default — a sofa bed does not count). | |
| flexible_days | No | Shift the check-in by ±N days (0..3) to find alternatives if the exact dates are not available. Default 0. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| trust | Yes | ||
| guests | Yes | ||
| nights | Yes | ||
| matches | Yes | ||
| check_in | Yes | ||
| currency | Yes | ||
| check_out | Yes | ||
| alternatives | Yes | Up to 6 alternatives (other dates ±flexible_days or other categories) when matches are empty or the agent asked for flexibility. | |
| priority_url | Yes | ||
| priority_note | Yes | ||
| minimum_stay_only | Yes | Properties that would be available if the stay met the minimum-nights rule. | |
| no_results_reason | No | Human-readable reason when both matches and alternatives are empty (e.g. all over minimum_stay or over budget). |