# State & market fundamentals (`market_fundamentals`)

A read-only tool of the Load Factor MCP server (https://mcp.loadfactorenergy.com/mcp), in the Grid & markets group.

State and market fundamentals for offtake and siting screens.

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.

## Parameters

| Parameter | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `state` | string | no | Two-letter US state code, e.g. 'TX'. |  |  |
| `market` | string | no | 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. |  |  |
| `zip` | string | no | 5-digit US ZIP code (solar resource; also sets the state). |  |  |
| `include` | string[] | no | Sections: retail_prices, generation_mix, load_forecast, solar_resource (a list or a comma-separated string). Default: all that the inputs support. | retail_prices, generation_mix, load_forecast, solar_resource |  |

## 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):

```json
{
  "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](https://loadfactorenergy.com/developers/mcp/access-and-permissions).
