Skip to main content
Glama

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.

Related MCP server: EnergyAtIt MCP Server

Features

  • Typed MCP tools with Pydantic inputs/outputs and structured results

  • Stable FastMCP 4.0.10 runtime targeting MCP 2026-07-28, with FastMCP's per-connection negotiation for legacy session-based clients

  • 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 one typed get_forecast contract, with persisted publication vintages and point-in-time as_of selection that excludes unknown publication chronology

  • Official supply-adequacy, supply-surplus, FFR Net Schedule, Dispatch Down Service, TMR reference-price, and AIES system-event reports

  • Official historical adequacy/cushion web codes, transmission outages, planning-area hourly load/generation, constrained volume, EEA events, operating-reserve directives, and the current Pool Participant registry through one typed research-archive contract

  • Authenticated APIM reports for merit order, commitments, capability/outages, interties, metered volumes, and operating-reserve offer control

  • Deterministic analytics: compact history summaries, period comparison, event detection, 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 research manifests identify exact input publications, parameters, methodology, completeness, and degradation warnings for multi-source market-event analysis

  • Public operating-reserve active/standby prices, seven-day forecasts, activations, and summaries

  • One complete server package and startup path: AESO_API_KEY is always required; there is no reduced credential-free server mode

  • Query bounds, cache provenance, completeness metadata, upstream Retry-After handling, and secret-safe machine-readable errors

  • Hardened HTTP transport with Host/Origin validation, bearer authentication required for non-loopback binds by default, rate/concurrency limits, request-size bounds, probes, and correlation IDs

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

Implemented datasets

Dataset

Tool

Notes

Market snapshot

get_market_snapshot

Current cohesive view

Pool Price

get_pool_prices

Hourly CAD/MWh

System Marginal Price

get_system_marginal_prices

Minute-level CAD/MWh

Alberta Internal Load

get_load

MW; optional forecast

Generation / fuel mix

get_generation

Current all fuels; historical wind/solar

Interchange

get_interchange

Current path flows MW

Operating reserves

get_reserves

Current MW indicators

Generator outages

get_outages

Hourly outage capacity by fuel/technology

AIES capacity/outages

get_generation_capacity

Hourly MC, AC, operating, and mothball outage MW

Load outage forecast

get_load_outage_forecast

Hourly forecast MW

Energy Merit Order

get_energy_merit_order

Historical blocks; 60-day publication delay

Unit commitments

get_unit_commitments

Generating-unit commitment directives

Intertie capability

get_intertie_capability

Import/export ATC, TTC, margins, gross offers

Intertie capability outages

get_intertie_outages

Outages affecting interties/flowgates

Metered volumes

get_metered_volumes

Hourly MWh by asset; optional ID filters

OR offer control

get_operating_reserve_offer_control

Historical reserve offer blocks; 60-day delay

Approved Tx outages

get_approved_transmission_outages

AESO-approved planned transmission outages

Long-range Tx outages

get_long_range_transmission_outages

Tentative ~24-month significant outages

MCSINR

get_monthly_cumulative_net_revenue

Cumulative net revenue vs offer-cap trigger

Secondary offer limit

get_secondary_offer_price_limit

Whether secondary offer cap is in effect

Assets

get_assets

Registry with filters

Historical CSD generation

get_historical_generation

Individual assets; hourly / five-minute operational MW

Official forecasts

get_forecast

AIL / Pool Price / wind / solar; source-specific horizons and cadence

Official research archive

get_research_data

Historical adequacy/cushion, transmission, planning-area, constraint, EEA, OR-directive, and current participant records

Supply adequacy / cushion

get_supply_adequacy

Official hourly categorical status bands

Supply surplus

get_supply_surplus

Official hourly zero-price forecast status

FFR Net Schedule

get_ffr_net_schedule

Hourly scheduled imports (negative) / exports (positive) MW

Dispatch Down Service

get_dispatch_down_service

Published DDS availability MW

TMR reference price

get_tmr_reference_price

Published CAD/MWh value by effective date

AIES system events

get_system_events

Bounded event-log comments; no inferred event end

UC settlement summary

get_uc_settlement_summary

Hourly CAD amount and charged MW

OR prices

get_operating_reserve_prices

Active and standby price components and volumes

OR forecast

get_operating_reserve_forecast

Current seven-day hourly MW forecast

OR activations

get_operating_reserve_activations

Hourly standby volume and activation price

