# Expedia Vrbo MCP

> Expedia Vrbo MCP connects your AI agent directly to global vacation rental listings. Search entire homes across multiple destinations; compare nightly rates and amenities; check availability calendars; and manage bookings without leaving your chat window.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** vacation-rental, entire-home, availability-calendar, travel-booking, property-search, nightly-rates

## Description

Planning a trip used to mean opening ten tabs: one for search, one for photos, another for policies, and then manually cross-referencing dates and prices. This MCP handles all of that complexity in a single conversation. You tell your agent what you need—say, a multi-bedroom house near the beach with a private pool—and it finds listings across Vrbo's global inventory. It doesn't just show results; it gives you the details: amenity lists, high-res photos, and even guest reviews to help you compare properties side-by-side. You can check availability for entire months or reserve the stay directly. Because Vinkius hosts this MCP in its catalog, your agent keeps all this travel data organized, letting you plan complex trips without ever having to click through dozens of websites.

## Tools

### book_rental
Creates a final itinerary by booking the property, requiring payment details and guest information.

### cancel_itinerary
Cancels an existing reservation; it checks the policy to determine any applicable refund amount.

### check_rental_policies
Retrieves the specific house rules and restrictions for a property before you commit to booking.

### get_itinerary
Looks up all the details of an already confirmed reservation using its unique itinerary ID.

### get_rental_calendar
Displays the availability schedule and pricing variations for a property across selected date ranges.

### get_rental_details
Pulls the full written description, house rules, and location coordinates for one specific rental listing.

### get_rental_images
Fetches a gallery of high-resolution photos for visual comparison before you make a booking decision.

### get_unit_amenities
Returns a detailed list of every amenity, like pool type or parking availability, for the unit.

### search_rental_regions
Finds valid destination IDs and coordinates when you only provide a city or neighborhood name.

### search_rentals
Acts as the primary search tool, returning initial results with pricing, amenities, and availability for multiple properties.

### get_rental_reviews
Gathers structured guest reviews and overall ratings to help evaluate the quality based on past traveler experiences.

## Prompt Examples

**Prompt:** 
```
Find a beachfront vacation home in Cancún for 8 guests, March 20-27.
```

**Response:** 
```
I found 31 beachfront properties in Cancún for your dates. Top match: 'Villa Caribe' (ID: VR-82914) — 4 bedrooms, private pool, ocean view, $285/night ($1,995 total). Also strong: 'Casa del Sol' (ID: VR-19283) — 5 bedrooms, rooftop terrace, steps from the beach, $340/night ($2,380 total). Both have excellent guest ratings above 4.7. Want me to check the availability calendar or pull photos for either?
```

**Prompt:** 
```
Show me the availability calendar for Villa Caribe through all of March.
```

**Response:** 
```
Here's the March calendar for Villa Caribe (VR-82914): **Mar 1-8** — Available, $265/night. **Mar 9-14** — Booked. **Mar 15-19** — Available, $275/night. **Mar 20-27** — Available, $285/night (your requested dates). **Mar 28-31** — Available, $260/night. Minimum stay is 3 nights. Your Mar 20-27 window is still open. Would you like to proceed with booking?
```

**Prompt:** 
```
Pull the photos for Villa Caribe so I can see what it looks like.
```

**Response:** 
```
I've retrieved 24 photos for Villa Caribe (VR-82914). The gallery includes: exterior with infinity pool overlooking the Caribbean (main photo), 4 bedroom shots (all with ocean-facing windows), the open-plan kitchen with marble countertops, a rooftop lounge area, and 3 beach access views. The property looks exactly as described — modern construction with direct beach access. Want me to compare this visually against Casa del Sol as well?
```

## Capabilities

### Find properties by criteria
Search for vacation homes across Expedia and Vrbo inventory using destination names, dates, and guest counts.

### Review property details and amenities
Pull specific information—like the full list of unit amenities or detailed room descriptions—for any single listing.

### Check availability and pricing trends
Determine which dates a property is free and what the nightly rates are across weeks or months.

### View visual evidence and reviews
Access high-resolution photo galleries and read structured guest ratings for comparison shopping.

### Manage reservations
Programmatically reserve a property or cancel an existing itinerary.

## Use Cases

### Planning a large family reunion.
The user needs a 5-bedroom house for 12 people with specific amenities, like a dedicated game room and pool. The agent runs `search_rentals` to narrow down options, then uses `get_unit_amenities` on the top three results to confirm they meet all amenity requirements.

