get_location_reviews
Retrieve user reviews for a specific Tripadvisor location to assess visitor experiences and ratings.
Instructions
Get reviews for a specific location
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| locationId | Yes | ||
| language | No | en |
Implementation Reference
- src/tripadvisor_mcp/server.py:126-145 (handler)The handler function decorated with @mcp.tool that implements the logic for fetching reviews for a given Tripadvisor location ID using the make_api_request helper.@mcp.tool(description="Get reviews for a specific location") async def get_location_reviews( locationId: Union[str, int], language: str = "en", ) -> Dict[str, Any]: """ Get the most recent reviews for a specific location. Parameters: - locationId: Tripadvisor location ID (can be string or integer) - language: Language code (default: 'en') """ params = { "language": language, } # Convert locationId to string to ensure compatibility location_id_str = str(locationId) return await make_api_request(f"location/{location_id_str}/reviews", params)
- src/tripadvisor_mcp/server.py:24-42 (helper)Supporting helper function that makes authenticated HTTP requests to the Tripadvisor API, called by the get_location_reviews handler.async def make_api_request(endpoint: str, params: Dict[str, Any] = None) -> Dict[str, Any]: """Make a request to the Tripadvisor Content API""" if not config.api_key: raise ValueError("Tripadvisor API key is missing. Please set TRIPADVISOR_API_KEY environment variable.") url = f"{config.base_url}/{endpoint}" headers = { "accept": "application/json" } if params is None: params = {} params["key"] = config.api_key async with httpx.AsyncClient() as client: response = await client.get(url, headers=headers, params=params) response.raise_for_status() return response.json()
- src/tripadvisor_mcp/server.py:126-126 (registration)The @mcp.tool decorator registers the get_location_reviews function as an MCP tool.@mcp.tool(description="Get reviews for a specific location")