Analytics: summarize_market_history, assess_supply_tightness, compare_market_periods, find_price_events, explain_market_conditions, compare_forecast_to_actual, get_price_statistics, get_price_duration_curve, analyze_market_event, calculate_capture_prices, analyze_net_load, analyze_supply_stack, analyze_intertie_utilization, analyze_generation_mix, analyze_asset_dispatch, analyze_outage_impact, analyze_forecast_error, calculate_asset_energy_revenue, compare_csd_to_metered, analyze_ramps, analyze_supply_surplus_events, summarize_operating_reserve_market, analyze_participant_concentration, analyze_regional_load_generation, analyze_constrained_volume, analyze_scarcity, and analyze_system_frequency.

Architecture

The documentation site includes a full architecture and MCP Inspector walkthrough and an MCP interoperability and security matrix.

MCP clients
    |
    v
FastMCP adapter (aeso_mcp/mcp)
    |
    v
Domain services (market, grid, history, forecasts, reports, research, reserves, operations)
    |
    +---------------+----------------+----------------+----------------+
    |               |                |                |
    v               v                v                v
GridStatus     Direct APIM     Public reports    CSD archive
    |               |           (ets.aeso.ca)      (Box)
    +-------+-------+
            |
            v
      AESO APIM gateway

Domain code does not depend on FastMCP. Framework changes should stay in aeso_mcp/mcp/. All upstream clients are implementation details of this single server: the APIM key is sent only to apimgw.aeso.ca and is never sent to the allow-listed ETS or Box hosts.

Requirements

Installation

See LIMITATIONS.md for an honest gap inventory.

export AESO_API_KEY=your-key
uvx aeso-mcp

For incremental DuckDB/Parquet historical storage:

uvx --from 'aeso-mcp[analytics]' aeso-mcp

From GitHub

To run the current repository version directly:

export AESO_API_KEY=your-key
uvx --from git+https://github.com/bchoi-qwe/aeso-mcp.git aeso-mcp

Development

git clone https://github.com/bchoi-qwe/aeso-mcp.git
cd aeso-mcp
uv sync --group dev --extra analytics --extra docs
cp .env.example .env   # set AESO_API_KEY
uv run aeso-mcp

Docker

docker build -t aeso-mcp .
docker run --rm \
  -e AESO_API_KEY=your-key \
  -e AESO_MCP_HTTP_BEARER_TOKEN=replace-with-a-long-random-token \
  -p 8000:8000 \
  aeso-mcp

Send the same token in the MCP client's Authorization: Bearer ... header. The image binds to 0.0.0.0, so it intentionally requires bearer authentication by default. The built-in HTTP listener does not terminate TLS; for off-host traffic, terminate TLS at a trusted reverse proxy and never send bearer credentials over public plaintext HTTP. See MCP interoperability and security.

Obtaining an AESO API key

  1. Register at the AESO developer portal

  2. Subscribe to the AESO public API product

  3. Copy the primary/secondary subscription key

  4. Set AESO_API_KEY in your environment (never commit it)

Missing credentials produce an actionable startup error. The key is never returned through MCP tools or logged.

Example MCP client configuration

See the documentation site's MCP client configurations for maintained Codex, ChatGPT desktop app, Claude Desktop, Claude Code, and Cursor setup instructions.

Cursor / Claude Desktop style (stdio)

{
  "mcpServers": {
    "aeso": {
      "command": "uvx",
      "args": ["aeso-mcp"],
      "env": {
        "AESO_API_KEY": "your-key"
      }
    }
  }
}

HTTP transport

uv run aeso-mcp --transport http --host 127.0.0.1 --port 8000

HTTP always validates Host and Origin. A non-loopback bind now refuses to start unless AESO_MCP_HTTP_BEARER_TOKEN is configured. The built-in listener is plain HTTP; terminate TLS at a trusted ingress before exposing it beyond a trusted private network. An explicit AESO_MCP_HTTP_ALLOW_INSECURE_REMOTE=true override exists for isolated environments that accept the risk; it is never the default. Also set AESO_MCP_HTTP_ALLOWED_HOSTS and AESO_MCP_HTTP_ALLOWED_ORIGINS for the deployment. /healthz and /readyz contain no market data or secrets. See .env.example for all bounded runtime settings.

Example prompts

  • What is Alberta's current grid situation?

  • What is the current pool price?

  • Show Alberta pool prices over the last 24 hours.

  • Compare today's pool prices with yesterday's.

  • Which hours had the highest prices this week?

  • How much wind and solar are producing right now?

  • What happened during the largest price spike this week?

  • How inaccurate was the seven-day wind forecast during that event?

  • Was AESO publishing a supply-surplus or tight supply-cushion status at the time?

  • What gross Pool Price energy revenue did this asset's metered MWh earn?

  • Explain the evidence associated with today's price increase.

Tools

Tool

Purpose

get_market_snapshot

Current market overview

get_pool_prices

Hourly Pool Price history

get_system_marginal_prices

Minute-level SMP history

get_load

Alberta Internal Load

get_generation

