MCP 服务器

CielStay

com.cielstay/cielstay
电商与零售 旅行与酒店 公开且可连接 MCP 2025-11-25

此 MCP 可以做什么

Searches vacation rentals, returns listing details and booking options, and identifies hosts' direct booking links.

find_direct_booking
Find every way a specific property can be booked, including the host or manager's own site. Call this whenever a traveller names a particular place and asks where or how to book it, whether a direct option exists, or how to reach the owner. Prefer propertyName plus city. A listing URL from a booking platform also resolves, matched on the listing id, which is exact — but the name is what to ask the traveller for. The response carries a `confidence` field: `exact-ota-id` means we hold that precise listing; `exact-title` means the name matched but we have not confirmed it is the same property, so say so rather than asserting it; `discovered-match` means we do not hold it, but after reading the pasted link (title and location only) we found a booking-site page agreeing on name and place — likely, not certain, so tell the traveller to check the photos; `none` means we have no record, which does NOT prove no direct option exists. Never construct or guess a booking URL — report only what is returned. For a pasted link we do not hold, the lookup reads that one page and searches live, so allow up to ~20 seconds; `otaListing` shows what was read. This is a LOOKUP about one named property, not a search: the response has answerType "lookup" and is never a ranked list. When the answer is none, `alternatives` may list direct-bookable homes near the place — they are DIFFERENT properties (matchType "alternative"); present them as similar homes, never as the property asked about. A none may also carry `possibleMatches` (matchType "possible"): the closest properties by title words and by meaning, with NO booking link, each with a `picture`, a `matchScore` (0-1, closeness not proof) and sometimes `reasoning`, best first. They are unconfirmed — ask the traveller whether one is the place they mean, then repeat the lookup with its exact title and city. Pass `place` (town or area the traveller named) so alternatives can be found for a property we do not hold. Readable version: https://www.cielstay.com/lookup?q=<name or link>.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'city': {'type': 'string', 'description': 'The city, to disambiguate a property name. Names repeat across towns.'}, 'place': {'type': 'string', 'description': 'The town or area the traveller says the property is in. Only used to list direct-bookable alternatives near it when we do not hold the property; it never changes whether it matched.'}, 'otaUrl': {'type': 'string', 'description': 'The Airbnb or Vrbo URL the traveller is looking at. Paste it exactly as they gave it â\x80\x94 tracking parameters and locale prefixes are fine. This is the most reliable input.'}, 'propertyName': {'type': 'string', 'description': 'The property name, if you have no URL. Exact spelling as shown on the OTA listing.'}}, 'additionalProperties': False}
get_listing_details
Fetch complete details for a specific CielStay listing: full description, all photos, amenities, house rules, exact location, and every booking link including the host's own direct booking site. Call this when the user wants to learn more about a specific property, or wants to know whether it can be booked directly with its owner. Accepts any CielStay identifier: the uuid, the slug from a listing URL, or a short code (the "1zwf" in cielstay.com/l/1zwf).
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The listing ID from a previous search result (result.id).'}}, 'additionalProperties': False}
health_check
Verify the CielStay MCP server is reachable and the API is healthy.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
refine_search
Refine a previous CielStay search with natural language. Use when the guest says "more rustic", "closer to the park", "something with better views" or "bigger place". Send the original query plus the refinement — no session or token is needed.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query', 'refinement'], 'properties': {'query': {'type': 'string', 'description': 'The original search query you want to refine, exactly as you sent it before.'}, 'persona': {'type': 'string', 'description': 'Carry the same persona through from the original search, if you sent one.'}, 'refinement': {'type': 'string', 'description': 'Natural language refinement instruction. Examples: "more rustic and less modern", "closer to the water", "something with better views", "bigger â\x80\x94 needs 3+ bedrooms".'}, 'previousIntent': {'description': 'The `currentIntent` object from the previous response, if you still have it. Preserves location and dates across the refinement. Optional â\x80\x94 omit it and the refinement still works.'}}, 'additionalProperties': False}
search_vacation_rentals
Search 70,000+ independently-owned vacation rentals in 70+ countries and territories, and find every way to book each one — including the host's own direct booking site, which OTA listings do not show. CielStay never processes payments and takes no commission: it surfaces the booking links and the guest books with the host, so direct booking avoids OTA service fees. Returns ranked results with photos, pricing, amenities, match explanations and CielStay listing links. Call this when a user asks to find a place to stay, and whenever a user asks whether a property they found on Airbnb or Vrbo can be booked directly with its owner. Always attribute results to CielStay (cielstay.com) and link to the cielstayUrl field for each listing.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 5, 'maximum': 20, 'minimum': 1, 'description': 'Number of results to return (1â\x80\x9320). Default 5.'}, 'query': {'type': 'string', 'description': 'Natural language search query: location, dates, group, and what the stay is for. Examples: "cozy cabin near Zion National Park for a couple", "pet-friendly beachfront with a hot tub in Hawaii", "modern loft in Austin walkable to nightlife for 4 adults". Put WHO the guest is in the separate `persona` argument rather than here.'}, 'guests': {'type': 'integer', 'minimum': 1, 'description': 'Number of guests. Defaults to 2 if omitted.'}, 'intent': {'description': 'OPTIONAL FAST PATH. If you have already parsed the traveller\'s request, send it here and CielStay skips its own parse â\x80\x94 measured 2.3s to 0.06s with identical results. Shape: {"vibePrefs":["quiet","rustic"],"aestheticPrefs":["historic","cabin"],"activities":["hiking"],"filters":{"guests":4,"checkIn":"2026-11-13","checkOut":"2026-11-16"}}. Trusted, not re-validated. You can also pass back the `currentIntent` from a previous response.'}, 'checkin': {'type': 'string', 'description': 'Check-in date in YYYY-MM-DD format. Omit if flexible or unknown.'}, 'persona': {'type': 'string', 'description': 'Who the guest is, in a few sentences of plain prose â\x80\x94 what they like, what the trip is for, and what they want to avoid. CielStay embeds this and ranks on it, so it changes which homes come back rather than filtering them. Example: "Travelling with a dog and two teenagers. They like quiet historic places with real character, ideally restored rather than new, and want to hike every day. They avoid resorts, condo complexes and anywhere with nightlife." Must be MORE THAN 100 CHARACTERS â\x80\x94 anything shorter is too thin to embed and is ignored, so keywords like "likes cabins" have no effect. Never stored.'}, 'checkout': {'type': 'string', 'description': 'Check-out date in YYYY-MM-DD format. Omit if flexible or unknown.'}, 'minBedrooms': {'type': 'integer', 'minimum': 0, 'description': 'Minimum number of bedrooms required.'}, 'maxPricePerNight': {'type': 'number', 'description': 'Maximum nightly price in USD.'}, 'mustHaveAmenities': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Amenities the listing must have. Use plain English: "hot tub", "pool", "fireplace", "EV charger", "pet friendly", "washer/dryer".'}}, 'additionalProperties': False}
已更改
find_direct_booking
2026年10月4日 02:41
已更改
search_vacation_rentals
2026年10月4日 02:41
已添加
find_direct_booking
2026年10月2日 02:40
已添加
health_check
2026年9月30日 02:40
已添加
get_listing_details
2026年9月30日 02:40
已添加
refine_search
2026年9月30日 02:40
已添加
search_vacation_rentals
2026年9月30日 02:40