Arcasos Rentals MCP Server

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.

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.

Get the public status of a booking request draft created by request_booking, using its draft_id and status_token. Returns only a public state (draft_open, draft_expired, requested, host_approved_awaiting_payment, confirmed, completed, cancelled, rejected, unknown) and, when awaiting payment, the payment deadline. No personal data.

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.

Create a booking REQUEST DRAFT for a rental on behalf of a person, and get a claim link for that person. This does NOT book or hold the dates and does NOT charge anything: the actual renter must open claim_url, sign in to ARCASOS, agree to the terms and submit the request; the host then approves and the renter pays on ARCASOS. The agent is never the payer. Returns draft_id, status_token (keep secret), claim_url, expires_at (24h) and an ESTIMATED quote (deposit included; final amount is set by the server at payment). Dates must be YYYY-MM-DD; most rentals accept weekly units only (7/14/21... days).