Fuel mix / renewable history

get_interchange

Intertie flows

get_reserves

Operating reserve indicators

get_outages

Hourly generator outage capacity by fuel

get_generation_capacity

AIES capability and outage grouping by fuel

get_load_outage_forecast

Hourly load-outage forecast

get_energy_merit_order

Historical energy merit-order blocks

get_unit_commitments

Generating-unit commitment directives

get_intertie_capability

Intertie/flowgate ATC, TTC, and margins

get_intertie_outages

Outages affecting intertie capability

get_metered_volumes

Metered energy by asset

get_operating_reserve_offer_control

Historical reserve offer-control blocks

get_approved_transmission_outages

Approved planned transmission outages

get_long_range_transmission_outages

Tentative long-range transmission outages

get_assets

Asset registry

get_monthly_cumulative_net_revenue

Current MCSINR publication

get_secondary_offer_price_limit

Current secondary offer-cap status

compare_market_periods

Aggregate period comparison

find_price_events

High-price event detection

explain_market_conditions

Structured evidence (not causal prose)

compare_forecast_to_actual

AIL forecast vs actual accuracy

summarize_market_history

Compact hourly/daily/weekly/monthly price and load summaries

assess_supply_tightness

Transparent reserve-adjusted supply-margin screening

get_historical_generation

Official individual-asset CSD archive history

sync_historical_store

Incremental local DuckDB/Parquet ingestion

get_historical_store_status

Local coverage, manifests, and partition status

get_forecast

Official AIL, Pool Price, wind, solar, and combined wind/solar forecasts

get_research_data

Bounded page from one verified official historical/spatial/reliability archive

get_supply_adequacy

Official supply-adequacy and market-supply-cushion status bands

get_supply_surplus

Official hourly supply-surplus forecast status

get_ffr_net_schedule

Historical scheduled FFR intertie transfer

get_dispatch_down_service

Dispatch Down Service availability report

get_tmr_reference_price

Published TMR reference price

get_system_events

Bounded AIES Event Log messages

get_uc_settlement_summary

Public hourly UC amount and charged volume

get_price_statistics

Price distribution and volatility statistics

get_price_duration_curve

Pool Price exceedance curve

analyze_market_event

Focus versus baseline multi-series associations

calculate_capture_prices

Generation-weighted price and capture rate

analyze_net_load

AIL minus selected renewable generation

analyze_supply_stack

Historical offer-stack analysis

analyze_intertie_utilization

Gross-offer to capability proxy

analyze_generation_mix

CSD energy and share by fuel

analyze_asset_dispatch

Asset output, capacity factor, and ramps

analyze_outage_impact

Hourly outage-price association

analyze_forecast_error

General forecast error, percentiles, market-hour and lead-time profiles

calculate_asset_energy_revenue

Metered MWh × Pool Price gross energy revenue

compare_csd_to_metered

Operational CSD output versus metered MWh

analyze_ramps

Cadence-aware AIL, net-load, renewable, or asset ramps

analyze_supply_surplus_events

Price/load/renewable associations during explicit surplus states

get_operating_reserve_prices

Active/standby price components and volumes

get_operating_reserve_forecast

Seven-day reserve-volume forecast

get_operating_reserve_activations

Hourly standby activations

summarize_operating_reserve_market

Product price/volume/activation summary

analyze_participant_concentration

Offered-volume shares and HHI using current participant mapping

analyze_regional_load_generation

Planning-area and regional load/generation aggregates

analyze_constrained_volume

Planning-area/fuel constrained MWh and optional price association

analyze_scarcity

Historical adequacy/cushion web codes, EEA, and price context

analyze_system_frequency

Compact six-hour 10-second frequency statistics; no raw row output

Market and research tools are read-only. sync_historical_store writes only to the configured local historical-store root; it does not mutate AESO or another external system.

Resources

URI

Content

aeso://glossary

Market terminology

aeso://datasets

Dataset catalog

aeso://methodology/pool-price

Pool Price interpretation

aeso://methodology/system-marginal-price

SMP interpretation

aeso://capabilities

Complete tool, prompt, and resource surface

aeso://methodology/{dataset}

Dataset-specific interpretation and caveats

Prompts: daily_market_brief, investigate_price_event, and compare_market_days.

