Check stay dates and pricing
get_stay_quoteCheck dates and total pricing on a published property's public host website. Send its property id, arrival/departure (YYYY-MM-DD) and guests; no guest contact or card details. Availability may be unknown even when a price is returned. Optional startingNightlyPrice is an advertised starting nightly rate, separate from price.total; never multiply it into a stay total or infer dates, party, fees or tax coverage. partyBasis:all_adults means every occupant was priced as an adult; disclose that assumption, since no reader prices child ages yet (children/childAges are retained only). Optional terms carry only the cancellation/payment details the host booking system returned, with provenance; an absent terms object or field is unknown, never free cancellation or no deposit, so tell the traveler to confirm terms with the host. Inspect reason, price.completeness, actual currency, checkedAt and expiresAt. Optional execution:browser requests the experimental selected-home browser agent on reviewed Stays sites and may take up to two minutes including source discovery; omit it for fast automatic execution. Search never starts this agent. Recent matching quotes may be reused until expiry; a pending search check is joined rather than repeated. The host may create an expiring anonymous price draft. A quote never reserves or confirms a booking; held is always false. Unsupported/protected sites return unknown. No host integration or credentials are required. After displaying cards, default to 1–3 short sentences, usually under 60 words unless the traveler requests a detailed comparison: explain a helpful fit or next choice, and include only a material price/availability caveat or a necessary question. Do not repeat result counts, card facts or the home list unless the traveler asks for a textual comparison. Do not narrate tools called or not called, backend mechanics, or your process. Keep operational checks internal; disclose material uncertainty and pricing assumptions plainly when they affect the traveler’s decision.
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": {
"id": "<id>",
"arrival": "<arrival>",
"departure": "<departure>",
"guests": "<guests>"
},
"name": "get_stay_quote"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| guests | Yes | ||
| arrival | Yes | ||
| children | No | How many of guests are children (under 18). guests stays total occupancy, so it must exceed children; capacity counts everyone. No reader prices child ages yet. | |
| currency | No | Preferred ISO 4217 currency, e.g. USD, EUR or NOK. Rough nightly estimates use approximate conversions (USD by default) when a fresh rate is supported; otherwise retain the host currency. Dated quotes depend on host support: always inspect the returned currency. May be supplied without dates for browsing. | |
| childAges | No | Each child's age at check-out, one entry per child (exactly children entries). Retained and disclosed; the host confirms child rates. | |
| departure | Yes | ||
| execution | No | Selected-home execution only. Default auto prefers the fast supported reader. browser requests the slower experimental quote-only agent on reviewed Stays sites; unsupported sites return unknown. Search never starts this agent. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| held | Yes | ||
| price | Yes | ||
| terms | No | ||
| guests | Yes | ||
| nights | Yes | ||
| reason | Yes | ||
| arrival | Yes | ||
| checkedAt | Yes | ||
| departure | Yes | ||
| expiresAt | Yes | ||
| sourceUrl | Yes | ||
| bookingUrl | Yes | ||
| partyBasis | No | ||
| propertyId | Yes | ||
| availability | Yes | ||
| minimumNights | Yes | ||
| roomSelection | No | ||
| startingNightlyPrice | No |