AESO MCP server

aeso-mcp

<!-- mcp-name: io.github.bchoi-qwe/aeso-mcp -->

Agent-native, strongly typed access and analytics for Alberta's electricity market using official AESO data.

Independent open-source project. Not affiliated with or endorsed by the Alberta Electric System Operator (AESO).

What it is

aeso-mcp is a Model Context Protocol (MCP) server that exposes Alberta electricity-market observations and deterministic analytics to AI clients. It is designed for energy analysts, researchers, developers, journalists, market participants, and AI agents that need reliable, structured AESO data—not a thin REST decorator layer.

Features

one typed getforecast contract, with persisted publication vintages and point-in-time asof selection that excludes unknown publication chronology

• Typed MCP tools with Pydantic inputs/outputs and structured results
• Current market snapshot combining price, load, generation, interchange, and reserves
• Paginated historical Pool Price, System Marginal Price, load, and generation retrieval
• Official individual-asset Historical CSD Generation Data at hourly and five-minute resolution
• Optional incremental DuckDB index and partitioned Parquet snapshots for repeatable research
• Official AIL, Pool Price, wind, solar, and combined wind/solar forecast publications through

reference-price, and AIES system-event reports

• Official supply-adequacy, supply-surplus, FFR Net Schedule, Dispatch Down Service, TMR

load/generation, constrained volume, EEA events, operating-reserve directives, and the current Pool Participant registry through one typed research-archive contract

• Official historical adequacy/cushion web codes, transmission outages, planning-area hourly

metered volumes, and operating-reserve offer control

• Authenticated APIM reports for merit order, commitments, capability/outages, interties,

condition evidence, price distributions, capture price, net load, supply stack, generation, outage association, generalized forecast accuracy, asset gross energy revenue, CSD-versus- metered comparisons, ramps, supply-surplus associations, and transparent supply-tightness indicators, plus participant concentration, regional, constrained-volume, scarcity, and compact system-frequency analysis

• Deterministic analytics: compact history summaries, period comparison, event detection,

completeness, and degradation warnings for multi-source market-event analysis

• Deterministic research manifests identify exact input publications, parameters, methodology,

reduced credential-free server mode

• Public operating-reserve active/standby prices, seven-day forecasts, activations, and summaries
• One complete server package and startup path: AESOAPIKEY is always required; there is no

secret-safe machine-readable errors

• Query bounds, cache provenance, completeness metadata, upstream Retry-After handling, and

non-loopback binds by default, rate/concurrency limits, request-size bounds, probes, and correlation IDs

• Hardened HTTP transport with Host/Origin validation, bearer authentication required for

• Reusable MCP prompts plus glossary, capability, dataset, and methodology resources

Implemented datasets

Shortened. The full README is on GitHub.