# LMP price snapshot (`lmp_snapshot`)

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

Locational marginal price (LMP) snapshot for one ISO market from Load Factor's latest price pull.

`view` picks the node list: negative (nodes with sub-zero prices in the 24 h window ending at the last loaded interval, most negative hours first), highest / lowest (price at that interval), congested (largest average congestion component), or node (name search; a single match also returns its hourly price shape). Each node carries its lmp, energy, congestion and losses ($/MWh; ERCOT has LMP only) at the last loaded interval with timestamp, 24 h average/min/max and negative hours. The ISO summary covers every node priced at that interval (count, average, median, min/max; view=negative adds the ISO-wide share of node-hours below $0), plus the fetch time and a stale flag.

Returns {summary, iso, market, view, iso_summary, freshness, matching_nodes, nodes, hourly_series, caveats}: `nodes` are the ranked rows (latitude/longitude only for precisely placed nodes), `hourly_series` is up to 48 hourly lmp/congestion points for a single view=node match, and `freshness` gives `last_fetched`, `age_hours` and `stale`. Empty keys are dropped; PJM, or SPP day-ahead, returns only a summary with `prices: "none"`.

`market` is the price run (DA or RT), not the ISO: the ISO goes in `iso`. Data is a one-day snapshot, not a history, and may be days old (check `freshness`). Day-ahead is the default (SPP has real-time only); PJM prices are not loaded; WEIM is open to all-ISO plans only. For prices near a specific project or point use grid_context.

## Parameters

| Parameter | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `iso` | string | yes | Market: MISO, ERCOT, SPP, CAISO, NYISO, ISO-NE, WEIM (PJM has no prices). |  |  |
| `market` | string | no | Price run (not the ISO; the ISO goes in `iso`): DA = day-ahead hourly, RT = real-time 5-minute. Default DA (RT for SPP). | DA, RT |  |
| `view` | string | no | negative = nodes with sub-zero prices in the window; highest / lowest = price at the last loaded interval; congested = largest average congestion; node = search by `node`. | negative, highest, lowest, congested, node | negative |
| `node` | string | no | Node name substring, for view=node (e.g. 'HB_NORTH', 'ALTW.BLKHKLDC'). |  |  |
| `limit` | integer | no | Nodes to return (max 50). |  | 15 |

## Example

Ask your assistant: "Which MISO pricing nodes had negative day-ahead prices in the latest snapshot?"

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": "lmp_snapshot",
    "arguments": {
      "iso": "MISO",
      "view": "negative"
    }
  }
}
```

## Availability

Listed to accounts with the LMP Tracker 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).
