# Read New Zealand weather and river observations

Preview: Check official New Zealand severe weather alerts, point and marine forecasts, and regional council rainfall totals and river observations.

Canonical: https://aroai.com/tools/nz_weather_data/

## Tool reference

MCP tool ID: `nz_weather_data`. Availability: Preview. Country: New Zealand.

Credit use: Free.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string",
      "enum": [
        "severe_weather_warnings",
        "forecast",
        "current_conditions",
        "marine_forecast",
        "rainfall",
        "river_flow_level",
        "monitoring_sites"
      ],
      "description": "Choose severe_weather_warnings for official severe weather alerts; forecast, current_conditions or marine_forecast for point and marine forecasts; rainfall or river_flow_level for regional council gauge totals and flows; monitoring_sites to discover council monitoring stations."
    },
    "location": {
      "description": "Named NZ location (e.g. Auckland, Wellington, Christchurch, Queenstown) for forecasts or rainfall sites.",
      "type": "string",
      "maxLength": 100
    },
    "region": {
      "description": "NZ council identifier, required for rainfall, river_flow_level and monitoring_sites: gwrc (Wellington), hbrc (Hawke's Bay), marlborough, northland, tasman; auckland (monitoring_sites only).",
      "type": "string",
      "maxLength": 100
    },
    "site": {
      "description": "Gauge or site name to match (case-insensitive substring) for rainfall, river_flow_level or monitoring_sites.",
      "type": "string",
      "maxLength": 150
    },
    "measurement": {
      "description": "River measurement for river_flow_level: level (stage), flow (discharge), or any (default).",
      "default": "any",
      "type": "string",
      "enum": [
        "level",
        "flow",
        "any"
      ]
    },
    "latitude": {
      "description": "Latitude for custom point forecast coordinates (-48 to -33).",
      "type": "number",
      "minimum": -48,
      "maximum": -33
    },
    "longitude": {
      "description": "Longitude for custom point forecast coordinates (165 to 180).",
      "type": "number",
      "minimum": 165,
      "maximum": 180
    },
    "hours": {
      "description": "Hourly window: forecasts and rainfall totals 1–72; river_flow_level reads at most the last 6 hours. Defaults: 1 for current_conditions, 24 otherwise.",
      "type": "integer",
      "minimum": 1,
      "maximum": 72
    },
    "days": {
      "description": "Multi-day forecast outlook horizon (1–7 days). Converts to hourly forecast window.",
      "type": "integer",
      "minimum": 1,
      "maximum": 7
    },
    "limit": {
      "default": 20,
      "description": "Maximum results to return (1–50, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "dataset",
    "limit"
  ],
  "additionalProperties": false
}
```

## Example input

```json
{
  "dataset": "severe_weather_warnings",
  "location": "Auckland"
}
```

## Usage notes

- Covers official severe weather watches, warnings and marine forecasts.
- Regional council rainfall and river levels require a supported council identifier (e.g. Wellington, Hawke's Bay, Marlborough, Northland, Tasman).
- Free source; does not consume credits.
- Does not provide radar animation imagery, international weather or road navigation.