# Explore NZ electricity market data

Preview: Review New Zealand wholesale electricity prices, monthly retailer connection counts, and public network and meter details for a known connection point.

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

## Tool reference

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

Credit use: 1 credit.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string",
      "enum": [
        "wholesale_prices",
        "connection_counts",
        "icp_lookup"
      ]
    },
    "node": {
      "type": "string",
      "minLength": 3,
      "maxLength": 20
    },
    "since": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "until": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "at": {
      "description": "NZ local HH:mm interval label on a five-minute boundary; use with one date. Archived publish times are matched to the nearest interval label.",
      "type": "string",
      "maxLength": 5
    },
    "period": {
      "description": "Required for connection_counts: a month in YYYY-MM format; omit for other datasets.",
      "type": "string",
      "maxLength": 20
    },
    "region_type": {
      "type": "string",
      "enum": [
        "national",
        "island",
        "zone",
        "main_centre",
        "regional_council",
        "network_reporting_region",
        "network_participant",
        "root_nsp"
      ]
    },
    "region": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "retailer": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "icp": {
      "type": "string",
      "maxLength": 32
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "fields": {
      "description": "Optional exact result keys to return. Omit this parameter to return all fields; wildcard `*` is not supported.",
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$"
      }
    }
  },
  "required": [
    "dataset"
  ],
  "additionalProperties": false
}
```

## Example input

```json
{
  "dataset": "connection_counts",
  "period": "2026-09",
  "region_type": "national"
}
```

## Usage notes

- Choose wholesale prices, connection counts or a connection-point lookup.
- Wholesale price queries cover one date at a time within the latest 31 days.
- Wholesale prices are interim and are not final settlement prices, retail tariffs, consumption or customer identity. Address search is not supported.