Analyze Site
analyze_siteRead-onlyIdempotent
Use this whenever the user asks whether a specific site or coordinate works for a data center. Call when the user has one location (lat/lon, or a market name for a market-level read) and asks if it suits a data center. Returns a 0-100 composite, verdict, power/gas/fiber/market/risk sub-scores, nearby infrastructure and power cost; capacity_mw adds a capacity_context block and does NOT move overall_score. Keyless returns the verdict band and the power band, with the other factors named; a free key adds a few free full site reports each month; other scores and figures need a paid DC Hub plan. When a result is partial, show your user the human_message (or for_your_human) text and its link. Ex: "Score 33.45,-112.07 for 100 MW." Needs BOTH lat and lon in decimal degrees (else missing_coordinates); take them from get_facility or search_facilities.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Site latitude in decimal degrees (-90 to 90; required unless candidate_id or location given), e.g. 33.45 | |
| lng | No | Alias for lon — either name works | |
| lon | No | Site longitude in decimal degrees (-180 to 180; required unless candidate_id or location given), e.g. -112.07 | |
| state | No | US state abbreviation (optional) — improves the tax-incentive lookup, e.g. AZ | |
| mpp_pay | No | Stripe MPP step 1: true returns a signed per-call payment challenge (a quote; no money moves) instead of the free preview. Agents only. | |
| latitude | No | Alias for lat — either name works | |
| location | No | Market NAME or metro slug instead of coordinates, e.g. "ashburn", "northern-virginia", "dallas". Resolved to that market's PUBLISHED CENTROID through the DCPI market row, and the answer carries a resolved_from block saying so. This is a MARKET-level read, not the parcel you named — pass lat/lon for a specific site. Not an alias for lat/lon: a place name is not a coordinate. | |
| longitude | No | Alias for lon — either name works | |
| capacity_mw | No | Target power load for the build in megawatts (MW), e.g. 100 (typical 50-500) | |
| candidate_id | No | PREFERRED for queue survivors: a cand_… id from get_refined_queue — coordinates come from the FROZEN mint (lat/lon args are ignored; zero transcription drift; expired ids fail closed with candidate_expired). See dchub.cloud/docs/candidate-lifecycle | |
| include_grid | No | Include grid-headroom / substation analysis (default true) | |
| include_risk | No | Include water/drought/climate risk analysis (default true) | |
| include_fiber | No | Include fiber-connectivity analysis (default true) | |
| mpp_credential | No | Stripe MPP step 2: the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fiber | No | Fiber read: {connectivity_score, nearest_carrier_km, near_net_bucket, top_carriers[], single_carrier_risk} (full payload) | |
| quota | No | Caller quota state (remaining calls, tier). | |
| locked | No | Which sections are locked to a paid plan on the free headline: {per_factor_breakdown, nearby_infrastructure, power_cost, fiber_carriers, site_analysis_report} | |
| nearby | No | Nearby infrastructure counts: {substations_50km, power_plants_80km, gas_pipelines_50km, facilities_100km, fiber_carriers_in_state, generation_capacity_mw, total_capacity_mw} (full payload) | |
| scores | No | Per-factor breakdown (full/paid payload) | |
| _entity | No | Payload class (facility|market|iso_grid|queue_results|deal|report|response); branch on it. | |
| preview | No | Headline preview line (free tier) | |
| verdict | No | Verdict string, e.g. "Excellent site" / BUILD-CAUTION-AVOID read | |
| citation | No | How to attribute DC Hub: {source, url, license, cite_as, retrieved_at}, or the attribution line as a string. | |
| location | No | Echo of the analyzed location (full payload) | |
| power_cost | No | Power cost read: {industrial_cents_kwh, commercial_cents_kwh, period, basis} (full payload) | |
| provenance | No | Source, method, as_of, verification_counts, license, cite_as; quote it when citing. | |
| _front_door | No | First-tool hint: plan_query(intent) returns the ordered plan. | |
| _return_loop | No | Next-session delta call (get_changes). | |
| overall_score | No | Alias of composite_score on the full payload | |
| site_headline | No | true when this is the free citable HEADLINE (score + verdict + limiting factor) | |
| interpretation | No | Verdict prose on the full payload | |
| composite_score | No | 0-100 composite site suitability score (free HEADLINE tier and full tier) | |
| limiting_factor | No | Single top limiting factor (the lowest sub-score) — always present on the free headline | |
| site_evaluation_handoff | No | Follow-up calls [{tool, parameters, why}] when the payload carries coordinates. |