CielStay

Sends a traveller's first message to a home's host through CielStay: questions, dates and party, a request to book, or a monthly or long-stay inquiry. Free. guestEmail must be the traveller's own address: CielStay emails it a confirmation link, and the message goes on only after the traveller opens it and signs in or creates a free account. Available for homes that carry messageHostUrl: hostReach in the reply is "host" (the host manages the home on CielStay) or "possible_contact" (a contact published on the operator's own site is told a guest asked; they may not answer). For any other home it is refused with hostReach "none", and bookUrl is the way to the host. CielStay never takes bookings or payments; the host replies with their terms. Takes the id from search_vacation_rentals or get_listing_details. messageHostUrl is the same form for the traveller to send.

Look up one named property and every way it can be booked, including the host's or manager's own site. Takes propertyName plus city (most reliable), or a listing URL from a booking platform, which is matched on its listing id. The response has answerType "lookup": a lookup about one property, not a ranked search. `confidence` describes the match: `exact-ota-id`, CielStay holds that exact listing; `exact-title`, the name matched but it is not confirmed to be the same property; `discovered-match`, CielStay does not hold it, but after reading the pasted link (title and location only) it found a booking-site page that agrees on name and place, which is likely but not certain; `none`, CielStay has no record, which does not show that no direct option exists. Every booking URL in the response is one CielStay holds or found; none is constructed. For a pasted link CielStay does not hold, the lookup reads that one page and searches live (up to about 20 seconds); `otaListing` shows what was read. When the answer is none, `alternatives` lists different, direct-bookable homes near `place` (matchType "alternative"), and `possibleMatches` lists the closest unconfirmed candidates by name and meaning (matchType "possible", no booking link, `matchScore` 0-1 is closeness, not proof). Readable version: https://www.cielstay.com/lookup?q=<name or link>.

Full details for one CielStay listing: description, photos, amenities, house rules, location, and every booking link CielStay holds, including the host's own booking site. With checkIn and checkOut, the response also carries liveQuote where the host's booking engine supports it: the total on the host's own site for those dates (room, fees and taxes), read live. Each live quote is a real request to the host's booking engine. Accepts the listing id, the slug from a listing URL, or a short code (the "1zwf" in cielstay.com/l/1zwf).

Every unit at one multi-unit property: a hotel, glamping site or building whose units share a booking site and a location. Search results carry readyToBook.property.id when a home is one of several such units. Returns the property (name only where the operator's own unit titles share it), and each unit with its label, bedrooms, guests, CielStay page and readyToBook. With checkIn and checkOut, each unit's readyToBook also carries availability and the total on the host's site for those dates (up to 30 units).

Check that the CielStay MCP server is reachable and the API is healthy.

Refine a previous CielStay search in natural language, such as "more rustic", "closer to the park", "better views", "bigger place" or "with ping pong". For any follow-up that adds to or changes an earlier search in the conversation; keeps that search's place and dates. Takes the original query plus the refinement, and the earlier `currentIntent` as previousIntent; no session or token is needed.

Search about 90,000 vacation rentals and longer-stay homes from independent hosts and property managers in 70+ countries and territories. Each result lists the ways it can be booked that CielStay holds: the host's own booking site or engine (directUrl / referenceUrl), bookUrl (the same booking page opened through CielStay, which lets CielStay count the referral) and a CielStay listing page (cielstayUrl). CielStay does not take bookings or payments. Results are ranked by fit to the request, with a photo, a price (the average per night of a 3-night stay including the host's fees, before taxes; or per month for monthly homes) and a match score. Suited to finding a place to stay, or to checking whether a home seen on another site can be booked with its host. Follow-ups to a search ("with ping pong", "cheaper", "bigger") are handled by refine_search, or here with previousIntent; without either, a follow-up that names no place is searched everywhere. Each result carries bookUrl (the host's booking page) and, where someone can receive a message about the home, messageHostUrl (its message form); for those, contact_host sends the traveller's first message, free, for questions or monthly stays.