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

Clone this repository

Create and activate a virtual environment:

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

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

Open Claude Desktop
Go to Settings > MCP Servers

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

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

Using the Vacation Planner

Start a new conversation in Claude
Just prompt anything with "Vacation Planner" prompt
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.

Setup Instructions

Prerequisites

Installation with uv

Clone this repository

Create and activate a virtual environment:

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

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

Open Claude Desktop

Go to Settings > MCP Servers

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

Replace PATH_TO_YOUR_PROJECT with the absolute path to your project directory

Replace YOUR_API_KEY_HERE with your actual TripAdvisor API key

Using the Vacation Planner

Start a new conversation in Claude

Just prompt anything with "Vacation Planner" prompt

Follow the interactive prompts to plan your perfect vacation!

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.