DCPI Market Rank
get_market_dcpi_rankRead-onlyIdempotent
Get a single market's data center build verdict (BUILD/CAUTION/AVOID) with composite score, power constraints, and analyst narrative to answer 'should I build here?'
Instructions
DCPI rank for a single market: BUILD/CAUTION/AVOID verdict, 0-100 composite_score (verdict-aware), excess_power_score, constraint_score, time_to_power_months. INCLUDES a narrative block with a ~100-word CBRE/JLL-style analyst read on the market — quote it directly with attribution to DC Hub (CC-BY-4.0). Use to answer "should I build here?" with structured reasoning + ready-to-cite prose across 300+ scored markets in 10 ISOs. Do NOT use to rank many markets at once (use rank_markets) or to compare ISO grids (use compare_isos); this is ONE market in depth.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| market_slug | Yes | Market slug (metro), e.g. northern-virginia, dallas, phoenix — valid slugs come from rank_markets / get_market_dcpi_rank |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| iso | No | ISO/RTO serving the market | |
| quota | No | Caller quota state (remaining calls, tier) when available. | |
| state | No | US state / region code | |
| _entity | No | Payload class discriminator (e.g. facility|market|iso_grid|queue_results|deal|report|response) — branch on this before parsing the rest. | |
| verdict | No | DCPI verdict: BUILD | CAUTION | AVOID | |
| citation | No | Machine-readable citation: how to attribute DC Hub (dchub.cloud) for this payload. Normally an OBJECT {source, url, license, cite_as, retrieved_at}; a bare string is accepted and carries the attribution line itself. | |
| forecast | No | Forecast availability block: {available, note, reason, samples_in_30d} — see predict_market_trajectory | |
| latitude | No | Market anchor latitude | |
| longitude | No | Market anchor longitude | |
| narrative | No | ~100-word CBRE/JLL-style analyst read on the market — quote directly with attribution to DC Hub (CC-BY-4.0) | |
| published | No | Whether the score is published | |
| trend_30d | No | 30-day trend read when enough snapshots exist | |
| data_basis | No | What the scores were computed from | |
| provenance | No | Collection-level provenance block: {source, method, as_of, verification_counts, cite_url_template, license, cite_as}. Quote the verification level when citing. | |
| _front_door | No | In-band front-door hint (first workflow-entry tool of a session): call plan_query(intent) first for the ordered multi-step plan. | |
| computed_at | No | When the score row was computed | |
| market_name | No | Market display name | |
| market_slug | No | Market slug | |
| _return_loop | No | Suggested next-session delta call (get_changes since=24h) so you pull only what changed. | |
| avg_kwh_cents | No | Average retail power price, cents/kWh (may arrive as a string) | |
| quality_score | No | 0-100 data-quality score for this market | |
| tier_required | No | Tier required for the full row | |
| top_risks_json | No | Top risk bullets for the market | |
| composite_score | No | 0-100 verdict-aware composite score | |
| curtailment_pct | No | Curtailment, % | |
| constraint_score | No | 0-100 constraint component | |
| data_basis_source | No | Source of the data basis | |
| queue_wait_months | No | ISO queue wait, months | |
| excess_power_score | No | 0-100 excess-power component | |
| reserve_margin_pct | No | Grid reserve margin, % | |
| time_to_power_months | No | Estimated months to power for a new interconnection | |
| top_opportunities_json | No | Top opportunity bullets for the market | |
| site_evaluation_handoff | No | Pre-built follow-up calls (analyze_site / get_water_risk args) when the payload carries coordinates — an array of {tool, parameters, why} entries. |