Expedia Travel Recommendations MCP
An MCP (Model Context Protocol) server for the Expedia Travel Recommendation Service API, supporting both stdio and streamable-http protocols for flexible integration.
Ask AI about Expedia Travel Recommendations MCP
Powered by Claude Β· Grounded in docs
I know everything about Expedia Travel Recommendations MCP. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
π Expedia Travel Recommendations MCP Server
This project provides an MCP (Model Context Protocol) server that exposes Expedia Travel Recommendations (hotels, flights, activities, and cars) via both stdio and streamable-http protocolsβideal for LLM integrations and web-based applications.
β¨ Features
- π MCP server integration for Expedia's travel recommendation APIs
- π¦ Supports both
stdioandstreamable-httpprotocols - π¨ Hotel, βοΈ Flight, πΊοΈ Activity, and π Car rental recommendations
- π API key-based secure access
π Prerequisites
- Python 3.11+
- Expedia API key
β‘ Running the MCP Server
Run with stdio protocol (LLM Integration)
export EXPEDIA_API_KEY="your_api_key_here"
uvx expedia_travel_recommendations_mcp --protocol "stdio"
Run with streamable-http protocol (Web Clients)
export EXPEDIA_API_KEY="your_api_key_here"
uvx expedia_travel_recommendations_mcp --protocol "streamable-http"
Access it at:
http://0.0.0.0:9900/mcp
π³ Running with Docker
Using Docker Compose (Recommended)
docker run \
-p 9900:9900 \
-e EXPEDIA_API_KEY=your_api_key_here \
expediagroup/expedia-travel-recommendations-mcp
Accessible at:
http://0.0.0.0:9900/mcp
βοΈ MCP Client Configuration
Using streamable-http (Recommended)
{
"mcpServers": {
"expedia-recommendation": {
"url": "http://localhost:9900/mcp"
}
}
}
Using stdio
{
"mcpServers": {
"expedia-travel-recommendations": {
"command": "uvx",
"args": [
"expedia_travel_recommendations_mcp",
"--protocol",
"stdio"
],
"env": {
"EXPEDIA_API_KEY": "your_api_key_here"
}
}
}
}
π§ͺ Example Query (Hotel)
{
"query": {
"destination": "Seattle",
"check_in": "2025-05-01",
"check_out": "2025-05-05",
"property_types": ["HOTEL", "RESORT"],
"amenities": ["POOL", "SPA"],
"guest_rating": "WONDERFUL",
"sort_type": "CHEAPEST"
}
}
π API Endpoints
These are exposed when using the
streamable-httpprotocol.
POST /expedia/hotelsβ Hotel recommendationsPOST /expedia/flightsβ Flight recommendationsPOST /expedia/activitiesβ Activity recommendationsPOST /expedia/carsβ Car rental recommendations
π§βπ» Example Clients
See the examples/ folder for client scripts.
1οΈβ£ stdio-based Client
Make sure the virtual env is activated (install.sh must be run first):
source install_env/bin/activate
python examples/mcp_client_stdio.py
2οΈβ£ streamable-http Client
Ensure MCP server is running:
python examples/mcp_client_streamable_http.py
π License
Licensed under the Apache License 2.0.