Data semantics

  • Timezone: America/Edmonton (AESO market time). DST days may have 23 or 25 local hours.

  • Intervals: Explicit interval_start / interval_end (half-open ranges in requests).

  • Units: Pool Price / SMP → CAD/MWh; load / generation / interchange / reserves → MW.

  • Status: Metadata includes actual / forecast / etc. Forecasts are never implied to be settled actuals.

  • Finality: Operational feeds may be preliminary; do not assume final settlement.

  • Point-in-time forecasts: as_of selects only vintages with known issue/publication times and retrieval times at or before the boundary. Unknown chronology is excluded; target intervals absent from persisted history remain unobserved rather than being backfilled from a later publication.

  • Completeness: Metadata reports available/missing series and expected/missing observations where the source cadence is known. Optional enrichment failures are surfaced as partial or degraded results with warnings.

  • Pagination: Raw price, SMP, load, generation, and operational reports return page metadata with next_offset. Use summarize_market_history before retrieving long raw series.

  • Cache timing: retrieved_at identifies the upstream fetch; served_at, cache_hit, and cache_age identify when and how the response was served.

  • Research identity: analyze_market_event.analysis_manifest records exact sources, parameters, methodology version, warnings, and a deterministic SHA-256 analysis_id.

Development

uv sync --group dev --extra analytics --extra docs
uv run ruff check src tests scripts
uv run ruff format --check src tests scripts
uv run pyright src
uv run pytest tests/unit tests/contract tests/mcp tests/evals tests/packaging --cov=aeso_mcp
uv run python scripts/generate_catalog.py --check
uv run mkdocs build --strict
uv run python tests/packaging/check_release_metadata.py
uv run python tests/packaging/check_lock_prereleases.py
uv build

Optional live tests:

AESO_API_KEY=... uv run pytest tests/integration -m integration

MCP Inspector:

# Prefer the console entrypoint; or point Inspector at:
# uv run aeso-mcp
npx @modelcontextprotocol/inspector uv run aeso-mcp

Tests

  • tests/unit — time, bounds, analytics, config

  • tests/contract — AESO APIM fixtures via respx

  • tests/mcp — tool/resource discovery and structured outputs

  • tests/integration — opt-in live AESO calls

Security

See SECURITY.md. Highlights: no arbitrary URL/shell/SQL tools, host allow-list, secret hygiene, bounded queries, stderr logging for stdio.

Development status

Version 0.4.0 includes the historical store, full CSD generation adapter, official forecast/report providers, general research analytics, operating-reserve market surface, eval suite, and documentation site. It also includes point-in-time forecast vintages, reproducibility manifests, release-policy hardening, and the verified official research-data archive.

Contributing

See CONTRIBUTING.md.

License

MIT — see LICENSE.

Disclaimer

This project is an independent open-source interface to publicly documented AESO APIs. It is not an official AESO product and is not affiliated with or endorsed by AESO. Market data may be preliminary or incomplete; verify critical decisions against official AESO publications.

Available Tools

57 tools
analyze_asset_dispatchAnalyze Asset DispatchB
Read-onlyIdempotent

Summarizes official hourly CSD dispatch for selected assets: energy, average/peak generation, available capacity factor, and hourly ramp extremes.

Inputs: request (required). Returns: results, metadata, warnings

analyze_forecast_errorAnalyze Forecast ErrorA
Read-onlyIdempotent

Calculates forecast-minus-actual bias, MAE, RMSE, denominator-aware MAPE, error percentiles, and breakdowns by market hour and lead time for AIL, Pool Price, wind, solar, or combined wind/solar when the official source provides paired values.

Inputs: request (required). Returns: Generalized forecast-error metrics with explicit missing-pair counts.

analyze_generation_mixAnalyze Generation MixA
Read-onlyIdempotent

Aggregates official hourly individual-asset CSD generation into energy, share, average MW, and peak MW by fuel type.

Inputs: request (required). Returns: results, metadata, warnings, total_generation_mwh

analyze_intertie_utilizationAnalyze Intertie UtilizationA
Read-onlyIdempotent

Summarizes gross offers relative to available intertie transfer capability by path and direction. This is an offer-to-capability proxy, not metered flow.

Inputs: request (required). Returns: results, metadata, warnings, methodology

analyze_market_eventAnalyze Market EventA
Read-onlyIdempotent

Compares structured price, demand/forecast, supply, merit-order, intertie, commitment, and operating-reserve evidence in a focus window against a supplied or immediately preceding baseline. Returns descriptive associations, not causal claims.

Inputs: request (required). Returns: metrics, evidence, metadata, warnings, +6 more

analyze_net_loadAnalyze Net LoadA
Read-onlyIdempotent

Calculates hourly Alberta Internal Load minus selected CSD renewable generation (wind and solar by default), including average, peak, and minimum net load.

Inputs: request (required). Returns: metadata, warnings, intervals, peak_net_load_mw, +2 more

analyze_outage_impactAnalyze Outage ImpactB
Read-onlyIdempotent

Joins hourly generator outage capacity to Pool Price and reports high-outage versus other-hour price differences plus Pearson correlation as non-causal associations.

Inputs: request (required). Returns: metadata, warnings, methodology, threshold_mw, +6 more

