aeso-mcp
aeso-mcp gives AI clients typed, read-only access to Alberta AESO electricity-market data, official forecasts/reports, deterministic analytics, and optional local historical storage.
Retrieve current market conditions: pool price, system marginal price, load, generation/fuel mix, interchange, and operating reserves.
Query historical AESO datasets: pool/SMP prices, load, generation, outages, capacity, interties, metered volumes, merit order, commitments, transmission outages, assets, reserve offer control, MCSINR, secondary offer limit, and UC settlement.
Access official forecasts and reports: AIL/pool-price/wind/solar forecasts, supply adequacy/surplus, FFR net schedule, DDS, TMR reference price, system events, operating-reserve prices/forecasts/activations, and research archives.
Run deterministic analytics: market summaries, period comparisons, price events/statistics/duration curves, capture prices, net load, supply stack/tightness, generation mix, asset dispatch/revenue, CSD-vs-metered comparisons, ramps, outage impact, forecast error, surplus/scarcity, participant concentration, regional load/generation, and frequency summaries.
Optionally sync and inspect a local DuckDB/Parquet historical store; most tools are read-only, while
sync_historical_storewrites only to the configured local store.Use MCP resources/prompts for glossary, dataset catalog, methodology guidance, daily market briefs, price-event investigation, and market-day comparisons.
Fetches official individual-asset Historical CSD Generation Data from AESO's Box-hosted archive, providing hourly and five-minute generation records.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@aeso-mcp What is Alberta's current grid situation?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 clientsCurrent 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_forecastcontract, with persisted publication vintages and point-in-timeas_ofselection that excludes unknown publication chronologyOfficial 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_KEYis always required; there is no reduced credential-free server modeQuery bounds, cache provenance, completeness metadata, upstream
Retry-Afterhandling, and secret-safe machine-readable errorsHardened 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 |
| Current cohesive view |
Pool Price |
| Hourly CAD/MWh |
System Marginal Price |
| Minute-level CAD/MWh |
Alberta Internal Load |
| MW; optional forecast |
Generation / fuel mix |
| Current all fuels; historical wind/solar |
Interchange |
| Current path flows MW |
Operating reserves |
| Current MW indicators |
Generator outages |
| Hourly outage capacity by fuel/technology |
AIES capacity/outages |
| Hourly MC, AC, operating, and mothball outage MW |
Load outage forecast |
| Hourly forecast MW |
Energy Merit Order |
| Historical blocks; 60-day publication delay |
Unit commitments |
| Generating-unit commitment directives |
Intertie capability |
| Import/export ATC, TTC, margins, gross offers |
Intertie capability outages |
| Outages affecting interties/flowgates |
Metered volumes |
| Hourly MWh by asset; optional ID filters |
OR offer control |
| Historical reserve offer blocks; 60-day delay |
Approved Tx outages |
| AESO-approved planned transmission outages |
Long-range Tx outages |
| Tentative ~24-month significant outages |
MCSINR |
| Cumulative net revenue vs offer-cap trigger |
Secondary offer limit |
| Whether secondary offer cap is in effect |
Assets |
| Registry with filters |
Historical CSD generation |
| Individual assets; hourly / five-minute operational MW |
Official forecasts |
| AIL / Pool Price / wind / solar; source-specific horizons and cadence |
Official research archive |
| Historical adequacy/cushion, transmission, planning-area, constraint, EEA, OR-directive, and current participant records |
Supply adequacy / cushion |
| Official hourly categorical status bands |
Supply surplus |
| Official hourly zero-price forecast status |
FFR Net Schedule |
| Hourly scheduled imports (negative) / exports (positive) MW |
Dispatch Down Service |
| Published DDS availability MW |
TMR reference price |
| Published CAD/MWh value by effective date |
AIES system events |
| Bounded event-log comments; no inferred event end |
UC settlement summary |
| Hourly CAD amount and charged MW |
OR prices |
| Active and standby price components and volumes |
OR forecast |
| Current seven-day hourly MW forecast |
OR 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 gatewayDomain 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
Python 3.13+
AESO APIM API key from developer-apim.aeso.ca
uvrecommended
Installation
See LIMITATIONS.md for an honest gap inventory.
From PyPI (recommended)
export AESO_API_KEY=your-key
uvx aeso-mcpFor incremental DuckDB/Parquet historical storage:
uvx --from 'aeso-mcp[analytics]' aeso-mcpFrom 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-mcpDevelopment
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-mcpDocker
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-mcpSend 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
Register at the AESO developer portal
Subscribe to the AESO public API product
Copy the primary/secondary subscription key
Set
AESO_API_KEYin 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 8000HTTP 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 |
| Current market overview |
| Hourly Pool Price history |
| Minute-level SMP history |
| Alberta Internal Load |
| Fuel mix / renewable history |
| Intertie flows |
| Operating reserve indicators |
| Hourly generator outage capacity by fuel |
| AIES capability and outage grouping by fuel |
| Hourly load-outage forecast |
| Historical energy merit-order blocks |
| Generating-unit commitment directives |
| Intertie/flowgate ATC, TTC, and margins |
| Outages affecting intertie capability |
| Metered energy by asset |
| Historical reserve offer-control blocks |
| Approved planned transmission outages |
| Tentative long-range transmission outages |
| Asset registry |
| Current MCSINR publication |
| Current secondary offer-cap status |
| Aggregate period comparison |
| High-price event detection |
| Structured evidence (not causal prose) |
| AIL forecast vs actual accuracy |
| Compact hourly/daily/weekly/monthly price and load summaries |
| Transparent reserve-adjusted supply-margin screening |
| Official individual-asset CSD archive history |
| Incremental local DuckDB/Parquet ingestion |
| Local coverage, manifests, and partition status |
| Official AIL, Pool Price, wind, solar, and combined wind/solar forecasts |
| Bounded page from one verified official historical/spatial/reliability archive |
| Official supply-adequacy and market-supply-cushion status bands |
| Official hourly supply-surplus forecast status |
| Historical scheduled FFR intertie transfer |
| Dispatch Down Service availability report |
| Published TMR reference price |
| Bounded AIES Event Log messages |
| Public hourly UC amount and charged volume |
| Price distribution and volatility statistics |
| Pool Price exceedance curve |
| Focus versus baseline multi-series associations |
| Generation-weighted price and capture rate |
| AIL minus selected renewable generation |
| Historical offer-stack analysis |
| Gross-offer to capability proxy |
| CSD energy and share by fuel |
| Asset output, capacity factor, and ramps |
| Hourly outage-price association |
| General forecast error, percentiles, market-hour and lead-time profiles |
| Metered MWh × Pool Price gross energy revenue |
| Operational CSD output versus metered MWh |
| Cadence-aware AIL, net-load, renewable, or asset ramps |
| Price/load/renewable associations during explicit surplus states |
| Active/standby price components and volumes |
| Seven-day reserve-volume forecast |
| Hourly standby activations |
| Product price/volume/activation summary |
| Offered-volume shares and HHI using current participant mapping |
| Planning-area and regional load/generation aggregates |
| Planning-area/fuel constrained MWh and optional price association |
| Historical adequacy/cushion web codes, EEA, and price context |
| 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 |
| Market terminology |
| Dataset catalog |
| Pool Price interpretation |
| SMP interpretation |
| Complete tool, prompt, and resource surface |
| 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_ofselects 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
pagemetadata withnext_offset. Usesummarize_market_historybefore retrieving long raw series.Cache timing:
retrieved_atidentifies the upstream fetch;served_at,cache_hit, andcache_ageidentify when and how the response was served.Research identity:
analyze_market_event.analysis_manifestrecords exact sources, parameters, methodology version, warnings, and a deterministic SHA-256analysis_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 buildOptional live tests:
AESO_API_KEY=... uv run pytest tests/integration -m integrationMCP Inspector:
# Prefer the console entrypoint; or point Inspector at:
# uv run aeso-mcp
npx @modelcontextprotocol/inspector uv run aeso-mcpTests
tests/unit— time, bounds, analytics, configtests/contract— AESO APIM fixtures viarespxtests/mcp— tool/resource discovery and structured outputstests/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 toolsanalyze_asset_dispatchAnalyze Asset DispatchBRead-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 ErrorARead-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 MixARead-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 UtilizationARead-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 EventARead-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 LoadARead-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 ImpactBRead-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 RampsARead-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 StackBRead-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 EventsARead-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 TightnessARead-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 RevenueARead-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 PricesARead-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 MeteredARead-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 ActualARead-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 PeriodsARead-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 ConditionsARead-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 EventsARead-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 OutagesARead-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 AssetsARead-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 ServiceARead-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 OrderARead-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 ScheduleARead-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 ForecastARead-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 GenerationARead-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 CapacityARead-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 GenerationARead-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 StatusARead-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 InterchangeARead-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 CapabilityARead-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 OutagesARead-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 LoadARead-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 ForecastARead-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 OutagesARead-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 SnapshotARead-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 VolumesARead-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 RevenueARead-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 ActivationsARead-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 ForecastARead-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 ControlARead-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 PricesARead-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 OutagesARead-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 PricesARead-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 CurveARead-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 StatisticsARead-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 ReservesARead-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 LimitARead-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 AdequacyARead-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 SurplusARead-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 EventsARead-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 PricesARead-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 PriceARead-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 SummaryARead-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 CommitmentsARead-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 HistoryARead-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 MarketBRead-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 StoreAIdempotent
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
Scored across 57 tools
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.
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.
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.
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
Related MCP Connectors
Live US power market prices, load, generation, weather and permits for AI agents.
Read-only energy market data: ISO prices, load, generation, regulatory dockets and weather.
Protocol-native energy infrastructure orchestration for AI data centers. Provides 46 MCP tools across 8 grid protocols (IEC-61850, DNP3, Modbus, OCPP, OpenADR, IEEE 2030.5, IEC 60870-5-104, ICCP) with 5 core API primitives: connect, dispatch, settle, comply, and intel. Enables AI agents to programmatically interact with substations, grid interfaces, and energy assets for real-time workload-grid coordination.
Query Australia's electricity market (NEM/AEMO): prices, generation, FCAS, interconnectors, bids.
Related MCP Servers
- AlicenseAqualityFmaintenanceOne-call Australian energy-market plumbing via AEMO — cited, structured responses for market data and analysis, not a data broker.5196 PyPIMIT
- AlicenseBqualityDmaintenanceConnects AI agents to energy infrastructure with 30+ tools for managing sites, assets, dispatch, settlements, compliance, and carbon tracking.3450 npm1MIT

kardashev-mcpofficial
AlicenseAqualityCmaintenanceMCP 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.1137 npmMIT- AlicenseNot gradedqualityCmaintenanceEnables 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 npmMIT