# Energy API

> Real-time and historical energy commodity prices — natural gas, electricity, crude oil, coal, EU ETS carbon allowances, and grid carbon intensity — normalized into consistent JSON.
> Authentication: `?api_key=YOUR_KEY` query parameter (not a header) on every request to energy-api.com. This MCP server also accepts `Authorization: Bearer YOUR_KEY` or `X-API-Key: YOUR_KEY`.
> Base URL: `https://energy-api.com/api/v1`
> Get a key: https://energy-api.com/register (free trial available), then https://energy-api.com/api-keys.
> MCP: `POST https://mcp.energy-api.com/mcp` (this server) — one tool per endpoint below, no catalog/search tools needed since the endpoint set is fixed.

## Endpoints

- **GET /symbols** (tool: `symbols`) — Full catalog of available price symbols, with name, category, country, currency, frequency, and description for each.
- **GET /latest** (tool: `latest`) — Most recent price for one or more symbols.
- **GET /historical** (tool: `historical`) — Price for one or more symbols on a specific past date. Falls back to the most recent value on or before that date for daily symbols (e.g. weekends/holidays); monthly symbols use the last value published within that month.
- **GET /timeseries** (tool: `timeseries`) — Historical price series between two dates for one or more symbols. The max date range is limited by the plan (see account plan tiers on the website); requests beyond it return 422.
- **GET /fluctuation** (tool: `fluctuation`) — Percent change, minimum, and maximum price over a date range, per symbol.
- **GET /ohlc** (tool: `ohlc`) — Open/high/low/close candles per symbol, bucketed weekly, monthly, or quarterly.
- **GET /electricity/latest** (tool: `electricity_latest`) — Latest day-ahead electricity price(s), optionally filtered by country. Covers day-ahead auction symbols across European and global markets (e.g. OMIE_ES_DA, EPEX_DE_DA, AEMO_NSW1_SPOT).
- **GET /electricity/hourly** (tool: `electricity_hourly`) — Intraday electricity price curve (hourly, 15-minute, or 5-minute, depending on the source) for one symbol on one date. Only symbols with intraday storage enabled are supported.
- **GET /electricity/pvpc** (tool: `electricity_pvpc`) — Hourly Spanish PVPC (Precio Voluntario para el Pequeño Consumidor) retail reference price for one date. Fixed to symbol PVPC_ES_2TD.
- **GET /gas/latest** (tool: `gas_latest`) — Latest TTF (EU) and Henry Hub (US) natural gas benchmark prices in one call. NBP (UK), JKM (Asia LNG), and AECO (Canada) are not currently sourced.
- **GET /emissions/latest** (tool: `emissions_latest`) — Latest EU ETS carbon allowance price (EUA_CO2). UK ETS is not currently sourced.
- **GET /coal/latest** (tool: `coal_latest`) — Latest Rotterdam (API2) and Newcastle thermal coal benchmark prices. COAL_ROTTERDAM may be temporarily absent if the upstream feed is unavailable.
- **GET /carbon-intensity** (tool: `carbon_intensity`) — Grid carbon intensity in gCO2eq/kWh, optionally filtered by country. Country-level series depend on the Electricity Maps provider; an EU average is sourced from Ember.
- **GET /forecast** (tool: `forecast`) — Next published day-ahead price for a symbol. Day-ahead auctions clear tomorrow's price today, so this is a deterministic lookup of the next already-published value, not a statistical model. Only supported for day-ahead-auction-sourced electricity symbols (omie, entsoe, energy_charts, esios, gridstatus providers) — not EUA_CO2 or other monthly/non-auction symbols.
- **POST /cost-estimate** (tool: `cost_estimate`) — Estimated monthly electricity cost from a kWh usage figure. MVP scope: most recent daily-average wholesale price x kWh/month. Does NOT account for retail markups, taxes, network charges, or an intraday usage profile — see methodology_note in the response.
- **GET /status** (tool: `status`) — Last fetch status (success/failure, duration, error count/message) for each upstream data provider. Useful for checking whether a given source is currently up before relying on its data.

---

For parameters, examples, and sample responses see: /llms-full.txt
Full docs: https://energy-api.com/docs
Agent auth details: https://energy-api.com/auth.md
Symbol catalog: https://energy-api.com/symbols