Skip to content
Load Factor Docs
Open Load Factor

MCP Tool

Queue statistics

Counts and capacity of renewable queue projects grouped by one dimension, optionally pivoted by a second one.

  • MCP
  • Read-only
  • Updated

Declaration

MCP tool
queue_stats(
    group_by: string,
    second_group_by?: string,
    iso?: string,
    state?: string,
    fuel?: string,
    status?: string,
    confidence?: string,
    developer?: string,
    min_mw?: number,
    max_mw?: number,
    include_duplicates?: boolean,
    sort?: string,
    limit?: integer
)

Parameters

group_bystringRequired
Dimension to group by. county groups are 'County, ST'; queue_year / in_service_year come from the queue dates; developer excludes projects with no developer; confidence groups by the web app's badge (confirmed = two sources agree, developer_of_record = named in the queue, inferred, unknown = not identified).Allowed: iso, fuel, state, county, status, confidence, developer, queue_year, in_service_year, study_cycle, project_stage
second_group_bystringOptional
Optional second dimension for a pivot (e.g. group_by=iso, second_group_by=fuel).Allowed: iso, fuel, state, county, status, confidence, developer, queue_year, in_service_year, study_cycle, project_stage
isostringOptional
ISO/region, or comma-separated list: PJM, MISO, ERCOT, SPP, CAISO, NYISO, ISO-NE, West, Southeast, IESO, AESO, Maritimes, Quebec, BC, Saskatchewan, Manitoba.
statestringOptional
Two-letter state/province code(s), comma-separated, e.g. 'TX' or 'IL,IN'.
fuelstringOptional
Fuel(s), comma-separated: Solar, Wind, Offshore Wind, Battery Storage, Hybrid, Hydro, Biomass, Biogas, Biofuel, Wood, Geothermal.
statusstringOptional
Queue status filter. live (default) = not withdrawn/suspended, INCLUDING projects already operating/in service; in_queue = not withdrawn and not yet operating (the development pipeline); operating = in service; withdrawn = withdrawn/suspended/cancelled; all = everything.Allowed: in_queue, live, withdrawn, operating, allDefault: live
confidencestringOptional
confirmed = two sources agree: two or more independent strong records name the developer; developer_of_record = named in the queue: the grid operator's queue names it and nothing else strong does yet; any_developer = a developer is named at any confidence; unknown = not identified: no developer identified; all (default).Allowed: confirmed, developer_of_record, any_developer, unknown, allDefault: all
developerstringOptional
Developer / SPV / owner name (substring). Use find_companies first to see name variants.
min_mwnumberOptional
Minimum summer MW.
max_mwnumberOptional
Maximum summer MW.
include_duplicatesbooleanOptional
Include PJM duplicate rows (the older '<id>' row whose queue position moved to '<id> - moved to TC1/TC2', and '<id> <number>' copies of '<id>-<number>'). Default false so counts and MW are not double-counted.Default: false
sortstringOptional
Group order: auto (default) = chronological for year groupings, else most projects; projects; mw; group = alphabetical.Allowed: auto, projects, mw, groupDefault: auto
limitintegerOptional
Groups (rows) to return, max 100.Default: 25

Return Value

Returns {summary, group_by, second_group_by, totals, groups_total, groups, filters, caveats}.

Discussion

Counts and capacity of renewable queue projects grouped by one dimension (iso, fuel, state, county, status, confidence, developer, queue_year, in_service_year, study_cycle, project_stage), optionally pivoted by a second one. Each group returns projects, total MW, average MW, the count where two sources agree on the developer (confirmed_developer) and the share with any developer named; overall totals are computed over every matching project.

Takes the same filters as search_projects. Default status='live' = not withdrawn, INCLUDING operating plants (totals report how many are operating); use status='in_queue' for the not-yet-built pipeline, status='operating' for built plants, or status='all' (with group_by=status) to see the status mix. PJM duplicate rows are excluded unless include_duplicates=true. study_cycle is only populated for MISO.

Returns {summary, group_by, second_group_by, totals, groups_total, groups, filters, caveats}. Each groups row has group (and subgroup when pivoted), projects, mw, avg_mw, confirmed_developer and pct_with_developer; a missing value reads '(not reported)'. groups_total counts every group even when limit shows fewer. MW in West, Southeast and CAISO is approximate (bucketed) and PJM MW is capacity (CIR) MW; caveats says which apply.

Use this for "how many / how much MW" questions; use search_projects to list the projects themselves.

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": "queue_stats",
    "arguments": {
      "group_by": "developer",
      "iso": "MISO",
      "fuel": "Solar",
      "limit": 10
    }
  }
}

Availability

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