Skip to content
Load Factor Docs
Open Load Factor

MCP Tool

LMP price snapshot

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

  • MCP
  • Read-only
  • Updated

Declaration

MCP tool
lmp_snapshot(
    iso: string,
    market?: string,
    view?: string,
    node?: string,
    limit?: integer
)

Parameters

isostringRequired
Market: MISO, ERCOT, SPP, CAISO, NYISO, ISO-NE, WEIM (PJM has no prices).
marketstringOptional
Price run (not the ISO; the ISO goes in iso): DA = day-ahead hourly, RT = real-time 5-minute. Default DA (RT for SPP).Allowed: DA, RT
viewstringOptional
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.Allowed: negative, highest, lowest, congested, nodeDefault: negative
nodestringOptional
Node name substring, for view=node (e.g. 'HB_NORTH', 'ALTW.BLKHKLDC').
limitintegerOptional
Nodes to return (max 50).Default: 15

Return Value

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.

Discussion

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.

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": "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.