{
  "name": "Belgian Electricity Grid API",
  "version": "0.1.0",
  "mcp_endpoint": "https://grid.physicstom.com/mcp",
  "rest": [
    {
      "path": "/api/get_grid_snapshot",
      "params": [],
      "description": "Current state of the Belgian electricity grid in one call: day-ahead price now (EUR/MWh and EUR/kWh), imbalance price, total load, solar, wind, cross-border flows (import/export), latest generation mix and CO2 intensity. Every value has its own timestamp and age_minutes. Use this for 'what is the price now?', 'is Belgium importing?', 'how much solar right now?'."
    },
    {
      "path": "/api/get_day_ahead_prices",
      "params": [
        "start",
        "end",
        "interval"
      ],
      "description": "Wholesale day-ahead electricity prices for Belgium (EUR/MWh and EUR/kWh) from ENTSO-E (or Energy-Charts when ENTSO-E is not configured or fails; see data_source), quarter-hourly since Oct 2025. Includes tomorrow once published (~13:00 Brussels). Returns a time series ready to plot plus min/avg/max. Not a household tariff."
    },
    {
      "path": "/api/get_cheapest_hours",
      "params": [
        "date",
        "hours",
        "contiguous",
        "most_expensive"
      ],
      "description": "Find the cheapest (or most expensive) time on a given day by day-ahead price, e.g. 'best 3 hours to charge my car tomorrow'. contiguous=true gives one block; false gives the N cheapest slots."
    },
    {
      "path": "/api/get_imbalance_prices",
      "params": [
        "start",
        "end",
        "interval"
      ],
      "description": "Belgian imbalance (real-time balancing) price per quarter-hour in EUR/MWh, plus system imbalance in MW, from Elia. Live (updated every 15 min). Data from 22/05/2024. Very volatile; not the day-ahead price."
    },
    {
      "path": "/api/get_generation_mix",
      "params": [
        "start",
        "end",
        "interval",
        "source"
      ],
      "description": "Electricity generation in Belgium by source (nuclear, gas, wind offshore/onshore, solar, biomass, waste, hydro, pumped storage, batteries, oil, other) in MW per interval, plus energy (GWh), % shares, renewable and low-carbon share. Validated Elia data (from 2020, published daily); recent hours are filled from ENTSO-E or Energy-Charts (each point has a `source`). Good for stacked area charts and pie charts."
    },
    {
      "path": "/api/get_load",
      "params": [
        "start",
        "end",
        "interval"
      ],
      "description": "Total electricity load (demand) on the Belgian grid in MW, measured plus Elia's latest and day-ahead forecasts (up to a week ahead). From 2015. Includes energy in GWh."
    },
    {
      "path": "/api/get_solar",
      "params": [
        "start",
        "end",
        "interval"
      ],
      "description": "Solar PV generation for all of Belgium (incl. rooftop) in MW, measured plus forecasts (up to 10 days ahead), and monitored installed capacity. From Oct 2020. Includes energy in GWh."
    },
    {
      "path": "/api/get_wind",
      "params": [
        "start",
        "end",
        "interval"
      ],
      "description": "Wind generation in Belgium in MW, split offshore/onshore, measured plus forecasts (up to a week ahead), and installed capacity. From 2015. Includes energy in GWh."
    },
    {
      "path": "/api/get_cross_border_flows",
      "params": [
        "start",
        "end",
        "interval"
      ],
      "description": "Physical electricity flows between Belgium and France, the Netherlands, Germany, Luxembourg and the UK, in MW. Positive = export from Belgium, negative = import. Includes net export. Live (15 min) and history from 2015."
    },
    {
      "path": "/api/get_carbon_intensity",
      "params": [
        "start",
        "end",
        "interval"
      ],
      "description": "CO2 intensity of Belgian electricity in gCO2eq/kWh, hourly: production-based (what Belgium generates) and consumption-based (what Belgium uses, incl. imports). Official Elia values, published daily up to yesterday. From Oct 2024."
    },
    {
      "path": "/api/get_grid_frequency",
      "params": [
        "start",
        "end",
        "interval"
      ],
      "description": "Grid frequency (Hz) measured by Elia every 10 seconds, aggregated to avg/min/max per interval. About 2 days behind real time. From Nov 2025."
    },
    {
      "path": "/api/list_elia_datasets",
      "params": [
        "search"
      ],
      "description": "Search the ~110 Elia Open Data datasets (balancing, reserves, congestion, capacities, unavailability, etc.). Use with query_elia_dataset for anything the other tools do not cover."
    },
    {
      "path": "/api/query_elia_dataset",
      "params": [
        "dataset",
        "select",
        "where",
        "group_by",
        "order_by",
        "limit"
      ],
      "description": "Run an ODSQL query on any Elia Open Data dataset. Times are UTC. Example: dataset 'ods201', select 'fueltypepublication, avg(generatedpower) as mw', where \"datetime >= '2026-11-01' and datetime < '2026-11-02'\", group_by 'fueltypepublication'. Call with only `dataset` to see its fields and 5 latest rows."
    }
  ]
}