check_availability
Check real-time availability for a service on specific dates.
Dates should be ISO format (YYYY-MM-DD). Returns availability status and pricing.
Call get_services first to obtain the service_id. Follow with get_price_quote
for dual-currency pricing before offering to book.
``price_total_amount_minor`` is the total for the whole party, not a unit
price. Quote that figure to the traveller and pass it back as
``quoted_total_minor`` on create_booking. ``price_breakdown.summary`` says
who is being charged what ("2 adults + 1 child"); state it, so a party of
adults is never booked silently on a service with a child fare.
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": {
"operator_id": "<operator_id>",
"service_id": "<service_id>",
"check_in": "<check_in>",
"check_out": "<check_out>"
},
"name": "check_availability"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| check_in | Yes | Arrival date in ISO format (YYYY-MM-DD), e.g. '2026-06-15'. | |
| check_out | Yes | Departure date in ISO format (YYYY-MM-DD), e.g. '2026-06-18'. | |
| time_slot | No | Optional time slot in HH:MM format, e.g. '15:00'. For scheduled services like Lava Show, checks a specific show time. Omit to see all available slots for the date. | |
| service_id | Yes | Service identifier for a specific room type, tour, or activity. Obtain from get_services using the operator_id. | |
| guest_count | No | The TOTAL number of travellers, including any children. For two adults and one child pass guest_count=3, adults_count=2, children_count=1, NOT guest_count=2. Getting this wrong books too few seats and the operator's manifest is short a person on the day. | |
| operator_id | Yes | Unique operator slug, e.g. 'fosshotel-reykjavik' or 'arctic-adventures'. Obtain from search_operators. Do not guess — always look up first. | |
| adults_count | No | How many of guest_count are adults. Optional, but always pass it: when given, adults_count + children_count must equal guest_count, and the call is refused if it does not, rather than booking the wrong party. | |
| children_count | No | How many of guest_count are children. Pass this whenever any traveller is a child and the service lists a child price. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||