MCP Tool
State & market fundamentals
State and market fundamentals for offtake and siting screens.
- MCP
- Read-only
- Updated
Declaration
market_fundamentals(
state?: string,
market?: string,
zip?: string,
include?: string[]
)Parameters
statestringOptional- Two-letter US state code, e.g. 'TX'.
marketstringOptional- ISO (PJM, MISO, ERCOT, SPP, CAISO, NYISO, ISO-NE), EIA balancing-authority code (e.g. CISO, ERCO, SWPP) or a utility / BA name for the load forecast.
zipstringOptional- 5-digit US ZIP code (solar resource; also sets the state).
includestring[]Optional- Sections: retail_prices, generation_mix, load_forecast, solar_resource (a list or a comma-separated string). Default: all that the inputs support.Allowed:
retail_prices,generation_mix,load_forecast,solar_resource
Return Value
Returns {summary, inputs, one key per section, caveats}: each section names its source, or carries a note (sometimes available: "none") when the inputs don't support it or no data is loaded.
Discussion
Sections (default: every section the inputs support):
retail_prices: EIA average retail price (cents/kWh) by sector for a state: latest month, same month last year, trailing-12-month average and change, last 12 months. Monthly data is loaded for 11 states; the rest have the 2024 annual residential price.generation_mix: the state's operating power plants by primary fuel: capacity MW and latest annual generation with shares (EIA-860/923 plant inventory).load_forecast: FERC Form 714 peak-demand and energy forecast for an ISO, balancing authority or utility (market), latest report year, with growth rate and revision vs the prior report.solar_resource: NREL irradiance (DNI, GHI, latitude tilt) for a ZIP, or the state's range, with an indicative fixed-tilt capacity factor.
Returns {summary, inputs, one key per section, caveats}: each section names its source, or carries a note (sometimes available: "none") when the inputs don't support it or no data is loaded. Retail prices are cents/kWh with yoy_pct; the mix gives MW, TWh and shares by fuel; the forecast gives yearly summer/winter peak MW and net energy TWh; solar values are kWh/m2/day with their fetched_at date.
Pass state and/or zip for the location sections and market for the load forecast. Queue project data is in search_projects / queue_stats; plant-level data in the plant tools.
Example
Ask your assistant:
Give me the market fundamentals for Texas.
It would call the tool with a request like this one (your client builds and sends it for you):
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "market_fundamentals",
"arguments": {
"state": "TX"
}
}
}Availability
Listed to accounts with the Developer Tracker, Calculator or Map module. Results follow your Load Factor permissions (ISOs, detail level, evidence depth and rows per call). See Access & permissions.