hourly_intensity
Get hourly grid carbon intensity (kg CO2e per kWh) for any US ZIP code, derived from EIA-930 hourly fuel-mix data. Data lags up to about a day (not real-time). Returns time series with per-hour fuel mix, total generation, and carbon intensity. For timing and analysis (demand response, load shifting, grid patterns), not inventory reporting: it uses fixed per-fuel combustion factors on in-BA generation (no imports), so its values don't match eGRID's annual factors. For live or forecast intensity, WattTime or Electricity Maps are better options.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "hourly_intensity"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ba | No | Balancing authority code directly (e.g. CISO, ERCO, PJM, MISO, NYIS). Use this OR zip. | |
| zip | No | 5-digit US ZIP code (or use ba parameter) | |
| hours | No | Number of most recent hours to return (default 24, max 168 = 1 week). | |
| aggregate | No | Optional: return the 24-hour average profile over the last 7 days (168 hours) instead of the hourly series. Buckets are UTC hours; for a local-time scheduling window use cleanest_hours. |