# Expedia Hotels MCP

> Expedia Hotels MCP gives your AI client programmatic access to one of the world's largest hotel inventory networks. Search global property availability, compare rates across room types, and pull aggregated guest reviews—all without leaving your chat window. Automate everything from finding a destination region to confirming an entire itinerary.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** hotel-availability, room-rates, travel-booking, guest-reviews, property-search, itinerary-management

## Description

Stop switching between browser tabs just to compare hotel prices. This MCP lets you take control of Expedia's massive database directly through your AI agent. Instead of manually checking multiple sites, your client can search thousands of properties worldwide using only location, dates, and guest counts. You can pull detailed rate plans, comparing everything from cancellation rules to meal inclusions for specific rooms. It also extracts aggregated review scores and recent guest feedback so you make choices based on data, not gut feeling. When you connect this MCP via Vinkius, your AI agent handles the deep search, pulling property details, checking availability, and even managing booking confirmations—all while you focus on the final decision.

## Tools

### book_hotel
Finalizes a reservation by submitting all required guest and payment details to create an actual booking.

### cancel_itinerary
Changes a real reservation status, returning the updated itinerary with cancellation specifics and refund information.

### check_availability
Identifies what room types are free for specific dates at a hotel property.

### check_price_match
Compares the current listed price against a competitor's URL and amount to see if an adjustment is possible.

### get_hotel_details
Retrieves comprehensive information about a property, including amenities, policies, address, and star rating.

### get_hotel_images
Pulls multiple image links for various parts of the hotel (rooms, lobby, pool) to display rich visuals to the user.

### get_itinerary
Retrieves the full status and details of an existing booking using its itinerary ID.

### get_rate_plans
Compares all available pricing options, including standard rates, package deals, and cancellation rules for a property.

### search_hotels
Finds multiple hotels based on destination IDs, dates, number of guests, and desired amenities.

### search_regions
Identifies specific city or neighborhood region IDs which are needed to start a hotel search.

### get_guest_reviews
Extracts individual reviews and ratings, allowing you to assess the property based on real traveler experiences.

### price_check
Validates a rate plan's price against current tax rates and fees right before confirming the booking.

## Prompt Examples

**Prompt:** 
```
Find available 4-star hotels in central Paris for December 15-18, two adults.
```

**Response:** 
```
I found 23 properties matching your criteria in central Paris. The top three are: 'Hôtel Le Marais' (ID: 28491) starting at €189/night with free cancellation, 'Grand Palais Suites' (ID: 74502) at €245/night including breakfast, and 'Opéra Garnier Hotel' (ID: 15893) at €210/night. Would you like me to pull the detailed rate plans for any of these?
```

**Prompt:** 
```
Show me the cancellation policy and rate breakdown for property 28491.
```

**Response:** 
```
Here are the rate plans for Hôtel Le Marais (28491): **Standard Room** — €189/night, free cancellation until Dec 13, total €567 + €42 taxes. **Superior Room** — €229/night, non-refundable, includes daily breakfast, total €687 + €51 taxes. The standard room offers the best flexibility. Want me to check guest reviews before you decide?
```

**Prompt:** 
```
What are the latest guest reviews saying about property 74502?
```

**Response:** 
```
Grand Palais Suites (74502) has a 4.6/5.0 average from 892 reviews. Recent highlights: guests consistently praise the central location (50m from Champs-Élysées) and the included breakfast quality. The most common critique mentions elevator wait times during peak morning hours. Overall sentiment is strongly positive — 94% of recent reviewers recommend the property.
```

## Capabilities

### Discover destinations
You can query destination suggestions to help pinpoint the right region or neighborhood for your trip.

### Search properties by criteria
Find available hotels globally using dates, guest counts, star ratings, and specific amenities.

### Compare pricing options
Get detailed rate plans for a property, comparing non-refundable rates against flexible or package deals.

### Validate current prices
Confirm that the price you saw earlier is still valid and check for any necessary tax adjustments before booking.

### Analyze guest feedback
Pull individual review entries, allowing you to evaluate a property based on specific details like cleanliness or staff quality.

### Manage reservations
Create new bookings with full guest details or modify existing stays by cancelling an itinerary ID.

## Use Cases

### Planning a multi-city corporate trip
A coordinator needs to find three different hotels across three different cities for a team of 10. Instead of running three separate Google searches, they tell their agent, 'Find the best available 4-star rate in these three areas.' The MCP runs `search_regions` first, then uses `search_hotels` and `get_rate_plans` repeatedly to deliver a comparison matrix for all three locations.

### Vetting a wedding venue
A planner needs to book accommodations for 50 guests over four nights. They ask the agent to find properties near 'The Grand Ballroom' and check both `get_guest_reviews` for ambiance, and run `check_availability` across multiple dates to ensure block room capacity.

### Handling a last-minute booking dispute
A client claims their original rate was better. The agent uses the `get_itinerary` tool for context, then runs `check_price_match` by providing the competitor's URL and price to see if Expedia can honor a match.

### Analyzing competitor pricing trends
A revenue manager wants to know how hotel prices shifted last quarter. They use the MCP's capabilities to run historical rate checks, comparing multiple `get_rate_plans` results across different time periods for market analysis.

## Benefits

- The `search_regions` tool lets you define your trip by neighborhood before searching for hotels, eliminating guesswork when picking a destination.
- You don't just see one price; using `get_rate_plans` shows every option—from the cheapest non-refundable deal to the premium package rate. It gives full visibility into payment terms.
- Need confidence in your booking? Run `check_price_match` if you found a better deal elsewhere, or use `price_check` right before hitting 'book' to verify taxes and fees.
- Gathering information is easy: `get_hotel_details` gives the full address and amenities list, while `get_hotel_images` populates your agent’s response with beautiful photo galleries.
- Evaluate risk by running `get_guest_reviews`. This tool pulls specific ratings for staff or location, letting you filter properties based on user consensus.
- Booking is fully automated. You can start the process using `search_hotels`, confirm details via `check_availability`, and finish with `book_hotel`.

## How It Works

The bottom line is that this MCP lets your AI agent run complex, multi-step travel research that normally takes hours of clicking through websites.

1. Sign up at the Expedia Group Developer Hub and generate your API Key and Shared Secret.
2. Enter those credentials into the MCP connection within Vinkius, connecting it to your AI client.
3. Tell your agent what you need—like 'Find a 4-star hotel in downtown Miami for two adults next month.' The agent then executes the necessary search and comparison tools.

## Frequently Asked Questions

**Can Expedia Hotels MCP help me compare rates?**
Yes, it compares all available pricing options using `get_rate_plans`. This tool shows you standard member deals, package prices, and non-refundable options side by side so you can pick the best deal for your needs.

**How do I book a hotel reservation with Expedia Hotels MCP?**
Booking is done through the `book_hotel` tool. However, always remember to first use `check_availability` and confirm the rates using `get_rate_plans` before committing to an actual booking.

**Does Expedia Hotels MCP handle cancellation?**
Yes, you can manage existing reservations using `cancel_itinerary`. This tool returns the updated itinerary status and details any refund amounts based on the original rate plan's policy.

**What if I find a better price somewhere else? Can Expedia Hotels MCP check it?**
You can use `check_price_match`. This tool requires you to provide a competitor’s URL and the lower price, checking if Expedia honors that match for your stay.

**Which tools should I use first when searching for hotels?**
You start by using `search_regions` to define the area you want. Then, you run `search_hotels` with dates and guest counts. This gives you a list of properties to investigate further.