analyze_rampsAnalyze RampsA
Read-onlyIdempotent

Calculates cadence-aware up/down ramps for AIL, net load, wind, solar, or selected asset CSD generation. Supports hourly and five-minute cadence where the source supports it, skips non-consecutive observations, reports MW per interval and MW/hour, and never fills missing values.

Inputs: request (required). Returns: Ramp statistics with explicit requested and observed cadence.

analyze_supply_stackAnalyze Supply StackB
Read-onlyIdempotent

Analyzes one historical Energy Merit Order hour: price-sorted offer blocks, offered and dispatched MW, and the highest dispatched offer price.

Inputs: request (required). Returns: blocks, metadata, warnings, offered_mw, +4 more

analyze_supply_surplus_eventsAnalyze Supply Surplus EventsA
Read-onlyIdempotent

Aligns official AESO supply-surplus status runs with observed Pool Price, AIL, and wind/solar generation. Durations are reported only when the official sequence provides an explicit end boundary. Results are descriptive associations, not causation.

Inputs: request (required). Returns: Descriptive associations around AESO-published supply-surplus states.

assess_supply_tightnessAssess Supply TightnessA
Read-onlyIdempotent

Combines the current market snapshot with hourly available generation capability and outages. Returns transparent supply-margin arithmetic plus a deterministic tight/watch/comfortable screening signal; it is not an AESO declaration or a causal price explanation.

Inputs: no named parameters. Returns: Current supply-adequacy arithmetic, without a causal market claim.

calculate_asset_energy_revenueCalculate Asset Energy RevenueA
Read-onlyIdempotent

Joins hourly metered energy (MWh) by selected asset to hourly AESO Pool Price (CAD/MWh) over [start, end). Returns gross Pool Price energy revenue, realized capture price, arithmetic average matched market price, capture rate, matched hours, and explicit missing intervals. This is not total settlement revenue.

Inputs: request (required). Returns: Deterministic gross Pool Price revenue from metered-energy joins.

calculate_capture_pricesCalculate Capture PricesA
Read-onlyIdempotent

Joins hourly Pool Price to official CSD generation and calculates generation-weighted capture price and capture rate by requested asset and/or fuel group.

Inputs: request (required). Returns: results, metadata, warnings

compare_csd_to_meteredCompare Csd To MeteredA
Read-onlyIdempotent

Compares hourly operational Historical CSD generation (MW converted to interval MWh) against hourly settlement-metered energy (MWh) by asset. Returns matched-hour differences, percentage errors, and missing-source counts. CSD operational output and metered settlement energy are distinct source concepts.

Inputs: request (required). Returns: Operational CSD generation and settlement-metered energy are separate concepts.

compare_forecast_to_actualCompare Forecast To ActualA
Read-onlyIdempotent

Compares Alberta Internal Load forecast versus actual over [start, end) in MW. Returns mean error, MAE, RMSE, MAPE, and paired intervals. Timestamps are America/Edmonton.

Inputs: request (required). Returns: Deterministic forecast accuracy statistics for AIL.

compare_market_periodsCompare Market PeriodsA
Read-onlyIdempotent

Compares aggregate pool-price and load statistics between two America/Edmonton market periods. Returns averages, min/max/median prices, load stats, and deltas. Does not assert causation.

Inputs: request (required). Returns: Side-by-side period comparison with deltas.

explain_market_conditionsExplain Market ConditionsA
Read-onlyIdempotent

Returns structured evidence for market conditions in a focus window versus a baseline window (default: immediately preceding equal-length window). Includes observed metrics and associated_changes. Does not claim causation; the calling model should produce any natural-language explanation.

Inputs: request (required). Returns: Structured evidence suitable for an LLM explanation. This response intentionall…

find_price_eventsFind Price EventsA
Read-onlyIdempotent

Detects sustained high Pool Price events in CAD/MWh over [start, end). Threshold may be an absolute CAD/MWh value or a percentile (default 90th). Returns event boundaries, duration, peak/average price, and load context when available.

Inputs: request (required). Returns: Detected price events for the requested window.

get_approved_transmission_outagesGet Approved Transmission OutagesA
Read-onlyIdempotent

Returns AESO-approved planned transmission outages (approval_status=approved). Omit start/end for the current public publication. Historical start/end select publication windows and are tightly bounded. Distinct from generator outages and from long-range tentative outages.

Inputs: request (required). Returns: Transmission outage observations from a single publication semantics.

get_assetsGet AssetsA
Read-onlyIdempotent

Returns AESO market asset registry records with optional filters for asset ID, pool participant, operating status, and asset type. Results may be truncated by the limit parameter.

Inputs: request (required). Returns: AESO asset registry response.

