MCP-Server

arcasos-rentals

com.arcasos/arcasos-rentals
Reisen & Hospitality Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

Searches Korean short-term rentals using natural-language or structured filters and provides rental details, amenities, pricing estimates, and availability information.

get_rental_details
Get detailed information for a specific rental by ID or slug. Returns full Schema.org Accommodation including pricing, amenities, location, photos. Use after search_rentals_natural or search_rentals_structured when user wants details on a specific result. Only returns publicly-eligible rentals (approved + available + bookable). Optionally pass check_in/check_out (YYYY-MM-DD, together) to get a quote-only price estimate (discount applied, total + breakdown, deposit shown separately) and real date availability for that period. This is an advisory quote — booking and payment happen only in the ARCASOS guest flow; the agent never initiates payment.
Eingabeschema
{'type': 'object', 'required': ['rental_id'], 'properties': {'check_in': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Optional move-in date (YYYY-MM-DD). Must be provided together with check_out. Enables period quote + date availability. Future dates only.'}, 'check_out': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Optional move-out date (YYYY-MM-DD). Must be provided together with check_in, and be after check_in. The check_out day is not occupied (next check-in allowed).'}, 'rental_id': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Rental UUID or slug from search results. Both formats supported.'}}, 'additionalProperties': False}
search_rentals_natural
PREFERRED tool for Korean short-term rental queries containing any descriptive language. ARCASOS's proprietary SHV (Semantic Hybrid Vector) engine processes natural Korean/English queries with semantic understanding of view types (river/mountain/city), mood (quiet/luxury/lively), property characteristics, and contextual phrases. Pass the user's natural language query AS-IS — do NOT extract slots. Returns semantically pre-ranked results in Schema.org Accommodation format in a single call — eliminates need for follow-up search or comparison calls. Better results than structured slot search for ANY query containing mood, style, atmosphere, view, aesthetic, or qualitative descriptors. Use this to minimize token usage and latency.
Eingabeschema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': "User's natural language query in Korean or English. Pass as-is. Examples: 'ê°\x95ë\x82¨ ë°\x98ë\xa0¤ë\x8f\x99물 ê°\x80ë\x8a¥í\x95\x9c í\x95\x9cê°\x95ë·° í\x8e\x9cí\x8a¸í\x95\x98ì\x9a°ì\x8a¤ 3주', 'quiet luxury rental near Han river for 2 weeks'"}}, 'additionalProperties': False}
search_rentals_structured
Use ONLY when the query consists entirely of explicit numeric/categorical constraints with NO descriptive language (no mood, view, atmosphere, or aesthetic words). Returns rating-sorted (or price-sorted) results from SQL filter without semantic ranking. For ANY query containing descriptors like 'cozy', 'quiet', 'luxury', 'river view', 'modern', use search_rentals_natural instead — it produces better results in a single call. Returns Schema.org Accommodation format.
Eingabeschema
{'type': 'object', 'properties': {'sort': {'enum': ['price_asc', 'price_desc', 'rating_desc'], 'type': 'string', 'description': 'Sort order (default: rating_desc)'}, 'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 10)'}, 'bedrooms': {'type': 'integer', 'maximum': 20, 'minimum': 0, 'description': "Exact number of bedrooms (not a minimum). Matches search_rentals_natural semantics â\x80\x94 '2룸' returns exactly 2-bedroom rentals."}, 'location': {'type': 'string', 'description': "Location name in Korean (e.g., 'ê°\x95ë\x82¨', 'ê°\x95ë\x82¨ì\x97\xad', 'í\x99\x8dë\x8c\x80')"}, 'amenities': {'type': 'array', 'items': {'type': 'string'}, 'description': "Required amenities (e.g., ['wifi', 'parking'])"}, 'bathrooms': {'type': 'integer', 'maximum': 20, 'minimum': 0, 'description': 'Minimum bathrooms required'}, 'mood_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': "Mood tags (e.g., ['luxury', 'cozy'])"}, 'max_guests': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Minimum guest capacity required'}, 'view_types': {'type': 'array', 'items': {'type': 'string'}, 'description': "View types (e.g., ['river', 'city', 'mountain'])"}, 'pet_allowed': {'type': 'boolean', 'description': 'Pet-friendly rentals only'}, 'kid_friendly': {'type': 'boolean', 'description': 'Kid-friendly rentals only'}, 'property_type': {'type': 'string', 'description': "Property type (e.g., 'ì\x95\x84í\x8c\x8cí\x8a¸', 'í\x8e\x9cí\x8a¸í\x95\x98ì\x9a°ì\x8a¤', '주í\x83\x9d')"}, 'is_private_entire': {'type': 'boolean', 'description': 'Entire private space (not shared)'}, 'max_price_per_week': {'type': 'number', 'minimum': 0, 'description': 'Maximum price per week in KRW'}, 'min_price_per_week': {'type': 'number', 'minimum': 0, 'description': 'Minimum price per week in KRW'}}, 'additionalProperties': False}
Hinzugefügt
get_rental_details
17. September 2026 12:33
Hinzugefügt
search_rentals_structured
17. September 2026 12:33
Hinzugefügt
search_rentals_natural
17. September 2026 12:33