Book now: hold dates with the host
book_stayHolds dates for the traveller at a home whose host offers "Book now" on CielStay (bookNow.available in get_listing_details): a Pro host whose calendar CielStay keeps in sync, within the host's limits (nights, lead time, guests, pets). guestEmail must be the traveller's own address: CielStay emails it a confirmation link, and the booking holds the dates for 30 minutes until the traveller confirms. On confirmation the dates are blocked on the host's calendar and the traveller receives the host's payment instructions. The booking and the payment are between the traveller and the host: CielStay is not a party to it and takes no payment. status "awaiting_guest_confirmation" on success; otherwise error explains why (dates taken, over the host's limits, calendar not confirmable just now) and contact_host remains available for a request instead. The reply's next describes what the traveller receives.
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": {
"listingId": "<listingId>",
"guestEmail": "<guestEmail>",
"checkIn": "<checkIn>",
"checkOut": "<checkOut>"
},
"name": "book_stay"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | The traveller's name, as the host will see it | |
| pets | No | Number of pets | |
| guests | No | Number of guests | |
| checkIn | Yes | Arrival date, YYYY-MM-DD | |
| message | No | A note to the host from the traveller (arrival time, who is coming) | |
| checkOut | Yes | Departure date, YYYY-MM-DD | |
| listingId | Yes | The home's CielStay id (or slug) | |
| guestEmail | Yes | The traveller's own email address: the confirmation link and the host's payment instructions go there |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| next | No | ||
| error | No | ||
| total | No | ||
| status | No | ||
| message | No | ||
| success | No | ||
| expiresAt | No |