get_nearby_locations
Find hotels, restaurants, and attractions near specific coordinates to plan trips using TripAdvisor data.
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")Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| latitude | Yes | ||
| longitude | Yes | ||
| category | No |
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