Voya Homes public vacation-home search

Read-only Voya Homes search for date-bound availability, prices and property details.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
68%
Naming quality
100%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,141Tokens (tool definitions)
~2.4 KBTypical response size
Moderate attention impact (0.89% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "voya-homes": {
      "url": "https://voyahomes.com/mcp"
    }
  }
}

Remote endpoints

https://voyahomes.com/mcpstreamable-http

What it can do

Tool inventory

Tools (4)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢list_destinations

Read-only. Lists destinations currently exposed by Voya Homes. It never creates a booking, intention, payment, hold or customer record.

Input Schema

{
  "type": "object",
  "additionalProperties": false
}

Output Schema

{
  "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.

Input Schema

{
  "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
}

Output Schema

{
  "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.

Input Schema

{
  "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
}

Output Schema

{
  "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.

Input Schema

{
  "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
}

Output Schema

{
  "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"
  ]
}

Recommended Prompts

search_research
Search for information about [topic] using Voya Homes public vacation-home search
Expected tools: search_homes
retrieve_data
Get details about [item] from Voya Homes public vacation-home search
Expected tools: get_home
find_specific
Find [specific item] using Voya Homes public vacation-home search
Expected tools: search_homes
list_items
List all [items] available in Voya Homes public vacation-home search
Expected tools: list_destinations
fetch_info
Fetch [information type] using Voya Homes public vacation-home search
Expected tools: get_home

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded4 tools
verifiedversion not recorded4 tools