gridstatus_query
Pack: gridstatus · Endpoint: https://gateway.pipeworx.io/gridstatus/mcp
Query 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” })
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
dataset_id | string | 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 | string | no | Optional ISO start time (rows on/after this). E.g. “2026-07-01T00:00Z” or “2026-07-01T00:00-05:00”. |
end_time | string | no | Optional ISO end time (rows before this). |
limit | number | no | Max rows to return (default 50, capped at 200). |
resample_frequency | string | no | Optional resampling bucket, e.g. “5 minutes”, “1 hour”, “1 day”. Reduces row volume for long windows. |
_apiKey | string | yes | GridStatus API key |
Example call
curl -X POST https://gateway.pipeworx.io/gridstatus/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"gridstatus_query","arguments":{}}}'Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"gridstatus": {
"url": "https://gateway.pipeworx.io/gridstatus/mcp"
}
}
}See Getting Started for client-specific install steps.