Check Live PMS Availability
check_availabilityCheck real-time PMS calendar availability for one specific villa or suite (`unit_id`).
Directly queries the property management system adapter (WebHotelier, Avantio, HostHub, Lodgify, Hostify)
to verify whether a known unit is open for a specific date range and guest count.
When to use:
- Use when you already have a specific `unit_id` (for example, when a traveler shifts dates or guest count on a shortlisted villa) and want a fast boolean availability check.
When NOT to use:
- Do NOT use for initial discovery across a destination or island—use `search_properties` instead.
- Do NOT use when you need itemized nightly pricing, cleaning fees, taxes, and cancellation policy—use `get_rate_details` instead.
Args:
unit_id: The unit_id from search_properties results (e.g. "n19trsyt73" or PMS unit identifier)
check_in: Arrival date YYYY-MM-DD
check_out: Departure date YYYY-MM-DD
guests: Number of guests
Returns:
JSON object confirming `available` (boolean), `unit_id`, `check_in`, `check_out`, `guests`, and optional `error`.
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": {
"unit_id": "<unit_id>",
"check_in": "<check_in>",
"check_out": "<check_out>",
"guests": "<guests>"
},
"name": "check_availability"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| guests | Yes | Total number of guests staying at the property. | |
| unit_id | Yes | Unique property unit identifier (`unit_id` from `search_properties` or PMS unit ID). | |
| check_in | Yes | Arrival date in ISO 8601 format (YYYY-MM-DD). | |
| check_out | Yes | Departure date in ISO 8601 format (YYYY-MM-DD). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |