Skip to content
Load Factor Docs
Open Load Factor

MCP Tool

Top PPA buyers (offtakers)

Largest PPA offtakers in a market, ranked by MWh bought from sellers of the chosen sector, computed live from FERC Electric Quarterly Report settlements.

  • MCP
  • Read-only
  • Updated

Declaration

MCP tool
ppa_top_buyers(
    market: string,
    sector?: string,
    period_from?: string,
    period_to?: string,
    limit?: integer
)

Parameters

marketstringRequired
ISO (PJM, MISO, SPP, CAISO, NYISO, ISO-NE, ERCOT), region (West, Southeast) or EQR balancing-authority code(s), comma-separated, e.g. 'MISO', 'SOCO', 'PACE,PACW'. ISO names include the legacy local balancing areas inside that market (MISO includes AMIL, ALTW, NSP...).
sectorstringOptional
Seller technology (Load Factor's classification; EQR filings do not report it). all = solar + wind + storage (plus generically tagged renewable sellers), the default; 'any' and 'renewables' mean the same. Fuel names from other tools work too (Solar/PV, Battery Storage, Offshore Wind).Allowed: all, solar, wind, storage, hydroDefault: all
period_fromstringOptional
First quarter or year, e.g. '2024' or '2024Q3'; a date such as 2024-07-01 counts as its quarter. Default: 7 quarters before period_to.
period_tostringOptional
Last quarter or year, e.g. '2025' or '2025Q4'; a date counts as its whole quarter. Default: the latest quarter with data for the market.
limitintegerOptional
Buyers to return (max 50).Default: 20

Return Value

Returns {summary, market, filters, total_buyers, total_mwh, total_settlement_usd, total_sellers, buyers, data_vintage, source, caveats}: the totals cover every buyer in the market, buyers is the top limit rows (rank, share_pct, top_sellers = the three largest sellers, mwh_by_sector when sector is all).

Discussion

Largest PPA offtakers in a market, ranked by MWh bought from sellers of the chosen sector (default solar, wind and storage), computed live from FERC Electric Quarterly Report settlements. Each row has MWh, dollars, volume-weighted $/MWh, number of sellers, first and last quarter, share of the market total, a sector split and the top sellers.

EQR buyer names are not normalised ('Consumers Energy Co' vs 'CONSUMERS ENERGY COMPANY'). Rows group spellings that differ only by case, punctuation or a legal suffix, and show the most common spelling plus the variants. Parent companies are not rolled up. Sales to ISO/RTO clearinghouses (merchant sales), non-energy settlements and implausible prices or volumes are excluded. ERCOT has no EQR data.

Returns {summary, market, filters, total_buyers, total_mwh, total_settlement_usd, total_sellers, buyers, data_vintage, source, caveats}: the totals cover every buyer in the market, buyers is the top limit rows (rank, share_pct, top_sellers = the three largest sellers, mwh_by_sector when sector is all). vw_price is computed from settlement values reported in FERC EQR, not a Load Factor estimate.

Use this for "who buys wind power in SPP". Use ppa_counterparties for one buyer's or seller's relationships and ppa_price_benchmarks for price levels.

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": "ppa_top_buyers",
    "arguments": {
      "market": "PJM"
    }
  }
}

Availability

Listed to accounts with the Developer Tracker module. Results follow your Load Factor permissions (ISOs, detail level, evidence depth and rows per call). See Access & permissions.