### A property investor checking market rates.
The user wants to know how much a specific house usually costs in peak season versus off-season. They use `search_rental_regions` first, then run `get_rental_calendar` on the target ID to map out seasonal pricing trends.

### A group organizing an event with strict rules.
Before booking a venue, the user asks about house restrictions. The agent uses `check_rental_policies`, and if there's a conflict (e.g., no catering allowed), they pivot to finding alternatives via `search_rentals`.

### A traveler needing quick booking confirmation.
The user finds the perfect property, but needs to confirm it hasn't been booked since their last check. They ask for an updated availability status using `get_rental_calendar`, followed immediately by `book_rental`.

## Benefits

- You don't have to manually cross-reference amenities. Use `get_unit_amenities` to verify specific features like accessibility or pet-friendliness immediately after searching.
- Stop guessing about pricing. Run `get_rental_calendar` first so you can see the actual nightly rate fluctuations and availability across entire months before committing.
- Get a full picture of quality by running `get_rental_reviews`. This gives you guest scores on cleanliness, location, or communication, which is way better than just looking at star ratings.
- When comparing listings, don't rely only on photos. Use `get_rental_details` to pull the official property description and house rules for a complete picture of what's included.
- The best part is managing logistics: you can use `book_rental` or `cancel_itinerary` directly from your agent without needing to switch to an external booking portal.

## How It Works

The bottom line is that your AI client transforms into a dedicated vacation rental concierge, doing all the tedious searching and data gathering for you.

1. Sign up at the Expedia Group Developer Hub and generate your API Key and Shared Secret.
2. Enter those credentials into this MCP within Vinkius. Your AI client now has access to Vrbo's global inventory.
3. Tell your agent what you need—for example, 'Find a pet-friendly house in Maui for 6 people next summer.' — and the tool does the rest.

## Frequently Asked Questions

**Can the Expedia Vrbo MCP help me compare prices for different dates using get_rental_calendar?**
Yes. You run `get_rental_calendar` to see the full rate variations. It shows you if rates spike during holidays or dip in the shoulder season, letting you plan around cost.

**How do I check if a property allows pets using get_unit_amenities?**
Use `get_unit_amenities`. It returns structured data that includes 'pet-friendliness' status and details, letting you confirm it before looking at photos or policies.

**What is the difference between search_rentals and get_rental_details?**
`search_rentals` gives you a list of options with basic rates. `get_rental_details` provides deep, specific text information—the full history, house rules, and description—for one property already selected.

**Can I manage my booking using the book_rental tool?**
Yes. If you've confirmed the details, `book_rental` handles creating the reservation programmatically. Just make sure you provide all payment and guest info first.

**When I use `get_rental_reviews`, what specific data points do I receive besides just a star rating?**
You get much more than an overall score. The tool returns structured feedback, including individual scores and review text for key categories like cleanliness, communication, location, and value from actual guests.

**Before I try to reserve a stay using `book_rental`, how do I check all the house restrictions?**
You run `check_rental_policies`. This tool pulls specific property rules and obligations. It's crucial for flagging potential issues, like minimum stays or restricted activities, before you commit to booking.

**If I don't have a proper destination ID, how do I start my search using `search_rental_regions`?**
This tool resolves common location names into valid region IDs and coordinates. You input the name (like 'Cancún') and get the necessary technical IDs required for running all subsequent searches.

**Does `get_rental_images` provide enough detail to compare properties visually?**
Yes, it retrieves not only URLs but also captions, dimensions, and category tags for every photo. This lets you programmatically analyze the property's visual assets for a detailed comparison.

**Can my AI agent find entire homes for a group trip with specific amenities like a pool or hot tub?**
Yes. Use the `search_rentals` tool with your destination, dates, guest count, and amenity preferences. The agent will filter results to show only properties matching your criteria, including pricing per night and total stay cost. You can then drill into any listing with `get_rental_details` for the full amenity breakdown.

**How can I check which dates a property is available before booking?**
The `get_rental_calendar` tool pulls the full availability calendar for any property. It shows open dates, blocked periods, nightly rates per date, and minimum stay requirements. Your agent can scan multiple weeks or months to identify the optimal booking window based on your budget and schedule.

**Can I see photos of a rental property before making a decision?**
Yes. The `get_rental_images` tool returns the complete photo gallery for any property, including high-resolution images of bedrooms, living areas, kitchen, exterior, and amenities. Your agent can provide direct image URLs that you can preview in your browser or include in a planning document.