Voya Homes public vacation-home search
Read-only Voya Homes search for date-bound availability, prices and property details.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"voya-homes": {
"url": "https://voyahomes.com/mcp"
}
}
}원격 엔드포인트
https://voyahomes.com/mcpstreamable-http할 수 있는 일
도구 목록
도구 (4)
🟢list_destinations
Read-only. Lists destinations currently exposed by Voya Homes. It never creates a booking, intention, payment, hold or customer record.
입력 스키마
{
"type": "object",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"destinations": {
"type": "array"
},
"retrievedAt": {
"type": "string"
}
},
"required": [
"destinations",
"retrievedAt"
]
}🟢search_homes(checkIn, checkOut, adults, children, city, ...)
Read-only search of vacation homes using destination, dates and guests. Returns current server-side availability, prices and links to continue on the Voya Homes property or checkout page. It never reserves, charges, creates an intention or sends a payment request.
입력 스키마
{
"type": "object",
"properties": {
"checkIn": {
"type": "string",
"format": "date",
"description": "Check-in date in YYYY-MM-DD."
},
"checkOut": {
"type": "string",
"format": "date",
"description": "Check-out date in YYYY-MM-DD."
},
"adults": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "Number of adults."
},
"children": {
"type": "integer",
"minimum": 0,
"maximum": 50,
"description": "Number of children."
},
"city": {
"type": "string",
"maxLength": 100,
"description": "Destination city. Orlando is currently bookable; other cities appear only when released by the inventory source."
},
"categories": {
"type": "array",
"maxItems": 10,
"items": {
"type": "string",
"maxLength": 50
}
},
"bedrooms": {
"type": "integer",
"minimum": 0,
"maximum": 50
},
"minPrice": {
"type": "number",
"minimum": 0
},
"maxPrice": {
"type": "number",
"minimum": 0
},
"amenities": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string",
"maxLength": 80
}
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 24
},
"language": {
"type": "string",
"enum": [
"pt-BR",
"en-US",
"es-ES"
]
}
},
"required": [
"checkIn",
"checkOut",
"adults"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "object"
},
"results": {
"type": "array"
},
"total": {
"type": "integer"
},
"page": {
"type": "integer"
},
"pageSize": {
"type": "integer"
},
"totalPages": {
"type": "integer"
},
"retrievedAt": {
"type": "string"
},
"checkoutNote": {
"type": "string"
}
},
"required": [
"query",
"results",
"total",
"page",
"pageSize",
"totalPages",
"retrievedAt",
"checkoutNote"
]
}🟢get_home(houseCode, checkIn, checkOut, adults, children, ...)
Read-only property details and optional date-bound price. When dates and guests are supplied, returns a server-side availability result plus a direct checkout URL. It never reserves, charges, creates an intention or modifies data.
입력 스키마
{
"type": "object",
"properties": {
"houseCode": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Public Voya Homes property code."
},
"checkIn": {
"type": "string",
"format": "date"
},
"checkOut": {
"type": "string",
"format": "date"
},
"adults": {
"type": "integer",
"minimum": 1,
"maximum": 50
},
"children": {
"type": "integer",
"minimum": 0,
"maximum": 50
},
"language": {
"type": "string",
"enum": [
"pt-BR",
"en-US",
"es-ES"
]
}
},
"required": [
"houseCode"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"property": {
"type": "object"
},
"retrievedAt": {
"type": "string"
}
},
"required": [
"property",
"retrievedAt"
]
}🟢find_homes(query, city, neighborhood, minBedrooms, maxGuests, ...)
Read-only static catalog discovery by property name, public code, condominium, neighborhood, city, bedrooms or amenities. It does not check date availability or return a fixed price; use search_homes after selecting travel dates.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 160,
"description": "Property name, public code, condominium, address or amenity."
},
"city": {
"type": "string",
"maxLength": 100
},
"neighborhood": {
"type": "string",
"maxLength": 120
},
"minBedrooms": {
"type": "integer",
"minimum": 0,
"maximum": 50
},
"maxGuests": {
"type": "integer",
"minimum": 1,
"maximum": 50
},
"amenities": {
"type": "array",
"maxItems": 10,
"items": {
"type": "string",
"maxLength": 80
}
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 24
},
"language": {
"type": "string",
"enum": [
"pt-BR",
"en-US",
"es-ES"
]
}
},
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "object"
},
"results": {
"type": "array"
},
"total": {
"type": "integer"
},
"page": {
"type": "integer"
},
"pageSize": {
"type": "integer"
},
"totalPages": {
"type": "integer"
},
"retrievedAt": {
"type": "string"
},
"discoveryNote": {
"type": "string"
}
},
"required": [
"query",
"results",
"total",
"page",
"pageSize",
"totalPages",
"retrievedAt",
"discoveryNote"
]
}권장 프롬프트
search_homesget_homesearch_homeslist_destinationsget_home커뮤니티
증거