Tripadvisor Mcp Server

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:

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

1. Install the required dependencies:

``bash 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:

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

1. Replace PATH_TO_YOUR_PROJECT with the absolute path to your project directory
2. 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. getlocationdetails_tool is usually the culprit.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: hhw67865
• Source: hhw67865/tripadvisor-mcp-server
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.