Skip to content
Load Factor Docs
Open Load Factor

MCP Tool

State & market fundamentals

State and market fundamentals for offtake and siting screens.

  • MCP
  • Read-only
  • Updated

Declaration

MCP tool
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:

It would call the tool with a request like this one (your client builds and sends it for you):

tools/call request
{
  "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.