get_forecast
Retrieve weather forecast data for any location using latitude and longitude coordinates. This tool provides detailed weather predictions to help plan activities and prepare for conditions.
Instructions
Get weather forecast for a location.
Args:
latitude: Latitude of the location
longitude: Longitude of the locationInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| latitude | Yes | ||
| longitude | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- weather.py:58-92 (handler)The main handler function for the 'get_forecast' tool. It is decorated with @mcp.tool() which handles both registration and schema inference from the function signature and docstring. Fetches the weather forecast from the National Weather Service API using the provided latitude and longitude, formats the next 5 forecast periods, and returns them as a formatted string.
@mcp.tool() async def get_forecast(latitude: float, longitude: float) -> str: """Get weather forecast for a location. Args: latitude: Latitude of the location longitude: Longitude of the location """ # First get the forecast grid endpoint points_url = f"{NWS_API_BASE}/points/{latitude},{longitude}" points_data = await make_nws_request(points_url) if not points_data: return "Unable to fetch forecast data for this location." # Get the forecast URL from the points response forecast_url = points_data["properties"]["forecast"] forecast_data = await make_nws_request(forecast_url) if not forecast_data: return "Unable to fetch detailed forecast." # Format the periods into a readable forecast periods = forecast_data["properties"]["periods"] forecasts = [] for period in periods[:5]: # Only show next 5 periods forecast = f""" {period['name']}: Temperature: {period['temperature']}°{period['temperatureUnit']} Wind: {period['windSpeed']} {period['windDirection']} Forecast: {period['detailedForecast']} """ forecasts.append(forecast) return "\n---\n".join(forecasts) - weather.py:13-24 (helper)Helper function used by get_forecast to make asynchronous HTTP requests to the NWS API with proper headers and error handling.
async def make_nws_request(url: str) -> dict[str, Any] | None: """Make a request to the NWS API with proper error handling""" headers = {"User-Agent": USER_AGENT, "Accept": "application/geo+json"} async with httpx.AsyncClient() as client: try: response = await client.get(url, headers=headers, timeout=30.0) response.raise_for_status() return response.json() except Exception: return None