Voya Homes public vacation-home search
Read-only Voya Homes search for date-bound availability, prices and property details.
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `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社群
證據