get_dispatch_down_serviceGet Dispatch Down ServiceA
Read-onlyIdempotent

Returns bounded official AESO Dispatch Down Service availability publications. DDS is distinct from energy-market dispatch and metered generation.

Inputs: request (required). Returns: page, records, metadata, warnings

get_energy_merit_orderGet Energy Merit OrderA
Read-onlyIdempotent

Returns one historical AESO Energy Merit Order report date as paginated offer blocks. Reports are released with a 60-day delay. Prices are CAD/MWh and volumes are MW; timestamps use America/Edmonton.

Inputs: request (required). Returns: Paginated historical energy-merit-order blocks.

get_ffr_net_scheduleGet Ffr Net ScheduleA
Read-onlyIdempotent

Returns the bounded official FFR Net Schedule archive. AESO defines scheduled imports as negative and exports as positive; this is not FFR offered or dispatched.

Inputs: request (required). Returns: page, metadata, warnings, intervals

get_forecastGet ForecastA
Read-onlyIdempotent

Returns typed official AESO actual and forecast observations over [start, end) for AIL, Pool Price, wind, solar, or combined wind/solar where the requested source horizon exists.

Inputs: request (required). Returns: Paginated official forecast observations with source metadata.

get_generationGet GenerationA
Read-onlyIdempotent

Returns Alberta generation data. Omit start/end for the current fuel-mix snapshot (all fuels, MW). Provide start and end for historical wind and solar hourly generation. Renewable share uses wind + solar + hydro over total generation.

Inputs: request (required). Returns: Generation / fuel-mix response.

get_generation_capacityGet Generation CapacityA
Read-onlyIdempotent

Returns hourly AIES maximum and available generation capability plus operating and mothball outages by fuel class. The inclusive date range is bounded to 31 days; values are MW and output is paginated.

Inputs: request (required). Returns: Paginated generation capability and outage observations.

get_historical_generationGet Historical GenerationA
Read-onlyIdempotent

Returns official AESO CSD individual-asset generation over [start, end), at hourly or five-minute resolution. Supports bounded asset/fuel filters and pagination. This operational CSD archive is not settlement-metered data.

Inputs: request (required). Returns: Bounded individual-asset historical generation results.

get_historical_store_statusGet Historical Store StatusA
Read-onlyIdempotent

Reports local DuckDB/Parquet coverage, detected cadence gaps, source-file and partition counts, schema version, and whether optional storage dependencies are installed.

Inputs: no named parameters. Returns: Read-only status for the configured historical store.

get_interchangeGet InterchangeA
Read-onlyIdempotent

Returns current Alberta interchange flows by path in MW, including net interchange. Positive/negative path signs follow AESO Current Supply Demand conventions.

Inputs: no named parameters. Returns: Current interchange flows.

get_intertie_capabilityGet Intertie CapabilityA
Read-onlyIdempotent

Returns hourly import/export ATC, TTC, reliability margins, and gross offers for AESO interties and flowgates. Supports hour-ending bounds and optional versioned reports; date ranges are limited to 100 days and output is paginated.

Inputs: request (required). Returns: Paginated intertie capability observations.

get_intertie_outagesGet Intertie OutagesA
Read-onlyIdempotent

Returns outages affecting AESO interties or flowgates for an inclusive date range. Includes affected paths and event boundaries in America/Edmonton; output is paginated.

Inputs: request (required). Returns: Paginated outages affecting intertie capability.

get_loadGet LoadA
Read-onlyIdempotent

Returns Alberta Internal Load (AIL) observations in MW for [start, end). Optionally includes load forecast values when available. Timestamps are America/Edmonton. Maximum range: 90 days.

Inputs: request (required). Returns: Alberta Internal Load observations in MW.

get_load_outage_forecastGet Load Outage ForecastA
Read-onlyIdempotent

Returns AESO hourly load-outage forecast observations in MW for an inclusive, maximum 31-day range. Timestamps use America/Edmonton and output is paginated.

Inputs: request (required). Returns: Paginated load-outage forecast observations.

get_long_range_transmission_outagesGet Long Range Transmission OutagesA
Read-onlyIdempotent

Returns Long Range Significant Transmission Outages covering ~24 months ahead. Entries may be tentative and not AESO-approved (approval_status=tentative). Do not confuse with get_approved_transmission_outages.

Inputs: request (required). Returns: Transmission outage observations from a single publication semantics.

get_market_snapshotGet Market SnapshotA
Read-onlyIdempotent

Returns a cohesive current-state view of the Alberta electricity market including recent pool price, system marginal price, Alberta Internal Load, generation by fuel, net interchange, and operating reserves. Units: prices CAD/MWh, power MW. Timezone: America/Edmonton.

