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