Nws Tools

Configuration File: nws_tools.json Tool Type: Local Tools Count: 3

This page contains all tools defined in the nws_tools.json configuration file.

Available Tools

NWS_get_active_alerts (Type: BaseRESTTool)

Get active weather alerts from the National Weather Service. Can be filtered by US state/territor…

NWS_get_active_alerts tool specification

Tool Information:

  • Name: NWS_get_active_alerts

  • Type: BaseRESTTool

  • Description: Get active weather alerts from the National Weather Service. Can be filtered by US state/territory. Returns current severe weather warnings, watches, and advisories including tornado warnings, flood warnings, winter storm warnings, etc.

Parameters:

  • area ([‘string’, ‘null’]) (optional) US state/territory abbreviation to filter by (e.g., ‘CA’, ‘TX’, ‘NY’). If not provided, returns all active alerts.

  • severity ([‘string’, ‘null’]) (optional) Filter by severity: Extreme, Severe, Moderate, Minor, Unknown

  • limit ([‘integer’, ‘null’]) (optional) Maximum number of alerts to return (default: 50)

Example Usage:

query = {
    "name": "NWS_get_active_alerts",
    "arguments": {
    }
}
result = tu.run(query)

NWS_get_forecast (Type: BaseRESTTool)

Get the 7-day weather forecast for a National Weather Service grid point. You need the gridId, gr…

NWS_get_forecast tool specification

Tool Information:

  • Name: NWS_get_forecast

  • Type: BaseRESTTool

  • Description: Get the 7-day weather forecast for a National Weather Service grid point. You need the gridId, gridX, and gridY values from NWS_get_point_metadata. Returns period-by-period forecast with temperature, wind, and detailed descriptions.

Parameters:

  • gridId (string) (required) NWS grid office identifier (e.g., ‘LWX’ for Washington DC area)

  • gridX (integer) (required) Grid X coordinate from point metadata

  • gridY (integer) (required) Grid Y coordinate from point metadata

Example Usage:

query = {
    "name": "NWS_get_forecast",
    "arguments": {
        "gridId": "example_value",
        "gridX": 10,
        "gridY": 10
    }
}
result = tu.run(query)

NWS_get_point_metadata (Type: BaseRESTTool)

Get weather metadata for a geographic point (latitude/longitude) from the US National Weather Ser…

NWS_get_point_metadata tool specification

Tool Information:

  • Name: NWS_get_point_metadata

  • Type: BaseRESTTool

  • Description: Get weather metadata for a geographic point (latitude/longitude) from the US National Weather Service. Returns the forecast office, grid coordinates, and URLs for forecast, hourly forecast, and observation stations. This is often the first step to get a weather forecast for a US location.

Parameters:

  • latitude (number) (required) Latitude of the location (e.g., 38.8894 for Washington DC)

  • longitude (number) (required) Longitude of the location (e.g., -77.0352 for Washington DC)

Example Usage:

query = {
    "name": "NWS_get_point_metadata",
    "arguments": {
        "latitude": "example_value",
        "longitude": "example_value"
    }
}
result = tu.run(query)