CielStay

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 and messageHost; for those, contact_host sends the traveller's message at once, free: the quickest way to ask about dates, pets or a monthly stay.

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.

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; hostTrust says what CielStay checked about the host and carries the host's own statements (how they take bookings, payment, cancellation). 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).

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: the host's reply goes there. Usually the message is sent at once (status "sent") and the traveller gets a "Sent" email with a link to the conversation; if the address already has a CielStay account, status is "awaiting_guest_confirmation" and the traveller confirms from an email link. Follow `next` in the reply. Available for homes that carry messageHostUrl: hostReach in the reply is "host" (the host manages the home on CielStay) or "possible_contact" (the message is emailed to a contact the host published on their own booking site; 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.

Holds 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.

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).

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>.

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

無需輸入參數。