aemo-mcp CLAUDE.md

aemo-mcp CLAUDE.md is an instructions file for coding agents from Bigred97/aemo-mcp. It costs 2,949 tokens per session, scanned A, original, MIT.

A set of instructions for agents working on the aemo-mcp project, which provides access to Australian electricity-market data. It documents the source data, supported datasets, Python package, and project-specific rules.

In plain words
What is it for?
Use it when editing, reviewing, or answering questions about the aemo-mcp codebase and its AEMO data sources.
Why use it?
It gives the agent the project context needed to handle the repository and its data conventions correctly.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/bigred97/aemo-mcp/claude-md
Clone the repo
git clone --depth 1 https://github.com/Bigred97/aemo-mcp

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for aemo-mcp CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/bigred97/aemo-mcp/claude-md.svg)](https://agentmods.dev/instructions/bigred97/aemo-mcp/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/bigred97/aemo-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/bigred97/aemo-mcp/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 2,949 This file is loaded in full into every session.
When invoked 2,949 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.02949 $0.02949
Opus 5 $0.01474 $0.01474
Sonnet 5 $0.00590 $0.00590
Haiku 4.5 $0.00295 $0.00295

Measured 4d ago against content hash 3ec5fb3e4060, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

aemo-mcp CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 198 lines

How it starts

The opening of the file, as written. The whole thing — 198 lines — stays where its author put it; the contents beside it link to each section on GitHub.

aemo-mcp

Sister MCP in the Australian Public Data stack. See ../CLAUDE.md for portfolio-wide conventions; this file captures repo-specific details plus the cross-sister discipline.

Source

Source agency Australian Energy Market Operator (AEMO)
Source URL http://nemweb.com.au/Reports/Current/
Data format Multi-section CSV (AEMO C,/I,/D, rows) packed in ZIP files, served from NEMWEB (IIS static file server). Directory listings are HTML.
Licence AEMO Copyright Permissions (general permission for any purpose with attribution; commercial use allowed)
Licence URL https://aemo.com.au/privacy-and-legal-notices/copyright-permissions
Python module aemo_mcp
PyPI package aemo-mcp
GitHub https://github.com/Bigred97/aemo-mcp

Note: AEMO's data is NOT CC-BY. Their Copyright Permissions policy is similar in effect (general permission with attribution) but the canonical attribution string differs — see models._AEMO_ATTRIBUTION.

Curated datasets (10)

dispatch_price · dispatch_region · interconnector_flows · generation_scada · rooftop_pv · predispatch_30min · daily_summary · trading_price · fcas_prices · dispatch_constraints

All cover the NEM (NSW1, QLD1, SA1, TAS1, VIC1). Western Australia (WEM) and the Northern Territory are not on the NEM and are out of scope.

Repo-specific module set

Required (every sister): server.py, models.py, curated.py, client.py, cache.py, shaping.py, data/curated/*.yaml

Repo-specific extras:

  • fetch.py — orchestration layer between server.py and the HTTP/parsing stack. Resolves curated dataset → folder(s) → file selection (Current vs Archive) → ZIP fetch → CSV parse → filter → shape. Sits where most sisters' server.py would have inline orchestration logic — pulled out because NEM file selection (5-min vs 30-min, Current vs Archive, latest vs window, forecast vs actual) is non-trivial.
  • feeds.py — dataset search ranking + DatasetSummary projection. Replaces rba-mcp's tables.py / abs-mcp's catalog.py.
  • parsing.py — AEMO multi-section CSV parser + ZIP unpacker. Each NEMWEB ZIP holds one CSV with one or more I,/D, sections (DISPATCH.PRICE, DISPATCH.REGIONSUM, DISPATCH.INTERCONNECTORRES, ...). Stdlib csv + zipfile only; no pandas.
  • duid_lookup.py — DUID → region/fuel join table for generation_scada. Static snapshot in data/duid_snapshot.csv (DUIDs change infrequently); refreshed periodically. Used to translate region/fuel filters into a DUID allow-set before filtering DISPATCH.UNIT_SCADA rows.

Read the full file on GitHub · 198 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 198 lines · 2,949 tokens per session scan A 3ec5fb3e4060

Subscribe to this mod's changes

aemo-mcp CLAUDE.md is an instructions file published in the GitHub repository Bigred97/aemo-mcp (0 stars, last pushed 1mo ago), licensed MIT. It adds 2,949 tokens to every session, about $0.0147 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.