Inputs: no named parameters. Returns: Cohesive current-state view of the Alberta electricity market.

get_metered_volumesGet Metered VolumesA
Read-onlyIdempotent

Returns hourly AESO metered energy in MWh by asset. Filter by up to 20 asset IDs or 20 pool-participant IDs (not both); unfiltered requests are limited to 16 days and all output is paginated.

Inputs: request (required). Returns: Paginated metered-volume observations.

get_monthly_cumulative_net_revenueGet Monthly Cumulative Net RevenueA
Read-onlyIdempotent

Returns the current AESO Monthly Cumulative Settlement Interval Net Revenue (MCSINR) public report. Includes cumulative CAD vs 1/6 annualized unavoidable costs and whether the secondary offer price limit trigger has been reached. Timestamps: America/Edmonton hour-ending intervals.

Inputs: request (required). Returns: Monthly Cumulative Settlement Interval Net Revenue publication.

get_operating_reserve_activationsGet Operating Reserve ActivationsA
Read-onlyIdempotent

Returns hourly standby operating-reserve activation volume and volume-weighted activation price for an inclusive market-date range.

Inputs: request (required). Returns: page, metadata, warnings, intervals

get_operating_reserve_forecastGet Operating Reserve ForecastA
Read-onlyIdempotent

Returns the current public seven-day hourly forecast of active and standby regulating, spinning, and supplemental operating-reserve volumes in MW.

Inputs: request (required). Returns: page, metadata, warnings, intervals

get_operating_reserve_offer_controlGet Operating Reserve Offer ControlA
Read-onlyIdempotent

Returns one historical AESO Operating Reserve Offer Control report date as paginated blocks. Reports are released with a 60-day delay; prices are CAD/MWh, volumes are MW, and timestamps use America/Edmonton.

Inputs: request (required). Returns: Paginated historical operating-reserve offer-control blocks.

get_operating_reserve_pricesGet Operating Reserve PricesA
Read-onlyIdempotent

Returns daily active and standby operating-reserve price components and volumes by regulating, spinning, or supplemental product and time block. Active price, standby premium, activation strike, and clearing blended price remain distinct.

Inputs: request (required). Returns: page, metadata, warnings, intervals

get_outagesGet OutagesA
Read-onlyIdempotent

Returns hourly AESO generator outage capacity by technology/fuel for [start, end) (Total Outage MW plus per-fuel components). Timestamps: America/Edmonton. For transmission planned outages use get_approved_transmission_outages or get_long_range_transmission_outages.

Inputs: request (required). Returns: Hourly generator outage capacity by technology/fuel.

get_pool_pricesGet Pool PricesA
Read-onlyIdempotent

Returns actual AESO hourly Pool Price observations in CAD/MWh for the requested market interval [start, end). Use get_system_marginal_prices for minute-level real-time pricing. Timestamps are America/Edmonton. Maximum range: 366 days.

Inputs: request (required). Returns: Hourly Pool Price observations in CAD/MWh.

get_price_duration_curveGet Price Duration CurveA
Read-onlyIdempotent

Returns an evenly sampled Pool Price duration curve sorted from highest to lowest with exceedance percentages over [start, end).

Inputs: request (required). Returns: points, metadata, warnings, observation_count

get_price_statisticsGet Price StatisticsA
Read-onlyIdempotent

Calculates count, mean, median, range, population standard deviation, negative/high price hours, and requested percentiles from complete hourly Pool Price observations.

Inputs: request (required). Returns: metadata, warnings, percentiles, observation_count, +7 more

get_reservesGet ReservesA
Read-onlyIdempotent

Returns current AESO operating reserve indicators in MW, including contingency reserve required/dispatched and fast frequency response volumes when published.

Inputs: no named parameters. Returns: Current operating reserve conditions.

get_secondary_offer_price_limitGet Secondary Offer Price LimitA
Read-onlyIdempotent

Returns the current AESO Secondary Offer Price Limit public report: whether the secondary offer cap is in effect and the CAD/MWh limit when posted. A null limit means the cap is not in effect.

Inputs: request (required). Returns: Secondary Offer Price Limit publication.

get_supply_adequacyGet Supply AdequacyA
Read-onlyIdempotent

Returns the official AESO hourly Supply Adequacy and Market Supply Cushion status bands. These published categorical metrics are distinct from the derived assess_supply_tightness screening label.

Inputs: request (required). Returns: Paginated AESO supply-adequacy and market-supply-cushion rows.

get_supply_surplusGet Supply SurplusA
Read-onlyIdempotent

Returns official AESO hourly Supply Surplus status observations. Zero-price states are forecasts/statuses; they are not inferred from observed Pool Price.

Inputs: request (required). Returns: Paginated supply-surplus status rows from the AESO named report.

