`query_dataset`

Pack: elexon · Endpoint: https://gateway.pipeworx.io/elexon/mcp

Fetch records from any of the 84 Elexon BMRS Insights datasets by its dataset code (MID market index/day-ahead prices, FUELHH generation by fuel, WINDFOR wind forecast, FREQ system frequency, TEMP temperature, REMIT outages, BOD/BOALF balancing bids and acceptances, and 77 more — call elexon_list_datasets for the directory). Pass a code and a datetime window; the correct window parameters for that dataset are chosen automatically. Keyless. Returns the raw records.

Parameters

Name	Type	Required	Description
`dataset`	string	yes	Dataset code, case-insensitive, e.g. “MID”, “FUELHH”, “WINDFOR”, “FREQ”, “REMIT”. Use elexon_list_datasets to find one; an unrecognised code is rejected with the full list rather than passed upstream.
`from`	string	yes	Window start, ISO datetime. For settlement-date datasets (B1610, MDB, MDO, PN, QPN, TUDM) this is the settlement date and settlement_period is also required.
`to`	string	yes	Window end, ISO datetime. Ignored for settlement-date datasets.
`settlement_period`	number	no	Settlement period 1-48. Required only for the settlement-date datasets B1610, MDB, MDO, PN, QPN and TUDM, which Elexon serves one period at a time.
`date_param`	string	no	Rarely needed — the window style is looked up per dataset. Pass “publishDateTime”, “from”, “settlement” (settlementDateFrom/To, which only FUELHH and FUELINST accept), “settlementDate”, “measurement” or “submission” only to override that lookup.

Example call

Arguments

{
  "dataset": "FUELHH",
  "from": "2026-08-27T00:00Z",
  "to": "2026-08-27T02:00Z"
}

curl

curl -X POST https://gateway.pipeworx.io/elexon/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"query_dataset","arguments":{"dataset":"FUELHH","from":"2026-08-27T00:00Z","to":"2026-08-27T02:00Z"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('query_dataset', {
  "dataset": "FUELHH",
  "from": "2026-08-27T00:00Z",
  "to": "2026-08-27T02:00Z"
});

More examples

{
  "dataset": "MID",
  "from": "2026-08-27T00:00Z",
  "to": "2026-08-27T02:00Z"
}

{
  "dataset": "PN",
  "from": "2026-08-27",
  "to": "2026-08-27",
  "settlement_period": 5
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "elexon": {
      "url": "https://gateway.pipeworx.io/elexon/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

query_dataset