Skip to content
Load Factor Docs
Open Load Factor

MCP Tool

Company queue rollup (one call)

One-call queue rollup for up to 10 companies.

  • MCP
  • Read-only
  • Updated

Declaration

MCP tool
get_company_queue_rollup(names: string[])

Parameters

namesstring[]Required
Company names exactly as filed, 1-10, e.g. ['Savion', 'Arevon', 'Invenergy']. One company's prospect-plus-competitors comparison in one call.

Return Value

Returns {companies, data_as_of, linkage, totals_label}: one companies row per name with matched, then either matched_variants, live / withdrawn / total projects and MW, by_iso, confidence (projects and MW per confidence label) and dominant_confidence, or a did_you_mean list.

Discussion

One-call queue rollup for up to 10 companies: for each name, live project count and MW (floored), withdrawn project count and MW, totals (withdrawn included), per-ISO breakdown, and the attribution confidence summary with the dominant confidence. Matching is exact-name: a near miss returns a "did you mean" list, never another company's data. Every number is dated (data as of date) and rounded down. For a prospect-plus-competitors comparison in one call, not five.

Returns {companies, data_as_of, linkage, totals_label}: one companies row per name with matched, then either matched_variants, live / withdrawn / total projects and MW, by_iso, confidence (projects and MW per confidence label) and dominant_confidence, or a did_you_mean list. Only the "two sources agree" label (confirmed) rests on two independent strong records. MW includes approximate bucketed values (West, Southeast, CAISO) and PJM capacity (CIR) MW; the rollup carries no caveats, so use get_company_profile for them.

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": "get_company_queue_rollup",
    "arguments": {
      "names": [
        "Savion",
        "Arevon",
        "Invenergy"
      ]
    }
  }
}

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.