Korean premium short-term rental search: natural language or structured filters (SHV engine).
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
draft_id from request_booking.
status_token from request_booking.
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.
| Argument | Type | Description |
|---|---|---|
| draft_id* | string | draft_id from request_booking. |
| status_token* | string | status_token from request_booking. |
{
"type": "object",
"required": [
"draft_id",
"status_token"
],
"properties": {
"draft_id": {
"type": "string",
"maxLength": 36,
"minLength": 36,
"description": "draft_id from request_booking."
},
"status_token": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "status_token from request_booking."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| 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). |
| rental_id* | string | Rental UUID or slug from search results. Both formats supported. |
{
"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
}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).
| Argument | Type | Description |
|---|---|---|
| guests | integer | Number of guests (default 1). |
| stay_id* | string | Rental ID (UUID) from search/details results. |
| check_in* | string | Move-in date (YYYY-MM-DD). |
| check_out* | string | Move-out date (YYYY-MM-DD), after check_in. |
| 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. |
{
"type": "object",
"required": [
"stay_id",
"check_in",
"check_out"
],
"properties": {
"guests": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Number of guests (default 1)."
},
"stay_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Rental ID (UUID) from search/details results."
},
"check_in": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Move-in date (YYYY-MM-DD)."
},
"check_out": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Move-out date (YYYY-MM-DD), after check_in."
},
"principal_hint": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 80
},
"email": {
"type": "string",
"maxLength": 200
},
"locale": {
"enum": [
"ko",
"en",
"ja",
"zh"
],
"type": "string"
}
},
"description": "Optional prefill hints for the renter's form (not verified, never contacted).",
"additionalProperties": false
},
"message_to_host": {
"type": "string",
"maxLength": 500,
"description": "Optional note shown as a prefill; the renter can edit it before submitting."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | string | User's natural language query in Korean or English. Pass as-is. Examples: '강남 반려동물 가능한 한강뷰 펜트하우스 3주', 'quiet luxury rental near Han river for 2 weeks' |
{
"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: '강남 반려동물 가능한 한강뷰 펜트하우스 3주', 'quiet luxury rental near Han river for 2 weeks'"
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| 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 |
{
"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 — '2룸' returns exactly 2-bedroom rentals."
},
"location": {
"type": "string",
"description": "Location name in Korean (e.g., '강남', '강남역', '홍대')"
},
"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., '아파트', '펜트하우스', '주택')"
},
"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
}