com.arcasos/arcasos-rentals

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Korean premium short-term rental search: natural language or structured filters (SHV engine).

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "arcasos-rentals": {
      "url": "https://mcp.arcasos.com",
      "transport": "streamable-http"
    }
  }
}

Measured tools (5)

• search_rentals_natural read-only

  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.

  Parameters:

  • query (required) — string — User's natural language query in Korean or English. Pass as-is. Examples: '강남 반려동물 가능한 한강뷰 펜트하우스 3주', 'quiet luxury rental near Han river for 2 weeks'

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• search_rentals_structured read-only

  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.

  Parameters:

  • sort — string — Sort order (default: rating_desc)
  • limit — integer — Max results (default 10)
  • bedrooms — integer — Exact number of bedrooms (not a minimum). Matches search_rentals_natural semantics — '2룸' returns exactly 2-bedroom rentals.
  • location — string — Location name in Korean (e.g., '강남', '강남역', '홍대')
  • amenities — array — Required amenities (e.g., ['wifi', 'parking'])
  • bathrooms — integer — Minimum bathrooms required
  • mood_tags — array — Mood tags (e.g., ['luxury', 'cozy'])
  • max_guests — integer — Minimum guest capacity required
  • view_types — array — View types (e.g., ['river', 'city', 'mountain'])
  • pet_allowed — boolean — Pet-friendly rentals only
  • kid_friendly — boolean — Kid-friendly rentals only
  • property_type — string — Property type (e.g., '아파트', '펜트하우스', '주택')
  • is_private_entire — boolean — Entire private space (not shared)
  • max_price_per_week — number — Maximum price per week in KRW
  • min_price_per_week — number — Minimum price per week in KRW

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_rental_details read-only

  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.

  Parameters:

  • rental_id (required) — string — Rental UUID or slug from search results. Both formats supported.
  • check_in — string — Optional move-in date (YYYY-MM-DD). Must be provided together with check_out. Enables period quote + date availability. Future dates only.
  • check_out — string — 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).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• request_booking

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

  Parameters:

  • stay_id (required) — string — Rental ID (UUID) from search/details results.
  • check_in (required) — string — Move-in date (YYYY-MM-DD).
  • check_out (required) — string — Move-out date (YYYY-MM-DD), after check_in.
  • guests — integer — Number of guests (default 1).
  • principal_hint — object — Optional prefill hints for the renter's form (not verified, never contacted).
  • message_to_host — string — Optional note shown as a prefill; the renter can edit it before submitting.

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_booking_status read-only

  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.

  Parameters:

  • draft_id (required) — string — draft_id from request_booking.
  • status_token (required) — string — status_token from request_booking.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.