MCP Tool
Company queue rollup (one call)
One-call queue rollup for up to 10 companies.
- MCP
- Read-only
- Updated
Declaration
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:
How do Savion, Arevon and Invenergy compare in the queue, live versus withdrawn?
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": "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.