What is Tripadvisor Mcp Server

Tripadvisor-mcp-server is a server that provides access to TripAdvisor data, enabling users to plan vacations by finding attractions, restaurants, and hotels.

Use cases

Use cases include helping users find vacation destinations, planning itineraries, discovering local attractions and dining options, and integrating TripAdvisor data into travel-related applications.

How to use

To use the Tripadvisor-mcp-server, set up the environment by installing Python 3.10 or higher, uv package, and obtaining a TripAdvisor API key. After cloning the repository, create a virtual environment, install dependencies, set the API key as an environment variable, and run the server using the provided commands.

Key features

Key features include searching for locations by name and category, obtaining detailed information about specific locations, finding nearby attractions, viewing photos and reviews, and an interactive vacation planning prompt.

Where to use

Tripadvisor-mcp-server can be used in travel planning applications, tourism websites, and any platform that requires access to TripAdvisor data for vacation planning.

TripAdvisor Vacation Planner MCP Server

This MCP server provides access to TripAdvisor data for planning vacations, finding attractions, restaurants, and hotels.

Features

• Search for locations by name and category
• Get detailed information about specific locations
• Find nearby attractions, restaurants, and hotels
• View photos and reviews
• Interactive vacation planning prompt

Setup Instructions

Prerequisites

• Python 3.10 or higher
• uv - Fast Python package installer and resolver
• TripAdvisor API key (get one from TripAdvisor Developer Portal)
• Claude Desktop
• Google Maps MCP Server (https://github.com/modelcontextprotocol/servers/tree/main/src/google-maps)

Installation with uv

1. Clone this repository
2. Create and activate a virtual environment:

   uv venv
   # On Windows
   .venv\Scripts\activate
   # On macOS/Linux
   source .venv/bin/activate
   

3. Install the required dependencies:

   uv add "mcp[cli]"
   

Running the Server

You can run the server directly with:

# Set your API key as an environment variable
export TRIPADVISOR_API_KEY=your_api_key_here  # Linux/macOS
set TRIPADVISOR_API_KEY=your_api_key_here     # Windows Command Prompt
$env:TRIPADVISOR_API_KEY="your_api_key_here"  # Windows PowerShell

# Run the server
mcp run server.py

Setting up for Claude Desktop

Set up the MCP Server with:

mcp install server.py

Configuring Claude Desktop

1. Open Claude Desktop
2. Go to Settings > MCP Servers
3. Add a new server with the following configuration:

   {
     "tripadvisor": {
       "command": "uv",
       "args": [
         "run",
         "--with",
         "mcp[cli]",
         "mcp",
         "run",
         "PATH_TO_YOUR_PROJECT\\server.py"
       ],
       "env": {
         "TRIPADVISOR_API_KEY": "YOUR_API_KEY_HERE"
       }
     }
   }
   

4. Replace PATH_TO_YOUR_PROJECT with the absolute path to your project directory
5. Replace YOUR_API_KEY_HERE with your actual TripAdvisor API key

Using the Vacation Planner

1. Start a new conversation in Claude
2. Just prompt anything with “Vacation Planner” prompt
3. Follow the interactive prompts to plan your perfect vacation!

API Endpoints Used

• Location Search: Find locations by name and category
• Location Details: Get comprehensive information about a location
• Location Photos: View photos of a location
• Location Reviews: Read reviews of a location
• Nearby Search: Find locations near a specific point

Troubleshooting

• If you see 401 Unauthorized errors, check that your API key is correct and that your IP is whitelisted in the TripAdvisor Developer Portal
• For issues with Claude Desktop integration, verify your configuration settings and ensure the path to server.py is correct
• If Claude is failing to complete, then there is a high chance that you are using too many input tokens. get_location_details_tool is usually the culprit.