TripAdvisor Vacation Planner MCP Server

Instructions

Find locations near a specific latitude and longitude

Args:
    latitude: Latitude coordinate
    longitude: Longitude coordinate
    category: Optional category filter (e.g., "hotels", "restaurants", "attractions")

Implementation Reference

• server.py:132-147 (handler)

  The handler function for the 'get_nearby_locations' tool. It is decorated with @mcp.tool() for registration, includes input schema in the function signature and docstring, makes an API call to TripAdvisor's nearby_search endpoint, and returns the results as JSON.

  @mcp.tool()
  async def get_nearby_locations(latitude: float, longitude: float, category: Optional[str] = None) -> str:
      """
      Find locations near a specific latitude and longitude
      
      Args:
          latitude: Latitude coordinate
          longitude: Longitude coordinate
          category: Optional category filter (e.g., "hotels", "restaurants", "attractions")
      """
      params = {"latLong": f"{latitude},{longitude}"}
      if category:
          params["category"] = category
      
      result = await tripadvisor_api_request("location/nearby_search", params)
      return json.dumps(result, indent=2)

• server.py:19-44 (helper)

  Helper function used by the get_nearby_locations tool to perform authenticated HTTP requests to the TripAdvisor API.

  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