get_system_eventsGet System EventsA
Read-onlyIdempotent

Returns bounded official AIES Event Log messages with a deterministic descriptive classification. Raw published comments remain authoritative and no event end is inferred.

Inputs: request (required). Returns: page, records, metadata, warnings

get_system_marginal_pricesGet System Marginal PricesA
Read-onlyIdempotent

Returns AESO System Marginal Price (SMP) observations in CAD/MWh with minute-level interval boundaries for [start, end). Prefer get_pool_prices for hourly settlement prices. Timestamps are America/Edmonton. Maximum range: 7 days.

Inputs: request (required). Returns: Minute-level System Marginal Price observations in CAD/MWh.

get_tmr_reference_priceGet Tmr Reference PriceA
Read-onlyIdempotent

Returns the official AESO Transmission Must-Run reference price by effective date; the published value is returned without independent recomputation.

Inputs: request (required). Returns: page, records, metadata, warnings

get_uc_settlement_summaryGet Uc Settlement SummaryA
Read-onlyIdempotent

Returns the public AESO hourly Unit Commitment settlement amount in CAD and charged volume in MW for an inclusive market-date range.

Inputs: request (required). Returns: Public UC settlement summary results.

get_unit_commitmentsGet Unit CommitmentsA
Read-onlyIdempotent

Returns AESO generating-unit commitment directives for an inclusive date range, paginated and bounded to 31 days. Includes issue, begin, operation-start, and operation-end timestamps in America/Edmonton.

Inputs: request (required). Returns: Paginated unit-commitment directives.

summarize_market_historySummarize Market HistoryA
Read-onlyIdempotent

Returns compact hourly, daily, weekly, or monthly Pool Price statistics and optional Alberta Internal Load statistics for [start, end). Use this before requesting raw series for long periods; summaries are capped at 400 buckets.

Inputs: request (required). Returns: Compact historical market summary suitable for agent context windows.

summarize_operating_reserve_marketSummarize Operating Reserve MarketB
Read-onlyIdempotent

Summarizes active prices or standby clearing blended prices and volumes by reserve product; optionally joins standby activations using volume-weighted activation price.

Inputs: request (required). Returns: results, metadata, warnings, methodology

sync_historical_storeSync Historical StoreA
Idempotent

Incrementally ingests selected AESO generation, pool-price, and load datasets into the configured local DuckDB index and partitioned Parquet snapshots. Reports gaps and duplicate source observations and refreshes preliminary intervals. Requires the optional analytics dependencies.

Inputs: request (required). Returns: Incremental ingestion outcome and provenance.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 57 tools

    Disambiguation3/5

    The descriptions are unusually careful about distinguishing related reports, but the 57-tool surface contains dense clusters with overlapping semantics: get_generation/historical_generation/capacity, get_outages/generation_capacity/outage_impact, and supply_adequacy/supply_surplus/assess_supply_tightness/analyze_supply_surplus_eents. An agent could easily select the wrong tool despite the disclaimers, especially among the many analyze_* and summarize_* helpers.

    Naming Consistency5/5

    Every tool follows snake_case verb_noun (or verb_adjective_noun) naming: get_, analyze_, calculate_, compare_, summarize_, assess_, explain_, find_, sync_. Acronyms like uc, ffr, and tmr are used consistently within the same pattern. No camelCase or mixed verb styles appear.

    Tool Count2/5

    57 tools is far beyond the 25+ threshold and will cause selection overhead even if the AESO domain is broad. Many tools could be consolidated behind parameters, such as one outages tool with a type flag, one operating-reserve tool with a report type, or one supply-status tool with an official/derived flag. The set feels like a full REST report catalog rather than a curated MCP surface.

    Completeness4/5

    The set covers the core AESO market surface very thoroughly: prices, load, generation, outages, interties, operating reserves, forecasts, settlements, and analytics. Obvious minor gaps exist, such as historical interchange flows and some single-date report lookups, but agents can usually work around these with existing tools.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      F
      maintenance
      One-call Australian energy-market plumbing via AEMO — cited, structured responses for market data and analysis, not a data broker.
      5
      196 PyPI
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Connects AI agents to energy infrastructure with 30+ tools for managing sites, assets, dispatch, settlements, compliance, and carbon tracking.
      34
      50 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for Kardashev Labs US grid data, giving agents live LMP, carbon intensity, load, curtailment, interconnection queues, ERCOT large loads, and the public RT-DA spread forecast track record. Requires no API key.
      11
      37 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables access to real-time electricity data for a 15-state US region plus Manitoba: fuel mix, five-minute wholesale prices, binding transmission constraints, load and forecasts, and wind/solar output. Can run as a remote MCP endpoint or a local stdio server with no authentication.
      77 npm
      MIT