MCP 服务器

Voya Homes public vacation-home search

com.voyahomes/voya-homes
旅行与酒店 公开且可连接 MCP 2026-07-28

此 MCP 可以做什么

Searches vacation homes by destination, dates, guests, availability, prices, and property details without completing bookings.

find_homes
Find Voya Homes properties by name and location
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': {'city': {'type': 'string', 'maxLength': 100}, 'page': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'query': {'type': 'string', 'maxLength': 160, 'description': 'Property name, public code, condominium, address or amenity.'}, 'language': {'enum': ['pt-BR', 'en-US', 'es-ES'], 'type': 'string'}, 'pageSize': {'type': 'integer', 'maximum': 24, 'minimum': 1}, 'amenities': {'type': 'array', 'items': {'type': 'string', 'maxLength': 80}, 'maxItems': 10}, 'maxGuests': {'type': 'integer', 'maximum': 50, 'minimum': 1}, 'minBedrooms': {'type': 'integer', 'maximum': 50, 'minimum': 0}, 'neighborhood': {'type': 'string', 'maxLength': 120}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['query', 'results', 'total', 'page', 'pageSize', 'totalPages', 'retrievedAt', 'discoveryNote'], 'properties': {'page': {'type': 'integer'}, 'query': {'type': 'object'}, 'total': {'type': 'integer'}, 'results': {'type': 'array'}, 'pageSize': {'type': 'integer'}, 'totalPages': {'type': 'integer'}, 'retrievedAt': {'type': 'string'}, 'discoveryNote': {'type': 'string'}}}
get_home
Get Voya Homes property details
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', 'required': ['houseCode'], 'properties': {'adults': {'type': 'integer', 'maximum': 50, 'minimum': 1}, 'checkIn': {'type': 'string', 'format': 'date'}, 'checkOut': {'type': 'string', 'format': 'date'}, 'children': {'type': 'integer', 'maximum': 50, 'minimum': 0}, 'language': {'enum': ['pt-BR', 'en-US', 'es-ES'], 'type': 'string'}, 'houseCode': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Public Voya Homes property code.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['property', 'retrievedAt'], 'properties': {'property': {'type': 'object'}, 'retrievedAt': {'type': 'string'}}}
list_destinations
List Voya Homes 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', 'required': ['destinations', 'retrievedAt'], 'properties': {'retrievedAt': {'type': 'string'}, 'destinations': {'type': 'array'}}}
search_homes
Search Voya Homes availability and prices
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', 'required': ['checkIn', 'checkOut', 'adults'], 'properties': {'city': {'type': 'string', 'maxLength': 100, 'description': 'Destination city. Orlando is currently bookable; other cities appear only when released by the inventory source.'}, 'page': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'adults': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Number of adults.'}, 'checkIn': {'type': 'string', 'format': 'date', 'description': 'Check-in date in YYYY-MM-DD.'}, 'bedrooms': {'type': 'integer', 'maximum': 50, 'minimum': 0}, 'checkOut': {'type': 'string', 'format': 'date', 'description': 'Check-out date in YYYY-MM-DD.'}, 'children': {'type': 'integer', 'maximum': 50, 'minimum': 0, 'description': 'Number of children.'}, 'language': {'enum': ['pt-BR', 'en-US', 'es-ES'], 'type': 'string'}, 'maxPrice': {'type': 'number', 'minimum': 0}, 'minPrice': {'type': 'number', 'minimum': 0}, 'pageSize': {'type': 'integer', 'maximum': 24, 'minimum': 1}, 'amenities': {'type': 'array', 'items': {'type': 'string', 'maxLength': 80}, 'maxItems': 20}, 'categories': {'type': 'array', 'items': {'type': 'string', 'maxLength': 50}, 'maxItems': 10}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['query', 'results', 'total', 'page', 'pageSize', 'totalPages', 'retrievedAt', 'checkoutNote'], 'properties': {'page': {'type': 'integer'}, 'query': {'type': 'object'}, 'total': {'type': 'integer'}, 'results': {'type': 'array'}, 'pageSize': {'type': 'integer'}, 'totalPages': {'type': 'integer'}, 'retrievedAt': {'type': 'string'}, 'checkoutNote': {'type': 'string'}}}
已添加
find_homes
2026年9月21日 02:40
已添加
get_home
2026年9月21日 02:40
已添加
search_homes
2026年9月21日 02:40
已添加
list_destinations
2026年9月21日 02:40