Gridstatus Query
gridstatus_queryQuery a grid dataset's time-series over a time window. Pass a dataset_id from gridstatus_datasets. Common ids: caiso_lmp_real_time_5_min, ercot_load, pjm_fuel_mix. Example: gridstatus_query({ dataset_id: "caiso_lmp_real_time_5_min", start_time: "2026-07-01T00:00Z", end_time: "2026-07-01T06:00Z", limit: 100, _apiKey: "your-key" })
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"limit": 100,
"_apiKey": "your-gridstatus-api-key",
"end_time": "2026-07-01T06:00Z",
"dataset_id": "caiso_lmp_real_time_5_min",
"start_time": "2026-07-01T00:00Z"
},
"name": "gridstatus_query"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows to return (default 50, capped at 200). | |
| _apiKey | Yes | GridStatus API key | |
| end_time | No | Optional ISO end time (rows before this). | |
| dataset_id | Yes | Dataset id to query, e.g. "caiso_lmp_real_time_5_min", "ercot_load", "pjm_fuel_mix". Discover ids via gridstatus_datasets. | |
| start_time | No | Optional ISO start time (rows on/after this). E.g. "2026-07-01T00:00Z" or "2026-07-01T00:00-05:00". | |
| resample_frequency | No | Optional resampling bucket, e.g. "5 minutes", "1 hour", "1 day". Reduces row volume for long windows. |