au.com.nempulse/nempulse

Official8 tools

by nempulse

Australian NEM battery (BESS) data for AI agents: revenue, dispatch, FCAS, events. Free, no auth.

au.com.nempulse/nempulse MCP Server

This Model Context Protocol (MCP) server provides read-only access to Australian NEM (National Electricity Market) grid-scale battery performance, revenue, dispatch, and FCAS data. The server is exposed as a tooling surface (8 tools total) intended for retrieving those datasets.

🛠️ Key Features

Read-only access
Australian NEM grid-scale battery performance data
Australian NEM battery revenue data
Australian NEM battery dispatch data
Australian NEM battery FCAS data
8 available tools

🚀 Use Cases

Query NEM grid-scale battery performance metrics
Retrieve revenue information for grid-scale batteries in the NEM
Access dispatch data for analysis or reporting
Obtain FCAS-related data for operational or research workflows

Captured live from the server via tools/list.

list_bess_units

List every NEM-registered grid-scale battery (DUID, station, region, MW/MWh, MLF, coordinates).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_fleet_summary

Fleet-wide snapshot: unit count, total capacity, revenue month-to-date, average spot price.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_battery_detail

Deep-dive metrics for one battery by DUID (e.g. HPR1 = Hornsdale): revenue, dispatch, SOC, FCAS.

Parameters1

duid

string

required

Battery DUID, e.g. HPR1

Raw schema

{
  "type": "object",
  "properties": {
    "duid": {
      "type": "string",
      "description": "Battery DUID, e.g. HPR1"
    }
  },
  "required": [
    "duid"
  ],
  "additionalProperties": false
}

query_nem_data

Ask a natural-language question about NEM BESS data; returns generated SQL, result rows and a plain-English explanation.

Parameters1

question

string

required

Plain-English question (max 500 chars).

Raw schema

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "Plain-English question (max 500 chars)."
    }
  },
  "required": [
    "question"
  ],
  "additionalProperties": false
}

get_battery_revenue

Daily gross-spot revenue by market (energy + FCAS) for one battery (DUID) over a date range. Daily grain only.

Parameters3

duid	string	required	Battery DUID, e.g. HPR1
date_from	string	required	Start date YYYY-MM-DD
date_to	string	required	End date YYYY-MM-DD

Raw schema

{
  "type": "object",
  "properties": {
    "duid": {
      "type": "string",
      "description": "Battery DUID, e.g. HPR1"
    },
    "date_from": {
      "type": "string",
      "description": "Start date YYYY-MM-DD"
    },
    "date_to": {
      "type": "string",
      "description": "End date YYYY-MM-DD"
    }
  },
  "required": [
    "duid",
    "date_from",
    "date_to"
  ],
  "additionalProperties": false
}

get_battery_optimal

Actual vs LP-optimal dispatch revenue, per-DUID summary, over a date range (energy-only, perfect-foresight benchmark). Returns all DUIDs; filter by the one you want.

Parameters2

date_from	string	required	Start date YYYY-MM-DD
date_to	string	required	End date YYYY-MM-DD

Raw schema

{
  "type": "object",
  "properties": {
    "date_from": {
      "type": "string",
      "description": "Start date YYYY-MM-DD"
    },
    "date_to": {
      "type": "string",
      "description": "End date YYYY-MM-DD"
    }
  },
  "required": [
    "date_from",
    "date_to"
  ],
  "additionalProperties": false
}

list_events

List NEM spot-price events (negative, elevated, spike, extreme), optionally filtered by region.

Parameters2

region	string	optional	NEM region, e.g. SA1 (optional)
limit	integer	optional	Max events to return (default 50, max 500)

Raw schema

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "description": "NEM region, e.g. SA1 (optional)"
    },
    "limit": {
      "type": "integer",
      "description": "Max events to return (default 50, max 500)"
    }
  },
  "additionalProperties": false
}

get_event_detail

Summary stats for one market price event by id (per-interval dispatch during the event is not exposed).

Parameters1

string

required

Event id

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Event id"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Install

Tools (8)

list_bess_unitsget_fleet_summaryget_battery_detailquery_nem_dataget_battery_revenueget_battery_optimallist_eventsget_event_detail

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://nempulse.com.au/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "nempulse": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://nempulse.com.au/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

au.com.nempulse/nempulse MCP Server

🛠️ Key Features

🚀 Use Cases

list_bess_units

get_fleet_summary

get_battery_detail

query_nem_data

get_battery_revenue

get_battery_optimal

list_events

get_event_detail

Install

Remote endpoint

Related servers