# aemo-mcp

MCP server wrapping AEMO NEMWEB feeds. Exposes 7 curated Australian National
Electricity Market (NEM) datasets through 5 plain-English tools.

## Tools

- `search_datasets(query, limit=10)` — fuzzy search the 7 curated NEM datasets.
- `describe_dataset(dataset_id)` — schema, filters, and source URL for one dataset.
- `get_data(dataset_id, filters, start_period, end_period, format)` — query data.
- `latest(dataset_id, filters)` — most recent interval for time-series feeds.
- `list_curated()` — list the 7 curated dataset IDs.

## Datasets

- `dispatch_price` — 5-min regional spot price (RRP) per NEM region
- `dispatch_region` — 5-min total demand, scheduled gen, semi-scheduled gen, net interchange
- `interconnector_flows` — 5-min MW flow across the 6 NEM interconnectors
- `generation_scada` — 5-min DUID-level SCADA MW with fuel attribution
- `rooftop_pv` — 30-min regional rooftop solar (actual + forecast)
- `predispatch_30min` — 30-min forecast, ~40h horizon (price, demand, interconnector)
- `daily_summary` — daily rolled-up compendium of yesterday's price + demand + dispatch

## Regions

NSW1 (New South Wales), QLD1 (Queensland), SA1 (South Australia), TAS1 (Tasmania),
VIC1 (Victoria). Western Australia (WEM) and the Northern Territory are not on
the NEM and are out of scope.

## Source + Licence

Data: Australian Energy Market Operator (AEMO), NEMWEB
https://nemweb.com.au/Reports/Current/

AEMO grants general permission to use AEMO Material for any purpose
(commercial included) with accurate attribution. Every response carries the
canonical attribution string in `DataResponse.attribution`. See
https://aemo.com.au/privacy-and-legal-notices/copyright-permissions.

## Cache behaviour

5-min feeds cache for 60s. 30-min feeds cache for 5min. Forecasts cache for
1h. Daily archives cache for 24h. Timestamped historical files are
immutable and cache effectively forever.

## Companion servers

- abs-mcp — Australian Bureau of Statistics (SDMX)
- rba-mcp — Reserve Bank of Australia (statistical tables)
- ato-mcp — Australian Taxation Office (taxation + ACNC charity)
- apra-mcp — Australian Prudential Regulation Authority (banking + super)
- aihw-mcp — Australian Institute of Health and Welfare
- asic-mcp — ASIC registers (companies + financial advisers + SMSF auditors)
- au-weather-mcp — Australian weather (Open-Meteo + BOM)
