`query_dataset`

Pack: elexon · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/query_dataset for the schema, then POST the same URL with its arguments for the data.

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 — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the elexon pack

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

See Getting Started for client-specific install steps.

query_dataset