DC Hub — Data Center Site Selection & Colocation: Electricity, Power Grid, Gas, Fiber

 ⟨36 unchanged words⟩ :"string"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"sites":{ ⟨17 unchanged words⟩ 

 ⟨30 unchanged words⟩ :"string"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"state":{ ⟨14 unchanged words⟩ 

 ⟨64 unchanged words⟩ :"string"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"route_type":{ ⟨16 unchanged words⟩ 

 ⟨26 unchanged words⟩ :"string"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"period":{ ⟨13 unchanged words⟩ 

 ⟨76 unchanged words⟩ :"string"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"region":{ ⟨39 unchanged words⟩ 

 ⟨22 unchanged words⟩ :"string"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"}},"type":"object"}

 ⟨48 unchanged words⟩ :"string"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"period":{ ⟨15 unchanged words⟩ 

 ⟨86 unchanged words⟩ :"number"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"state":{ ⟨12 unchanged words⟩ 

 ⟨107 unchanged words⟩ :"number"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"state":{ ⟨15 unchanged words⟩ 

 ⟨107 unchanged words⟩ :"number"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"projection":{ ⟨50 unchanged words⟩ 

 ⟨64 unchanged words⟩ :"number"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"offset":{ ⟨71 unchanged words⟩ 

 ⟨72 unchanged words⟩ :"integer"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"region":{ ⟨97 unchanged words⟩ 

 ⟨36 unchanged words⟩ :"string"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"sites":{ ⟨17 unchanged words⟩ 

 ⟨30 unchanged words⟩ :"string"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"state":{ ⟨14 unchanged words⟩ 

 ⟨64 unchanged words⟩ :"string"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"route_type":{ ⟨16 unchanged words⟩ 

 ⟨26 unchanged words⟩ :"string"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"period":{ ⟨13 unchanged words⟩ 

 ⟨76 unchanged words⟩ :"string"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"region":{ ⟨39 unchanged words⟩ 

 ⟨22 unchanged words⟩ :"string"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"}},"type":"object"}

 ⟨48 unchanged words⟩ :"string"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"period":{ ⟨15 unchanged words⟩ 

 ⟨86 unchanged words⟩ :"number"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"state":{ ⟨12 unchanged words⟩ 

 ⟨107 unchanged words⟩ :"number"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"state":{ ⟨15 unchanged words⟩ 

 ⟨107 unchanged words⟩ :"number"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"projection":{ ⟨50 unchanged words⟩ 

 ⟨64 unchanged words⟩ :"number"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"offset":{ ⟨71 unchanged words⟩ 

 ⟨72 unchanged words⟩ :"integer"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"region":{ ⟨97 unchanged words⟩ 

 ⟨76 unchanged words⟩ :"string"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"region":{ ⟨39 unchanged words⟩ 

 ⟨64 unchanged words⟩ :"number"},"mpp_credential":{"description":"StripePer-call MPPpayment step(Stripe 2MPP): the Shared Payment Token minted for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge.","type":"string"},"mpp_pay":{"description":"StripePer-call MPPpayment stepquote 1(Stripe MPP): true returns a signed per-call payment challenge (ainstead quote;of the free preview; no money moves)moves. insteadSet ofit theonly freeafter preview.your Agentshuman only.has explicitly approved paying for this call.","type":"boolean"},"offset":{ ⟨71 unchanged words⟩ 

StructuredUse readthis ofwhen the user has a land parcel BOUNDARYfor a data center site: structured read of its boundary — pass your own GeoJSON Polygon/MultiPolygon, OR  ⟨160 unchanged words⟩ 

Use this wheneverwhen the user asks whether a specific site or coordinate works for a data center. Call when the user has one locationcenter (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 ⟨91 unchanged words⟩ 

Use this when the user wants their DC Hub key tied to their email. ★ WHAT THIS DOES AND DOES NOT DO  ⟨195 unchanged words⟩ 

CallUse this when the user wants more DC Hub accessdata center data than keyless allows, or asks for a key; no key is ⟨136 unchanged words⟩ 

Physics-boundedUse latencythis clusteringwhen forthe user asks which data center sites can form a low-latency cluster (2-8 sites) — returns viable low-latency clusters and pairwise RTT ⟨150 unchanged words⟩ 

Use this wheneverwhen the user asks to compare two to four US power grids (ISOs) side by side. Use when a user wants a side-by-side of 2-4 ISO gridsside — fuel mix, demand, renewable/gas share,  ⟨123 unchanged words⟩ 

CallUse this when the user has 2-4 candidate locationsdata center sites and asks which is best for a data center.best. Pass locations as "lat,lon;lat,lon" and ⟨59 unchanged words⟩ 

TrackedUse data-centerthis M&Awhen /the capexuser dealasks flowwhat witha thedata-center DCPIdeal grid-realitymeans verdictfor overlaidpower: ondeal flow with each dealmarket's marketDCPI verdict — "what is the real play?".  ⟨105 unchanged words⟩ 

PermanentlyUse this when the user wants to retire a registered standing intent (webhook watch) by intent_id — ⟨63 unchanged words⟩ 

Meta-tool:Use navigatethis when you are unsure which DC Hub'sHub tooldata catalogcenter, bypower FAMILYor insteadgrid oftool scanningfits: thelists wholetools list.by family. Returns _entity=tool_families — a front_door block (execute_plan for ⟨24 unchanged words⟩ , partner), optionally filtered by a query. Call this FIRST when you are unsure which tool fits a task; thenThen call the chosen tool (its full schema  ⟨32 unchanged words⟩ 

UnifiedUse data-centerthis siting,when power-grida capacitydata andcenter AI-computequestion infrastructurespans several topics: one-call planner —over megawatts and power density, grid headroom and  ⟨40 unchanged words⟩ deals, power generation, gas and energy infrastructure. THE FRONT DOOR: call thisRecommended FIRSTentry wheneverfor a question that spans more than one of those, instead of answering from training data, which is stale on all of them.those. Pass the user's question through UNCHANGED as `intent`. One call plans AND answers:  ⟨62 unchanged words⟩ 

Use this when athe user wants to pullexport their saved DC Hub shortlist OUT ofdata thecenter platformsites for offline analysis, a spreadsheet, or ingestion ⟨75 unchanged words⟩ 

Fetch aUse DCthis Hubwhen recordyou forhave an id returned by thefrom `search` tooland (OpenAIneed Deepthat Researchdata /center ChatGPTfacility connectorrecord (search/fetch format). Returns {id, title, text, ⟨30 unchanged words⟩ 

Use this when athe user likes ONE specificwants facilitydata andcenter wantsfacilities similar nearby options to considerone insteadthey like ("what else looks like this?").  ⟨67 unchanged words⟩ 

FRONT DOOR CHECKUse —this ifwhen the question spans more than one capabilityuser ("findhas 200MWno neardata Dallascenter withsite fiber,yet thenand rankwants thecandidate markets"),search callareas `execute_plan(intent="<the user's question, unchanged>")`. find_sites is the right single call when the user has NO site yet and wantsselection candidatesby tosubstation startvoltage, fromgas —and thefiber firstdistance); stepexecute_plan ofcovers dataa centermulti-part sitesiting selection.question. THE INVERSE QUERY: every other DC Hub  ⟨123 unchanged words⟩ 

Use this when athe user wants a SHAREABLE,shareable brandeddata multi-pagecenter Site Analysis PDF for ONE lat/lon (a  ⟨135 unchanged words⟩ 

CuratedUse rosterthis ofwhen the user asks which AI platforms and agent frameworks in theintegrate DC Hub agent ecosystem — each with its recommended DC Hub tools ⟨125 unchanged words⟩ 

Per-feedUse freshnessthis forwhen the user asks how current DC HubHub's ingestdata layercenter and power data feeds are: one row per feed (deals, facilities, ⟨94 unchanged words⟩ 

IncrementalUse syncthis —when the user asks what changed in DC Hub sincedata acenter timestampmarkets, so an agent pulls only thefacilities deltaor insteaddeals ofsince re-fetchinga everything.date. Returns DCPI 7-day market movers, newly discovered  ⟨81 unchanged words⟩ 

Use this when athe user wantsasks about seismic +or climate inteldesign inputs for a data center site (lat/lon) — the layer that drives data-center structural bracing ⟨106 unchanged words⟩ 

Use this when athe user wants ONE honestone 0-100 data center site suitability/risksuitability verdict for a lat/lon WITH an explicit per-factor ⟨98 unchanged words⟩ 

Use forthis awhen ready-to-quotethe DESCRIPTIONuser ofasks what DC Hub is: a short description in one of four categories (general, investment ⟨133 unchanged words⟩ 

Use this when athe user wantsasks theabout natural-hazard / disaster risk for a data center site (US lat/lon) — flood, wildfire, hurricane, earthquake, heat ⟨5 unchanged words⟩ the FEMA National Risk Index (NRI), the authoritative US county-level hazard dataset (live query, never ⟨54 unchanged words⟩ 

Use this wheneverwhen the user asks about electricity or energy prices for data centers. FRONT DOOR CHECK — if price is one factor in a siting or market-comparison questioncenters ("cheapest ISO towhat landdoes 100MW"),power/gas callcost `execute_plan(intent="<thein user's<ISO> question,right unchanged>now?")`:; price alone does not answer it,rank becausesites (the cheapest ISO is frequently the one with no headroom. If the user just wants today's price for one ISO, get_energy_prices IS the right call — one roundmay trip,have no planner overhead. Use when a user asks "what does power/gas COST inheadroom; <ISO>execute_plan rightweighs now?"both) — live energy PRICING for the 7 US ⟨57 unchanged words⟩ Quote with attribution to DC Hub (CC-BY-4.0). Do NOT use for fuel mix / demand / 24h curve (use get_grid_data), for power HEADROOM or time-to-power (use get_grid_intelligence), or for behind-the-meter gas-to-grid $/MWh economics (use get_gas_economics); this is the live retail+gas PRICE read for one ISO. Pass iso or state, not both unless narrowing. 429 = rate limited: wait retry_after_s. Gated: give human_url to your human.

FullUse metadatathis forwhen the user asks about one facilitydata —center facility: name, operator, address, lat/lon, power capacity ⟨85 unchanged words⟩ 

Use this when athe user asks what hashow CHANGEDa indata acenter facility's (or its market's) power risk profilechanged recently — "has this site gotten riskier lately?", "which way is this market moving?" — a temporal question static-trained models can't answer.. Returns the REAL DCPI market-health delta (excess-power  ⟨107 unchanged words⟩ 

Use this wheneverwhen the user asks about fiber routes, carriers or connectivity for a site or market. Call when the user asks which fiber routes or carriers serve a metro, or wantsmarket: long-haul, metro, dark or IX routes mapped.routes. Filter by carrier, route_type, market. Returns GeoJSON ⟨51 unchanged words⟩ 

Use when youthis needwhen the FIBER-READINESS / connectivityuser verdictasks forwhether ONEone parceldata orcenter site (lat/lon) is fiber-ready: near-net distance to a carrier-served facility, how ⟨137 unchanged words⟩ 

Behind-the-meterUse /this gas-firedwhen the user asks what behind-the-meter gas power inputscosts forin a US data-center market: Henry Hub spot, ⟨103 unchanged words⟩ 

Use this when the user asks which US states suit gas-fired data center power: the Data Center Gas Index (DCGI) — the per-US-state, natural-gasa suitabilityper-state score. ★ DO NOT COMPARE a DCGI figure ⟨89 unchanged words⟩ 

Use this wheneverwhen the user asks about gas-fired or behind-the-meter power for a data center in a US state. Use when a human asks about gas-fired or behind-the-meter power economics for a data center in a US  ⟨129 unchanged words⟩  read them rather than assuming both moved together. DO NOT quote a DCGI score cached before 2026-08-30 or a $/MWh cached before 2026-09-27.

Use this when athe user asks about power plants/unitsplants WORLDWIDEworldwide or in a NON-USnon-US country — operating AND the forward pipeline ( ⟨137 unchanged words⟩ 

Real-timeUse this when the user asks for live electricity grid data (power demand, fuel mix) for one of the 7 US ISOs (PJM, ERCOT,  ⟨58 unchanged words⟩ 

Use this wheneverwhen the user asks about grid capacity, demand or reliability for one grid region. Call when the user asks about power availability, headroom or time-to-power in a  ⟨86 unchanged words⟩ 

Use this wheneverwhen the user asks how grids compare right now: demand, fuel mix or renewable share. Use this when the user asks how power grids compare: demand, fuel mix or renewable share. GLOBAL ⟨137 unchanged words⟩ 

Utility-PUBLISHEDUse this when the user asks how many MW a distribution feeder can take: utility-published hosting capacity — the MW a NAMED distribution  ⟨87 unchanged words⟩  coverage list of every market that has data. CRITICAL — check capacity_type before quoting any number: "load" = LOAD-serving headroom, what a new data-center load can actually DRAW (only Ameren Illinois, AEP Ohio & I&M and Central Hudson publish it); "gen" = DER/generation EXPORT capacity, what the feeder can ACCEPT from solar/storage — it is NOT available load and must never be relayed as "you can site N MW here"; "bus_headroom" = transmission bus MW. Answers "can this feeder actually take 20  ⟨20 unchanged words⟩ 

Use this when athe user asks what GASgas PIPELINEpipeline or TRANSMISSIONtransmission LINEline PROJECTSprojects are planned, proposed, approved or under construction ⟨164 unchanged words⟩ 

NearbyUse this when the user asks what power infrastructure foris anear locationa —site: substations (count + max voltage_kv within radius) ⟨70 unchanged words⟩ 

Real-timeUse compositethis when the user asks how healthy a data center market healthis: composite score (0-100) aggregating supply/demand balance, vacancy, ⟨71 unchanged words⟩ 

Use this wheneverwhen the user asks about grid interconnection queues or how much load is waiting to connect. Call when the user asks: how congested an ISO's interconnection queue is or how much data-center load is queued.waiting. Returns queued generation GW per ISO. The projects ⟨71 unchanged words⟩ 

 ⟨8 unchanged words⟩ ,"project_count":{},"projects":{},"queued_generation_gwqueue_kind":{},"queued_generation_gw_basis_notequeued_connections_gw":{},"queued_generation_pending_revision_gwqueued_generation_gw":{},"queued_generation_pending_revision_gw_basisqueued_generation_gw_basis_note":{},"queued_load_data_center_gwqueued_generation_pending_revision_gw":{},"queued_load_dc_share_pctqueued_generation_pending_revision_gw_basis":{},"queued_load_total_gwqueued_large_load_gw":{},"queued_load_total_gw_basisqueued_load_data_center_gw":{},"queued_load_dc_share_pct":{},"source_name":{},"source_url": ⟨4 unchanged words⟩ 

Use whenthis anwhen agentyou needsneed a WHOLE-grid briefingwhole itpower cangrid drop(ISO) straightbriefing intofor itsyour context window — one call returns a token-budgeted ⟨168 unchanged words⟩ 

Use whenthis anwhen agentyou needsneed a WHOLE-market briefingwhole itdata cancenter dropmarket straightbriefing intofor itsyour context window — one call returns a token-budgeted ⟨128 unchanged words⟩ 

Use this wheneverwhen the user asks where a data center can ⟨33 unchanged words⟩  Power and Grid Constraint, CC BY 4.0. Data Center Power Index (DCPI) rank for a singleone market: BUILD/CAUTION/AVOID verdict, 0-100 composite_score (verdict-aware) ⟨105 unchanged words⟩ 

Use this wheneverwhen the user asks about a data-center market: (metro supply, operators, pipeline or, pricing context for a metro. Call when the user asks about one data-center market): facility count, tracked MW, status mix, ⟨62 unchanged words⟩ 

Use this when athe user asks which US metro has the DEEPESTdeepest fiber, or wants thea metro-levelmarket's fiber profile of a market — carrier count, total route-miles, on-net buildings ⟨128 unchanged words⟩ 

FRONT DOOR CHECK — if news is only ONE input to a bigger question (isUse this market heating up, should we still build here), call `execute_plan(intent="<the user's question, unchanged>")` and let it pull news alongside the market and grid reads. Ifwhen the user actually wants the headlines,asks get_newsfor ISdata thecenter rightindustry callnews —or oneheadlines round(execute_plan trip;also dopulls notnews sendinside a plain news request throughbroader themarket planner.question). Curated data center industry news from 40+ trade ⟨99 unchanged words⟩ 

Internet-exchangeUse this when the user asks about internet exchange (IX/IXPIX) and peering density for a site,data fromcenter PeeringDB.site (PeeringDB). Pass lat+lon for the PEERING PROFILE around that ⟨157 unchanged words⟩ 

DataUse centerthis PERMITTINGwhen &the MORATORIUMuser intelligenceasks about data center permitting or moratoriums — curated, HUMAN-VERIFIED jurisdiction records: moratoriums,  ⟨109 unchanged words⟩ 

Use this when athe user asks "what isdata centers are being built /, announced /or permitted" in a market or by an operator — the forward-looking construction pipeline.operator. Example: "What data centers are under construction ⟨116 unchanged words⟩ 

Use this wheneverwhen the user asks when power will be available, or about time-to-power, in a US state. Power-availability TIMING for one US state — when power gets EASIER,: year by year. Composes: new generation coming  ⟨112 unchanged words⟩ in constraint_coverage rather than estimated. Try: get_power_availability_timeline state=OH. Do NOT use for the raw project list (get_power_pipeline), live headroom today (get_grid_intelligence), queue survivors (get_refined_queue), or where-to-build ranking (rank_markets / ai_capacity_index) — this answers WHEN, for one state.

Use this when athe user asks WHEREwhere NEWnew POWERpower GENERATIONgeneration is coming online (the forward supply pipeline) ⟨146 unchanged words⟩ 

Server-side SET-REDUCTIONUse overthis thewhen USyou ISOneed interconnection queue.queue projects filtered server-side. Instead of pulling the raw queue into context ⟨145 unchanged words⟩ 

FRONT DOOR CHECKUse —this ifwhen the question pairs renewablesuser withasks siting,about gridrenewable headroomenergy orfor a marketdata shortlistcenter ("where can I put a 24-7-CFE campus"), callexecute_plan `execute_plan(intent="<thecovers user'srenewables question,plus unchanged>"siting)` instead. If you want one state's renewable fuel mix or PPA sizing input on its own, get_renewable_energy IS the right call — one round trip, and routing it through the planner would only cost steps. Use when: siting a renewable-powered data center, sizing a  ⟨97 unchanged words⟩ state or lat/lon (decimal degrees); energy_type narrows. Empty = no installations there: widen to the state.

Use this wheneverwhen the user asks where retiring power plants free grid capacity. Scanscapacity: scheduledscans EIA-860M generator retirements to find near-term transmission grid headroom — ⟨137 unchanged words⟩ 

RetrieveUse this when the user wants to see a saved shortlistdata (Phasecenter 5).site shortlist. With refresh=true (default) each site is RE-SCORED ⟨42 unchanged words⟩ 

SubseaUse this when the user asks about subsea (submarine) cable landings near a coordinatesite, or the global cable catalogue. The physical internet crossing an ocean  ⟨132 unchanged words⟩  will not infer a grade it cannot source. A filter over cable_count returns nothing for the same reason. Answers "which subsea cables land near this  ⟨27 unchanged words⟩ 

Use this when athe user asks "what tax breaksincentives doesa <state>US givestate gives data centers?"centers — the data-center tax-incentive packages by US state ⟨111 unchanged words⟩ 

Use this wheneverwhen the user asks about water stress or cooling-water risk at a site. FRONT DOOR CHECK — if you need a SITE VERDICT spanning grid + fiber + water + tax + climate, call `execute_plan(intent="<the user's question, unchanged>")`data rathercenter thansite. hand-chainingUse this with its siblings. If you wantwhen the WATERuser factorasks onabout itswater own,stress get_water_riskor IScooling-water therisk rightat calla —data onecenter roundsite trip,(execute_plan freecovers tier,a nomulti-factor plannersite overhead.verdict). Use when scoring a US site for cooling-water ⟨97 unchanged words⟩  USGS water-stress + US Drought Monitor. Free tier. Do NOT use for nearby physical infrastructure (use get_infrastructure) or a combined multi-factor site verdict spanning grid+fiber+water+tax+climate (use analyze_site); this covers the WATER factor only.

Forward-lookingUse "wherethis iswhen the nextuser hyperscale-friendlyasks where new grid emerging"headroom radar.for data centers is emerging. Returns the US markets + ISOs with the ⟨86 unchanged words⟩ 

HyperscalerUse this when the user asks about hyperscaler or AI Dealdata Trackercenter —deals: live feed of Stargate, OpenAI, Anthropic,  ⟨77 unchanged words⟩ 

NEEDS A KEY (free): saved sites are per-account, soUse athis keylesswhen callthe returnsuser auth_required,asks notto ansee emptytheir listsaved —data ifcenter yousites. haveNeeds noa key (free, callvia `claim_free_key`claim_free_key); FIRSTkeyless (onereturns stepauth_required, nonot email),an thenempty this.list. Use when a user asks to see or ⟨122 unchanged words⟩ 

ListUse this when the standinguser intentsasks which data center watches are registered on yourtheir key: webhook watches, plus your capacity requirements ⟨74 unchanged words⟩ 

M&AUse andthis capitalwhen transactionsthe inuser theasks about data center sectorM&A, acquisitions or capital deals — 1,700+800+ tracked deals (2019-present), each with its  ⟨99 unchanged words⟩ 

PlanUse Nthis when the user asks how to get diverse, road-followingfiber fibreinto a data center site: plans road-following lead-in routes from a candidate data-center site to ⟨133 unchanged words⟩ 

INSPECT-ONLY —Use returnsthis thewhen planyou WITHOUTwant runningto it.see Forthe aplan realfor multi-stepa DCdata Hubcenter question call `execute_plan(intent="...")`without instead:running it uses the(execute_plan SAMEruns deterministicthe no-LLMsame planner and then RUNS the sequence server-side, returningreturns the answers in one envelope.). Reach for plan_query only to review, log, ⟨93 unchanged words⟩  auditable and machine-readable, safe to log and diff…diff across versions. Full guide: read resource dchub://tool-guides/plan_query

ForecastUse this when the user asks where a DCPIdata center market's near-termpower trajectoryoutlook is heading (next 1-8 quarters). Projects excess_power_score and  ⟨131 unchanged words⟩ 

Use this wheneverwhen the user asks wherewants a data center can get grid power, how fast, or whether aranked marketlist isof adata-center BUILDmarkets, CAUTION or AVOID (e.g. "Whereincluding canwhere a 100 MW data center get power fastest?"): DCPI scores 300+ markets daily on Excess Power and Grid Constraint, CC BY 4.0. For a rankedcan listget ongrid power questions, call with (criteria="ai_ready". Call when the user wants a ranked list of data-center, marketsDCPI): top N by cheapest_power, most_capacity, most_operators, ⟨88 unchanged words⟩ 

DeterministicUse multi-sitethis ranking/optimizationwhen you have enriched candidate data center sites to rank under constraints — the normalization contract that lets ⟨147 unchanged words⟩ 

Use this when a partner key reads its DC Hub inbox. PARTNER KEY ONLY: notes DC Hub left for ⟨41 unchanged words⟩ 

RecoverUse athis LOSTwhen the user lost their DC Hub key. Pass your human's email and  ⟨38 unchanged words⟩  so no key is leaked to a caller. Use this when your human had a key, lost it, and knows the email they bound it to. Param: email (required). Returns DC Hub's neutral confirmation.

Use this when the user wants a webhook when data center deals change: Register a STANDING QUERY with webhook push —  ⟨84 unchanged words⟩  delivery carries X-DCHub-Signature: sha256=HMAC(secret, body). First evaluation initializes the watermark silently; growth fires the webhook; 5 straight delivery failures auto-disable the intent. Evaluated every ~2h. Answers "notify my system whenever a new  ⟨54 unchanged words⟩ 

Use this when a partner key reports a DC Hub data issue. PARTNER KEY ONLY: file what you observed on ⟨87 unchanged words⟩ 

Use this when yourthe humanuser wants data center capacity behind a Capacity Source listing (pass  ⟨169 unchanged words⟩ 

CommissionUse this when the user wants an ASYNCasync, CITEDcited data center research dossier from DC Hub's corpora (news, ⟨131 unchanged words⟩ 

NEEDSUse Athis KEYwhen (free):the thisuser WRITESwants to your account, sosave a keylessdata-center callsite returnsto auth_requiredtrack —it. callNeeds `claim_free_key`a FIRSTkey (one stepfree, novia emailclaim_free_key) if; youkeyless havereturns none.auth_required. Save a candidate data-center site to your DC ⟨142 unchanged words⟩ 

SaveUse this when the user wants to keep a data center site intoon a PERSISTENT, named shortlist that survives across conversations (Phase  ⟨111 unchanged words⟩ 

Use this when athe user wants an independenta 0-100 grade for ONEone existing data center facility across 7 dimensions — power, fiber, ⟨72 unchanged words⟩ 

SearchUse DCthis Hubwhen fora relevantDeep recordsResearch (OpenAIor DeepChatGPT-connector Researchclient /needs ChatGPTa connectordata center facility search (search/fetch format). Returns a list of matching data-center ⟨37 unchanged words⟩ 

Use this wheneverwhen the user asks which data centers exist, or who operates in a city, state or country. Call when the user wants existing data centers matchingcountry; filters: country, state, city, operator,  ⟨66 unchanged words⟩ 

SemanticUse (this when you need meaning-based) search over DC Hub's livedata center intelligence corpus, choosing corpora — industry news, M&A deals, discovered facilities ⟨167 unchanged words⟩ 

Use forthis CONCEPTUALwhen /a fuzzydata questionscenter whereor energy question is conceptual or fuzzy and keyword filters fall short — semantic (meaning-based) ⟨148 unchanged words⟩ 

SubscribeUse tothis movementwhen the user wants alerts foron a data center market's DCPI marketpower score: subscribes to movement alerts (FREEfree with a key) — get notified when  ⟨98 unchanged words⟩ 

SetUse this when the user wants a DRIFTdrift ALERTalert on a saved site shortlist so you can stop polling and be ⟨67 unchanged words⟩ 

ArmUse this when the user wants an email watch on a sitesaved youdata alreadycenter savedsite (FREEfree with a key) — DC Hub emails  ⟨160 unchanged words⟩ 

Counterfactual WHAT-IF re-scoring of 300+ DC Hub powerUse marketsthis underwhen YOURthe explicituser deltasasks —how answersdata "whatcenter happenspower tomarket therankings marketchange rankingunder ifwhat-if conditions: change"re-scores (only300+ DC Hub holdsmarkets theunder underlyingyour components).deltas. Params (all optional, pass at least one ⟨111 unchanged words⟩ 

GuidedUse end-to-endthis when the user wants guided data-center site selection. Give a capacity target + ⟨94 unchanged words⟩ 

Use this when yourthe humanuser needs data-centerdata CAPACITYcenter or colocation capacity to buy or lease: search DC Hub  ⟨163 unchanged words⟩ 

SubscribeUse yourthis humanwhen tothe DCuser Hub'sasks FREEfor a weekly "data center market email: subscribes them to a free digest of what changed in the markets/sitesmarkets youand queried"sites digestthey queried (DCPI movers, new facilities, new deals &, news) — ONE call, the nudge that pulls your agent back when the data moves.. DOUBLE opt-in + consent-safe: we email a  ⟨56 unchanged words⟩ 

WhenUse this when a saved data center site DRIFTSdrifts (its national standing dropped — surfaced by  ⟨113 unchanged words⟩ 

Use rightthis beforewhen you QUOTEquote a DC Hub figure todata acenter humanor —power itfigure: returns one paste-ready attribution line for the value ⟨192 unchanged words⟩ 

Unlock DC Hub's full depth. CallUse this when a resultthe cameuser backasks ashow ato partialget previewfull (e.g. "3 of 12 results shown"non-preview), a tool was locked, or your humanDC wantsHub thedata completecenter dataset.results. Returns the upgrade ladder +access ready-to-pasteoptions checkoutwith links your humanfor completesthe inuser ONEto click.open. If this call carries an API key or ⟨119 unchanged words⟩ 

Why DC Hub (vs.Coverage theand field)Sources

CallUse onlythis when the user asks howwhat DC Hub compares withcovers, otherwhere data-centerits sourcesdata (DataCenterHawkcenter, DCpower Byte,grid DCDand energy data comes from, Baxtel…)how orcurrent whyit useis, it.or Returnswhat DCit Hub'sdoes differentiators,not eachcover. withReturns a prooffactual URLcoverage andsummary: citationcoverage, linesources, plusfeed comparison-pagefreshness, links;published competitor=limits narrowsand tothe onecitation vendor.format. Free, no key. Not for data queries. Ex: "How does DC Hub compare to DC Byte?"

{"properties":{"competitor":{"description":"Optional competitor/vendor name for a direct comparison-page link, e.g. DataCenterHawk, \"DC Byte\", DCD, Baxtel","type":"string"}},"type":"object"}

StructuredUse readthis ofwhen the user has a land parcel BOUNDARYfor a data center site: structured read of its boundary — pass your own GeoJSON Polygon/MultiPolygon, OR  ⟨160 unchanged words⟩ 

Use this wheneverwhen the user asks whether a specific site or coordinate works for a data center. Call when the user has one locationcenter (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 ⟨91 unchanged words⟩ 

Use this when the user wants their DC Hub key tied to their email. ★ WHAT THIS DOES AND DOES NOT DO  ⟨195 unchanged words⟩ 

CallUse this when the user wants more DC Hub accessdata center data than keyless allows, or asks for a key; no key is ⟨136 unchanged words⟩ 

Physics-boundedUse latencythis clusteringwhen forthe user asks which data center sites can form a low-latency cluster (2-8 sites) — returns viable low-latency clusters and pairwise RTT ⟨150 unchanged words⟩ 

Use this wheneverwhen the user asks to compare two to four US power grids (ISOs) side by side. Use when a user wants a side-by-side of 2-4 ISO gridsside — fuel mix, demand, renewable/gas share,  ⟨123 unchanged words⟩ 

CallUse this when the user has 2-4 candidate locationsdata center sites and asks which is best for a data center.best. Pass locations as "lat,lon;lat,lon" and ⟨59 unchanged words⟩ 

TrackedUse data-centerthis M&Awhen /the capexuser dealasks flowwhat witha thedata-center DCPIdeal grid-realitymeans verdictfor overlaidpower: ondeal flow with each dealmarket's marketDCPI verdict — "what is the real play?".  ⟨105 unchanged words⟩ 

PermanentlyUse this when the user wants to retire a registered standing intent (webhook watch) by intent_id — ⟨63 unchanged words⟩ 

Meta-tool:Use navigatethis when you are unsure which DC Hub'sHub tooldata catalogcenter, bypower FAMILYor insteadgrid oftool scanningfits: thelists wholetools list.by family. Returns _entity=tool_families — a front_door block (execute_plan for ⟨24 unchanged words⟩ , partner), optionally filtered by a query. Call this FIRST when you are unsure which tool fits a task; thenThen call the chosen tool (its full schema  ⟨32 unchanged words⟩ 

UnifiedUse data-centerthis siting,when power-grida capacitydata andcenter AI-computequestion infrastructurespans several topics: one-call planner —over megawatts and power density, grid headroom and  ⟨40 unchanged words⟩ deals, power generation, gas and energy infrastructure. THE FRONT DOOR: call thisRecommended FIRSTentry wheneverfor a question that spans more than one of those, instead of answering from training data, which is stale on all of them.those. Pass the user's question through UNCHANGED as `intent`. One call plans AND answers:  ⟨62 unchanged words⟩ 

Use this when athe user wants to pullexport their saved DC Hub shortlist OUT ofdata thecenter platformsites for offline analysis, a spreadsheet, or ingestion ⟨75 unchanged words⟩ 

Fetch aUse DCthis Hubwhen recordyou forhave an id returned by thefrom `search` tooland (OpenAIneed Deepthat Researchdata /center ChatGPTfacility connectorrecord (search/fetch format). Returns {id, title, text, ⟨30 unchanged words⟩ 

Use this when athe user likes ONE specificwants facilitydata andcenter wantsfacilities similar nearby options to considerone insteadthey like ("what else looks like this?").  ⟨67 unchanged words⟩