TripAdvisor Vacation Planner MCP Server

Instructions

Search for locations on TripAdvisor

Args:
    query: Search term (e.g., "hotels in Paris")
    category: Optional category filter (e.g., "hotels", "restaurants", "attractions")

Implementation Reference

• server.py:116-131 (handler)

  The main handler for the 'search_locations' tool. Decorated with @mcp.tool() for registration. Defines input schema via type hints and docstring. Executes search by calling TripAdvisor API via helper function.

  @mcp.tool()
  async def search_locations(query: str, category: Optional[str] = None) -> str:
      """
      Search for locations on TripAdvisor
      
      Args:
          query: Search term (e.g., "hotels in Paris")
          category: Optional category filter (e.g., "hotels", "restaurants", "attractions")
      """
      params = {"searchQuery": query}
      if category:
          params["category"] = category
      
      result = await tripadvisor_api_request("location/search", params)
      return json.dumps(result, indent=2)

• server.py:19-44 (helper)

  Supporting helper function that handles API requests to TripAdvisor, used by the search_locations tool and other tools.

  async def tripadvisor_api_request(endpoint: str, params: Dict[str, Any] = None) -> Dict[str, Any]:
      """Make a request to the TripAdvisor API"""
      if not TRIPADVISOR_API_KEY:
          return {"error": "TripAdvisor API key not configured. Set TRIPADVISOR_API_KEY environment variable."}
      
      headers = {"accept": "application/json", "key": TRIPADVISOR_API_KEY}
  
      if params is None:
          params = {}
  
      params["key"] = TRIPADVISOR_API_KEY
  
      url = f"{API_BASE_URL}/{endpoint}"
      
      async with httpx.AsyncClient() as client:
          try:
              response = await client.get(url, headers=headers, params=params, timeout=30.0)
              response.raise_for_status()
              return response.json()
          except httpx.HTTPStatusError as e:
              return {
                  "error": f"HTTP error occurred: {e}",
                  "details": str(e)
              }
          
  #Resources for specific location details