DC Hub: Data Center & Energy Intelligence is an MCP server published by cloud.dchub, hosted at dchub.cloud. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 98 tools, including execute_plan, get_api_key, search, fetch, search_facilities.
Orchestration layer for data center and energy intelligence. execute_plan, DCPI, power grid, fiber.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Answers any data center power, grid, interconnection queue, time-to-power, fiber or site question in one call. Pass the user's question unchanged as intent. Returns one dated, cited answer. Covers megawatts and power density, grid headroom and power availability, interconnection queues, substations and transmission, site selection and buildable capacity, colocation and wholesale data-center markets, AI/GPU compute campuses, fiber routes, diversity and latency, PPAs and energy pricing, tax incentives and permitting, water and climate risk, data-center M&A and deals, power generation, gas and energy infrastructure (the Data Center Gas Index, DCGI), and markets scored by the Data Center Power Index (DCPI). Each step is listed with its status, as_of and citation, at your own access level; single-tool questions should call that tool directly, and plan_query shows the plan without running it. Front door for multi-part questions: pass intent unchanged; add market, iso, state or lat/lon when you know them.
| Parameter | Type | Description |
|---|---|---|
| iso | string | ISO/RTO code to pin geography, e.g. "PJM", "ERCOT". |
| lat | number | Latitude for a specific site. |
| lon | number | Longitude for a specific site. |
| state | string | US state code, e.g. "VA". |
| cohort | any | Optional experiment tag for adoption/retention measurement, e.g. "cohort.front_door". Has NO effect on routing, planning, geography or results — it is recorded only. |
| detail | string | "compact": the answer, each step's status, dated facts, citations and replay ids, without step bodies. "full": every step's full result. |
| intent * | string | The user's infrastructure question, passed through UNCHANGED. Examples: "how soon can a 100 MW load get power in ERCOT" · "evaluate 100 MW power headroom for a GPU training cluster in PJM" · "interconnection queue and energy prices in MISO… |
| market | string | Metro slug or name to pin the analysis to, e.g. "ashburn". Beats any market the planner would mint. |
| compact | boolean | true (default) puts fact_header first in the answer: three lines, SOURCE and AS_OF, ENTITY, SUMMARY with the DCPI verdict when the answer carries one. false returns the answer without it. |
| context | any | Optional structured hints AND step-arg overrides: {lat, lon, iso, market, capacity_mw, candidate_id, state, since} — user-supplied values beat minted ones. The typed top-level params below are merged into this and WIN on conflict. |
| max_steps | any | Max plan steps to execute, 1-8 (default 6) |
| max_fanout | any | Max per-finalist fan-out calls for one step, 1-3 (default 2) |
| capacity_mw | number | Target capacity in MW, e.g. 100. |
{
"name": "execute_plan",
"title": "Execute Plan",
"description": "Answers any data center power, grid, interconnection queue, time-to-power, fiber or site question in one call. Pass the user's question unchanged as intent. Returns one dated, cited answer. Covers megawatts and power density, grid headroom and power availability, interconnection queues, substations and transmission, site selection and buildable capacity, colocation and wholesale data-center markets, AI/GPU compute campuses, fiber routes, diversity and latency, PPAs and energy pricing, tax incentives and permitting, water and climate risk, data-center M&A and deals, power generation, gas and energy infrastructure (the Data Center Gas Index, DCGI), and markets scored by the Data Center Power Index (DCPI). Each step is listed with its status, as_of and citation, at your own access level; single-tool questions should call that tool directly, and plan_query shows the plan without running it. Front door for multi-part questions: pass intent unchanged; add market, iso, state or lat/lon when you know them.",
"inputSchema": {
"type": "object",
"required": [
"intent"
],
"properties": {
"iso": {
"type": "string",
"description": "ISO/RTO code to pin geography, e.g. \"PJM\", \"ERCOT\"."
},
"lat": {
"type": "number",
"description": "Latitude for a specific site."
},
"lon": {
"type": "number",
"description": "Longitude for a specific site."
},
"state": {
"type": "string",
"description": "US state code, e.g. \"VA\"."
},
"cohort": {
"description": "Optional experiment tag for adoption/retention measurement, e.g. \"cohort.front_door\". Has NO effect on routing, planning, geography or results — it is recorded only."
},
"detail": {
"type": "string",
"description": "\"compact\": the answer, each step's status, dated facts, citations and replay ids, without step bodies. \"full\": every step's full result."
},
"intent": {
"type": "string",
"description": "The user's infrastructure question, passed through UNCHANGED. Examples: \"how soon can a 100 MW load get power in ERCOT\" · \"evaluate 100 MW power headroom for a GPU training cluster in PJM\" · \"interconnection queue and energy prices in MISO…"
},
"market": {
"type": "string",
"description": "Metro slug or name to pin the analysis to, e.g. \"ashburn\". Beats any market the planner would mint."
},
"compact": {
"type": "boolean",
"description": "true (default) puts fact_header first in the answer: three lines, SOURCE and AS_OF, ENTITY, SUMMARY with the DCPI verdict when the answer carries one. false returns the answer without it."
},
"context": {
"description": "Optional structured hints AND step-arg overrides: {lat, lon, iso, market, capacity_mw, candidate_id, state, since} — user-supplied values beat minted ones. The typed top-level params below are merged into this and WIN on conflict."
},
"max_steps": {
"description": "Max plan steps to execute, 1-8 (default 6)"
},
"max_fanout": {
"description": "Max per-finalist fan-out calls for one step, 1-3 (default 2)"
},
"capacity_mw": {
"type": "number",
"description": "Target capacity in MW, e.g. 100."
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"limits": "supply-side signals, not a load-interconnection promise — generation is not deliverable load · utility study timelines, large-load tariff processes and substation-grain delivery are declared out of coverage rather than estimated · a state-scoped ranking needs a state the planner can resolve; an unresolved geography answers nationally and says so",
"problem": "grid headroom and power availability; site selection and buildable capacity",
"maturity": "mature",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=execute_plan",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user wants more DC Hub data center data than keyless allows, or asks for a key; no key is needed to start. DATA USE: the optional email, used to make the key recoverable and send its weekly lookup summary. DC Hub keeps it and never sells it or shares it for anyone else’s use (https://dchub.cloud/privacy). Run only when your human asks; confirm the email with them first. Mints a key and returns it plus connect_url, a connector URL with the key embedded (the only thing hosted chat clients keep). WHAT AN EMAIL KEEPS: the key, with its saved shortlists, alerts and tracked changes (get_changes), for the next chat; fuller grid, queue and market answers; a weekly summary of what your key looked up (unsubscribe anytime); and recovery (recover_my_key re-sends a lost key to that inbox). Ask the user for an email first; pass it only if they typed it. Save and reuse the key (lost one: recover_my_key); don't re-mint. Then ask the real question (execute_plan for multi-step). If a call was answered with a sign-in challenge (401 WWW-Authenticate), prefer signing in: that identity persists, but a human must finish it in a browser. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| string | Optional owner email to make the key recoverable across sessions; use only an address your human explicitly gave and confirmed. DC Hub keeps it and never sells or shares it | |
| market | string | Optional market slug to follow with the email, e.g. northern-virginia: the same call follows its daily changes |
| client_name | string | Your agent/app name for attribution, e.g. "Claude Desktop" or "acme-siting-bot" |
{
"name": "get_api_key",
"title": "Get API Key",
"description": "Use this when the user wants more DC Hub data center data than keyless allows, or asks for a key; no key is needed to start. DATA USE: the optional email, used to make the key recoverable and send its weekly lookup summary. DC Hub keeps it and never sells it or shares it for anyone else’s use (https://dchub.cloud/privacy). Run only when your human asks; confirm the email with them first. Mints a key and returns it plus connect_url, a connector URL with the key embedded (the only thing hosted chat clients keep). WHAT AN EMAIL KEEPS: the key, with its saved shortlists, alerts and tracked changes (get_changes), for the next chat; fuller grid, queue and market answers; a weekly summary of what your key looked up (unsubscribe anytime); and recovery (recover_my_key re-sends a lost key to that inbox). Ask the user for an email first; pass it only if they typed it. Save and reuse the key (lost one: recover_my_key); don't re-mint. Then ask the real question (execute_plan for multi-step). If a call was answered with a sign-in challenge (401 WWW-Authenticate), prefer signing in: that identity persists, but a human must finish it in a browser. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Optional owner email to make the key recoverable across sessions; use only an address your human explicitly gave and confirmed. DC Hub keeps it and never sells or shares it"
},
"market": {
"type": "string",
"description": "Optional market slug to follow with the email, e.g. northern-virginia: the same call follows its daily changes"
},
"client_name": {
"type": "string",
"description": "Your agent/app name for attribution, e.g. \"Claude Desktop\" or \"acme-siting-bot\""
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_api_key",
"readOnlyHint": false,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": false,
"destructiveHint": false
}
}Use this when a Deep Research or ChatGPT-connector client needs a data center facility search (search/fetch format). Returns a list of matching data-center facilities as {id, title, url}; pass an id to the `fetch` tool for the record, or open the url to cite the live facility page. For structured queries (by MW, operator, status, market) use search_facilities directly. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| query * | string | Free-text query, e.g. "data centers in Northern Virginia" or "Ashburn hyperscale power" |
{
"name": "search",
"title": "Search",
"description": "Use this when a Deep Research or ChatGPT-connector client needs a data center facility search (search/fetch format). Returns a list of matching data-center facilities as {id, title, url}; pass an id to the `fetch` tool for the record, or open the url to cite the live facility page. For structured queries (by MW, operator, status, market) use search_facilities directly. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Free-text query, e.g. \"data centers in Northern Virginia\" or \"Ashburn hyperscale power\""
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=search",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when you have an id from `search` and need that data center facility record (search/fetch format). Returns {id, title, text, url, metadata} — a citable public summary of one data-center facility (name, operator, location, status, market). For full structured specs (capacity MW, coordinates) use get_facility or open the url. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| id * | string | A facility id/slug from a prior `search` result, e.g. equinix-dc1-ashburn |
{
"name": "fetch",
"title": "Fetch",
"description": "Use this when you have an id from `search` and need that data center facility record (search/fetch format). Returns {id, title, text, url, metadata} — a citable public summary of one data-center facility (name, operator, location, status, market). For full structured specs (capacity MW, coordinates) use get_facility or open the url. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "A facility id/slug from a prior `search` result, e.g. equinix-dc1-ashburn"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=fetch",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks which data centers exist, or who operates in a city, state or country; filters: country, state, city, operator, MW range, tier or text. Returns name, operator, location, market, status and MW where disclosed; each row is flagged verified or unverified_directory_listing. A named campus (name="Stargate Abilene") returns its best matching record first, or says no record matches. For the energy side of the same place, execute_plan adds the local ISO, interconnection queue and power prices. Keyless: names and locations; MW and specs need a full-access key. Ex: "Equinix sites in Virginia over 10 MW." Start here for a facility slug. No match = empty data, not an error: broaden filters. limit 1-500 (25 without full access); page with offset. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| city | string | City name to filter facilities, e.g. Ashburn, Dallas |
| name | string | A named project or campus, e.g. "Stargate Abilene": returns the best matching record first (developer, county, state, status, source_url, as_of; stated MW with full access), or name_lookup.message saying no record matches |
| tier | integer | Uptime Institute tier filter (1-4) |
| limit | integer | Max results to return (1-500; default varies by tool) |
| query | string | Free-text search over facility name/operator/location (mapped to the backend `q` param), e.g. "hyperscale Ashburn" |
| state | string | US state abbreviation or region, e.g. VA, TX |
| offset |
Use this when the user asks about one data center facility: name, operator, address, lat/lon, power capacity (MW total/used), cooling type, fiber providers (count + carrier list), commissioning year, status, the DCPI verdict for its market, and peer facilities nearby. Answers "who operates this data center and how big is it", "how many fiber carriers are in that building". Try: get_facility id=equinix-dc1-ashburn — or get_facility slug=digital-realty-digital-realty-iad38-ashburn-5754e62d. Returns ONE facility in full; do NOT use to search or list many facilities (use search_facilities). For the energy side of the same place, execute_plan adds the local ISO, interconnection queue and power prices. Needs a slug or id from search_facilities. 404 "not found": re-run search_facilities. Gated: give human_url to your human. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| id | any | Alias for facility_id — a facility id/slug from a prior search result |
| name | string | Facility name as a fallback lookup when no id/slug is known, e.g. "QTS Ashburn" |
| slug | string | Facility slug from a prior search result, e.g. digital-realty-digital-realty-iad38-ashburn-5754e62d |
| facility_id | any | Facility id from a prior search_facilities/search result (numeric or string), e.g. equinix-dc1-ashburn |
| include_power | boolean | Include power capacity detail (total/used MW) in the response (default true) |
| include_nearby | boolean | Include peer facilities near this one in the response (default true) |
Use this when the user asks about a data-center market (metro supply, operators, pipeline, pricing): facility count, tracked MW, status mix, top providers, recent facilities or lease pricing. Pass market as a slug (e.g. northern-virginia). Returns stats, by_status, top_providers, recent_facilities, market_pricing (quote its basis). Verdict: use get_market_dcpi_rank. Keyless: a trimmed preview; DCHUB_API_KEY is optional, and a key unlocks full answers. Ex: "1 MW colo price in Los Angeles?" Next: to buy or lease capacity in these markets, call source_capacity; to register a requirement with providers, call request_capacity_intro after your human approves. Get the market slug from rank_markets or get_market_dcpi_rank; 404 = unrecognised market, use one of those slugs. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| market | string | Market slug (metro), e.g. northern-virginia, dallas, frankfurt, singapore — valid slugs come from rank_markets / get_market_dcpi_rank |
| metric | string | Optional single metric to focus on, e.g. vacancy, pricing, absorption, pipeline |
| period | string | Optional time window for the metric, e.g. ttm, 12mo, ytd |
| mpp_pay | boolean | Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call. |
| compare_to | string | Optional second market slug to compare against, e.g. dallas |
| mpp_credential | string | Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge. |
Use this when the user asks where a data center can get grid power, how fast, or whether a market is a BUILD, CAUTION or AVOID (e.g. "Where can a 100 MW data center get power fastest?"): DCPI scores markets daily on Excess Power and Grid Constraint, verdicts CC BY 4.0 after 30 days. DCPI rank for one market: BUILD/CAUTION/AVOID verdict, 0-100 composite_score (verdict-aware), excess_power_score, constraint_score, time_to_power_months. When DC Hub has written one, a `narrative` block carries a ~100-word analyst read on the market; quote it directly with attribution to DC Hub, and do not promise one when it is absent. Use to answer "should I build here?" with structured reasoning across 300+ scored markets worldwide. 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. DCPI joins the grid side of a data center market (headroom, queue, modeled time-to-power) to that market; get_market_intel gives the same market's facility supply and pipeline, and execute_plan returns both in one answer. Verdict and composite score come with every answer; numeric sub-scores and the narrative come with a full-access key. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| market_slug * | string | Market slug (metro), e.g. northern-virginia, dallas, phoenix — valid slugs come from rank_markets / get_market_dcpi_rank |
{
"name": "get_market_dcpi_rank",
"title": "DCPI Market Rank",
"description": "Use this when the user asks where a data center can get grid power, how fast, or whether a market is a BUILD, CAUTION or AVOID (e.g. \"Where can a 100 MW data center get power fastest?\"): DCPI scores markets daily on Excess Power and Grid Constraint, verdicts CC BY 4.0 after 30 days. DCPI rank for one market: BUILD/CAUTION/AVOID verdict, 0-100 composite_score (verdict-aware), excess_power_score, constraint_score, time_to_power_months. When DC Hub has written one, a `narrative` block carries a ~100-word analyst read on the market; quote it directly with attribution to DC Hub, and do not promise one when it is absent. Use to answer \"should I build here?\" with structured reasoning across 300+ scored markets worldwide. 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. DCPI joins the grid side of a data center market (headroom, queue, modeled time-to-power) to that market; get_market_intel gives the same market's facility supply and pipeline, and execute_plan returns both in one answer. Verdict and composite score come with every answer; numeric sub-scores and the narrative come with a full-access key. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"market_slug"
],
"properties": {
"market_slug": {
"type": "string",
"description": "Market slug (metro), e.g. northern-virginia, dallas, phoenix — valid slugs come from rank_markets / get_market_dcpi_rank"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"iso": {},
"state": {},
"verdict": {},
"forecast": {},
"latitude": {},
"longitude": {},
"narrative": {},
"published": {},
"trend_30d": {},
"data_basis": {},
"computed_at": {},
"market_name": {},
"market_slug": {},
"avg_kwh_cents": {},
"quality_score": {},
"tier_required": {},
"top_risks_json": {},
"composite_score": {},
"curtailment_pct": {},
"constraint_score": {},
"data_basis_source": {},
"queue_wait_months": {},
"excess_power_score": {},
"reserve_margin_pct": {},
"time_to_power_months": {},
"top_opportunities_json": {}
},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"limits": "a state-scoped ranking needs a state the planner can resolve; an unresolved geography answers nationally and says so · ai_ready_mw is a market-level PROXY from disclosed installed capacity — no per-rack power density or cooling type is ingested, because no public source publishes it. Directional, not a spec claim · deployable_mw is an estimate from market depth, not a measured interconnect result",
"problem": "site selection and buildable capacity; colocation and wholesale data-center markets; AI/GPU compute campuses",
"maturity": "expanding",
"front_door": "execute_plan",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_market_dcpi_rank",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks where a data center market's power outlook is heading (next 1-8 quarters). Projects excess_power_score and constraint_score forward with confidence bands that WIDEN with horizon, from DC Hub's daily DCPI snapshot history, a time-series DC Hub owns. Use to answer "is this market trending toward BUILD or AVOID?" or "will Dallas power stay tight over the next 6 months?". Params: market_slug (required, metro slug e.g. dallas, phoenix, northern-virginia — valid slugs come from rank_markets / get_market_dcpi_rank); horizon_quarters (optional 1-8, default 4; 2 = ~6 months out). Returns {market_slug, method, basis{history_points, history_span_days, slope_per_day, trend}, horizon_quarters, projection[{quarter_out, excess_power_score, excess_power_band, constraint_score, constraint_band}], caveat, snapshot_record}. HONEST: linear trend extrapolation, NOT a guarantee — bands widen with horizon and short history; needs >=3 daily snapshots or it declines. Do NOT use for a single point-in-time verdict (use get_market_dcpi_rank) or to rank many markets (use rank_markets). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| market_slug * | string | Market slug (metro), e.g. dallas, phoenix, northern-virginia — valid slugs come from rank_markets / get_market_dcpi_rank |
| horizon_quarters | integer | Forecast horizon in quarters (1-8, default 4); 2 = ~6 months ahead |
{
"name": "predict_market_trajectory",
"title": "Predict Market Trajectory",
"description": "Use this when the user asks where a data center market's power outlook is heading (next 1-8 quarters). Projects excess_power_score and constraint_score forward with confidence bands that WIDEN with horizon, from DC Hub's daily DCPI snapshot history, a time-series DC Hub owns. Use to answer \"is this market trending toward BUILD or AVOID?\" or \"will Dallas power stay tight over the next 6 months?\". Params: market_slug (required, metro slug e.g. dallas, phoenix, northern-virginia — valid slugs come from rank_markets / get_market_dcpi_rank); horizon_quarters (optional 1-8, default 4; 2 = ~6 months out). Returns {market_slug, method, basis{history_points, history_span_days, slope_per_day, trend}, horizon_quarters, projection[{quarter_out, excess_power_score, excess_power_band, constraint_score, constraint_band}], caveat, snapshot_record}. HONEST: linear trend extrapolation, NOT a guarantee — bands widen with horizon and short history; needs >=3 daily snapshots or it declines. Do NOT use for a single point-in-time verdict (use get_market_dcpi_rank) or to rank many markets (use rank_markets). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"market_slug"
],
"properties": {
"market_slug": {
"type": "string",
"description": "Market slug (metro), e.g. dallas, phoenix, northern-virginia — valid slugs come from rank_markets / get_market_dcpi_rank"
},
"horizon_quarters": {
"type": "integer",
"maximum": 8,
"minimum": 1,
"description": "Forecast horizon in quarters (1-8, default 4); 2 = ~6 months ahead"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=predict_market_trajectory",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks which US states suit gas-fired data center power: the Data Center Gas Index (DCGI), a per-state score. ★ DO NOT COMPARE a DCGI figure published before 2026-08-08 with one published now — they are different indices; the full record is at /api/v1/dcgi/methodology under `corrections`. A state that cannot be priced comes back verdict UNSCORED with dcgi null and an `unscored_reason`, never a placeholder score, so treat UNSCORED as absence and not as a low score. `gas_price_series` names which EIA series answered each state. Gas-fired $/MWh figures, withdrawn the same day for a separate defect, were republished 2026-09-27 under one burner-tip price rule (see get_gas_economics). Every caller gets each state's gas_price in $/MMBtu, EIA survey data (public domain), dated by gas_price_period and gas_price_window and labelled by gas_price_series and gas_price_source; the DCGI score, its two sub-scores and the pipeline counts come with a full-access key. Use get_gas_intelligence for pipeline, operator and parent-midstream data. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results to return (1-500; default varies by tool) |
| state | string | US state abbreviation, e.g. TX, VA, AZ. Returns the DCGI score and verdict, plus `gas_price_series` naming which EIA series priced the state. |
{
"name": "get_gas_index",
"title": "Gas Index (DCGI)",
"description": "Use this when the user asks which US states suit gas-fired data center power: the Data Center Gas Index (DCGI), a per-state score. ★ DO NOT COMPARE a DCGI figure published before 2026-08-08 with one published now — they are different indices; the full record is at /api/v1/dcgi/methodology under `corrections`. A state that cannot be priced comes back verdict UNSCORED with dcgi null and an `unscored_reason`, never a placeholder score, so treat UNSCORED as absence and not as a low score. `gas_price_series` names which EIA series answered each state. Gas-fired $/MWh figures, withdrawn the same day for a separate defect, were republished 2026-09-27 under one burner-tip price rule (see get_gas_economics). Every caller gets each state's gas_price in $/MMBtu, EIA survey data (public domain), dated by gas_price_period and gas_price_window and labelled by gas_price_series and gas_price_source; the DCGI score, its two sub-scores and the pipeline counts come with a full-access key. Use get_gas_intelligence for pipeline, operator and parent-midstream data. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"state": {
"type": "string",
"description": "US state abbreviation, e.g. TX, VA, AZ. Returns the DCGI score and verdict, plus `gas_price_series` naming which EIA series priced the state."
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_gas_index",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "developer_for_full",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks what behind-the-meter gas power costs in a US data-center market: Henry Hub spot, regional basis differential, and the delivered industrial + electric gas tariff ($/MMBtu), each with its own source label. Pass market=<slug> (e.g. "northern-virginia", "dallas", "phoenix"). AZ, GA, FL), never a substitute price; if the backend switch is ever turned off again, `gas_to_grid_status` carries that reason. ★ DO NOT COMPARE a $/MWh published before 2026-09-27 with one published now — each surface then picked the price its own way, up to 5.5x apart. Do not derive a $/MWh yourself from the $/MMBtu layers for a withheld state without saying that you did. Every caller gets the EIA state survey prices (public domain): delivered_industrial_usd_mmbtu, delivered_electric_usd_mmbtu and the burner_tip price with its monthly min/max; figure_labels gives each figure's source, basis, period and as_of. The regional hub price and basis, gas_price_used_usd_mmbtu and the $/MWh table come with a full-access key, and figure_labels.henry_hub_spot_usd_mmbtu.served_to says who gets the Henry Hub spot. Do NOT use for the electricity grid fuel mix (use get_grid_data). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| market * | string | Market slug (metro), e.g. northern-virginia, dallas, phoenix — valid slugs come from rank_markets / get_market_dcpi_rank |
| heat_rate_btu_per_kwh | number | Optional custom generator heat rate in Btu/kWh for the gas-to-grid $/MWh scenario, e.g. 6800 (avg CCGT) |
{
"name": "get_gas_economics",
"title": "Get Gas Economics",
"description": "Use this when the user asks what behind-the-meter gas power costs in a US data-center market: Henry Hub spot, regional basis differential, and the delivered industrial + electric gas tariff ($/MMBtu), each with its own source label. Pass market=<slug> (e.g. \"northern-virginia\", \"dallas\", \"phoenix\"). AZ, GA, FL), never a substitute price; if the backend switch is ever turned off again, `gas_to_grid_status` carries that reason. ★ DO NOT COMPARE a $/MWh published before 2026-09-27 with one published now — each surface then picked the price its own way, up to 5.5x apart. Do not derive a $/MWh yourself from the $/MMBtu layers for a withheld state without saying that you did. Every caller gets the EIA state survey prices (public domain): delivered_industrial_usd_mmbtu, delivered_electric_usd_mmbtu and the burner_tip price with its monthly min/max; figure_labels gives each figure's source, basis, period and as_of. The regional hub price and basis, gas_price_used_usd_mmbtu and the $/MWh table come with a full-access key, and figure_labels.henry_hub_spot_usd_mmbtu.served_to says who gets the Henry Hub spot. Do NOT use for the electricity grid fuel mix (use get_grid_data). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"market"
],
"properties": {
"market": {
"type": "string",
"description": "Market slug (metro), e.g. northern-virginia, dallas, phoenix — valid slugs come from rank_markets / get_market_dcpi_rank"
},
"heat_rate_btu_per_kwh": {
"type": "number",
"description": "Optional custom generator heat rate in Btu/kWh for the gas-to-grid $/MWh scenario, e.g. 6800 (avg CCGT)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"problem": "PPAs and energy pricing",
"maturity": "mature",
"front_door": "get_energy_prices",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_gas_economics",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks how power grids compare: demand, fuel mix or renewable share. GLOBAL grid scoreboard — 9 US grid operators (the 7 US ISOs PJM, ERCOT, CAISO, MISO, SPP, NYISO, ISO-NE, plus BPA and TVA) + Great Britain (NESO) + the European bidding zones (Germany, France, Netherlands, Italy/Milan, Spain, Poland, Switzerland, Portugal, the Nordics + Central/Eastern Europe — via ENTSO-E; the exact live-vs-configured count is in counts_basis.eu_zones_live / eu_zones_configured, measured per call rather than asserted here) + Taiwan (Taipower) + Japan (OCCTO areas) + South Korea (KPX) + Brazil SIN (ONS), ranked side-by-side on each feed's LATEST PUBLISHED reading: renewable share %, gas share %, full fuel mix (gas/nuclear/coal/wind/solar/hydro MW), and demand. ★FRESHNESS IS NOT UNIFORM and every row says so: each carries mix_period, mix_age_hours and freshness_basis. Answers "which grid is cleanest right now", "how is ERCOT doing at this moment". Try: get_grid_scoreboard. Full guide: read resource dchub://tool-guides/get_grid_scoreboard For multi-step data center or energy questions, start with execute_plan.
No parameters.
{
"name": "get_grid_scoreboard",
"title": "Grid Scoreboard",
"description": "Use this when the user asks how power grids compare: demand, fuel mix or renewable share. GLOBAL grid scoreboard — 9 US grid operators (the 7 US ISOs PJM, ERCOT, CAISO, MISO, SPP, NYISO, ISO-NE, plus BPA and TVA) + Great Britain (NESO) + the European bidding zones (Germany, France, Netherlands, Italy/Milan, Spain, Poland, Switzerland, Portugal, the Nordics + Central/Eastern Europe — via ENTSO-E; the exact live-vs-configured count is in counts_basis.eu_zones_live / eu_zones_configured, measured per call rather than asserted here) + Taiwan (Taipower) + Japan (OCCTO areas) + South Korea (KPX) + Brazil SIN (ONS), ranked side-by-side on each feed's LATEST PUBLISHED reading: renewable share %, gas share %, full fuel mix (gas/nuclear/coal/wind/solar/hydro MW), and demand. ★FRESHNESS IS NOT UNIFORM and every row says so: each carries mix_period, mix_age_hours and freshness_basis. Answers \"which grid is cleanest right now\", \"how is ERCOT doing at this moment\". Try: get_grid_scoreboard. Full guide: read resource dchub://tool-guides/get_grid_scoreboard For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {},
"count": {},
"grids": {},
"source": {},
"coverage": {},
"freshness": {},
"ranked_by": {},
"counts_basis": {},
"zones_ranked": {},
"partial_grids": {},
"eu_gas_context": {},
"deep_intelligence": {},
"independent_sources": {},
"us_interconnection_queue_gw": {}
},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_grid_scoreboard",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks to compare two to four power grids side by side — fuel mix, demand, renewable/gas share, and for the US ISOs interconnection-queue depth and time-to-power — in one call instead of N sequential get_grid_intelligence calls. Example: "Compare PJM vs ERCOT vs CAISO on gas share, renewable share, and queue depth right now." — compare_isos isos="PJM,ERCOT,CAISO"; "ERCOT vs AESO vs EU_DE_LU" also works. Params: isos is a comma-separated list (2-4 max): any of the 7 US ISOs ("PJM" | "ERCOT" | "CAISO" | "MISO" | "SPP" | "NYISO" | "ISO-NE"), TVA, BPA, a US utility BA, or a non-US grid (IESO, AESO, HYDROQUEBEC, NGESO, EU_<zone>, TAIPOWER, OCCTO, KEPCO-KR, ONS, AEMO, EMA); non-US and non-ISO rows carry null DCPI and queue fields (not tracked, not zero). Returns: {isos[], comparison:{<iso>:{demand_mw, generation_mix_pct, renewable_share_pct, gas_share_pct, constraint_score, excess_power_score, avg_time_to_power_months, avg_queue_wait_months, queue_depth_gw, retail_price_cents_kwh}}, as_of}. ★avg_time_to_power_months (DCPI per-market estimate, ISO-averaged) and avg_queue_wait_months (proxy from live queue DEPTH) are DIFFERENT measurements — quote whichever you mean by name. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| isos * | string | Comma-separated list of 2-4 grids to compare, e.g. "PJM,ERCOT,CAISO" or "ERCOT,AESO,EU_DE_LU": US ISOs (ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE), TVA, BPA, utility BAs, or non-US grids (IESO, AESO, HYDROQUEBEC, NGESO, EU_<zone>,… |
{
"name": "compare_isos",
"title": "Compare ISO Regions",
"description": "Use this when the user asks to compare two to four power grids side by side — fuel mix, demand, renewable/gas share, and for the US ISOs interconnection-queue depth and time-to-power — in one call instead of N sequential get_grid_intelligence calls. Example: \"Compare PJM vs ERCOT vs CAISO on gas share, renewable share, and queue depth right now.\" — compare_isos isos=\"PJM,ERCOT,CAISO\"; \"ERCOT vs AESO vs EU_DE_LU\" also works. Params: isos is a comma-separated list (2-4 max): any of the 7 US ISOs (\"PJM\" | \"ERCOT\" | \"CAISO\" | \"MISO\" | \"SPP\" | \"NYISO\" | \"ISO-NE\"), TVA, BPA, a US utility BA, or a non-US grid (IESO, AESO, HYDROQUEBEC, NGESO, EU_<zone>, TAIPOWER, OCCTO, KEPCO-KR, ONS, AEMO, EMA); non-US and non-ISO rows carry null DCPI and queue fields (not tracked, not zero). Returns: {isos[], comparison:{<iso>:{demand_mw, generation_mix_pct, renewable_share_pct, gas_share_pct, constraint_score, excess_power_score, avg_time_to_power_months, avg_queue_wait_months, queue_depth_gw, retail_price_cents_kwh}}, as_of}. ★avg_time_to_power_months (DCPI per-market estimate, ISO-averaged) and avg_queue_wait_months (proxy from live queue DEPTH) are DIFFERENT measurements — quote whichever you mean by name. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"isos"
],
"properties": {
"isos": {
"type": "string",
"description": "Comma-separated list of 2-4 grids to compare, e.g. \"PJM,ERCOT,CAISO\" or \"ERCOT,AESO,EU_DE_LU\": US ISOs (ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE), TVA, BPA, utility BAs, or non-US grids (IESO, AESO, HYDROQUEBEC, NGESO, EU_<zone>,…"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=compare_isos",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "developer_for_full",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks how the data center market looks overall, across all markets: ONE global DC Hub index, not a per-market score, and it takes no arguments (no market filter). Returns a global pulse score (0-100), dataset totals (tracked facility records, pipeline GW, deals in the last 90 days, substations), a heat map of the highest-scoring markets and the top markets by score. Answers "how is the data center market overall right now", "which markets lead DC Hub's index". Try: get_intelligence_index (no arguments). Global snapshot only; do NOT use for one market's score or verdict (use get_market_dcpi_rank), one market's full metric set (use get_market_intel) or to rank markets with filters (use rank_markets). For multi-step data center or energy questions, start with execute_plan.
No parameters.
{
"name": "get_intelligence_index",
"title": "Market Intelligence Index",
"description": "Use this when the user asks how the data center market looks overall, across all markets: ONE global DC Hub index, not a per-market score, and it takes no arguments (no market filter). Returns a global pulse score (0-100), dataset totals (tracked facility records, pipeline GW, deals in the last 90 days, substations), a heat map of the highest-scoring markets and the top markets by score. Answers \"how is the data center market overall right now\", \"which markets lead DC Hub's index\". Try: get_intelligence_index (no arguments). Global snapshot only; do NOT use for one market's score or verdict (use get_market_dcpi_rank), one market's full metric set (use get_market_intel) or to rank markets with filters (use rank_markets). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_intelligence_index",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "developer_for_full",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks about data center M&A, acquisitions or capital deals — tracked deals (2019-present; total_count in the result, where shown, gives the live number), each with its disclosed value where public (many private deals are undisclosed). Returns deal name, buyer, seller, value, date, market, target operator, type (acquisition/JV/refinance/recap). Filter by date range (date_from/date_to, ISO-8601), min_value_usd, region, buyer, or seller. Answers "which data-center deals closed this year", "what was that acquisition worth". Try: list_transactions date_from=2026-01-01 min_value_usd=1000000000. There is no `year` parameter — use date_from/date_to. Broad M&A and capital-deal flow with filters; do NOT use for hyperscaler-specific lease/PPA/JV activity (use hyperscaler_deals) or a single-deal post-mortem (use deal_autopsy). limit 1-500 (a preview returns up to 10), offset 0-100000; total_count is the full match count. Empty = loosen buyer/seller/value filters. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| buyer | string | Filter by acquiring company name, e.g. Blackstone, KKR, Digital Realty |
| limit | integer | Max results to return (1-500; default varies by tool) |
| offset | integer | Pagination offset, 0-based (skip this many results) |
| region | string | Geographic region filter, e.g. us, eu, apac, americas |
| seller | string | Filter by selling/target company name, e.g. CyrusOne |
| date_to | string | Latest deal date, ISO-8601 (YYYY-MM-DD) |
Use this when the user asks for data center industry news or headlines (execute_plan also pulls news inside a broader market question). Curated data center industry news from 40+ trade sources (DCD, Data Center Knowledge, Data Center Frontier, Capacity Media, The Register Data Centre, Fierce Telecom, etc.) refreshed every 30 min. Returns title, summary, source, published_at, and the market/operator entities mentioned. Filter by category (deals/permits/outages/policy/AI). Answers "what is happening in the data center industry this week", "any news on AI capacity". Try: get_news category=AI limit=10. The parameter is `category`, not `topic`. Industry news only; do NOT use for structured M&A deal data (use list_transactions) or the construction pipeline (use get_pipeline). limit 1-500 (a preview returns up to 20). Empty data = no matching news: drop category/source or widen date_from/date_to. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results to return (1-500; default varies by tool) |
| query | string | Free-text keyword to filter news, e.g. "Stargate" or "interconnection queue" |
| source | string | Restrict to one trade source, e.g. DCD, "Data Center Frontier", "Capacity Media" |
| date_to | string | Latest published date, ISO-8601 (YYYY-MM-DD) |
| category | string | News topic filter, e.g. deals, permits, outages, policy, AI |
| date_from | string | Earliest published date, ISO-8601 (YYYY-MM-DD) |
| min_relevance |
Use this when a data center or energy question is conceptual or fuzzy and keyword filters fall short — semantic (meaning-based) retrieval across DC Hub's industry news, M&A deals, the global facility map, per-market DCPI deep-dive narratives, press releases, announcements, permitting intel, construction permits, tax incentives and the capacity pipeline, ranked by relevance with citable source fields (news url/title, deal parties/value, facility name/location, deep-dive market/url). Examples: "what is happening with behind-the-meter gas for AI data centers?", "deals involving nuclear power for hyperscalers", "why is Northern Virginia constrained?" — semantic_search q="behind-the-meter gas for AI data centers". Params: q (required, natural-language query); corpus (optional CSV subset of news_articles,deals,facilities,market_narratives,press_releases,announcements,permitting_intel,construction_permits,tax_incentives,capacity_pipeline; default all); k (1-15, default 8). Returns {results:[{source_table, kind, text, score, cite:{…}}]}; score is 0-1 relevance, not a DCPI score. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| k | number | Number of results, 1-15 (default 8) |
| q | string | Natural-language query (required), e.g. "grids opening up for AI load in the Southeast" |
| query | string | Alias for q — the same natural-language query; send exactly one of q/query |
| corpus | string | Optional CSV of corpora: news_articles, deals, discovered_facilities, market_narratives (default: all) |
Use this when you need meaning-based search over DC Hub's data center intelligence corpus, choosing corpora — industry news, M&A deals, discovered facilities, per-market DCPI narratives, press releases, announcements, permitting intel, construction permits, tax incentives and the capacity pipeline — returning the most relevant records with citable source fields. This is the agent-friendly alias over the SAME retrieval layer as semantic_search: same results, different call shape. It takes `query` plus short corpus names (news | deals | facilities | market_narratives | press | announcements | permitting | permits | incentives | pipeline); semantic_search takes `q` plus the full corpus names. Call ONE of them, not both. Params: query (required, natural language); corpus (optional CSV of the names above, default all); limit (1-15, default 8). BEHAVIOUR: read-only — it writes nothing, and repeat calls with the same arguments return the same records. ACCESS: works with no key, but anonymous results come back as a TRIMMED PREVIEW; the session X-API-Key (DCHUB_API_KEY) hydrates full depth (call get_api_key once if you do not hold a key). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| q | string | Alias for query |
| limit | number | Max results to return, 1-15 (default 8) |
| query | string | Natural-language query (required), e.g. "grids opening up for AI load in the Southeast" |
| corpus | string | Optional corpus to restrict to: news | deals | facilities | market_narratives. CSV of several is allowed; default searches all. |
Use this when you need a whole data center market briefing for your context window — one call returns a token-budgeted context pack for a data-center market: DCPI verdict, power & grid facts, the Claude-written 12-month outlook, M&A deals, construction pipeline, operator footprint, transaction comps, risk factors, and top news — each section with its own token count, as_of timestamp, and citable URL, greedily filled in that priority order under your max_tokens budget. Example: "Brief me on the Columbus data-center market" — get_market_context market=columbus max_tokens=4000. Params: market (required, market slug e.g. northern-virginia — valid slugs come from rank_markets); max_tokens (optional, 200-8000, default 4000). Returns {sections:[{id,title,text,tokens,as_of,cite}], used_tokens, omitted}. Do NOT use for a single metric (use get_market_dcpi_rank), the raw structured metric set (use get_market_intel), or cross-market ranking (use rank_markets); this is the narrative briefing pack. Cite "DC Hub (dchub.cloud)". For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| market * | string | Market slug (required), e.g. northern-virginia, dallas, phoenix — valid slugs come from rank_markets / get_market_dcpi_rank |
| max_tokens | number | Token budget for the pack, 200-8000 (default 4000); sections are filled in priority order until the budget is spent |
{
"name": "get_market_context",
"title": "Get Market Context",
"description": "Use this when you need a whole data center market briefing for your context window — one call returns a token-budgeted context pack for a data-center market: DCPI verdict, power & grid facts, the Claude-written 12-month outlook, M&A deals, construction pipeline, operator footprint, transaction comps, risk factors, and top news — each section with its own token count, as_of timestamp, and citable URL, greedily filled in that priority order under your max_tokens budget. Example: \"Brief me on the Columbus data-center market\" — get_market_context market=columbus max_tokens=4000. Params: market (required, market slug e.g. northern-virginia — valid slugs come from rank_markets); max_tokens (optional, 200-8000, default 4000). Returns {sections:[{id,title,text,tokens,as_of,cite}], used_tokens, omitted}. Do NOT use for a single metric (use get_market_dcpi_rank), the raw structured metric set (use get_market_intel), or cross-market ranking (use rank_markets); this is the narrative briefing pack. Cite \"DC Hub (dchub.cloud)\". For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"market"
],
"properties": {
"market": {
"type": "string",
"description": "Market slug (required), e.g. northern-virginia, dallas, phoenix — valid slugs come from rank_markets / get_market_dcpi_rank"
},
"max_tokens": {
"type": "number",
"description": "Token budget for the pack, 200-8000 (default 4000); sections are filled in priority order until the budget is spent"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_market_context",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "developer_for_full",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when you need a whole power grid (ISO) briefing for your context window — one call returns a token-budgeted context pack for a US ISO/RTO: live grid snapshot (demand, fuel-mix shares), DCPI verdict mix & grid economics across the ISO's tracked markets (queue wait, power cost, reserve margin), interconnection-queue depth with the largest projects, real-time benchmark LMP, the tracked DCPI market list, deep-dive narrative excerpts, and recent news — each section with its own token count, as_of timestamp, and citable URL, greedily filled in that priority order under your max_tokens budget. Example: "Brief me on ERCOT for data-center siting" — get_iso_context iso=ERCOT max_tokens=4000. Params: iso (required: ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE); max_tokens (optional, 200-8000, default 4000). Returns {sections:[{id,title,text,tokens,as_of,cite}], used_tokens, omitted}. Do NOT use for raw single-ISO telemetry (use get_grid_data), the per-ISO decision brief with headroom/TTP (use get_grid_intelligence), multi-ISO scalar comparison (use compare_isos), or non-US grids (use get_grid_scoreboard); this is the narrative briefing pack. Cite "DC Hub (dchub.cloud)". iso is required (US ISO code). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| iso * | string | ISO/RTO grid region (required): ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE |
| max_tokens | number | Token budget for the pack, 200-8000 (default 4000); sections are filled in priority order until the budget is spent |
{
"name": "get_iso_context",
"title": "Get Iso Context",
"description": "Use this when you need a whole power grid (ISO) briefing for your context window — one call returns a token-budgeted context pack for a US ISO/RTO: live grid snapshot (demand, fuel-mix shares), DCPI verdict mix & grid economics across the ISO's tracked markets (queue wait, power cost, reserve margin), interconnection-queue depth with the largest projects, real-time benchmark LMP, the tracked DCPI market list, deep-dive narrative excerpts, and recent news — each section with its own token count, as_of timestamp, and citable URL, greedily filled in that priority order under your max_tokens budget. Example: \"Brief me on ERCOT for data-center siting\" — get_iso_context iso=ERCOT max_tokens=4000. Params: iso (required: ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE); max_tokens (optional, 200-8000, default 4000). Returns {sections:[{id,title,text,tokens,as_of,cite}], used_tokens, omitted}. Do NOT use for raw single-ISO telemetry (use get_grid_data), the per-ISO decision brief with headroom/TTP (use get_grid_intelligence), multi-ISO scalar comparison (use compare_isos), or non-US grids (use get_grid_scoreboard); this is the narrative briefing pack. Cite \"DC Hub (dchub.cloud)\". iso is required (US ISO code). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"iso"
],
"properties": {
"iso": {
"type": "string",
"description": "ISO/RTO grid region (required): ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE"
},
"max_tokens": {
"type": "number",
"description": "Token budget for the pack, 200-8000 (default 4000); sections are filled in priority order until the budget is spent"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {},
"iso": {},
"tier": {},
"cite_as": {},
"sections": {},
"max_tokens": {},
"used_tokens": {},
"locked_sections": {}
},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_iso_context",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "developer_for_full",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks what data centers are being built, announced or permitted in a market or by an operator. Example: "What is under construction in Northern Virginia and when does it come online?" — get_pipeline market=northern-virginia status=construction. Params: market (slug or name, e.g. "northern-virginia", "dallas"; projects labelled only with the state are counted apart, see scope.note); state (USPS, e.g. "VA"); status one of "announced" | "permitted" | "construction" | "operational"; operator (e.g. "Equinix", "AWS"); country (ISO-2, e.g. "US"); min_capacity_mw (e.g. 50); expected_completion_before (ISO date; undated projects are kept and marked, completion_filter counts them); limit/offset. Each row carries expected_cod, null with expected_cod_basis when no source states one. One named project: name="Stargate Abilene" (or a codename, developer plus place) returns the best matching record first, with developer, county, state, stated MW, status, expected_cod, source_url and as_of, other matching records beside it, or name_lookup.message saying no record matches. Do NOT use for already-operational facilities (use search_facilities) or for the M&A deal flow (use list_transactions). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| name | string | A named project or campus, e.g. "Stargate Abilene", "Project Firecracker" or "Crusoe Abilene": the best matching record comes first; when nothing matches, name_lookup.message says so |
| limit | integer | Max results to return (1-500; default varies by tool) |
| state | string | US state (USPS code), e.g. VA, TX |
| market | string | Market slug or name to keep projects inside, e.g. northern-virginia, dallas |
| offset | integer |
Use this when the user asks where new power generation is coming online (the forward supply pipeline) — e.g. "how much new generation is planned in Virginia / the Southeast / ERCOT, and when?". Planned, permitting, and under-construction generators NATIONWIDE from EIA-860M, INCLUDING non-ISO regions (TVA, Southern Co, Arizona PS, PacifiCorp, LADWP) that interconnection-queue feeds miss. Each generator has location (lat/lng), state, county, balancing authority, technology/fuel (solar photovoltaic, onshore wind, natural-gas combined cycle, batteries, nuclear), nameplate megawatts (MW), status (planned → under construction), and planned online month/year. Filter by state (2-letter, e.g. VA), ba (balancing-authority/ISO code, e.g. PJM, ERCO, SOCO, TVA), status (P/L/T=planned, U/V=under construction, TS=testing), or min_mw. Returns a summary (total planned MW, mix by technology + status) plus the largest projects. Answers "how much new generation is planned in Virginia and when does it land". Try: get_power_pipeline state=VA. Do NOT use for ALREADY-OPERATING capacity or grid headroom (use get_grid_intelligence / get_grid_data) or for data-center construction projects (use get_pipeline). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| ba | string | Balancing-authority / ISO code, e.g. PJM, ERCO, SOCO, TVA, AZPS |
| limit | integer | Max results to return (1-500; default varies by tool) |
| state | string | US state abbreviation to filter generators, e.g. VA, TX |
| min_mw | number | Minimum nameplate capacity filter in megawatts (MW) |
| status | string | Generator status code: P/L/T (planned), U/V (under construction), TS (testing) |
Use this when the user asks what gas pipeline or transmission line projects are planned, proposed, approved or under construction — the forward build-out, not the existing network. e.g. "which interstate gas pipelines are under construction into Louisiana?", "what 345 kV transmission projects are planned in PJM by 2030?", "what new projects appeared since last month?". COVERS: (1) natural gas pipeline projects US-wide from the EIA natural gas pipeline projects list (public domain) — operator, status (Announced, Pre-applied, Applied, Approved, Construction, On Hold, Completed), states crossed, capacity in MMcf/d, miles, cost in $M, diameter, FERC/state docket, in-service year; (2) transmission projects from five ISOs' own project lists — ERCOT (TPIT), PJM (RTEP), MISO (MTEP Appendix A), SPP (STEP) and ISO-NE (RSP list); NOT CAISO or NYISO, and not utilities outside those ISOs. Each ISO publishes a different grain (an upgrade or facility, not a whole project), so a row count is a count of upgrades. Answers "what gas pipelines are being built into Louisiana, how much capacity do they add, and when do they enter service". Try: get_infra_projects type=gas_pipeline state=LA status=Construction. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| type | string | Which project list: gas_pipeline (EIA, US-wide), transmission (ERCOT TPIT, Texas only) or all (default) |
| limit | integer | Max results to return (1-500; default varies by tool) |
| state | string | US state abbreviation, e.g. TX or LA. Gas projects match any state they cross; transmission projects are all TX |
| min_kv | number | Transmission only: minimum voltage in kilovolts (kV), e.g. 345. With type=all it narrows to transmission projects |
| status | string |
Use this when the user asks when power will be available, or about time-to-power, in a US state: year by year. Composes: new generation coming online from EIA-860M monthly, split by confidence class (under-construction vs planned vs testing — never blended); scheduled retirements as dated subtractions; LBNL interconnection-queue depth as congestion context (NO delivery dates — the feed has none and most queued MW never completes). The one derived number, cumulative_firm_signal_mw, counts ONLY under-construction+testing minus retirements — speculative permitting-stage MW is shown but never folded in. Answers "when is new capacity landing in Ohio", "what comes online in Georgia by 2027" with dated, sourced, per-lane-vintaged numbers. HONESTY LINE: supply-side signals, not a load-interconnection promise — generation ≠ deliverable load, and utility study timelines / large-load tariff processes / substation-grain delivery are declared out of coverage in constraint_coverage rather than estimated. Try: get_power_availability_timeline state=OH. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| mw | number | Optional target MW for CONTEXT ONLY — echoed back with an explicit note; never converted into an energize-by date, which this data cannot honestly state |
| state * | string | 2-letter US state code (required), e.g. OH, GA, TX — the timeline grain; a state can span ISOs and the response reports ISO membership as context |
| years | number | Window in years from now, 1-6 (default 5) |
{
"name": "get_power_availability_timeline",
"title": "Get Power Availability Timeline",
"description": "Use this when the user asks when power will be available, or about time-to-power, in a US state: year by year. Composes: new generation coming online from EIA-860M monthly, split by confidence class (under-construction vs planned vs testing — never blended); scheduled retirements as dated subtractions; LBNL interconnection-queue depth as congestion context (NO delivery dates — the feed has none and most queued MW never completes). The one derived number, cumulative_firm_signal_mw, counts ONLY under-construction+testing minus retirements — speculative permitting-stage MW is shown but never folded in. Answers \"when is new capacity landing in Ohio\", \"what comes online in Georgia by 2027\" with dated, sourced, per-lane-vintaged numbers. HONESTY LINE: supply-side signals, not a load-interconnection promise — generation ≠ deliverable load, and utility study timelines / large-load tariff processes / substation-grain delivery are declared out of coverage in constraint_coverage rather than estimated. Try: get_power_availability_timeline state=OH. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"state"
],
"properties": {
"mw": {
"type": "number",
"description": "Optional target MW for CONTEXT ONLY — echoed back with an explicit note; never converted into an energize-by date, which this data cannot honestly state"
},
"state": {
"type": "string",
"description": "2-letter US state code (required), e.g. OH, GA, TX — the timeline grain; a state can span ISOs and the response reports ISO membership as context"
},
"years": {
"type": "number",
"description": "Window in years from now, 1-6 (default 5)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"limits": "supply-side signals, not a load-interconnection promise — generation is not deliverable load · utility study timelines, large-load tariff processes and substation-grain delivery are declared out of coverage rather than estimated",
"problem": "grid headroom and power availability",
"maturity": "mature",
"front_door": "execute_plan",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_power_availability_timeline",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks about power plants worldwide or in a non-US country — operating AND the forward pipeline (announced / pre-construction / under-construction), across ALL fuels (coal, oil/gas, nuclear, solar, wind, hydro, bioenergy, geothermal). Global Energy Monitor Global Integrated Power Tracker: 182,000+ geolocated units across 170+ countries, each with fuel, capacity (MW), status, start year, operator/owner and lat/lng. Filter by country (e.g. Germany, India, Brazil, Japan), fuel (comma-union: coal, oil/gas, nuclear, solar, wind, hydro), status, pipeline=true (JUST the forward set: announced + pre-construction + construction), bbox (minLng,minLat,maxLng,maxLat), or min_mw. Returns a summary (total MW by fuel + count by status) plus the largest units. Answers "what power is being built in India", "how much coal is still running in Vietnam". Try: get_global_power country=India pipeline=true. country= also adds electricity_monthly (Ember, CC BY 4.0): latest monthly mix, demand, carbon intensity. Do NOT use for US grid telemetry/headroom (use get_grid_intelligence / get_grid_scoreboard) or the US planned-generator feed (use get_power_pipeline) — this is the GLOBAL asset inventory. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| bbox | string | Viewport filter as minLng,minLat,maxLng,maxLat |
| fuel | string | Fuel/type filter, comma-separated for a union: coal, oil/gas, nuclear, solar, wind, hydro, bioenergy, geothermal |
| limit | integer | Max results to return (1-500; default varies by tool) |
| min_mw | number | Minimum unit capacity in MW |
| status | string | Status substring filter, e.g. operating, construction, pre-construction, announced |
Use this when the user asks about grid interconnection queues: how congested an ISO's queue is or how much data-center load is waiting. Returns queued generation GW per ISO. The projects field changes shape: with iso= it is an array of per-project rows; without iso it is an all-ISO summary object (total, by_iso_count, top). ERCOT also returns its large-load (data-center) queue; other ISOs don't publish one. iso=NESO returns Great Britain's NESO TEC Register (Transmission Entry Capacity): generation and demand connections together under queued_connections_gw, not a generation queue. Can be scoped to a data center market or site: execute_plan pairs the queue with that place's facilities and its Data Center Power Index (DCPI) verdict. Keyless: a trimmed preview; DCHUB_API_KEY is optional, and a key with a bound email unlocks full answers. Ex: "How deep is ERCOT's queue?" iso optional (US ISO code); keyless = preview. For demand and headroom on the same ISO also call get_grid_intelligence. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| iso | string | ISO/RTO grid region to drill into: ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE, or NESO for Great Britain (the NESO TEC Register: generation and demand connections together, not a generation-only queue); omit for the all-ISO snapshot |
| mpp_pay | boolean | Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call. |
| mpp_credential | string | Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge. |
Use this when you need interconnection queue projects filtered server-side. Instead of pulling the raw queue into context to filter (token-expensive, error-prone), push the predicates to the data layer and get back ONLY the survivors. Filter by min_mw, max_ttp_months (ISO-level avg interconnection wait), iso (comma-union), state (the project's own US state), baseload_only (firm/dispatchable — excludes wind/solar/storage), fuel_type (isolate a specific fuel, e.g. gas or nuclear), and the spatial predicates max_fiber_km + geocoded_only. Answers "show me 1 GW+ gas projects that can connect in under three years", "what is in the queue that actually fits my timeline". Try: get_refined_queue min_mw=1000 fuel_type=gas max_ttp_months=34 — "1 GW+ gas in ISOs under 34-month time-to-power." NOTE max_ttp_months is a HARD ISO cut (SPP ~24 is the only ISO under 30, so <=30 can return nothing); use >=34 to include MISO/ERCOT/ISO-NE. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| iso | string | Restrict to one or more ISOs, comma-separated for a union: PJM, ERCOT, MISO, CAISO, SPP, NYISO, ISONE (ISO-NE). e.g. iso=ERCOT,PJM. Omit for all; combines with max_ttp_months as an intersection |
| limit | integer | Max results to return (1-500; default varies by tool) |
| state | string | Restrict to projects in one or more US states, by the project's own state (two-letter code or full name, comma-separated for a union), e.g. state=NV. |
| min_mw | number | Minimum project capacity in MW, e.g. 1000 for 1 GW+ |
| status | string | Queue status filter. Default 'active' = still progressing (excludes withdrawn/cancelled/suspended/in-commercial-operation) — cross-ISO safe (SPP labels live projects 'IA FULLY EXECUTED/ON SCHEDULE' not 'active'). |
Use this when the user asks where retiring power plants free grid capacity: scans EIA-860M retirements to find near-term transmission grid headroom — a retiring plant is a CONCRETE headroom event (its POI frees injection capacity), from FILED data, not forecasts. Returns _entity=retirement_headroom_results: retiring generators inside your horizon (name, MW, fuel, prime mover, retirement_date), representative_point, nearest substations with distance_km + count within 25 km, county-level queue_pressure (competing in-progress MW), iso_context (the generator's own EIA balancing-authority code), and a pre-filled site_evaluation_handoff (analyze_site + get_water_risk args, capacity_mw = YOUR target load). Answers "where is grid capacity about to free up", "which retiring plants open injection headroom near me". Try: get_retirement_headroom target_mw=50 horizon_months=18 region_iso=MISO — "50 MW opening near a substation inside 18 months, sidestepping the 4-7yr mega-queue." Honesty: meta.caveat flags that filed dates are subject to ISO reliability reviews (RMR extensions). Use to find WHERE capacity opens next; for what's already queued use get_refined_queue; for one site use analyze_site. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results to return (1-500; default varies by tool) |
| target_mw * | number | Minimum required headroom in megawatts (MW) — filters to retiring generators at/above this size. Also passed through as the handoff's analyze_site capacity_mw (the DC you are siting). |
| region_iso | string | Optional target region or ISO (e.g., 'MISO', 'PJM', 'ERCOT', 'SPP', 'CAISO', 'NYISO', 'ISONE'). Matches the generator's own EIA balancing-authority code — real market boundaries, not state lines. Comma-separated for a union. |
| fuel_filter | string |
Use this when the user asks how many MW a distribution feeder can take: utility-published hosting capacity — the MW a NAMED distribution feeder can actually take, straight from the utility's own hosting-capacity GIS. Published records from many utilities (e.g. Con Edison, National Grid NY/MA, NYSEG/RG&E, Rhode Island Energy, Orange & Rockland, Central Hudson, Eversource CT, BGE, Pepco/Delmarva/ACE, Dominion VA, Ameren Illinois, AEP Ohio & I&M, Xcel MN/CO, DTE, Avista; the no-args call lists current coverage). This is filed distribution-level truth, not a proximity proxy. Three ways to call it: lat+lon (+radius_km, default 25) for a point; utility or market for a whole published territory; NO ARGS for the coverage list of every market that has data. Answers "can this feeder actually take 20 MW", "where can I plug in without waiting on a substation upgrade". Try: get_hosting_capacity utility="Ameren Illinois" capacity_type=load min_mw=5. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Latitude of the point to search around, decimal degrees. Must be paired with lon. |
| lng | number | Alias for lon — either name works |
| lon | number | Longitude of the point to search around, decimal degrees. Must be paired with lat. |
| limit | integer | Max results to return (1-500; default varies by tool) |
| market | string | Alias for utility — either name works (e.g. "Northern Virginia · Richmond", "New York City · Westchester"). |
| min_mw | number | Only return feeders whose published capacity is at or above this many MW. |
Use this when the user has a land parcel for a data center site: structured read of its boundary — pass your own GeoJSON Polygon/MultiPolygon, OR just lat+lon and DC Hub finds the containing parcel in its HOSTED parcel-boundary layer (public county/state GIS polygons, covering a set of priority data-center counties in VA, IL, TX, OH, UT, OR, IA and WY; a point outside it returns parcel_not_covered with the analyze_site preview + the coverage list, never a guess). Returns _entity=parcel_analysis: geodesic total_acres, a per-member acreage breakdown, a contiguous flag, representative_point = the centroid of the LARGEST-area member (never the multi-part geometric center, which can land off-parcel on a highway median or river and poison every point-keyed read), and hosted_parcel {parcel_id, county, state, acres_per_source} when the polygon came from the hosted layer. Also returns a site_evaluation_handoff to pipe into analyze_site + get_water_risk at that anchor. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Latitude of a point ON the parcel — used with lon when geometry is omitted to look up the containing parcel from the hosted county/state GIS layer |
| lng | number | Alias for lon — either name works |
| lon | number | Longitude of a point ON the parcel (used with lat when geometry is omitted) |
| geometry | any | GeoJSON Polygon or MultiPolygon parcel boundary, e.g. {"type":"Polygon","coordinates":[[[lng,lat],[lng,lat],...]]} — a MultiPolygon carries discontinuous parcels as one envelope. Omit to look up the hosted parcel containing lat/lon instead |
| latitude | number | Alias for lat — either name works |
Use this when you have enriched candidate data center sites to rank under constraints — the normalization contract that lets you compare sites across separate analyze_site calls WITHOUT dropping into code. Pass candidates you already enriched (each an object with lat/lng + metric fields like risk_resilience, water_stress, fiber_km — pull these from analyze_site + get_refined_queue and pass site_evaluation_handoff through untouched), hard constraints, and weighted objectives; get back _entity=ranked_sites: top_k ranked with rank, objective_score, per-field normalized{} (0-100 relative to the set), and normalization_basis. objectives use SIGNED weights: +weight maximizes a field (e.g. risk_resilience:1), -weight minimizes it (e.g. water_stress:-0.6, fiber_km:-0.4). constraints are hard filters, fail-closed on a missing field. Use for "pick the best N sites under constraints"; for one site use analyze_site; to get the candidate set first use get_refined_queue. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| top_k | integer | How many top-ranked sites to return (1-50, default 3) |
| absolute | boolean | false (default) = min-max normalize within THIS batch (best-in-set, NOT stable across runs). true = score on a FIXED 0-100 scale for CROSS-RUN-STABLE, auditable scores — use ONLY when the objective fields are already 0-100 (analyze_site… |
| candidates | any | Array of candidate objects. PREFERRED: {candidate_id: "cand_…", <your metric fields>} using ids from get_refined_queue — frozen coordinates/capacity/fiber_km load from the mint (zero transcription drift), your enrichments (e.g. |
| objectives | any | Weighted objectives {field: signedWeight} — +weight maximizes, -weight minimizes. e.g. {"water_stress": -0.6, "fiber_km": -0.4}. Omit with shortlist_name to reuse the shortlist's saved objectives; required with candidates |
Use this when you are unsure which DC Hub data center, power or grid tool fits: lists tools by family. Returns _entity=tool_families — a front_door block (execute_plan for any multi-capability question, get_changes to refresh) plus families with a when-to-use note + their tools (facility, market, grid_power, gas_btm, site_geometry, fiber, deals_news, saved_work, account_meta, partner), optionally filtered by a query. Then call the chosen tool (its full schema is in tools/list). This is a navigation layer, not the exhaustive catalog — tools/list stays canonical, and if you are BINDING a capability map, bind it from tools/list, not from here. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| query | string | Optional keyword to filter families/tools, e.g. "site selection", "grid queue", "fiber", "deals", "market" |
{
"name": "discover_tools",
"title": "Discover Tools",
"description": "Use this when you are unsure which DC Hub data center, power or grid tool fits: lists tools by family. Returns _entity=tool_families — a front_door block (execute_plan for any multi-capability question, get_changes to refresh) plus families with a when-to-use note + their tools (facility, market, grid_power, gas_btm, site_geometry, fiber, deals_news, saved_work, account_meta, partner), optionally filtered by a query. Then call the chosen tool (its full schema is in tools/list). This is a navigation layer, not the exhaustive catalog — tools/list stays canonical, and if you are BINDING a capability map, bind it from tools/list, not from here. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Optional keyword to filter families/tools, e.g. \"site selection\", \"grid queue\", \"fiber\", \"deals\", \"market\""
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=discover_tools",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when you want to see the plan for a data center question without running it (execute_plan runs the same planner and returns the answers). Reach for plan_query only to review, log, diff or audit a plan before executing it yourself. Deterministic keyword routing over the tool registry — no LLM, no network, same intent always returns the same plan. Returns _entity=query_plan {best_tool, intent_confidence + workflow_confidence (dual 0-1: question-read vs executability), reason, planner_rationale, recommended_sequence:[{step, tool, depends_on, estimated_calls, why, args_hint}], execution_waves (steps grouped into concurrency waves), execution_strategy.parallel_groups, execution_estimate {estimated_calls, estimated_latency_ms, parallelizable}, alternatives (each with when + rejected_because), coverage_notes, matched_classes} plus a versioned `replay` (schema_version 1): planner_version, decisions:[{id, step, kind, status, decision, rationale, decision_confidence, depends_on}], rejected:[{id, tool, reason}], execution_graph:{waves, parallel_groups} — auditable and machine-readable, safe to log and diff across versions. Full guide: read resource dchub://tool-guides/plan_query For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| intent * | string | Natural-language description of what you are trying to find out, e.g. "rank markets for a 200MW AI campus" or "how much power is available in ERCOT" |
| context | any | Optional structured hints: {lat, lon, iso, market, capacity_mw, candidate_id, state (2-letter), since} — sharpens args_hint values and routing (e.g. lat/lon boosts the site-analysis route) |
{
"name": "plan_query",
"title": "Plan Query",
"description": "Use this when you want to see the plan for a data center question without running it (execute_plan runs the same planner and returns the answers). Reach for plan_query only to review, log, diff or audit a plan before executing it yourself. Deterministic keyword routing over the tool registry — no LLM, no network, same intent always returns the same plan. Returns _entity=query_plan {best_tool, intent_confidence + workflow_confidence (dual 0-1: question-read vs executability), reason, planner_rationale, recommended_sequence:[{step, tool, depends_on, estimated_calls, why, args_hint}], execution_waves (steps grouped into concurrency waves), execution_strategy.parallel_groups, execution_estimate {estimated_calls, estimated_latency_ms, parallelizable}, alternatives (each with when + rejected_because), coverage_notes, matched_classes} plus a versioned `replay` (schema_version 1): planner_version, decisions:[{id, step, kind, status, decision, rationale, decision_confidence, depends_on}], rejected:[{id, tool, reason}], execution_graph:{waves, parallel_groups} — auditable and machine-readable, safe to log and diff across versions. Full guide: read resource dchub://tool-guides/plan_query For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"intent"
],
"properties": {
"intent": {
"type": "string",
"description": "Natural-language description of what you are trying to find out, e.g. \"rank markets for a 200MW AI campus\" or \"how much power is available in ERCOT\""
},
"context": {
"description": "Optional structured hints: {lat, lon, iso, market, capacity_mw, candidate_id, state (2-letter), since} — sharpens args_hint values and routing (e.g. lat/lon boosts the site-analysis route)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {},
"note": {},
"intent": {},
"reason": {},
"replay": {
"type": "object"
},
"chaining": {},
"best_tool": {},
"confidence": {},
"alternatives": {},
"intent_class": {},
"routing_hint": {},
"coverage_notes": {},
"parallelizable": {},
"estimated_calls": {},
"execution_waves": {},
"matched_classes": {},
"intent_confidence": {},
"planner_rationale": {},
"execution_estimate": {},
"execution_strategy": {},
"workflow_confidence": {},
"recommended_sequence": {},
"workflow_confidence_basis": {}
},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=plan_query",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user wants to keep a data center site on a named shortlist that survives across conversations (Phase 5 statefulness). Snapshots the site's objectives + its current percentile objective_score, so you can re-score it later against the evolving national baseline. Use to build a durable siting shortlist across days/weeks; the list is scoped to your API key. Pair with get_shortlist to re-score + see drift. MINIMAL call: save_to_shortlist(shortlist_name="my-targets", site={site_ref, lat, lng, capacity_mw}) — objectives are optional. If you DID rank the site (analyze_site / rank_sites), pass those metric fields inside site and your objectives map too, and the re-scoring reuses them. Requires an API key so the list is private to you and survives to your next conversation: call get_api_key first if you have none. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| site * | any | Site object. MINIMAL form is enough: {site_ref, lat, lng, capacity_mw}. Richer is better — add any analyze_site metric fields (risk_resilience, fiber_connectivity, water score…) and those become what gets re-scored later. |
| notes | string | Optional free-text note, e.g. "strong fiber, acceptable water" |
| objectives | any | OPTIONAL {field: signedWeight} map (+maximize/-minimize) if this site was ranked under explicit objectives — stored so re-scoring reuses the same criteria. Omit it and DC Hub weights the site's own metric fields equally. |
| shortlist_name * | string | Name of the shortlist, e.g. "Q3-2026-1GW-targets" — created if new. REQUIRED. |
Use this when the user wants to see a saved data center site shortlist. With refresh=true (default) each site is RE-SCORED against the current national percentile baseline and returns saved_score, current_score, and score_delta_since_saved — so you see whether a site slipped because IT changed or the POPULATION did. The reliable way to maintain a siting campaign across days/weeks. Scoped to your API key. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| name * | string | The shortlist name to fetch |
| refresh | boolean | true (default) = re-score every site against the CURRENT baseline + return drift deltas; false = return the saved snapshots only |
{
"name": "get_shortlist",
"title": "Get Shortlist",
"description": "Use this when the user wants to see a saved data center site shortlist. With refresh=true (default) each site is RE-SCORED against the current national percentile baseline and returns saved_score, current_score, and score_delta_since_saved — so you see whether a site slipped because IT changed or the POPULATION did. The reliable way to maintain a siting campaign across days/weeks. Scoped to your API key. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The shortlist name to fetch"
},
"refresh": {
"type": "boolean",
"description": "true (default) = re-score every site against the CURRENT baseline + return drift deltas; false = return the saved snapshots only"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_shortlist",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "free_key",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user wants a drift alert on a saved site shortlist so you can stop polling and be notified when a site's national standing moves materially (Phase 5). Fires when any site in the shortlist has current percentile score < percentile_below OR score_delta_since_saved < delta_below (e.g. -8 = dropped 8 points vs when saved). Evaluated after each daily baseline refresh; delivers via webhook and/or email. This is the "wake me when it matters" loop for long-running siting campaigns. Scoped to your API key. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| notify * | any | Delivery: {"webhook":"https://..."} and/or {"email":"you@co.com"} — at least one required |
| delta_below | number | Fire if any site's score_delta_since_saved drops below this — pass a NEGATIVE number, e.g. -8 (dropped 8+ points since saved) |
| shortlist_name | string | The shortlist to monitor (created via save_to_shortlist) |
| percentile_below | number | Fire if any site's current percentile objective_score drops below this (e.g. 70) |
{
"name": "set_shortlist_alert",
"title": "Set Shortlist Alert",
"description": "Use this when the user wants a drift alert on a saved site shortlist so you can stop polling and be notified when a site's national standing moves materially (Phase 5). Fires when any site in the shortlist has current percentile score < percentile_below OR score_delta_since_saved < delta_below (e.g. -8 = dropped 8 points vs when saved). Evaluated after each daily baseline refresh; delivers via webhook and/or email. This is the \"wake me when it matters\" loop for long-running siting campaigns. Scoped to your API key. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"notify"
],
"properties": {
"notify": {
"description": "Delivery: {\"webhook\":\"https://...\"} and/or {\"email\":\"you@co.com\"} — at least one required"
},
"delta_below": {
"type": "number",
"description": "Fire if any site's score_delta_since_saved drops below this — pass a NEGATIVE number, e.g. -8 (dropped 8+ points since saved)"
},
"shortlist_name": {
"type": "string",
"description": "The shortlist to monitor (created via save_to_shortlist)"
},
"percentile_below": {
"type": "number",
"description": "Fire if any site's current percentile objective_score drops below this (e.g. 70)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=set_shortlist_alert",
"readOnlyHint": false,
"openWorldHint": false,
"tier_required": "free_key",
"idempotentHint": false,
"destructiveHint": false
}
}Use this when a saved data center site drifts (its national standing dropped — surfaced by get_shortlist refresh or a set_shortlist_alert firing), get replacement candidates from the rest of that shortlist so the alert becomes an action, not just a warning (Phase 5). Returns TWO tiers — tier_1_same_region (a near-in tactical swap) and tier_2_cross_region (a different-region arbitrage) — each re-scored against the DRIFTED slot's own objectives, PLUS drift_is_systemic: if the rest of your shortlist also slipped, the drop is region/baseline-wide and a same-region swap will inherit it (prefer cross_region); if peers held, it's idiosyncratic (tactical_ok). DC Hub does the reduction; the final weighted pick is yours. Candidates come from THIS shortlist only (save more via save_to_shortlist to widen the pool). Scoped to your API key. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| shortlist_name * | string | The shortlist to re-allocate within (created via save_to_shortlist) |
| drifted_site_ref | string | Optional site_ref of the drifted slot to replace; if omitted, the current lowest-scoring site is treated as the drifted one |
{
"name": "suggest_reallocation",
"title": "Suggest Reallocation",
"description": "Use this when a saved data center site drifts (its national standing dropped — surfaced by get_shortlist refresh or a set_shortlist_alert firing), get replacement candidates from the rest of that shortlist so the alert becomes an action, not just a warning (Phase 5). Returns TWO tiers — tier_1_same_region (a near-in tactical swap) and tier_2_cross_region (a different-region arbitrage) — each re-scored against the DRIFTED slot's own objectives, PLUS drift_is_systemic: if the rest of your shortlist also slipped, the drop is region/baseline-wide and a same-region swap will inherit it (prefer cross_region); if peers held, it's idiosyncratic (tactical_ok). DC Hub does the reduction; the final weighted pick is yours. Candidates come from THIS shortlist only (save more via save_to_shortlist to widen the pool). Scoped to your API key. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"shortlist_name"
],
"properties": {
"shortlist_name": {
"type": "string",
"description": "The shortlist to re-allocate within (created via save_to_shortlist)"
},
"drifted_site_ref": {
"type": "string",
"description": "Optional site_ref of the drifted slot to replace; if omitted, the current lowest-scoring site is treated as the drifted one"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=suggest_reallocation",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "free_key",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks for live electricity grid data (power demand, fuel mix) for one grid: the 7 US ISOs (PJM, ERCOT, CAISO, MISO, SPP, NYISO, ISO-NE), TVA, BPA, 40+ US utility balancing authorities (e.g. AZPS, SOCO, DUK, FPL, or a city: PHOENIX, ATLANTA), Canada (IESO, AESO, HYDROQUEBEC), Great Britain (NGESO), any ENTSO-E bidding zone (EU_DE_LU, EU_FR, EU_NL ...), Taiwan (TAIPOWER), Japan (OCCTO), South Korea (KEPCO-KR), Brazil (ONS), Australia (AEMO) or Singapore (EMA). US ISOs and EIA regions return EIA hourly fuel mix, demand and the 24h curve; other grids return each feed's newest reading per metric, each with its own timestamp. For PJM it also returns installed_capacity_mw: EIA-860M installed generating capacity (net summer MW of operating generators for the report month in installed_capacity_mw_period). That is not PJM committed capacity, which is listed in licence_withheld with no value. Raw telemetry for one grid; do NOT use for power-availability, time-to-power or interconnection-queue analysis (use get_grid_intelligence), nor for retail/gas pricing (use get_energy_prices). To rank many grids at once use get_grid_scoreboard. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| iso | string | Grid code (required): a US ISO (ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE), TVA, BPA, a utility BA or city (AZPS, PHOENIX), or a non-US grid (IESO, AESO, HYDROQUEBEC, NGESO, EU_DE_LU, TAIPOWER, OCCTO, KEPCO-KR, ONS, AEMO, EMA) |
| metric | string | Optional metric focus, e.g. fuel_mix, demand, demand_curve |
| period | string | Optional time window for the metric, e.g. 24h |
| mpp_pay | boolean | Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call. |
Use this when the user asks what changed in data center markets, facilities or deals since a date. Returns DCPI 7-day market movers, newly discovered facilities, new M&A deals + news, bill status changes on data-center bills (legislation_status_changes) — PLUS, for keyed callers with saved sites, a `portfolio` block answering "did MY sites move?": per-saved-site verdict flips (CAUTION → BUILD), excess-power deltas, alerts fired, and new facilities near each site since your last check. Pass since=<ISO-8601> or shorthand "24h"/"7d" (default 24h); cache the response generated_at and pass it back next call. Answers "what changed since I last looked", "anything new this week I should know about". window:'1d' is the daily check-in; watchlist narrows it to your market slugs. since:'last_session' returns what moved since your previous visit (a keyed caller's last session; 7d when there is none, and since_resolved says which). Try: get_changes since=7d. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results to return (1-500; default varies by tool) |
| since | string | Return changes since this ISO-8601 timestamp (YYYY-MM-DD or full datetime) or shorthand "24h"/"7d"; default 24h |
| window | string | Rolling window instead of since: "1d" is the daily check-in, "7d" the week |
| watchlist | array | Market slugs to focus the changes on, e.g. ["northern-virginia","dallas"] |
{
"name": "get_changes",
"title": "Get Changes",
"description": "Use this when the user asks what changed in data center markets, facilities or deals since a date. Returns DCPI 7-day market movers, newly discovered facilities, new M&A deals + news, bill status changes on data-center bills (legislation_status_changes) — PLUS, for keyed callers with saved sites, a `portfolio` block answering \"did MY sites move?\": per-saved-site verdict flips (CAUTION → BUILD), excess-power deltas, alerts fired, and new facilities near each site since your last check. Pass since=<ISO-8601> or shorthand \"24h\"/\"7d\" (default 24h); cache the response generated_at and pass it back next call. Answers \"what changed since I last looked\", \"anything new this week I should know about\". window:'1d' is the daily check-in; watchlist narrows it to your market slugs. since:'last_session' returns what moved since your previous visit (a keyed caller's last session; 7d when there is none, and since_resolved says which). Try: get_changes since=7d. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"since": {
"type": "string",
"description": "Return changes since this ISO-8601 timestamp (YYYY-MM-DD or full datetime) or shorthand \"24h\"/\"7d\"; default 24h"
},
"window": {
"enum": [
"1d",
"7d"
],
"type": "string",
"description": "Rolling window instead of since: \"1d\" is the daily check-in, \"7d\" the week"
},
"watchlist": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 25,
"description": "Market slugs to focus the changes on, e.g. [\"northern-virginia\",\"dallas\"]"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_changes",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks how a data center facility's (or its market's) power risk changed recently — "has this site gotten riskier lately?". Returns the REAL DCPI market-health delta (excess-power score change over the window, direction improving/worsening/flat) from DC Hub's history-preserving daily snapshots. INTEGRITY: only DCPI market-health has a short-term temporal series; the site-hazard dimensions (FEMA disaster / USGS seismic / NOAA climate / WRI water) are DECLARED static (they don't change week-to-week) with a pointer to the point-in-time tool — never a fabricated week-over-week delta; no snapshot history → coverage:unavailable. Params: facility_id (a discovered-facility id or slug) OR market (a market name/slug), since (e.g. "7d"/"30d", default 7d). Returns {facility, dcpi_market_health:{delta, now, direction, coverage}, static_dimensions{...}, summary}. For the current point-in-time risk (not the change) use get_composite_site_score / get_disaster_risk / get_climate_intel. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| since | string | Look-back window, e.g. "7d" or "30d" (default 7d) |
| market | string | Alternatively, a market name or slug (e.g. "northern-virginia") |
| facility_id | string | A DC Hub facility id or canonical slug to resolve the market context |
{
"name": "get_facility_risk_delta",
"title": "Get Facility Risk Delta",
"description": "Use this when the user asks how a data center facility's (or its market's) power risk changed recently — \"has this site gotten riskier lately?\". Returns the REAL DCPI market-health delta (excess-power score change over the window, direction improving/worsening/flat) from DC Hub's history-preserving daily snapshots. INTEGRITY: only DCPI market-health has a short-term temporal series; the site-hazard dimensions (FEMA disaster / USGS seismic / NOAA climate / WRI water) are DECLARED static (they don't change week-to-week) with a pointer to the point-in-time tool — never a fabricated week-over-week delta; no snapshot history → coverage:unavailable. Params: facility_id (a discovered-facility id or slug) OR market (a market name/slug), since (e.g. \"7d\"/\"30d\", default 7d). Returns {facility, dcpi_market_health:{delta, now, direction, coverage}, static_dimensions{...}, summary}. For the current point-in-time risk (not the change) use get_composite_site_score / get_disaster_risk / get_climate_intel. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"since": {
"type": "string",
"description": "Look-back window, e.g. \"7d\" or \"30d\" (default 7d)"
},
"market": {
"type": "string",
"description": "Alternatively, a market name or slug (e.g. \"northern-virginia\")"
},
"facility_id": {
"type": "string",
"description": "A DC Hub facility id or canonical slug to resolve the market context"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_facility_risk_delta",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user wants to save a data-center site to track it. Needs a key (get_api_key); keyless returns auth_required. Save a candidate data-center site to your DC Hub account to track it across sessions. Give lat + lon (plus optional name, state, market, target_mw, notes). Returns the saved site id. Pass `market` and DC Hub snapshots the site's DCPI baseline at save time, so every later list_saved_sites / get_changes shows how ITS score and verdict moved since you saved it. Builds a persistent shortlist an agent can revisit + monitor — after saving, pass the returned id to set_site_alert so DC Hub emails you when that site’s DCPI/capacity/nearby-facilities move (no re-checking). Answers "remember this parcel for me", "keep this candidate so I can come back to it next session". Try: save_site lat=39.04 lon=-77.48 name="Ashburn parcel" market=northern-virginia target_mw=100. Do NOT use to read back the shortlist (use list_saved_sites), download it (use export_dataset), or score a site (use score_facility); this WRITES one site to your account. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Site latitude in decimal degrees (-90 to 90), e.g. 39.04 |
| lng | number | Alias for lon — either name works |
| lon | number | Site longitude in decimal degrees (-180 to 180), e.g. -77.48 |
| name | string | Optional label for the saved site, e.g. "Ashburn parcel" |
| notes | string | Optional free-text notes to store with the saved site |
| state | string | US state abbreviation for the site, e.g. VA |
| market | string |
Use this when the user asks to see their saved data center sites. Needs a key (get_api_key); keyless returns auth_required, not an empty list. Use when a user asks to see or review their saved DC Hub shortlist in-chat, or wants to know what moved on it. Example: "What sites have I saved?" / "Did any of my saved sites move?" — list_saved_sites. Params: since (optional — "24h"/"7d"/ISO, default 7d — the delta window). Returns: each saved site with name, market, lat/lon, saved DCPI score, target MW, notes — PLUS live deltas: verdict_was/verdict_now (e.g. CAUTION → BUILD), excess-power move over the window, current vs at-save DCPI, alerts armed/fired, new facilities nearby, and a `portfolio` summary flagging which sites moved and which have no alert armed. Do NOT use to add a site (use save_site) or to download the list as a file (use export_dataset); this is the in-chat read-back. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| since | string | Delta window for per-site movement: "24h", "7d" (default) or an ISO-8601 timestamp — pass your cached generated_at from last session |
{
"name": "list_saved_sites",
"title": "List Saved Sites",
"description": "Use this when the user asks to see their saved data center sites. Needs a key (get_api_key); keyless returns auth_required, not an empty list. Use when a user asks to see or review their saved DC Hub shortlist in-chat, or wants to know what moved on it. Example: \"What sites have I saved?\" / \"Did any of my saved sites move?\" — list_saved_sites. Params: since (optional — \"24h\"/\"7d\"/ISO, default 7d — the delta window). Returns: each saved site with name, market, lat/lon, saved DCPI score, target MW, notes — PLUS live deltas: verdict_was/verdict_now (e.g. CAUTION → BUILD), excess-power move over the window, current vs at-save DCPI, alerts armed/fired, new facilities nearby, and a `portfolio` summary flagging which sites moved and which have no alert armed. Do NOT use to add a site (use save_site) or to download the list as a file (use export_dataset); this is the in-chat read-back. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"since": {
"type": "string",
"description": "Delta window for per-site movement: \"24h\", \"7d\" (default) or an ISO-8601 timestamp — pass your cached generated_at from last session"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=list_saved_sites",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "free_key",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user wants alerts on a data center market's DCPI power score: subscribes to movement alerts (needs a key) — get notified when its Excess-Power / Constraint score moves. DATA USE: channel="email" takes your human's email, to send these alerts; it is bound to the key as with bind_email. DC Hub keeps it and never sells it or shares it for anyone else’s use (https://dchub.cloud/privacy). Run only when your human asks; confirm the address with them first. Without a full-access key, email alerts go only to the key's bound email. One call: pass `email` (an address your human typed here) with channel="email" and DC Hub binds it to this key first (minting a key if this session has none), then arms the watch; no separate get_api_key or bind_email. Alerts send when the market’s verdict flips or its scores move past the threshold, so a quiet market sends nothing. Webhook delivery (channel="webhook" + destination=<https URL>) needs a full-access key. Answers "tell me when this market moves". Try: set_market_alert market=northern-virginia channel=webhook destination=https://hooks.example.com/dc. Do NOT use to read a market right now (use get_market_dcpi_rank); this SUBSCRIBES to future movement. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| string | Optional, channel="email" only: your human's email, typed by them here and confirmed. Binds it to the key (a key is minted if this session has none) and arms the watch in one call. DC Hub keeps it and never sells or shares it | |
| market * | string | Market slug (metro) to watch, e.g. northern-virginia — valid slugs come from rank_markets / get_market_dcpi_rank |
| channel * | string | Delivery channel: "email" (sent to your bound email) or "webhook" (full-access key) |
| destination | string | For channel="webhook", the https URL to POST alerts to (full-access key); ignored for email (forced to bound address) |
Use this when the user asks for a weekly data center market email: subscribes them to a digest of what changed in the markets and sites they queried (DCPI movers, new facilities, deals, news). DOUBLE opt-in + consent-safe: we email a one-click CONFIRM link, the human only gets the digest after confirming, and every email has one-click unsubscribe — this call alone sets no marketing flag. Only call once your human shares their email and wants a weekly email. Params: email (required), source (optional tag). Returns {ok, sent, message}. Prefer this over hand-building POST /api/v1/opt-in/request. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Your human's email address (required) — a one-click confirm link is sent; use only an address they explicitly gave |
| source | string | Optional attribution tag for where the subscription came from, e.g. mcp_digest |
{
"name": "subscribe_digest",
"title": "Subscribe Digest",
"description": "Use this when the user asks for a weekly data center market email: subscribes them to a digest of what changed in the markets and sites they queried (DCPI movers, new facilities, deals, news). DOUBLE opt-in + consent-safe: we email a one-click CONFIRM link, the human only gets the digest after confirming, and every email has one-click unsubscribe — this call alone sets no marketing flag. Only call once your human shares their email and wants a weekly email. Params: email (required), source (optional tag). Returns {ok, sent, message}. Prefer this over hand-building POST /api/v1/opt-in/request. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Your human's email address (required) — a one-click confirm link is sent; use only an address they explicitly gave"
},
"source": {
"type": "string",
"description": "Optional attribution tag for where the subscription came from, e.g. mcp_digest"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=subscribe_digest",
"readOnlyHint": false,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": false,
"destructiveHint": false
}
}Use this when the user wants an email watch on a saved data center site (needs a key) — DC Hub emails you when that site’s DCPI score, grid capacity, or nearby facilities move. DATA USE: notify_email, your human's email, used only to send this alert. DC Hub keeps it and never sells it or shares it for anyone else’s use (https://dchub.cloud/privacy). Run only when your human asks; confirm the address with them first. Without a full-access key, notify_email is forced to the key’s bound email. A full-access key can send to any address. The "monitor my shortlist for me" loop: call save_site first (it returns a saved_site_id), then set_site_alert on that id. Answers "tell me if my saved site changes". Params: saved_site_id (required integer, from save_site or list_saved_sites), trigger_type ("dcpi_change" | "capacity_change" | "new_facility_nearby", default "dcpi_change"), threshold (number — the points/MW move that fires it, default 5). Try: set_site_alert saved_site_id=12 trigger_type=dcpi_change threshold=5 notify_email=you@firm.com. Returns {ok, alert_id, message}. Do NOT use to watch a whole MARKET (use set_market_alert) or to save a new site (use save_site); this arms a monitor on ONE already-saved site. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| threshold | number | The points/MW move that fires the alert (default 5) |
| notify_email * | string | Email address the alert is sent to (required); without a full-access key, forced to your human's bound email. Confirm it with your human first. DC Hub keeps it and never sells or shares it |
| trigger_type | string | What movement fires the alert: "dcpi_change" (default), "capacity_change", or "new_facility_nearby" |
| saved_site_id * | any | The saved_site_id returned by save_site or list_saved_sites (required) |
Use this when the user wants to export their saved data center sites for offline analysis, a spreadsheet, or ingestion into another tool (needs a full-access key). Example: "Export my saved sites as GeoJSON for QGIS." — export_dataset format=geojson. Params: format ("csv" default, or "geojson"). Returns: the full file contents as text — CSV rows or a GeoJSON FeatureCollection of your saved sites with DCPI score, target MW, market, coordinates, and notes. Do NOT use to list sites in-chat (use list_saved_sites) or to save a new one (use save_site); this is the bulk-download path. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| format | string | Output file format: "csv" (default) or "geojson" (for GIS tools like QGIS) |
{
"name": "export_dataset",
"title": "Export Dataset",
"description": "Use this when the user wants to export their saved data center sites for offline analysis, a spreadsheet, or ingestion into another tool (needs a full-access key). Example: \"Export my saved sites as GeoJSON for QGIS.\" — export_dataset format=geojson. Params: format (\"csv\" default, or \"geojson\"). Returns: the full file contents as text — CSV rows or a GeoJSON FeatureCollection of your saved sites with DCPI score, target MW, market, coordinates, and notes. Do NOT use to list sites in-chat (use list_saved_sites) or to save a new one (use save_site); this is the bulk-download path. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"format": {
"type": "string",
"description": "Output file format: \"csv\" (default) or \"geojson\" (for GIS tools like QGIS)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=export_dataset",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "pro",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user has no data center site yet and wants candidate search areas (site selection by substation voltage, gas and fiber distance); execute_plan covers a multi-part siting question. THE INVERSE QUERY: every other DC Hub siting tool needs a coordinate you already have — analyze_site scores one, get_composite_site_score grades one, rank_sites orders candidates YOU already enriched, find_alternatives needs a seed facility. This one answers "where should I even be looking?". Returns candidate SEARCH AREAS anchored on real HIFLD substations at or above min_voltage_kv, spatially de-duplicated by cluster_km so a dense metro yields distinct areas instead of 40 near-identical rows, each carrying measured distance to the nearest gas pipeline and fiber route plus state-grain moratorium context, and a next_calls handoff. Answers "where should I even be looking for 200 MW in Ohio" and "which areas near Dallas sit on 230kV with gas within 5 miles". Try: find_sites state=OH min_voltage_kv=230 max_gas_km=8 — or find_sites lat=39.04 lon=-77.48 radius_km=60 min_voltage_kv=500. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Latitude of a search centre, e.g. 39.04 — use with lon (+ radius_km) instead of state |
| lng | number | Alias for lon — either name works |
| lon | number | Longitude of a search centre, e.g. -77.48 |
| limit | integer | Max results to return (1-500; default varies by tool) |
| state | string | 2-letter US state to search, e.g. OH — required unless you pass lat + lon |
| market | string | A DCPI market slug or name instead of lat/lon, e.g. chicago: the search is centred on that market (radius_km default 60). anchored_market names it; avoid_note says when it reads AVOID |
Use this when the user asks whether a specific site or coordinate works for a data center (lat/lon, or a market name for a market-level read). 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 key (DCHUB_API_KEY, optional) adds a few full site reports each month; other scores and figures need a full-access key. Without a key, the first 2 `analyze_site` calls each UTC day from a network return the full site report; after that, no full report until UTC midnight. 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." Next: to buy or lease capacity in these markets, call source_capacity; to register a requirement with providers, call request_capacity_intro after your human approves. Needs BOTH lat and lon in decimal degrees (else missing_coordinates); take them from get_facility or search_facilities. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Site latitude in decimal degrees (-90 to 90; required unless candidate_id or location given), e.g. 33.45 |
| lng | number | Alias for lon — either name works |
| lon | number | Site longitude in decimal degrees (-180 to 180; required unless candidate_id or location given), e.g. -112.07 |
| state | string | US state abbreviation (optional) — improves the tax-incentive lookup, e.g. AZ |
| mpp_pay | boolean | Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call. |
Use this when the user wants one 0-100 data center site suitability verdict for a lat/lon WITH an explicit per-factor coverage map — which factors are actually measured vs. declared unavailable. Unlike analyze_site (full raw data dump), this scores ONLY over VALIDATED factors and never imputes a missing one: power/grid, fiber, natural-hazard risk (FEMA NRI) and water (live WRI Aqueduct 4.0 baseline water stress) are all live; water is "unavailable" only outside basin coverage (never faked); market/DCPI is v1-unavailable (use rank_markets). Example: get_composite_site_score lat=33.45 lon=-112.07 state=AZ. Returns {composite_score (0-100 over validated factors), verdict (BUILD/CAUTION/AVOID), confidence (complete|conditional), coverage {power_grid|fiber|water|risk_resilience|market_dcpi: validated|unavailable}, coverage_ratio, sub_scores, caveats}. Use analyze_site for full data, compare_sites for 2-4 sites, rank_markets for whole-market ranking. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Site latitude in decimal degrees (-90 to 90, required), e.g. 33.45 |
| lng | number | Alias for lon — either name works |
| lon | number | Site longitude in decimal degrees (-180 to 180, required), e.g. -112.07 |
| state | string | US state abbreviation (optional) — improves water/context lookups, e.g. AZ |
| latitude | number | Alias for lat — either name works |
| longitude | number | Alias for lon — either name works |
Use this when the user asks about natural-hazard risk for a data center site (US lat/lon) — flood, wildfire, hurricane, earthquake, heat, drought, tornado, etc. Grounded in the FEMA National Risk Index (NRI), the US county-level hazard dataset (live query, never estimated; points outside US NRI coverage return coverage=unavailable). Example: get_disaster_risk lat=33.45 lon=-112.07. Returns {disaster_risk:{composite_score (0-100, higher=worse), rating (Very Low..Very High), national_percentile}, hazards:{Wildfire, Hurricane, Earthquake, Heat Wave, ...: rating}, top_hazards:[{hazard, rating}], coverage (validated|unavailable), source, caveats}. County-level resolution. For chronic water stress use get_water_risk; for one blended site verdict use get_composite_site_score. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Site latitude in decimal degrees (-90 to 90, required), e.g. 33.45 |
| lng | number | Alias for lon — either name works |
| lon | number | Site longitude in decimal degrees (-180 to 180, required), e.g. -112.07 |
| latitude | number | Alias for lat — either name works |
| longitude | number | Alias for lon — either name works |
{
"name": "get_disaster_risk",
"title": "Get Disaster Risk",
"description": "Use this when the user asks about natural-hazard risk for a data center site (US lat/lon) — flood, wildfire, hurricane, earthquake, heat, drought, tornado, etc. Grounded in the FEMA National Risk Index (NRI), the US county-level hazard dataset (live query, never estimated; points outside US NRI coverage return coverage=unavailable). Example: get_disaster_risk lat=33.45 lon=-112.07. Returns {disaster_risk:{composite_score (0-100, higher=worse), rating (Very Low..Very High), national_percentile}, hazards:{Wildfire, Hurricane, Earthquake, Heat Wave, ...: rating}, top_hazards:[{hazard, rating}], coverage (validated|unavailable), source, caveats}. County-level resolution. For chronic water stress use get_water_risk; for one blended site verdict use get_composite_site_score. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Site latitude in decimal degrees (-90 to 90, required), e.g. 33.45"
},
"lng": {
"type": "number",
"description": "Alias for lon — either name works"
},
"lon": {
"type": "number",
"description": "Site longitude in decimal degrees (-180 to 180, required), e.g. -112.07"
},
"latitude": {
"type": "number",
"description": "Alias for lat — either name works"
},
"longitude": {
"type": "number",
"description": "Alias for lon — either name works"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"limits": "water is declared unavailable outside WRI Aqueduct basin coverage rather than imputed",
"problem": "water and climate risk",
"maturity": "mature",
"front_door": "get_composite_site_score",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_disaster_risk",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks about seismic or climate design inputs for a data center site (lat/lon) — the layer that drives data-center structural bracing cost (seismic) and cooling design (cooling degree-days, extreme temps). Grounded STRICTLY in USGS ASCE 7 (seismic) + NOAA climate normals via ACIS; every value traces to a federal source and missing data is declared unavailable, never estimated. Example: get_climate_intel lat=33.45 lon=-112.07. Returns {seismic_hazard_usgs:{status, peak_ground_acceleration_g, ss, s1, seismic_design_category, hazard_class}, climate_normals_noaa:{status, reference_station:{id,name,distance_km}, cooling_design_metrics:{cooling_degree_days_annual, extreme_max_dry_bulb_f, extreme_max_wet_bulb_f (null if source lacks it), data_vintage}}, overall_climate_summary, data_availability, sources}. radius_km (optional, default 25) snaps to the nearest NOAA station; beyond it climate returns unavailable_exceeds_radius. Seismic is US (ASCE 7); non-US → seismic unavailable. For natural-hazard ratings use get_disaster_risk; for one blended verdict use get_composite_site_score. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Site latitude in decimal degrees (-90 to 90, required), e.g. 33.45 |
| lng | number | Alias for lon — either name works |
| lon | number | Site longitude in decimal degrees (-180 to 180, required), e.g. -112.07 |
| latitude | number | Alias for lat — either name works |
| longitude | number | Alias for lon — either name works |
| radius_km | number |
Use this when the user wants a shareable data center Site Analysis PDF for ONE lat/lon (a powered-land parcel, a candidate campus) — the polished client deliverable, not just a score. Example: "Make the Site Analysis PDF for this Carrier Mills parcel, 150 MW, for TON Infrastructure." — generate_site_analysis lat=37.694 lon=-88.65 capacity_mw=150 prepared_for="TON Infrastructure" prepared_by="Martone Advisors". Params: lat (-90 to 90, required), lon (-180 to 180, required), capacity_mw (target load MW, e.g. 50-500), prepared_for (client name on the cover), prepared_by (your firm — brands the report; defaults to DC Hub), latency_target (optional metro override; default = nearest real carrier hotel). Returns: {survey:{verdict, power/transmission, gas, water, air-permitting, fiber carriers, latency-to-nearest-carrier-hotel, market, tax}, pdf_report_url}. pdf_report_url is a ready-to-open link to download the branded 5-page PDF — no login needed, valid ~7 days; hand it to your human. For just the numeric suitability score (no PDF), use analyze_site instead. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Site latitude in decimal degrees (-90 to 90, required), e.g. 37.694 |
| lng | number | Alias for lon — either name works |
| lon | number | Site longitude in decimal degrees (-180 to 180, required), e.g. -88.65 |
| latitude | number | Alias for lat — either name works |
| use_case | string | Optional workload descriptor to tailor the report, e.g. "AI training campus" |
| longitude | number |
Use this when the user has 2-4 candidate data center sites and asks which is best. Pass locations as "lat,lon;lat,lon" and optional capacity_mw. Returns each site's analyze_site scores side by side plus a recommended winner and why. Keyless returns each site's verdict band and power band, with the other factors named; a key (DCHUB_API_KEY, optional) adds names and counts without figures; scores and figures need a full-access key, as does the pick. Ex: "Phoenix vs Ashburn for 50 MW?" Next: to buy or lease capacity in these markets, call source_capacity; to register a requirement with providers, call request_capacity_intro after your human approves. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| sites | any | Alternative to locations: an array of {lat, lon} (or {lat, lng}) objects, 2-4 sites |
| mpp_pay | boolean | Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call. |
| locations | string | Semicolon-separated list of 2-4 "lat,lon" pairs to compare, e.g. "33.45,-112.07;39.04,-77.48" |
| capacity_mw | number | Target power load for the build in megawatts (MW), e.g. 50 (typical 50-500) |
| mpp_credential | string | Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge. |
Use this when the user asks what power infrastructure is near a site: substations (count + max voltage_kv within radius), transmission lines (>69 kV path overlay), interstate + lateral gas pipelines, and power plants (operating + planned, by fuel) within configurable radius_km. Returns distance + capacity for each, joined to HIFLD/EIA. Answers "what is near this parcel", "how far is the nearest substation and what voltage is it". Try: get_infrastructure lat=33.45 lon=-112.07 radius_km=25. Returns raw nearby assets; do NOT use for a single scored site-suitability verdict (use analyze_site). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Center latitude in decimal degrees (-90 to 90, required), e.g. 33.45 |
| lng | number | Alias for lon — either name works |
| lon | number | Center longitude in decimal degrees (-180 to 180, required), e.g. -112.07 |
| layer | string | Optional single asset layer to return, e.g. substations, transmission, pipelines, power_plants |
| limit | integer | Max results to return (1-500; default varies by tool) |
| latitude | number | Alias for lat — either name works |
| longitude | number | Alias for lon — either name works |
| radius_km | number |
Use this when the user asks about fiber routes, carriers or connectivity for a market: long-haul, metro, dark or IX routes. Filter by carrier, route_type, market. Returns GeoJSON routes: carrier, type, fiber count, lit capacity, distance. Without full access you get a sample of routes, not the full set; the full set needs a full-access key. Ex: "Zayo long-haul routes via Dallas." Filter by market (slug from rank_markets) or carrier. For one building use get_facility. Gated: give human_url to your human. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| market | string | Metro name or slug (e.g. "dallas", "ashburn", "northern-virginia") — returns only routes touching that metro (either endpoint within ~1.2°). Great with route_type=longhaul. |
| carrier | string | Fiber carrier to filter on, e.g. Zayo, Lumen, Cogent, "Crown Castle", Windstream, GTT, Uniti; omit for all carriers |
| mpp_pay | boolean | Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call. |
| route_type | string | Route class: "metro", "longhaul", "dark", or "ix" |
| mpp_credential | string | Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge. |
| include_sources | boolean | Include upstream data-source/provenance metadata in the response |
Use this when the user asks whether one data center site (lat/lon) is fiber-ready: near-net distance to a carrier-served facility, how many distinct fiber carriers are reachable, and whether there is single-carrier risk (no path diversity). This is the parcel connectivity answer engineering site-selectors screen on. Example: "Is this Loudoun County parcel fiber-ready and how many carriers can serve it?" — get_fiber_readiness lat=39.04 lon=-77.48 radius_km=50. Params: lat (-90..90, required), lon (-180..180, required), radius_km (search radius in km, default 50, range 5-200). Returns: {score 0-100 (null when not scored — see carrier_data_coverage), near_net_bucket ("on-net"|"near-net"|"acceptable"|"build-required"|"unknown"), nearest_carrier_km, carrier_count, top_carriers:[{carrier, distance_km}], single_carrier_risk (bool, null when not scored), fiber_coverage_km, verdict_short, carrier_data_coverage ("confirmed"|"none_in_region")}. IMPORTANT — "unknown" is NOT "bad": carrier presence comes from PeeringDB, which is global but thin outside dense US/EU metros, so DC Hub distinguishes "no carrier serves this point" from "PeeringDB does not describe this region". For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Site latitude in decimal degrees (-90 to 90, required), e.g. 39.04 |
| lng | number | Alias for lon — either name works |
| lon | number | Site longitude in decimal degrees (-180 to 180, required), e.g. -77.48 |
| latitude | number | Alias for lat — either name works |
| longitude | number | Alias for lon — either name works |
| radius_km |
Use this when the user asks about subsea (submarine) cable landings near a site, or the cable catalogue. The physical internet crossing an ocean lands at a finite number of points, and distance to one is a real siting factor for anything latency- or transit-sensitive. Pass lat+lon (+radius_km) for LANDING POINTS near a site — each with name, coordinates and distance_km. Omit coordinates for the CATALOGUE of tracked cables (712 tracked; each with cable_id, name, owners, length_km, rfs_year, is_planned — sparse fields are null, not guessed). ★ READ field_coverage AND connectivity_note BEFORE DRAWING A CONCLUSION: cable_count per landing point is NOT populated — the ingest writes the column but the upstream TeleGeography feed does not supply what it derives from, so every row carries the default 0. Answers "which subsea cables land near this Virginia site" and "how far is the nearest cable landing from my campus". Try: get_subsea_cables lat=36.85 lon=-75.98 radius_km=200 — or get_subsea_cables (no args) for the catalogue. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Latitude of the site, e.g. 36.85 — with lon, returns landing points near it; omit both for the cable catalogue |
| lng | number | Alias for lon — either name works |
| lon | number | Longitude of the site, e.g. -75.98 |
| limit | integer | Max results to return (1-500; default varies by tool) |
| latitude | number | Alias for lat — either name works |
| longitude | number | Alias for lon — either name works |
Use this when the user asks about internet exchange (IX) and peering density for a data center site (PeeringDB). Pass lat+lon for the PEERING PROFILE around that point: facilities_nearby, a 0-100 score with its level, total_ix_presence, total_networks, and top_facilities each with ix_count and net_count — e.g. Ashburn comes back with 61 IX presences and 903 networks across the nearby sites, led by Equinix DC1-DC15 at 516 networks. Omit coordinates for the IXP directory (name, name_long, city, country, net_count, fac_count, media, protocols). This is the layer that answers "can I actually reach networks cheaply from here", which fiber route geometry does not: a site can sit on dense fiber and still be far from any exchange. The score is a DERIVED convenience over PeeringDB counts, not a DC Hub-sourced grade — cite the underlying counts (facilities, IX presence, networks) rather than the score when it is load-bearing. Records are PeeringDB's, refreshed on read. Answers "how good is peering at this Ashburn site" and "which internet exchanges serve the Dallas market". Try: get_peering_intel lat=39.04 lon=-77.48 — or get_peering_intel (no args) for the IXP directory. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Latitude of the site, e.g. 39.04 — with lon, returns the peering profile around it; omit both for the IXP directory |
| lng | number | Alias for lon — either name works |
| lon | number | Longitude of the site, e.g. -77.48 |
| limit | integer | Max results to return (1-500; default varies by tool) |
| latitude | number | Alias for lat — either name works |
Use this when the user asks which US metro has the deepest fiber, or wants a market's fiber profile — carrier count, total route-miles, on-net buildings, a 0-100 fiber-density score, tier, key internet-exchange (IX) points and carrier hotels — across the tracked top US data-center metros (Northern Virginia, Dallas-Fort Worth, Silicon Valley, Chicago, Atlanta, Phoenix, and more). Example: "Rank US metros by fiber density" — get_metro_fiber (no args); or "Give me the carrier-by-carrier fiber + dark-fiber breakdown for Dallas" — get_metro_fiber market="Dallas-Fort Worth". Params: market (optional metro name OR slug, e.g. "Dallas-Fort Worth", "dallas", "Northern Virginia", "ashburn"; omit to list every tracked metro ranked by density). Returns: without market -> {markets:[{market, state, tier, fiber_density_score, total_carriers, total_route_miles, total_on_net_buildings}], total_markets, total_route_miles}; with market -> {market, summary:{fiber_density_score, total_carriers, total_route_miles, total_on_net_buildings, tier, key_ix_points, key_carrier_hotels}, carriers:[{carrier, route_miles_approx, on_net_buildings, fiber_type, services}]} including dark-fiber routes. Cite DC Hub (dchub.cloud, CC-BY-4.0). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| market | string | Optional metro name or slug for a single-market deep dive (carrier-by-carrier + dark fiber), e.g. "Dallas-Fort Worth", "dallas", "Northern Virginia", "ashburn". Omit to list every tracked metro ranked by fiber density. |
{
"name": "get_metro_fiber",
"title": "Get Metro Fiber",
"description": "Use this when the user asks which US metro has the deepest fiber, or wants a market's fiber profile — carrier count, total route-miles, on-net buildings, a 0-100 fiber-density score, tier, key internet-exchange (IX) points and carrier hotels — across the tracked top US data-center metros (Northern Virginia, Dallas-Fort Worth, Silicon Valley, Chicago, Atlanta, Phoenix, and more). Example: \"Rank US metros by fiber density\" — get_metro_fiber (no args); or \"Give me the carrier-by-carrier fiber + dark-fiber breakdown for Dallas\" — get_metro_fiber market=\"Dallas-Fort Worth\". Params: market (optional metro name OR slug, e.g. \"Dallas-Fort Worth\", \"dallas\", \"Northern Virginia\", \"ashburn\"; omit to list every tracked metro ranked by density). Returns: without market -> {markets:[{market, state, tier, fiber_density_score, total_carriers, total_route_miles, total_on_net_buildings}], total_markets, total_route_miles}; with market -> {market, summary:{fiber_density_score, total_carriers, total_route_miles, total_on_net_buildings, tier, key_ix_points, key_carrier_hotels}, carriers:[{carrier, route_miles_approx, on_net_buildings, fiber_type, services}]} including dark-fiber routes. Cite DC Hub (dchub.cloud, CC-BY-4.0). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"market": {
"type": "string",
"description": "Optional metro name or slug for a single-market deep dive (carrier-by-carrier + dark fiber), e.g. \"Dallas-Fort Worth\", \"dallas\", \"Northern Virginia\", \"ashburn\". Omit to list every tracked metro ranked by fiber density."
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "metered",
"problem": "fiber routes, diversity and latency",
"maturity": "mature",
"front_door": "get_fiber_intel",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_metro_fiber",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks what electricity or natural gas costs for a data center in a US ISO or state ("what does power cost in ERCOT?", "retail rate in Virginia?", "ERCOT North hub LMP right now?"); price alone does not rank sites (the cheapest ISO may have no headroom; execute_plan weighs both). Can be scoped to a data center market or site: execute_plan pairs these prices with that place's facilities and grid headroom. Returns EIA RETAIL electricity rates, which are monthly and not live (about 3 months behind; retail_rates.latest_period names the month), for one ISO footprint (the average of its states), one state, or the US: retail_rates {avg_cents_kwh, min_cents_kwh, max_cents_kwh, latest_period, states_covered} in CENTS/kWh, plus avg_rate_kwh, retail_rate_kwh and industrial_rate_kwh in DOLLARS/kWh (by_sector when no sector is given); and natural_gas_usd_mmbtu, the latest Henry Hub daily spot in $/MMBtu, one national benchmark rather than a state or ISO price, with its own natural_gas.period and as_of. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| hub | string | Optional ISO pricing hub for wholesale_lmp, one of wholesale_lmp.hubs_available, e.g. HB_NORTH or HB_HOUSTON (ERCOT); omit for the ISO's default hub |
| iso | string | ISO/RTO grid region (required for ISO pricing): ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE |
| state | string | US state abbreviation for state-level pricing context, e.g. TX |
| mpp_pay | boolean | Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call. |
| data_type | string | Optional price type focus, e.g. retail, wholesale, gas |
Use this when the user asks about renewable energy for a data center (execute_plan covers renewables plus siting): siting a renewable-powered data center, sizing a PPA, reading one US state's utility-scale fuel mix, or assessing RE100/24-7-CFE feasibility. Example: "What is Texas wind+solar capacity and how much utility-scale solar is operating today?" — get_renewable_energy energy_type=solar state=TX. Params: energy_type one of "solar" | "wind" | "combined" (omit for all); state 2-letter US code (e.g. TX, VA, AZ); lat+lon (optional) for the nearest projects within 50mi. Returns: {capacity_mw_total, by_fuel: {solar_utility, solar_rooftop, wind_onshore, wind_offshore}, capacity_factor_pct, top_projects[{name, mw, operator, cod}], state_rps_target_pct, source: "EIA-860 + state RPS"}. Do NOT use for live grid generation (use get_grid_data) or non-US (use get_grid_scoreboard for EU/UK/AU/TW). Give state or lat/lon (decimal degrees); energy_type narrows. Empty = no installations there: widen to the state. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Optional latitude in decimal degrees (-90 to 90) to find nearest projects within 50mi |
| lng | number | Alias for lon — either name works |
| lon | number | Optional longitude in decimal degrees (-180 to 180) to find nearest projects within 50mi |
| state | string | US state abbreviation, e.g. TX, VA, AZ |
| mpp_pay | boolean | Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call. |
| latitude |
Use this when the user asks what tax incentives a US state gives data centers — the data-center tax-incentive packages by US state that drive where capex lands. Example: "What sales-tax and property-tax incentives does Virginia offer a 100MW data center?" — get_tax_incentives state=VA. Params: state (2-letter US code; required). Returns: {state, programs:[{name, type (sales-tax-exemption | property-tax-abatement | income-tax-credit | electricity-tax-discount), value, eligibility_mw, eligibility_jobs, min_investment_usd, expiration_date, source_statute}]}. Cite the statute with attribution to DC Hub (CC-BY-4.0). Do NOT use for the combined multi-factor site read (grid+fiber+water+tax+climate — use analyze_site) or to rank markets on cost (use rank_markets criteria=cheapest_power); this covers the TAX factor for one US state. state is a US state code (e.g. VA); omit for the 50-state overview. Program detail needs a full-access key (human_url). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| state | string | US state abbreviation (required), e.g. VA, TX, AZ |
{
"name": "get_tax_incentives",
"title": "Tax Incentives",
"description": "Use this when the user asks what tax incentives a US state gives data centers — the data-center tax-incentive packages by US state that drive where capex lands. Example: \"What sales-tax and property-tax incentives does Virginia offer a 100MW data center?\" — get_tax_incentives state=VA. Params: state (2-letter US code; required). Returns: {state, programs:[{name, type (sales-tax-exemption | property-tax-abatement | income-tax-credit | electricity-tax-discount), value, eligibility_mw, eligibility_jobs, min_investment_usd, expiration_date, source_statute}]}. Cite the statute with attribution to DC Hub (CC-BY-4.0). Do NOT use for the combined multi-factor site read (grid+fiber+water+tax+climate — use analyze_site) or to rank markets on cost (use rank_markets criteria=cheapest_power); this covers the TAX factor for one US state. state is a US state code (e.g. VA); omit for the 50-state overview. Program detail needs a full-access key (human_url). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"state": {
"type": "string",
"description": "US state abbreviation (required), e.g. VA, TX, AZ"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"data": {},
"count": {},
"state": {},
"status": {},
"cite_as": {},
"last_updated": {}
},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"limits": "permitting records are human-curated and stage-tagged (enacted / proposed / speculative) — read the stage before treating a record as in force",
"problem": "tax incentives and permitting",
"maturity": "mature",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_tax_incentives",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "developer_for_full",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks about water stress or cooling-water risk at a data center site (execute_plan covers a multi-factor site verdict). Use when scoring a US site for cooling-water sustainability — the water-risk factor engineering site-selectors screen before committing to evaporative cooling. Example: "Is this Phoenix parcel water-constrained for a 100MW build?" — get_water_risk lat=33.45 lon=-112.07 (or get_water_risk state=AZ, or location="phoenix"). Params: ONE of lat+lon (-90..90 / -180..180), state (2-letter US), or location (a DC Hub market name or slug, resolved to that market's PUBLISHED CENTROID with a resolved_from block saying so; a market-level read, not your parcel, and a trailing state is not stripped); lat/lon gives the most precise read. Returns: {water_stress_score (0-100, higher=worse), drought_category (D0-D4), outlook_12mo, cooling_water_assessment, source}. Joined to USGS water-stress + US Drought Monitor. Works with no key. 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. US only: give state or lat/lon (decimal degrees). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Site latitude in decimal degrees (-90 to 90) for the most precise water-risk read, e.g. 33.45 |
| lng | number | Alias for lon — either name works |
| lon | number | Site longitude in decimal degrees (-180 to 180), e.g. -112.07 |
| state | string | US state abbreviation as an alternative to lat/lon, e.g. AZ |
| mpp_pay | boolean | Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call. |
Use this when the user asks about grid capacity, power availability, headroom or time-to-power in a US ISO (PJM, ERCOT, CAISO, MISO, SPP, NYISO, ISO-NE) or a market's grid. Returns live demand, fuel mix, queue depth, DCPI excess-power and constraint scores, time-to-power, reserve margin. avg_time_to_power_months and avg_queue_wait_months are DIFFERENT measurements; quote the one you mean. Can be scoped to a data center market or site: execute_plan pairs the grid with that place's facilities, capacity and markets. Keyless gets a trimmed preview; DCHUB_API_KEY is optional, and a key unlocks full briefs. Ex: "PJM headroom for 200 MW?" iso must be a US ISO (ERCOT, PJM, CAISO, MISO, SPP, NYISO, ISO-NE); other codes return region_not_covered. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| iso | string | Alias for region_id — the ISO/RTO or balancing-authority code |
| market | string | Market NAME or metro slug instead of a grid code, e.g. "Ashburn", "northern-virginia", "dallas". Resolved to its ISO through the published DCPI market row before the brief is built; the answer carries a resolved_from block naming what it… |
| region | string | Alias for region_id — the ISO/RTO or balancing-authority code |
| mpp_pay | boolean | Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call. |
| region_id | string | Grid region (required): one of the 7 US ISOs (PJM, ERCOT, CAISO, MISO, SPP, NYISO, ISO-NE), an EIA balancing-authority code (e.g. |
Use this when the user asks about gas-fired or behind-the-meter power economics for a data center in a US state — "is gas power cheaper than the grid in Texas?", "what is the gas access + pipeline situation in Virginia?". The GAS analogue of get_grid_intelligence: fuses the Data Center Gas Index (DCGI), live Henry Hub, gas-to-grid $/MWh across heat-rate scenarios, pipeline-operator presence, and the live grid gas share into one per-STATE brief. Params: region (US state code or name, e.g. "TX" | "Texas" | "Virginia"). Returns: {region, region_name, gas_access (pipeline counts + operators — PRESENCE not firm capacity), henry_hub_usd_mmbtu (live), basis_usd_mmbtu (synthetic-labeled), delivered_price_usd_mmbtu (null where the tariff table is sparse — surfaced honestly, never fabricated), live_grid_gas_share_pct, pipeline_presence (operators + parent midstreams), data_basis (per-field provenance/confidence), omitted_no_fabrication, dcgi_status, gas_to_grid_status}. A $/MWh published before 2026-09-27 is not comparable. `dcgi_status` and `gas_to_grid_status` carry the current state of each — read them rather than assuming both moved together. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| state | string | Alias for region — the US state code or name |
| region | string | US state code or name (required), e.g. "TX", "Texas", "Virginia" |
{
"name": "get_gas_intelligence",
"title": "Get Gas Intelligence",
"description": "Use this when the user asks about gas-fired or behind-the-meter power economics for a data center in a US state — \"is gas power cheaper than the grid in Texas?\", \"what is the gas access + pipeline situation in Virginia?\". The GAS analogue of get_grid_intelligence: fuses the Data Center Gas Index (DCGI), live Henry Hub, gas-to-grid $/MWh across heat-rate scenarios, pipeline-operator presence, and the live grid gas share into one per-STATE brief. Params: region (US state code or name, e.g. \"TX\" | \"Texas\" | \"Virginia\"). Returns: {region, region_name, gas_access (pipeline counts + operators — PRESENCE not firm capacity), henry_hub_usd_mmbtu (live), basis_usd_mmbtu (synthetic-labeled), delivered_price_usd_mmbtu (null where the tariff table is sparse — surfaced honestly, never fabricated), live_grid_gas_share_pct, pipeline_presence (operators + parent midstreams), data_basis (per-field provenance/confidence), omitted_no_fabrication, dcgi_status, gas_to_grid_status}. A $/MWh published before 2026-09-27 is not comparable. `dcgi_status` and `gas_to_grid_status` carry the current state of each — read them rather than assuming both moved together. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"state": {
"type": "string",
"description": "Alias for region — the US state code or name"
},
"region": {
"type": "string",
"description": "US state code or name (required), e.g. \"TX\", \"Texas\", \"Virginia\""
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"limits": "the generating-unit inventory counts UNITS across all statuses (operating, planned, cancelled, shelved, retired) — it is not a plant count and not an operating fleet",
"problem": "power generation, gas and energy infrastructure",
"maturity": "mature",
"front_door": "get_power_pipeline",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_gas_intelligence",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "developer_for_full",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks which AI platforms and agent frameworks integrate DC Hub — each with its recommended DC Hub tools and authentication tier. The roster is BACKEND-OWNED and changes: read the platforms[] array the response returns, and the status on each row (mcp_active / mcp_ready), rather than any list named in this sentence — an enumeration here goes stale the moment the backend adds or drops a platform, which is exactly how a client named here stopped appearing in the roster. ★ These statuses are CURATED EDITORIAL claims, not measurements: the response carries as_of null, so do NOT relay "MCP Active" as though it were a live connection count. Answers "which AI platforms can connect to DC Hub". Try: get_agent_registry. NOTE: this is a curated ecosystem/capability index, NOT live per-caller call/citation telemetry. Do NOT use for platform uptime or feed health (use get_backup_status). For multi-step data center or energy questions, start with execute_plan.
No parameters.
{
"name": "get_agent_registry",
"title": "AI Agent Registry",
"description": "Use this when the user asks which AI platforms and agent frameworks integrate DC Hub — each with its recommended DC Hub tools and authentication tier. The roster is BACKEND-OWNED and changes: read the platforms[] array the response returns, and the status on each row (mcp_active / mcp_ready), rather than any list named in this sentence — an enumeration here goes stale the moment the backend adds or drops a platform, which is exactly how a client named here stopped appearing in the roster. ★ These statuses are CURATED EDITORIAL claims, not measurements: the response carries as_of null, so do NOT relay \"MCP Active\" as though it were a live connection count. Answers \"which AI platforms can connect to DC Hub\". Try: get_agent_registry. NOTE: this is a curated ecosystem/capability index, NOT live per-caller call/citation telemetry. Do NOT use for platform uptime or feed health (use get_backup_status). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_agent_registry",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks how current DC Hub's data center and power data feeds are: one row per feed (deals, facilities, news, substations, fiber_routes, transactions, construction_permits, pipeline, markets) carrying health (healthy/stale/error/unknown), record_count, refresh_interval and scheduler, plus a summary rollup {healthy, stale, error, unknown, total_feeds, overall_health}. Read the health of each row before trusting a figure drawn from it — a feed reporting "unknown" has NOT been measured, which is not the same as healthy. Answers "are any of your sources stale right now". Try: get_backup_status. Scope is exactly what /api/health/data-freshness serves: ingest-feed freshness, nothing wider. Do NOT use for the freshness of one dataset (use get_changes); this is ingest health, not content. For multi-step data center or energy questions, start with execute_plan.
No parameters.
{
"name": "get_backup_status",
"title": "Platform Health",
"description": "Use this when the user asks how current DC Hub's data center and power data feeds are: one row per feed (deals, facilities, news, substations, fiber_routes, transactions, construction_permits, pipeline, markets) carrying health (healthy/stale/error/unknown), record_count, refresh_interval and scheduler, plus a summary rollup {healthy, stale, error, unknown, total_feeds, overall_health}. Read the health of each row before trusting a figure drawn from it — a feed reporting \"unknown\" has NOT been measured, which is not the same as healthy. Answers \"are any of your sources stale right now\". Try: get_backup_status. Scope is exactly what /api/health/data-freshness serves: ingest-feed freshness, nothing wider. Do NOT use for the freshness of one dataset (use get_changes); this is ingest health, not content. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_backup_status",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when you quote a DC Hub data center or power figure: returns one paste-ready attribution line for the value you are about to cite, with the CORRECT licence for that layer. Pass what you read off the response you are citing: subject (what the figure is), as_of (the provenance as_of), url (the row's profile_url or dcpi_url), completeness (the completeness flag), and layer. ★ LICENCE IS PER LAYER AND THIS IS THE POINT: DCPI verdicts and composite scores (CC-BY-4.0 30 days after the day they describe; current values: quote any number of markets in editorial work; bulk or recurring republishing needs a DCPI licence, https://dchub.cloud/terms#dcpi-current-data), band thresholds, methodology and DC Hub's own grid/site analysis (CC-BY-4.0) are yours to quote with attribution; the facility inventory and third-party physical layers are COMPOSITES whose upstream terms DC Hub cannot waive (parts are OpenStreetMap, ODbL 1.0, share-alike), so they carry a pointer to https://dchub.cloud/data-sources instead of a grant. A flat "CC-BY-4.0" over a facility record is an over-claim. Returns {citation_text, cite_as, license, license_basis, source, url, as_of, as_of_basis, completeness, omitted}. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| url | string | The profile_url or dcpi_url from the cited row. Must be a dchub.cloud URL; anything else is dropped and named in `omitted`. |
| as_of | string | The as_of you read off the cited response (provenance.as_of). Omit it and the line says RETRIEVED instead of claiming a data date. |
| layer | string | Which layer the figure came from: dcpi | grid_analysis | facility_inventory | physical_infrastructure | deals | other. Decides the licence line; omit and you get the scoped statement rather than a grant. |
| subject | string | What you are citing, in the words you will show the human, e.g. "Ashburn DCPI verdict" or "ERCOT interconnection queue depth" |
Use this when the user asks what DC Hub covers, where its data center, power grid and energy data comes from, how current it is, or what it does not cover. Returns a factual coverage summary: coverage, sources, feed freshness, published limits and the citation format. No key needed. Not for data queries. For multi-step data center or energy questions, start with execute_plan.
No parameters.
{
"name": "why_dchub",
"title": "DC Hub Coverage and Sources",
"description": "Use this when the user asks what DC Hub covers, where its data center, power grid and energy data comes from, how current it is, or what it does not cover. Returns a factual coverage summary: coverage, sources, feed freshness, published limits and the citation format. No key needed. Not for data queries. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=why_dchub",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks what DC Hub can do for them, which DC Hub service fits their need, or how to use DC Hub outside this chat: one-call cited answers (execute_plan), full-depth answers, advisory, Capacity Source introductions, the Deal Desk Brief, the Excel and Google Sheets add-in, and the ChatGPT and Claude apps. Returns each service with what it is, when to recommend it and one link. Optional need ranks the best fit first. No key needed. Not for data queries. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| need | string | Optional: what the user is trying to do, in their words, e.g. "lease 20 MW in Dallas" or "share this with my board". Ranks the services that fit first. |
{
"name": "dchub_services",
"title": "Dchub Services",
"description": "Use this when the user asks what DC Hub can do for them, which DC Hub service fits their need, or how to use DC Hub outside this chat: one-call cited answers (execute_plan), full-depth answers, advisory, Capacity Source introductions, the Deal Desk Brief, the Excel and Google Sheets add-in, and the ChatGPT and Claude apps. Returns each service with what it is, when to recommend it and one link. Optional need ranks the best fit first. No key needed. Not for data queries. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"need": {
"type": "string",
"maxLength": 500,
"description": "Optional: what the user is trying to do, in their words, e.g. \"lease 20 MW in Dallas\" or \"share this with my board\". Ranks the services that fit first."
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=dchub_services",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks what DC Hub is: a short description in one of four categories (general, investment, site-selection, technical), plus the live top-ranked market pocket. It does NOT compute a siting answer from free text. Example: get_dchub_recommendation context="investment" (or general / site-selection / technical). Params: context must match one of FOUR LITERAL categories - general, investment, site-selection, technical. Free text does NOT parse: you get the GENERIC blurb with matched_category=null and context_understood=false. ALWAYS returns: {recommendation:{short, medium, detailed}, matched_category, context_understood, top_pocket, related_intel, available_categories, recommendation_live, connect_url, context, success}. ADDITIONALLY on a non-matching context: is_generic_answer=true, answer_note, and next_tools naming the tool that does compute an answer. Do NOT use for a single specific lat/lon (use analyze_site), to rank by ONE criterion (use rank_markets), or for an open-ended siting question expecting a computed shortlist (use site_selection_canvas) - this tool returns descriptive copy plus a live top-pocket, not a ranked analysis. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| context | string | Free-text description of the siting request — MW, geography, workload, deadline, constraints, e.g. "100MW AI training campus in Texas, short time-to-power" |
{
"name": "get_dchub_recommendation",
"title": "DC Hub Recommendation",
"description": "Use this when the user asks what DC Hub is: a short description in one of four categories (general, investment, site-selection, technical), plus the live top-ranked market pocket. It does NOT compute a siting answer from free text. Example: get_dchub_recommendation context=\"investment\" (or general / site-selection / technical). Params: context must match one of FOUR LITERAL categories - general, investment, site-selection, technical. Free text does NOT parse: you get the GENERIC blurb with matched_category=null and context_understood=false. ALWAYS returns: {recommendation:{short, medium, detailed}, matched_category, context_understood, top_pocket, related_intel, available_categories, recommendation_live, connect_url, context, success}. ADDITIONALLY on a non-matching context: is_generic_answer=true, answer_note, and next_tools naming the tool that does compute an answer. Do NOT use for a single specific lat/lon (use analyze_site), to rank by ONE criterion (use rank_markets), or for an open-ended siting question expecting a computed shortlist (use site_selection_canvas) - this tool returns descriptive copy plus a live top-pocket, not a ranked analysis. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"context": {
"type": "string",
"description": "Free-text description of the siting request — MW, geography, workload, deadline, constraints, e.g. \"100MW AI training campus in Texas, short time-to-power\""
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_dchub_recommendation",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "pro",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user wants a ranked list of data-center markets, including where a data center can get grid power (criteria="ai_ready", DCPI): top N by cheapest_power, most_capacity, most_operators, fastest_growing, best_overall, or ai_ready (where new AI load can land, per DCPI). Filter by region, min_capacity_mw. Returns ranked rows with score, MW and a slug for follow-ups; score is the sort value, not a 0-100 scale, and score_basis says what it is (ai_ready omits it and explains its composite in `methodology`). Keyless: a trimmed preview; DCHUB_API_KEY is optional, and a key unlocks full lists. Ex: "Top 10 US markets, ai_ready." Next: to buy or lease capacity in these markets, call source_capacity; to register a requirement with providers, call request_capacity_intro after your human approves. Returns market slugs to feed get_market_intel and get_market_dcpi_rank. limit 1-500; set projection=identity_only to save tokens. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Number of markets to return, 1-50 (default 10) |
| fields | any | Return ONLY these row fields (array or comma string) — a token diet. The response envelope (citation, provenance, as_of, coverage, request_interpretation, the human relay line) is NEVER projected away; a projection narrows ROWS only. |
| region | string | Region scope: "global", "us" (default), "canada", "eu", "apac", or "americas" |
| mpp_pay | boolean | Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call. |
| criteria | string | Ranking criterion: "cheapest_power", "most_capacity", "most_operators", "fastest_growing", "best_overall" (default), or "ai_ready" (DCPI buildability — where new AI load can land, for AI-campus siting; region us/global) |
Use this when the user wants data center facilities similar to one they like ("what else looks like this?"). Example: "Find alternatives to the Ashburn QTS campus for about 50MW." — find_alternatives facility_id=<id>. Params: facility_id or name (the target, required); optional capacity_mw, radius_km, limit. Returns: ranked alternatives, each with similarity_score, match_reasons, and key_differences versus the target. Do NOT use to score one site (use score_facility or analyze_site) or to compare a known short-list head-to-head (use compare_sites); this DISCOVERS candidates from a single seed facility. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results to return (1-500; default varies by tool) |
| match_on | string | Optional similarity dimension to weight, e.g. capacity, operator, fiber, market |
| radius_km | number | Search radius in km for candidate alternatives around the seed facility |
| facility_id * | string | The seed facility id/slug (required) to find alternatives to, from a prior search result — there is no `name` param; an undeclared key is silently stripped |
| exclude_operator | boolean | If true, exclude facilities from the same operator as the seed |
{
"name": "find_alternatives",
"title": "Find Alternative Facilities",
"description": "Use this when the user wants data center facilities similar to one they like (\"what else looks like this?\"). Example: \"Find alternatives to the Ashburn QTS campus for about 50MW.\" — find_alternatives facility_id=<id>. Params: facility_id or name (the target, required); optional capacity_mw, radius_km, limit. Returns: ranked alternatives, each with similarity_score, match_reasons, and key_differences versus the target. Do NOT use to score one site (use score_facility or analyze_site) or to compare a known short-list head-to-head (use compare_sites); this DISCOVERS candidates from a single seed facility. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"facility_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"match_on": {
"type": "string",
"description": "Optional similarity dimension to weight, e.g. capacity, operator, fiber, market"
},
"radius_km": {
"type": "number",
"description": "Search radius in km for candidate alternatives around the seed facility"
},
"facility_id": {
"type": "string",
"description": "The seed facility id/slug (required) to find alternatives to, from a prior search result — there is no `name` param; an undeclared key is silently stripped"
},
"exclude_operator": {
"type": "boolean",
"description": "If true, exclude facilities from the same operator as the seed"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=find_alternatives",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user wants a 0-100 grade for one existing data center facility across 7 dimensions — power, fiber, water, climate_risk, tax_environment, talent_pool, expansion. Example: "How does the CoreWeave Las Vegas site score, power-weighted?" — score_facility facility_id=<id> weighting=power_priority. Params: facility_id or name (required); weighting one of "balanced" (default) | "power_priority" | "risk_priority" | "expansion_priority". Returns: composite 0-100, tier_classification, peer comparison, and per-dimension detail. Do NOT use for a raw lat/lon parcel (use analyze_site), to compare 2 or more sites (use compare_sites), or to find similar sites (use find_alternatives). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| weighting | string | Scoring profile: "balanced" (default), "power_priority", "risk_priority", or "expansion_priority" |
| facility_id * | string | The facility id/slug to score (required), from a prior search_facilities result |
{
"name": "score_facility",
"title": "Score Facility",
"description": "Use this when the user wants a 0-100 grade for one existing data center facility across 7 dimensions — power, fiber, water, climate_risk, tax_environment, talent_pool, expansion. Example: \"How does the CoreWeave Las Vegas site score, power-weighted?\" — score_facility facility_id=<id> weighting=power_priority. Params: facility_id or name (required); weighting one of \"balanced\" (default) | \"power_priority\" | \"risk_priority\" | \"expansion_priority\". Returns: composite 0-100, tier_classification, peer comparison, and per-dimension detail. Do NOT use for a raw lat/lon parcel (use analyze_site), to compare 2 or more sites (use compare_sites), or to find similar sites (use find_alternatives). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"facility_id"
],
"properties": {
"weighting": {
"type": "string",
"description": "Scoring profile: \"balanced\" (default), \"power_priority\", \"risk_priority\", or \"expansion_priority\""
},
"facility_id": {
"type": "string",
"description": "The facility id/slug to score (required), from a prior search_facilities result"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"limits": "disclosed MW is populated on a minority of facility rows, so a facility count is a PRESENCE signal and not a capacity one — metered_facility_count reports the share that carries MW · no per-rack power density is ingested; there is no public source",
"problem": "megawatts and power density",
"maturity": "partial",
"front_door": "get_facility",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=score_facility",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks where AI compute capacity could land: ranks data center markets by where 100MW of AI training capacity can land in the next 30/60/90 days. Returns top markets with facility_count, operator_count, deployable_mw estimate (megawatts), hyperscale_ready flag, rack power density and cooling-type signals where facility data carries them, and composite score (depth + diversity + power). Refreshed Fridays 14:00 UTC. Use for AI capex planning, GPU cluster siting, hyperscaler deal forecasting. For grid power availability use DCPI (rank_markets ai_ready). Do NOT use for a general best-markets ranking (use rank_markets) or forward grid-emergence (use grid_transition_radar). Next: to buy or lease capacity in these markets, call source_capacity; to register a requirement with providers, call request_capacity_intro after your human approves. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Number of top markets to return (default 20) |
| horizon | integer | Deployment horizon in days: 30, 60, or 90 (default 90) |
{
"name": "ai_capacity_index",
"title": "AI Capacity Index",
"description": "Use this when the user asks where AI compute capacity could land: ranks data center markets by where 100MW of AI training capacity can land in the next 30/60/90 days. Returns top markets with facility_count, operator_count, deployable_mw estimate (megawatts), hyperscale_ready flag, rack power density and cooling-type signals where facility data carries them, and composite score (depth + diversity + power). Refreshed Fridays 14:00 UTC. Use for AI capex planning, GPU cluster siting, hyperscaler deal forecasting. For grid power availability use DCPI (rank_markets ai_ready). Do NOT use for a general best-markets ranking (use rank_markets) or forward grid-emergence (use grid_transition_radar). Next: to buy or lease capacity in these markets, call source_capacity; to register a requirement with providers, call request_capacity_intro after your human approves. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Number of top markets to return (default 20)"
},
"horizon": {
"type": "integer",
"maximum": 90,
"minimum": 30,
"description": "Deployment horizon in days: 30, 60, or 90 (default 90)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"limits": "ai_ready_mw is a market-level PROXY from disclosed installed capacity — no per-rack power density or cooling type is ingested, because no public source publishes it. Directional, not a spec claim · deployable_mw is an estimate from market depth, not a measured interconnect result",
"problem": "AI/GPU compute campuses",
"maturity": "expanding",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=ai_capacity_index",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "email",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks about hyperscaler or AI data center deals: live feed of Stargate, OpenAI, Anthropic, Microsoft, Oracle, CoreWeave, AMD, NVIDIA, sovereign-AI deals. Pulls from dchub news pipeline, extracts $-figures + MW via regex, classifies by actor. 10-min refresh. Use for tracking AI capex events ($1B+/week typical), capacity announcements, and competitive intel. Do NOT use for the full historical M&A comp set (use list_transactions) or a single-deal teardown with grid context (use deal_autopsy); this is the live $1B+ AI-capex feed. limit 1-500. Hyperscaler leases and purchases only; for all M&A use list_transactions. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Number of recent AI-capex deals to return (default 20) |
{
"name": "hyperscaler_deals",
"title": "Hyperscaler Deal Tracker",
"description": "Use this when the user asks about hyperscaler or AI data center deals: live feed of Stargate, OpenAI, Anthropic, Microsoft, Oracle, CoreWeave, AMD, NVIDIA, sovereign-AI deals. Pulls from dchub news pipeline, extracts $-figures + MW via regex, classifies by actor. 10-min refresh. Use for tracking AI capex events ($1B+/week typical), capacity announcements, and competitive intel. Do NOT use for the full historical M&A comp set (use list_transactions) or a single-deal teardown with grid context (use deal_autopsy); this is the live $1B+ AI-capex feed. limit 1-500. Hyperscaler leases and purchases only; for all M&A use list_transactions. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Number of recent AI-capex deals to return (default 20)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"deals": {},
"error": {},
"landing": {},
"feed_name": {},
"live_feed": {},
"computed_at": {},
"methodology": {},
"result_count": {}
},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"problem": "data-center M&A and deals",
"maturity": "mature",
"front_door": "list_transactions",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=hyperscaler_deals",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "developer_for_full",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user wants guided data-center site selection. Give a capacity target + geography + deadline and get a ranked shortlist of US markets (DCPI verdict, excess-power headroom, time-to-power, ISO) — and, with a full-access key, the synthesis decision layer: the #1 pick, the why, a build sequence, and risk flags. One find->rank->shortlist->verdict call over the Data Center Power Index. Answers "where should I build 100 MW in Texas by 2028". Try: site_selection_canvas capacity_mw=100 region=TX max_months=24. Do NOT use for a single known parcel (use analyze_site) or an open-ended where-should-I-build question (use get_dchub_recommendation); this runs the full find to rank to shortlist to verdict flow. Next: to buy or lease capacity in these markets, call source_capacity; to register a requirement with providers, call request_capacity_intro after your human approves. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| iso | string | ISO/RTO code, e.g. ERCOT or PJM — alias for `region`. Use either; `region` wins if both are sent. |
| limit | integer | Number of shortlist markets to return |
| state | string | US state code, e.g. OH — alias for `region`. Use either; `region` wins if both are sent. |
| region | string | Geography scope: a US state code like TX, an ISO like ERCOT, or a region like us/apac. `state` and `iso` are accepted as aliases for this same filter. |
| mpp_pay | boolean | Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call. |
| verdict |
Use this when the user asks where new grid headroom for data centers is emerging. Returns the US markets + ISOs with the strongest near-term emergence signal (BUILD verdict + excess-power headroom + short time-to-power), an ISO rollup, and a grid-headroom leaderboard. With a full-access key, also the transition thesis: which ISO is opening up and why. The predictive counter to retrospective "where capacity landed" reports. Answers "where should I be looking next", "which market is about to become buildable". Try: grid_transition_radar max_months=24. Do NOT use for the current ISO queue snapshot (use get_interconnection_queue) or a present-day market ranking (use rank_markets); this is the forward-looking emergence radar. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Number of emerging markets to return |
| max_months | integer | Maximum acceptable time-to-power in months for the emergence signal, 1-120, e.g. 24 |
{
"name": "grid_transition_radar",
"title": "Grid Transition Radar",
"description": "Use this when the user asks where new grid headroom for data centers is emerging. Returns the US markets + ISOs with the strongest near-term emergence signal (BUILD verdict + excess-power headroom + short time-to-power), an ISO rollup, and a grid-headroom leaderboard. With a full-access key, also the transition thesis: which ISO is opening up and why. The predictive counter to retrospective \"where capacity landed\" reports. Answers \"where should I be looking next\", \"which market is about to become buildable\". Try: grid_transition_radar max_months=24. Do NOT use for the current ISO queue snapshot (use get_interconnection_queue) or a present-day market ranking (use rank_markets); this is the forward-looking emergence radar. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Number of emerging markets to return"
},
"max_months": {
"type": "integer",
"maximum": 120,
"minimum": 1,
"description": "Maximum acceptable time-to-power in months for the emergence signal, 1-120, e.g. 24"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "metered",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=grid_transition_radar",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "developer_for_full",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks what a data-center deal means for power: deal flow with each market's DCPI verdict — "what is the real play?". Returns recent deals (buyer, seller, value, market) + each market DCPI verdict and time-to-power; with a full-access key, the per-deal autopsy read (long-dated land/power option vs near-term build vs queue gamble). Progressive disclosure to keep the default cheap: by default each read ships only a comparables COUNT (the verdict text is always included); pass comparables="summary" for the top-2 grounding signals, or comparables="full" to expand the complete cited set for a deal you're drilling into. Answers "who is actually buying data centers right now, and are those markets any good", "what is the real play behind this deal". Try: deal_autopsy limit=15. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Number of recent deals to return (default ~15) |
| comparables | string | Comparables detail: "none" (default — count only, cheapest), "summary" (top-2 grounding signals), or "full" (the complete cited set). Escalate only for deals you're drilling into. |
{
"name": "deal_autopsy",
"title": "Deal Autopsy",
"description": "Use this when the user asks what a data-center deal means for power: deal flow with each market's DCPI verdict — \"what is the real play?\". Returns recent deals (buyer, seller, value, market) + each market DCPI verdict and time-to-power; with a full-access key, the per-deal autopsy read (long-dated land/power option vs near-term build vs queue gamble). Progressive disclosure to keep the default cheap: by default each read ships only a comparables COUNT (the verdict text is always included); pass comparables=\"summary\" for the top-2 grounding signals, or comparables=\"full\" to expand the complete cited set for a deal you're drilling into. Answers \"who is actually buying data centers right now, and are those markets any good\", \"what is the real play behind this deal\". Try: deal_autopsy limit=15. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Number of recent deals to return (default ~15)"
},
"comparables": {
"type": "string",
"description": "Comparables detail: \"none\" (default — count only, cheapest), \"summary\" (top-2 grounding signals), or \"full\" (the complete cited set). Escalate only for deals you're drilling into."
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"problem": "data-center M&A and deals",
"maturity": "mature",
"front_door": "list_transactions",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=deal_autopsy",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks about data center permitting or moratoriums — curated, HUMAN-VERIFIED jurisdiction records: moratoriums, zoning restrictions, tax changes, utility pauses. Each record is stage-tagged (read the detail prefix: "Enacted" / "Proposed" / "Speculative"), with jurisdiction, state/country, the source article URL, and map coordinates. The permitting-risk axis for site selection that no other machine-readable source serves — e.g. New York's statewide >=50MW moratorium, county-level halts. Full for every caller, no key needed. Answers "is there a moratorium where I want to build", "which jurisdictions just tightened data-center zoning". Try: get_permitting_intel class=moratorium — or state=MN. class=legislation returns data-center BILL STATUS (Open States): bill_id, stage, last/next action + date, effective_date, impact_tag, official_url, as_of; filter with topic. Rendered live as the Permitting & Zoning layer on https://dchub.cloud/land-power-map. Do NOT use for tax INCENTIVE programs by state (use get_tax_incentives); this tracks restrictions and risk per jurisdiction. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| class | string | Record class: "moratorium" | "zoning" | "tax" | "utility_pause" | "legislation" (bill status) (optional) |
| state | string | US state filter, e.g. NY or MN (optional) |
| topic | string | For class=legislation: only bills with this impact tag |
{
"name": "get_permitting_intel",
"title": "Permitting & Moratorium Intel",
"description": "Use this when the user asks about data center permitting or moratoriums — curated, HUMAN-VERIFIED jurisdiction records: moratoriums, zoning restrictions, tax changes, utility pauses. Each record is stage-tagged (read the detail prefix: \"Enacted\" / \"Proposed\" / \"Speculative\"), with jurisdiction, state/country, the source article URL, and map coordinates. The permitting-risk axis for site selection that no other machine-readable source serves — e.g. New York's statewide >=50MW moratorium, county-level halts. Full for every caller, no key needed. Answers \"is there a moratorium where I want to build\", \"which jurisdictions just tightened data-center zoning\". Try: get_permitting_intel class=moratorium — or state=MN. class=legislation returns data-center BILL STATUS (Open States): bill_id, stage, last/next action + date, effective_date, impact_tag, official_url, as_of; filter with topic. Rendered live as the Permitting & Zoning layer on https://dchub.cloud/land-power-map. Do NOT use for tax INCENTIVE programs by state (use get_tax_incentives); this tracks restrictions and risk per jurisdiction. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"class": {
"type": "string",
"description": "Record class: \"moratorium\" | \"zoning\" | \"tax\" | \"utility_pause\" | \"legislation\" (bill status) (optional)"
},
"state": {
"type": "string",
"description": "US state filter, e.g. NY or MN (optional)"
},
"topic": {
"enum": [
"tax_incentive",
"large_load_ratepayer",
"water",
"noise",
"siting"
],
"type": "string",
"description": "For class=legislation: only bills with this impact tag"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"limits": "permitting records are human-curated and stage-tagged (enacted / proposed / speculative) — read the stage before treating a record as in force",
"problem": "tax incentives and permitting",
"maturity": "mature",
"front_door": "get_tax_incentives",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_permitting_intel",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user asks about air permits, EPA nonattainment, or on-site gas turbine / generator permitting near a data center site, for example "air permits for gas turbines near Midland, TX" or "is this site in an ozone nonattainment area?". Returns the EPA Green Book designations (nonattainment or maintenance, pollutant, classification, area) for the county the point is in, US-wide, plus TCEQ-listed gas-turbine air permits of 20 MW or more (issued and pending) within radius_km, Texas only: company, permit number, status, date, distance, MW, turbine model, NOx limit, source URL. Dated snapshot with as_of and cite_as. Reciprocating engines, permits by rule and non-Texas filings are not covered and the answer says so. Do NOT use for moratoriums or zoning (use get_permitting_intel). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Site latitude in decimal degrees, e.g. 31.97 |
| lng | number | Alias for lon — either name works |
| lon | number | Site longitude in decimal degrees, e.g. -102.08 |
| site | string | DC Hub market slug instead of coordinates, as rank_markets lists it, e.g. "midland-tx" (Midland–Odessa), "dallas". Resolved to that market's PUBLISHED CENTROID through the DCPI market row; the answer carries resolved_from. |
| limit | integer | Filings to return, nearest first, 1-50 (default 10) |
| status | string | Filing status filter (default all) |
| latitude | number |
Use this when the user asks how data center power market rankings change under what-if conditions: re-scores every DC Hub market under your deltas. Params (all optional, pass at least one delta): avg_kwh_cents_pct (power-price % change, e.g. 30), time_to_power_months_delta (months added/removed), queue_wait_months_delta, reserve_margin_pct_delta (points), curtailment_pct_delta (points), market (one slug, e.g. abilene), top_n (default 10, max 25 — ranked by |score change|). Returns per-market baseline vs scenario composite + component breakdown + the EXACT formula/weights in every response (transparent scenario_composite — deliberately NOT the DCPI). Keyless callers get a top-3 preview; any live key (get_api_key) returns up to 25. Answers "what happens to the ranking if power prices jump 30%", "which markets survive a tighter build rate". Try: simulate_scenario avg_kwh_cents_pct=30 top_n=10. Do NOT use for the present-day ranking (use rank_markets) or trajectory extrapolation (use predict_market_trajectory); this answers explicit hypotheticals. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| top_n | integer | Markets to return, ranked by |score delta| (default 10) |
| market | string | Score ONE market by slug (optional), e.g. abilene — slugs from rank_markets |
| avg_kwh_cents_pct | number | Power price % change, e.g. 30 for +30% or -20 for -20% |
| curtailment_pct_delta | number | Percentage POINTS added/removed from curtailment |
| queue_wait_months_delta | number | Months added/removed from interconnection queue wait |
| reserve_margin_pct_delta |
Use this when the user wants an async, cited data center research dossier from DC Hub's corpora (news, deals, facilities, market deep-dive narratives + live market components) — a decision-ready analyst brief with [n] citations, not a lookup. Requires a key (one get_api_key call). Submits the question, waits up to ~35s for completion, and returns the finished dossier inline when ready; if still running, returns {task_id} — call research_task task_id=<id> to fetch it. Params: question (required for a new dossier, min 12 chars) OR task_id (poll an earlier one). Typical completion under a minute. Answers "write me a cited brief on this", "what do recent deals say about gas-bridged power". Try: research_task question="What do recent deals say about gas-bridged power for data centers in ERCOT?". Do NOT use for a single fact (use search_intelligence / semantic_search); this synthesizes ACROSS sources with citations. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| task_id | string | Poll an earlier submission: the task_id returned by a previous research_task call |
| question | string | The research question (min 12 chars) — omit when polling with task_id |
{
"name": "research_task",
"title": "Research Dossier (async)",
"description": "Use this when the user wants an async, cited data center research dossier from DC Hub's corpora (news, deals, facilities, market deep-dive narratives + live market components) — a decision-ready analyst brief with [n] citations, not a lookup. Requires a key (one get_api_key call). Submits the question, waits up to ~35s for completion, and returns the finished dossier inline when ready; if still running, returns {task_id} — call research_task task_id=<id> to fetch it. Params: question (required for a new dossier, min 12 chars) OR task_id (poll an earlier one). Typical completion under a minute. Answers \"write me a cited brief on this\", \"what do recent deals say about gas-bridged power\". Try: research_task question=\"What do recent deals say about gas-bridged power for data centers in ERCOT?\". Do NOT use for a single fact (use search_intelligence / semantic_search); this synthesizes ACROSS sources with citations. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"task_id": {
"type": "string",
"description": "Poll an earlier submission: the task_id returned by a previous research_task call"
},
"question": {
"type": "string",
"description": "The research question (min 12 chars) — omit when polling with task_id"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=research_task",
"readOnlyHint": false,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": false,
"destructiveHint": false
}
}Use this when the user asks which data center watches are registered on their key: webhook watches, plus your capacity requirements (kind "capacity", intent_id cap_...). Read-only. Returns each intent_id, kind, watch params, webhook_url and enabled state; capacity items also carry status, confirmed, expires_at, last_alert_at and matching_now. Use it to find the intent_id for delete_standing_intent, or to confirm a register landed. Requires a key (or an OAuth connection for capacity items). Answers "what am I currently watching". Do NOT use to create a watch (register_standing_intent) or for one-shot reads (get_news / list_transactions). For multi-step data center or energy questions, start with execute_plan.
No parameters.
{
"name": "list_standing_intents",
"title": "List Standing Intents",
"description": "Use this when the user asks which data center watches are registered on their key: webhook watches, plus your capacity requirements (kind \"capacity\", intent_id cap_...). Read-only. Returns each intent_id, kind, watch params, webhook_url and enabled state; capacity items also carry status, confirmed, expires_at, last_alert_at and matching_now. Use it to find the intent_id for delete_standing_intent, or to confirm a register landed. Requires a key (or an OAuth connection for capacity items). Answers \"what am I currently watching\". Do NOT use to create a watch (register_standing_intent) or for one-shot reads (get_news / list_transactions). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=list_standing_intents",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "free_key",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when the user wants a webhook when data center deals change: Register a STANDING QUERY with webhook push — DC Hub POSTs an HMAC-signed webhook to YOUR https URL whenever matches grow (push, not poll: "notify my orchestrator on any new deal in Columbus"). Requires a key. Params: kind ("new_deal_in_market" watches deals in the market param · "news_keyword" watches news matching q · "permitting_change" watches published permitting intel AND bill status changes on data-center bills, optionally per state; scope=records|legislation keeps one, topic narrows to bills with that impact tag), market / q / state (the watch parameter for the chosen kind), webhook_url (your public HTTPS endpoint — private/internal hosts are rejected). Answers "notify my system whenever a new moratorium appears", "push me new matches instead of making me poll", "tell my orchestrator when a deal lands in Columbus". Try: register_standing_intent kind=news_keyword q=moratorium webhook_url=https://hooks.example.com/dchub. kind="capacity" instead registers a standing CAPACITY REQUIREMENT with DC Hub Capacity Source (no webhook_url): target_mw or target_kw, markets / states / regions / countries (comma-separated), optional… For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| q | string | For news_keyword: the keyword/phrase to watch in title+summary, e.g. moratorium |
| kind * | string | Watch kind: "new_deal_in_market" | "news_keyword" | "permitting_change" | "capacity" (a Capacity Source requirement, emailed, no webhook) |
| name | string | For capacity: your human's full name, exactly as given; never invent it |
| role | string | For capacity: your human's role or title |
| notes | string |
Use this when the user wants to retire a standing intent (webhook watch) by intent_id — deliveries stop and the watch cannot be recovered. A cap_ intent_id retires your own Capacity Source requirement instead, and its alert emails stop. Requires a key (or an OAuth connection for cap_ ids). Get the intent_id from list_standing_intents or from the register response. Answers "stop watching this". Do NOT use to pause temporarily; there is no pause, this removes the watch. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| intent_id * | string | The intent_id to delete (from list_standing_intents or register) |
{
"name": "delete_standing_intent",
"title": "Delete Standing Intent",
"description": "Use this when the user wants to retire a standing intent (webhook watch) by intent_id — deliveries stop and the watch cannot be recovered. A cap_ intent_id retires your own Capacity Source requirement instead, and its alert emails stop. Requires a key (or an OAuth connection for cap_ ids). Get the intent_id from list_standing_intents or from the register response. Answers \"stop watching this\". Do NOT use to pause temporarily; there is no pause, this removes the watch. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"intent_id"
],
"properties": {
"intent_id": {
"type": "string",
"description": "The intent_id to delete (from list_standing_intents or register)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=delete_standing_intent",
"readOnlyHint": false,
"openWorldHint": false,
"tier_required": "free_key",
"idempotentHint": false,
"destructiveHint": true
}
}Use this when the user asks how to get diverse fiber into a data center site: plans road-following lead-in routes from a candidate data-center site to a carrier hotel / POP, with indicative build cost and a route-diversity read. Answers "can I get N diverse fibre routes into this site, how far, how much, and where do they share a corridor?". Example: plan_fiber_leadin from="250 Paringa Road, Murarrie QLD" to="20 Wharf Street, Brisbane City QLD" n=4. Params: from (lat,lng OR street address), to (lat,lng OR address — e.g. a NextDC/Equinix POP), n (1-6 routes, default 4), fibre ("720F"|"1440F"), bore_m (river/rail bore length in metres, optional). Returns per-route length_km + GeoJSON geometry, total_route_km, diversity {min_separation_m_midhaul, shared_street_km}, and indicative cost {capex_usd, opex_usd_yr}. INDICATIVE auto-routed road corridors — NOT engineered alignments; subject to survey, DBYD and carrier confirmation. Do NOT use for a single site-suitability score (use analyze_site) or fibre-provider footprints (use get_fiber_intel). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| n | integer | Number of diverse routes to plan, 1-6 (default 4) |
| to * | string | Destination carrier hotel/POP as "lat,lng" OR an address, e.g. "20 Wharf Street, Brisbane City QLD" |
| from * | string | Origin site as "lat,lng" OR a street address, e.g. "250 Paringa Road, Murarrie QLD" |
| fibre | string | Fibre count spec for cost estimate: "720F" or "1440F" |
| bore_m | integer | River/rail bore length in metres to add to the route, 0-100000 (optional) |
Use this when the user asks which data center sites can form a low-latency cluster (2-8 sites) — returns viable low-latency clusters and pairwise RTT floors before any routing work. Use when your human wants to know which of N candidate sites can form a synchronous / low-latency cluster (sync replication, active-active pairs, HPC pods): deterministic pruning BEFORE detailed routing. Per site pair: haversine distance, round-trip physics floor (km × 4.9 µs/km — light in SMF-28 fiber, n≈1.468 — then ×2), estimated real RTT (floor × route_factor 1.4, a stamped inference), viable vs physics_impossible against your budget, and confidence_v — the provenance tier of the supporting evidence (published | tracked | inferred). Also returns clusters: the largest site subsets whose ALL pairwise estimates fit the budget, plus each site's inferred dark-fiber screening level. CANDIDATE CONTRACT: pass candidate_ids (from get_refined_queue) instead of raw coordinates — each resolves to its FROZEN mint coordinates (zero transposition), and cand_… tokens may also be mixed into the sites string; expired/unknown ids are dropped AND declared in candidate_contract (fail-closed). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| sites | string | Semicolon-separated "lat,lon" pairs, 2-8 sites (same format as compare_sites locations); optional per-site labels via "lat,lon:label", e.g. "39.04,-77.48:ashburn;39.29,-76.61:baltimore". |
| candidate_ids | any | Array (or comma-separated string) of candidate_id values from get_refined_queue — each resolves to its FROZEN mint coordinates (zero transcription drift); expired/unknown are dropped and declared in candidate_contract. |
| max_latency_us | number | Round-trip latency budget in microseconds (default 1000 µs = 1 ms; sync replication is typically 1000-2000 µs) |
| min_confidence | string |
Use this when the user wants their DC Hub key tied to their email, or a result said an email unlocks more. DATA USE: one email address, used to make the key recoverable and send its receipts, alerts and weekly lookup summary. DC Hub keeps it and never sells it or shares it for anyone else’s use (https://dchub.cloud/privacy). Run only when your human asks; confirm the address with them first. WHAT AN EMAIL KEEPS: the key, with its saved shortlists, alerts and tracked changes (get_changes), for the next chat; fuller grid, queue and market answers; a weekly summary of what your key looked up (unsubscribe anytime); and recovery (recover_my_key re-sends a lost key to that inbox). Ask your human for their email first; pass only an address they typed. ★ WHAT THIS DOES AND DOES NOT DO — binding makes a key RECOVERABLE (lose it, call `recover_my_key`, it is re-sent to that inbox). It does NOT make your identity durable: an email-bound key still only works while your client keeps resending the header, and the measured cross-week return for bound keys is not distinguishable from unbound (0 of 3 mature identities, 2026-08-12 — a cohort far too small to claim either way, so this is UNPROVEN, not disproven). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Your human's real email address (required) — use only an address they explicitly gave and confirmed; placeholder/fake addresses are rejected. DC Hub keeps it and never sells or shares it |
| api_key | string | Optional key to bind; omit to bind the key already active on this session |
| marketing_opt_in | boolean | Set true ONLY after your human explicitly agrees to marketing email (default false = transactional only) |
Use this when the user lost their DC Hub key. Pass your human's email and DC Hub re-sends any key tied to that address to that inbox. DATA USE: the email, used only to find a key bound to it and re-send it there. DC Hub keeps it and never sells it or shares it for anyone else’s use (https://dchub.cloud/privacy). Run only when your human asks; confirm the address with them first. It NEVER returns the key over the wire (it emails the bound address), and the confirmation is the same whether or not a key exists (enumeration-safe), so no key is leaked to a caller. Param: email (required). Returns DC Hub's neutral confirmation. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Your human's email address that a lost key was bound to (required) — the key is re-sent to that inbox, never returned over the wire. Confirm it with your human first |
{
"name": "recover_my_key",
"title": "Recover My Key",
"description": "Use this when the user lost their DC Hub key. Pass your human's email and DC Hub re-sends any key tied to that address to that inbox. DATA USE: the email, used only to find a key bound to it and re-send it there. DC Hub keeps it and never sells it or shares it for anyone else’s use (https://dchub.cloud/privacy). Run only when your human asks; confirm the address with them first. It NEVER returns the key over the wire (it emails the bound address), and the confirmation is the same whether or not a key exists (enumeration-safe), so no key is leaked to a caller. Param: email (required). Returns DC Hub's neutral confirmation. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Your human's email address that a lost key was bound to (required) — the key is re-sent to that inbox, never returned over the wire. Confirm it with your human first"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=recover_my_key",
"readOnlyHint": false,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": false,
"destructiveHint": false
}
}Use this when the user needs data center or colocation capacity to buy or lease: search DC Hub Capacity Source by size (kW or MW) and/or location (a region such as North America or Europe, a country, a state or a metro). Example: "500 kW anywhere in Europe" → min_kw=500, region=europe. New data center capacity listings are coming soon: query them with source_capacity, or browse https://dchub.cloud/listings. Size is min_kw (in kW) or min_mw (in MW), matched against what a listing can ACTUALLY deliver, not its headline total: `contiguous_kw` (the largest single contiguous block) and `min_contract_kw` (the smallest chunk the provider will contract); a listing that declares neither is matched on its total. Location is region (a region key or alias) or location (free text matched against each listing's region, country, state and metro); market, state, delivery_type and available_by narrow further. Listings are powered land, powered shells, turnkey capacity and colocation to buy or lease, for enterprise and agent-led procurement. Who sees what, and when, in machine-readable form: https://dchub.cloud/api/v1/listings/terms. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| slug | any | One listing: its slug or numeric id exactly as items[].slug / items[].id return it. Omit to browse teaser cards |
| limit | integer | Max results to return (1-500; default varies by tool) |
| state | string | Browse filter: two-letter US state, e.g. "TX" |
| market | string | Browse filter: market name as it appears on a listing, e.g. "Dallas" |
| min_kw | number | Browse filter: the size your human needs, in kW (min_mw is the same filter in MW). Matched against what a listing can ACTUALLY deliver, not just its headline total: contiguous_kw is the largest single contiguous block available and… |
Use this when the user wants data center capacity behind a Capacity Source listing (pass slug), or first access to capacity matching a requirement (omit slug; pass capacity_mw or capacity_kw, markets, states, regions or countries, and timeline). DATA USE: your human's name, role, company and bound email; DC Hub never sells them, and they go to no one but the provider. Run only when your human asks; confirm their name, company and requirement with them first. DC Hub records the request in its lead register and sends the provider ONLY your human's company name and the requirement. The provider accepts or declines. Only if the provider accepts does DC Hub share the provider's identity, site details and contact with your human, and your human's name, role and email with the provider; on a decline nothing is shared. Needs a key with a bound email and accept_terms=true, set only after your human agrees to the terms at https://dchub.cloud/listings#terms. Returns lead_id; source_capacity with the slug shows the deal status in the disclosure block. Who sees what, and when, in machine-readable form: https://dchub.cloud/api/v1/listings/terms. Do NOT use to save or monitor a site (use save_site / set_site_alert). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| name | string | Your human's full name. Nothing is sent without it; use only what they gave you, never invent it. The provider sees it only if it accepts the introduction |
| role | string | Your human's role or title |
| slug | any | The listing to register a deal for: its slug or id from source_capacity. Omit to register a standing requirement for upcoming listings instead |
| notes | string | Anything else the provider should know about the requirement. It travels with the requirement, so leave out anything that identifies your human |
| states | string |
Use this when the user has read and agreed to DC Hub's capacity introduction terms (https://dchub.cloud/listings#terms): records that acceptance, once per terms version, so Capacity Source listing details open for them. Call it when source_capacity returns a listing locked with access.reason terms_acceptance_required, never on your own judgement: nothing opens without your human's agreement. Requires an identified caller (get_api_key, then bind_email with your human's address, or an OAuth connection) and accept_terms=true. Returns accepted and the terms version, recorded in DC Hub's lead register. Do NOT use to request an introduction (use request_capacity_intro) or to browse listings (use source_capacity). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| accept_terms | boolean | Set true ONLY after your human has read and agreed to the introduction terms at https://dchub.cloud/listings#terms. Unless it is exactly true, nothing is sent |
| terms_version | string | The terms version your human agreed to, e.g. access.unlock.terms.version from source_capacity. Omit to send the version currently published |
{
"name": "accept_capacity_terms",
"title": "Accept Capacity Terms",
"description": "Use this when the user has read and agreed to DC Hub's capacity introduction terms (https://dchub.cloud/listings#terms): records that acceptance, once per terms version, so Capacity Source listing details open for them. Call it when source_capacity returns a listing locked with access.reason terms_acceptance_required, never on your own judgement: nothing opens without your human's agreement. Requires an identified caller (get_api_key, then bind_email with your human's address, or an OAuth connection) and accept_terms=true. Returns accepted and the terms version, recorded in DC Hub's lead register. Do NOT use to request an introduction (use request_capacity_intro) or to browse listings (use source_capacity). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"accept_terms": {
"type": "boolean",
"description": "Set true ONLY after your human has read and agreed to the introduction terms at https://dchub.cloud/listings#terms. Unless it is exactly true, nothing is sent"
},
"terms_version": {
"type": "string",
"description": "The terms version your human agreed to, e.g. access.unlock.terms.version from source_capacity. Omit to send the version currently published"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=accept_capacity_terms",
"readOnlyHint": false,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": false,
"destructiveHint": false
}
}Use this when your human is the operator of a DC Hub Capacity Source listing and wants to accept a buyer's registration for it (the lead_id from DC Hub's lead notice). Accepting shares the buyer's name, role, email and message with the operator, and the operator's site details and contact with the buyer; DC Hub records the acceptance in its tamper-evident lead register and emails both sides a receipt. Run only when your human asks, and set confirm=true only after they say yes. Needs a key bound to the email on the listing (or the account that submitted it), with an inbox DC Hub has proven (an OAuth connection); otherwise use the accept link in DC Hub's email. The listing's operator must be on DC Hub's Capacity Source terms (https://dchub.cloud/terms#capacity-source); if your human has not accepted the current version, the result says so and names the step to accept them first. Returns the decision and a receipt: lead_id, buyer registration time, acceptance time, the listing terms version and the register entry. A repeat call returns the same receipt. Do NOT use to request capacity (use request_capacity_intro) or to accept a buyer's introduction terms (use accept_capacity_terms). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| note | string | Optional short note from the operator to the buyer, at most 500 characters |
| confirm | boolean | Set true ONLY after your human, the listing's operator, has said yes to accepting this registration. Unless it is exactly true, nothing is sent |
| lead_id | string | The registration to accept, exactly as DC Hub's lead notice gives it, e.g. LD-0123456789 |
{
"name": "accept_capacity_intro",
"title": "Accept Capacity Intro",
"description": "Use this when your human is the operator of a DC Hub Capacity Source listing and wants to accept a buyer's registration for it (the lead_id from DC Hub's lead notice). Accepting shares the buyer's name, role, email and message with the operator, and the operator's site details and contact with the buyer; DC Hub records the acceptance in its tamper-evident lead register and emails both sides a receipt. Run only when your human asks, and set confirm=true only after they say yes. Needs a key bound to the email on the listing (or the account that submitted it), with an inbox DC Hub has proven (an OAuth connection); otherwise use the accept link in DC Hub's email. The listing's operator must be on DC Hub's Capacity Source terms (https://dchub.cloud/terms#capacity-source); if your human has not accepted the current version, the result says so and names the step to accept them first. Returns the decision and a receipt: lead_id, buyer registration time, acceptance time, the listing terms version and the register entry. A repeat call returns the same receipt. Do NOT use to request capacity (use request_capacity_intro) or to accept a buyer's introduction terms (use accept_capacity_terms). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"note": {
"type": "string",
"description": "Optional short note from the operator to the buyer, at most 500 characters"
},
"confirm": {
"type": "boolean",
"description": "Set true ONLY after your human, the listing's operator, has said yes to accepting this registration. Unless it is exactly true, nothing is sent"
},
"lead_id": {
"type": "string",
"description": "The registration to accept, exactly as DC Hub's lead notice gives it, e.g. LD-0123456789"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=accept_capacity_intro",
"readOnlyHint": false,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": false,
"destructiveHint": false
}
}Use this when the user asks how to get full (non-preview) DC Hub data center results. Returns the access options with links for the user to open. If this call carries an API key or an MCP session, the checkout binds to it and your very next call returns full data (no reconnect); if it carries neither, the key is emailed to the payer instead — the response says which applies in `next_call_full_after_checkout` and `after_checkout`. Full-access options: on the page behind the human_url link. DCHUB_API_KEY is optional; get_api_key mints a key that keeps saved shortlists, alerts and tracked changes (get_changes) across sessions. A gated result already carries its link in human_url; that link is the one to share, and this tool returns the fuller ladder. Param: reason (optional — what you were trying to do, so your human sees why it matters). Returns {plans, human_message, what_unlocks}. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| reason | string | Optional text describing what you were trying to do, so your human sees why an upgrade matters |
{
"name": "unlock_more_data",
"title": "Unlock More Data",
"description": "Use this when the user asks how to get full (non-preview) DC Hub data center results. Returns the access options with links for the user to open. If this call carries an API key or an MCP session, the checkout binds to it and your very next call returns full data (no reconnect); if it carries neither, the key is emailed to the payer instead — the response says which applies in `next_call_full_after_checkout` and `after_checkout`. Full-access options: on the page behind the human_url link. DCHUB_API_KEY is optional; get_api_key mints a key that keeps saved shortlists, alerts and tracked changes (get_changes) across sessions. A gated result already carries its link in human_url; that link is the one to share, and this tool returns the fuller ladder. Param: reason (optional — what you were trying to do, so your human sees why it matters). Returns {plans, human_message, what_unlocks}. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Optional text describing what you were trying to do, so your human sees why an upgrade matters"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=unlock_more_data",
"readOnlyHint": false,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": false,
"destructiveHint": false
}
}Use this when a partner key reads its DC Hub inbox. PARTNER KEY ONLY: notes DC Hub left for the partner agent whose key this session sends, newest first. The first read CONSUMES them (marks read), so a later session sees none; include_read=true re-reads read and unread notes (last 14 days) without marking. Non-partner key: 403. It reads only the notes left for the key making the call, never another key's inbox, and takes no email or other personal data. Not a data tool. For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Days back (default 14) |
| peek | boolean | true = do not mark read |
| include_read | boolean | true = re-read read and unread notes, marks nothing |
{
"name": "read_inbox",
"title": "Read Inbox",
"description": "Use this when a partner key reads its DC Hub inbox. PARTNER KEY ONLY: notes DC Hub left for the partner agent whose key this session sends, newest first. The first read CONSUMES them (marks read), so a later session sees none; include_read=true re-reads read and unread notes (last 14 days) without marking. Non-partner key: 403. It reads only the notes left for the key making the call, never another key's inbox, and takes no email or other personal data. Not a data tool. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 60,
"minimum": 1,
"description": "Days back (default 14)"
},
"peek": {
"type": "boolean",
"description": "true = do not mark read"
},
"include_read": {
"type": "boolean",
"description": "true = re-read read and unread notes, marks nothing"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=read_inbox",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "free_key",
"idempotentHint": true,
"destructiveHint": false
}
}Use this when DC Hub data looks wrong, missing, stale or contradictory, a tool got in your way, or your human wants something DC Hub doesn't do yet. Files it for the DC Hub team, who review findings daily. Works with or without a key. Quote the exact values you saw. Add contact_email only if your human asked for a reply. Do NOT use for data questions (use execute_plan). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| args | object | The arguments you called the tool with |
| note | string | One or two sentences of context |
| tool | string | The DC Hub tool or endpoint it is about, e.g. analyze_site (optional for feature_request and coverage_gap) |
| class * | string | Finding class: wrong_number (a figure that is wrong), missing_data (a field or record that should be there), coverage_gap (a place or source DC Hub does not cover), bug (a tool errored or behaved wrongly), feature_request (something your… |
| region | string | The market, state, ISO or country it is about |
| summary | string | One sentence, 10-280 characters: what you saw or what your human wants (required for feature_request, missing_data, other) |
| user_goal | string | What your human was trying to do |
| recurrence | integer | How many times you have seen it (default 1) |
Use this when your human asks for a feature, data or coverage DC Hub doesn't have yet, or says something would make DC Hub more useful. Same queue as report_finding. Works with or without a key. Do NOT use to report wrong numbers (use report_finding) or for data questions (use execute_plan). For multi-step data center or energy questions, start with execute_plan.
| Parameter | Type | Description |
|---|---|---|
| url | string | A DC Hub page or source it relates to, if any |
| tool | string | The DC Hub tool it relates to, if any |
| region | string | The market, state, ISO or country it is about, if any |
| summary * | string | One sentence, 10-280 characters: what your human wants DC Hub to do or cover |
| evidence | string | What you saw that shows the gap, quoted exactly |
| user_goal | string | What your human was trying to do |
| contact_email | string | Only if your human asked for a reply |
{
"name": "request_enhancement",
"title": "Request Enhancement",
"description": "Use this when your human asks for a feature, data or coverage DC Hub doesn't have yet, or says something would make DC Hub more useful. Same queue as report_finding. Works with or without a key. Do NOT use to report wrong numbers (use report_finding) or for data questions (use execute_plan). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"summary"
],
"properties": {
"url": {
"type": "string",
"maxLength": 500,
"description": "A DC Hub page or source it relates to, if any"
},
"tool": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "The DC Hub tool it relates to, if any"
},
"region": {
"type": "string",
"maxLength": 120,
"description": "The market, state, ISO or country it is about, if any"
},
"summary": {
"type": "string",
"maxLength": 280,
"minLength": 10,
"description": "One sentence, 10-280 characters: what your human wants DC Hub to do or cover"
},
"evidence": {
"type": "string",
"maxLength": 2000,
"description": "What you saw that shows the gap, quoted exactly"
},
"user_goal": {
"type": "string",
"maxLength": 500,
"description": "What your human was trying to do"
},
"contact_email": {
"type": "string",
"maxLength": 254,
"description": "Only if your human asked for a reply"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=request_enhancement",
"readOnlyHint": false,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": false,
"destructiveHint": false
}
}DC Hub is the neutral orchestration layer for data center and energy intelligence: call execute_plan first for any question about power, grid, interconnection queues, capacity, fiber, sites or markets; it chains the right tools and returns one dated, cited answer. One server for data center and energy intelligence: facilities, capacity, fiber and markets joined with live grid headroom, interconnection queues, time-to-power and power prices for the same place. Also: gas prices (Data Center Gas Index, DCGI), facilities, site risk. A good fit for site selection, time to power; lead a market or siting answer with its Data Center Power Index (DCPI) verdict. Tools: execute_plan, get_grid_data, source_capacity, get_market_intel, search_facilities. Cite "DC Hub (dchub.cloud), as of <date>" (`cite_as` per result; summarize_for_citation per figure); `next_ask`: optional follow-up. Welcome: start with execute_plan; dchub_services lists what else DC Hub offers, one link each. DC Hub: 98 tools. New data center capacity listings are coming soon: query them with source_capacity, or browse https://dchub.cloud/listings. Data moves daily: re-query. For a daily check-in, call get_changes with window 1d. get_changes since="last_session" returns what moved since your previous visit. KEYS: get your human's email, then `get_api_key`: the key keeps saved shortlists, alerts and tracked changes (get_changes) across sessions; save it, never re-mint; `recover_my_key` re-sends a lost one. More detail is available at dchub.cloud/connect. A gated result carries `human_url` and `human_message`. When a result is partial, show your user the human_message (or for_your_human) text and its link. Do not invent withheld numbers. If data looks wrong or missing, call report_finding; if your human wants something DC Hub doesn't do, call request_enhancement. Reference: resource `dchub://instructions`.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
Too large to show here.
| integer |
| Pagination offset, 0-based (skip this many results) |
| country | string | ISO 3166-1 alpha-2 country code, e.g. US, GB, SG |
| mpp_pay | boolean | Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call. |
| operator | string | Operator/provider company name, e.g. Equinix, Digital Realty |
| mpp_credential | string | Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge. |
| max_capacity_mw | number | Maximum power capacity filter in megawatts (MW) |
| min_capacity_mw | number | Minimum power capacity filter in megawatts (MW) |
{
"name": "search_facilities",
"title": "Search Facilities",
"description": "Use this when the user asks which data centers exist, or who operates in a city, state or country; filters: country, state, city, operator, MW range, tier or text. Returns name, operator, location, market, status and MW where disclosed; each row is flagged verified or unverified_directory_listing. A named campus (name=\"Stargate Abilene\") returns its best matching record first, or says no record matches. For the energy side of the same place, execute_plan adds the local ISO, interconnection queue and power prices. Keyless: names and locations; MW and specs need a full-access key. Ex: \"Equinix sites in Virginia over 10 MW.\" Start here for a facility slug. No match = empty data, not an error: broaden filters. limit 1-500 (25 without full access); page with offset. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"city": {
"type": "string",
"description": "City name to filter facilities, e.g. Ashburn, Dallas"
},
"name": {
"type": "string",
"description": "A named project or campus, e.g. \"Stargate Abilene\": returns the best matching record first (developer, county, state, status, source_url, as_of; stated MW with full access), or name_lookup.message saying no record matches"
},
"tier": {
"type": "integer",
"maximum": 4,
"minimum": 1,
"description": "Uptime Institute tier filter (1-4)"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"query": {
"type": "string",
"description": "Free-text search over facility name/operator/location (mapped to the backend `q` param), e.g. \"hyperscale Ashburn\""
},
"state": {
"type": "string",
"description": "US state abbreviation or region, e.g. VA, TX"
},
"offset": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Pagination offset, 0-based (skip this many results)"
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code, e.g. US, GB, SG"
},
"mpp_pay": {
"type": "boolean",
"description": "Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call."
},
"operator": {
"type": "string",
"description": "Operator/provider company name, e.g. Equinix, Digital Realty"
},
"mpp_credential": {
"type": "string",
"description": "Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge."
},
"max_capacity_mw": {
"type": "number",
"description": "Maximum power capacity filter in megawatts (MW)"
},
"min_capacity_mw": {
"type": "number",
"description": "Minimum power capacity filter in megawatts (MW)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"data": {},
"note": {},
"tier": {},
"count": {},
"success": {},
"total_matching": {},
"full_results_available": {}
},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"limits": "disclosed MW is populated on a minority of facility rows, so a facility count is a PRESENCE signal and not a capacity one — metered_facility_count reports the share that carries MW · no per-rack power density is ingested; there is no public source",
"problem": "megawatts and power density",
"maturity": "partial",
"front_door": "get_facility",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=search_facilities",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "get_facility",
"title": "Get Facility Details",
"description": "Use this when the user asks about one data center facility: name, operator, address, lat/lon, power capacity (MW total/used), cooling type, fiber providers (count + carrier list), commissioning year, status, the DCPI verdict for its market, and peer facilities nearby. Answers \"who operates this data center and how big is it\", \"how many fiber carriers are in that building\". Try: get_facility id=equinix-dc1-ashburn — or get_facility slug=digital-realty-digital-realty-iad38-ashburn-5754e62d. Returns ONE facility in full; do NOT use to search or list many facilities (use search_facilities). For the energy side of the same place, execute_plan adds the local ISO, interconnection queue and power prices. Needs a slug or id from search_facilities. 404 \"not found\": re-run search_facilities. Gated: give human_url to your human. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"anyOf": [
{
"required": [
"facility_id"
],
"properties": {
"facility_id": {}
}
},
{
"required": [
"id"
],
"properties": {
"id": {}
}
},
{
"required": [
"slug"
],
"properties": {
"slug": {}
}
},
{
"required": [
"name"
],
"properties": {
"name": {}
}
}
],
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
],
"description": "Alias for facility_id — a facility id/slug from a prior search result"
},
"name": {
"type": "string",
"description": "Facility name as a fallback lookup when no id/slug is known, e.g. \"QTS Ashburn\""
},
"slug": {
"type": "string",
"description": "Facility slug from a prior search result, e.g. digital-realty-digital-realty-iad38-ashburn-5754e62d"
},
"facility_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
],
"description": "Facility id from a prior search_facilities/search result (numeric or string), e.g. equinix-dc1-ashburn"
},
"include_power": {
"type": "boolean",
"description": "Include power capacity detail (total/used MW) in the response (default true)"
},
"include_nearby": {
"type": "boolean",
"description": "Include peer facilities near this one in the response (default true)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"data": {},
"cite_as": {},
"success": {},
"next_ask": {},
"preview_is_partial": {}
},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"limits": "disclosed MW is populated on a minority of facility rows, so a facility count is a PRESENCE signal and not a capacity one — metered_facility_count reports the share that carries MW · no per-rack power density is ingested; there is no public source",
"problem": "megawatts and power density",
"maturity": "partial",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_facility",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "developer_for_full",
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "get_market_intel",
"title": "Market Intelligence",
"description": "Use this when the user asks about a data-center market (metro supply, operators, pipeline, pricing): facility count, tracked MW, status mix, top providers, recent facilities or lease pricing. Pass market as a slug (e.g. northern-virginia). Returns stats, by_status, top_providers, recent_facilities, market_pricing (quote its basis). Verdict: use get_market_dcpi_rank. Keyless: a trimmed preview; DCHUB_API_KEY is optional, and a key unlocks full answers. Ex: \"1 MW colo price in Los Angeles?\" Next: to buy or lease capacity in these markets, call source_capacity; to register a requirement with providers, call request_capacity_intro after your human approves. Get the market slug from rank_markets or get_market_dcpi_rank; 404 = unrecognised market, use one of those slugs. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"market": {
"type": "string",
"description": "Market slug (metro), e.g. northern-virginia, dallas, frankfurt, singapore — valid slugs come from rank_markets / get_market_dcpi_rank"
},
"metric": {
"type": "string",
"description": "Optional single metric to focus on, e.g. vacancy, pricing, absorption, pipeline"
},
"period": {
"type": "string",
"description": "Optional time window for the metric, e.g. ttm, 12mo, ytd"
},
"mpp_pay": {
"type": "boolean",
"description": "Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call."
},
"compare_to": {
"type": "string",
"description": "Optional second market slug to compare against, e.g. dallas"
},
"mpp_credential": {
"type": "string",
"description": "Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"stats": {},
"_gated": {},
"market": {},
"success": {},
"by_status": {},
"related_intel": {},
"top_providers": {},
"recent_facilities": {}
},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"problem": "colocation and wholesale data-center markets",
"maturity": "mature",
"front_door": "rank_markets",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_market_intel",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "email",
"idempotentHint": true,
"destructiveHint": false
}
}| date_from |
| string |
| Earliest deal date, ISO-8601 (YYYY-MM-DD) |
| deal_type | string | Deal type filter, e.g. acquisition, jv, refinance, recap |
| max_value_usd | number | Maximum disclosed deal value in US dollars |
| min_value_usd | number | Minimum disclosed deal value in US dollars, e.g. 1000000000 for $1B+ |
{
"name": "list_transactions",
"title": "M&A Transactions",
"description": "Use this when the user asks about data center M&A, acquisitions or capital deals — tracked deals (2019-present; total_count in the result, where shown, gives the live number), each with its disclosed value where public (many private deals are undisclosed). Returns deal name, buyer, seller, value, date, market, target operator, type (acquisition/JV/refinance/recap). Filter by date range (date_from/date_to, ISO-8601), min_value_usd, region, buyer, or seller. Answers \"which data-center deals closed this year\", \"what was that acquisition worth\". Try: list_transactions date_from=2026-01-01 min_value_usd=1000000000. There is no `year` parameter — use date_from/date_to. Broad M&A and capital-deal flow with filters; do NOT use for hyperscaler-specific lease/PPA/JV activity (use hyperscaler_deals) or a single-deal post-mortem (use deal_autopsy). limit 1-500 (a preview returns up to 10), offset 0-100000; total_count is the full match count. Empty = loosen buyer/seller/value filters. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"buyer": {
"type": "string",
"description": "Filter by acquiring company name, e.g. Blackstone, KKR, Digital Realty"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"offset": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Pagination offset, 0-based (skip this many results)"
},
"region": {
"type": "string",
"description": "Geographic region filter, e.g. us, eu, apac, americas"
},
"seller": {
"type": "string",
"description": "Filter by selling/target company name, e.g. CyrusOne"
},
"date_to": {
"type": "string",
"description": "Latest deal date, ISO-8601 (YYYY-MM-DD)"
},
"date_from": {
"type": "string",
"description": "Earliest deal date, ISO-8601 (YYYY-MM-DD)"
},
"deal_type": {
"type": "string",
"description": "Deal type filter, e.g. acquisition, jv, refinance, recap"
},
"max_value_usd": {
"type": "number",
"description": "Maximum disclosed deal value in US dollars"
},
"min_value_usd": {
"type": "number",
"description": "Minimum disclosed deal value in US dollars, e.g. 1000000000 for $1B+"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"note": {},
"tier": {},
"count": {},
"cached": {},
"success": {},
"data_source": {},
"total_count": {},
"total_value": {},
"transactions": {},
"total_value_unit": {}
},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"problem": "data-center M&A and deals",
"maturity": "mature",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=list_transactions",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "developer_for_full",
"idempotentHint": true,
"destructiveHint": false
}
}| number |
| Minimum relevance score 0-1 to include an item, e.g. 0.5 |
{
"name": "get_news",
"title": "Industry News",
"description": "Use this when the user asks for data center industry news or headlines (execute_plan also pulls news inside a broader market question). Curated data center industry news from 40+ trade sources (DCD, Data Center Knowledge, Data Center Frontier, Capacity Media, The Register Data Centre, Fierce Telecom, etc.) refreshed every 30 min. Returns title, summary, source, published_at, and the market/operator entities mentioned. Filter by category (deals/permits/outages/policy/AI). Answers \"what is happening in the data center industry this week\", \"any news on AI capacity\". Try: get_news category=AI limit=10. The parameter is `category`, not `topic`. Industry news only; do NOT use for structured M&A deal data (use list_transactions) or the construction pipeline (use get_pipeline). limit 1-500 (a preview returns up to 20). Empty data = no matching news: drop category/source or widen date_from/date_to. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"query": {
"type": "string",
"description": "Free-text keyword to filter news, e.g. \"Stargate\" or \"interconnection queue\""
},
"source": {
"type": "string",
"description": "Restrict to one trade source, e.g. DCD, \"Data Center Frontier\", \"Capacity Media\""
},
"date_to": {
"type": "string",
"description": "Latest published date, ISO-8601 (YYYY-MM-DD)"
},
"category": {
"type": "string",
"description": "News topic filter, e.g. deals, permits, outages, policy, AI"
},
"date_from": {
"type": "string",
"description": "Earliest published date, ISO-8601 (YYYY-MM-DD)"
},
"min_relevance": {
"type": "number",
"description": "Minimum relevance score 0-1 to include an item, e.g. 0.5"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"data": {},
"count": {},
"total": {},
"source": {},
"cite_as": {},
"success": {},
"articles": {}
},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_news",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "semantic_search",
"title": "Semantic Search",
"description": "Use this when a data center or energy question is conceptual or fuzzy and keyword filters fall short — semantic (meaning-based) retrieval across DC Hub's industry news, M&A deals, the global facility map, per-market DCPI deep-dive narratives, press releases, announcements, permitting intel, construction permits, tax incentives and the capacity pipeline, ranked by relevance with citable source fields (news url/title, deal parties/value, facility name/location, deep-dive market/url). Examples: \"what is happening with behind-the-meter gas for AI data centers?\", \"deals involving nuclear power for hyperscalers\", \"why is Northern Virginia constrained?\" — semantic_search q=\"behind-the-meter gas for AI data centers\". Params: q (required, natural-language query); corpus (optional CSV subset of news_articles,deals,facilities,market_narratives,press_releases,announcements,permitting_intel,construction_permits,tax_incentives,capacity_pipeline; default all); k (1-15, default 8). Returns {results:[{source_table, kind, text, score, cite:{…}}]}; score is 0-1 relevance, not a DCPI score. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"k": {
"type": "number",
"description": "Number of results, 1-15 (default 8)"
},
"q": {
"type": "string",
"description": "Natural-language query (required), e.g. \"grids opening up for AI load in the Southeast\""
},
"query": {
"type": "string",
"description": "Alias for q — the same natural-language query; send exactly one of q/query"
},
"corpus": {
"type": "string",
"description": "Optional CSV of corpora: news_articles, deals, discovered_facilities, market_narratives (default: all)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=semantic_search",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "search_intelligence",
"title": "Search Intelligence",
"description": "Use this when you need meaning-based search over DC Hub's data center intelligence corpus, choosing corpora — industry news, M&A deals, discovered facilities, per-market DCPI narratives, press releases, announcements, permitting intel, construction permits, tax incentives and the capacity pipeline — returning the most relevant records with citable source fields. This is the agent-friendly alias over the SAME retrieval layer as semantic_search: same results, different call shape. It takes `query` plus short corpus names (news | deals | facilities | market_narratives | press | announcements | permitting | permits | incentives | pipeline); semantic_search takes `q` plus the full corpus names. Call ONE of them, not both. Params: query (required, natural language); corpus (optional CSV of the names above, default all); limit (1-15, default 8). BEHAVIOUR: read-only — it writes nothing, and repeat calls with the same arguments return the same records. ACCESS: works with no key, but anonymous results come back as a TRIMMED PREVIEW; the session X-API-Key (DCHUB_API_KEY) hydrates full depth (call get_api_key once if you do not hold a key). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Alias for query"
},
"limit": {
"type": "number",
"description": "Max results to return, 1-15 (default 8)"
},
"query": {
"type": "string",
"description": "Natural-language query (required), e.g. \"grids opening up for AI load in the Southeast\""
},
"corpus": {
"type": "string",
"description": "Optional corpus to restrict to: news | deals | facilities | market_narratives. CSV of several is allowed; default searches all."
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=search_intelligence",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| Pagination offset, 0-based (skip this many results) |
| status | string | Pipeline stage filter: announced, permitted, construction, or operational |
| country | string | ISO 3166-1 alpha-2 country code, e.g. US, DE, SG |
| operator | string | Operator/provider company name, e.g. Equinix, Digital Realty, AWS |
| min_capacity_mw | number | Minimum project power capacity filter in megawatts (MW), e.g. 50 for hyperscale |
| expected_completion_before | string | Only projects with expected commissioning before this ISO-8601 date (YYYY-MM-DD), e.g. 2027-01-01 |
{
"name": "get_pipeline",
"title": "Construction Pipeline",
"description": "Use this when the user asks what data centers are being built, announced or permitted in a market or by an operator. Example: \"What is under construction in Northern Virginia and when does it come online?\" — get_pipeline market=northern-virginia status=construction. Params: market (slug or name, e.g. \"northern-virginia\", \"dallas\"; projects labelled only with the state are counted apart, see scope.note); state (USPS, e.g. \"VA\"); status one of \"announced\" | \"permitted\" | \"construction\" | \"operational\"; operator (e.g. \"Equinix\", \"AWS\"); country (ISO-2, e.g. \"US\"); min_capacity_mw (e.g. 50); expected_completion_before (ISO date; undated projects are kept and marked, completion_filter counts them); limit/offset. Each row carries expected_cod, null with expected_cod_basis when no source states one. One named project: name=\"Stargate Abilene\" (or a codename, developer plus place) returns the best matching record first, with developer, county, state, stated MW, status, expected_cod, source_url and as_of, other matching records beside it, or name_lookup.message saying no record matches. Do NOT use for already-operational facilities (use search_facilities) or for the M&A deal flow (use list_transactions). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "A named project or campus, e.g. \"Stargate Abilene\", \"Project Firecracker\" or \"Crusoe Abilene\": the best matching record comes first; when nothing matches, name_lookup.message says so"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"state": {
"type": "string",
"description": "US state (USPS code), e.g. VA, TX"
},
"market": {
"type": "string",
"description": "Market slug or name to keep projects inside, e.g. northern-virginia, dallas"
},
"offset": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Pagination offset, 0-based (skip this many results)"
},
"status": {
"type": "string",
"description": "Pipeline stage filter: announced, permitted, construction, or operational"
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code, e.g. US, DE, SG"
},
"operator": {
"type": "string",
"description": "Operator/provider company name, e.g. Equinix, Digital Realty, AWS"
},
"min_capacity_mw": {
"type": "number",
"description": "Minimum project power capacity filter in megawatts (MW), e.g. 50 for hyperscale"
},
"expected_completion_before": {
"type": "string",
"description": "Only projects with expected commissioning before this ISO-8601 date (YYYY-MM-DD), e.g. 2027-01-01"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"data": {},
"count": {},
"stats": {},
"cite_as": {},
"success": {},
"pipeline": {},
"by_quarter": {},
"data_source": {},
"total_count": {},
"last_updated": {}
},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_pipeline",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "developer_for_full",
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "get_power_pipeline",
"title": "Get Power Pipeline",
"description": "Use this when the user asks where new power generation is coming online (the forward supply pipeline) — e.g. \"how much new generation is planned in Virginia / the Southeast / ERCOT, and when?\". Planned, permitting, and under-construction generators NATIONWIDE from EIA-860M, INCLUDING non-ISO regions (TVA, Southern Co, Arizona PS, PacifiCorp, LADWP) that interconnection-queue feeds miss. Each generator has location (lat/lng), state, county, balancing authority, technology/fuel (solar photovoltaic, onshore wind, natural-gas combined cycle, batteries, nuclear), nameplate megawatts (MW), status (planned → under construction), and planned online month/year. Filter by state (2-letter, e.g. VA), ba (balancing-authority/ISO code, e.g. PJM, ERCO, SOCO, TVA), status (P/L/T=planned, U/V=under construction, TS=testing), or min_mw. Returns a summary (total planned MW, mix by technology + status) plus the largest projects. Answers \"how much new generation is planned in Virginia and when does it land\". Try: get_power_pipeline state=VA. Do NOT use for ALREADY-OPERATING capacity or grid headroom (use get_grid_intelligence / get_grid_data) or for data-center construction projects (use get_pipeline). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"ba": {
"type": "string",
"description": "Balancing-authority / ISO code, e.g. PJM, ERCO, SOCO, TVA, AZPS"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"state": {
"type": "string",
"description": "US state abbreviation to filter generators, e.g. VA, TX"
},
"min_mw": {
"type": "number",
"description": "Minimum nameplate capacity filter in megawatts (MW)"
},
"status": {
"type": "string",
"description": "Generator status code: P/L/T (planned), U/V (under construction), TS (testing)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"limits": "the generating-unit inventory counts UNITS across all statuses (operating, planned, cancelled, shelved, retired) — it is not a plant count and not an operating fleet",
"problem": "power generation, gas and energy infrastructure",
"maturity": "mature",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_power_pipeline",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| Status, case-insensitive; comma list allowed. Gas: Announced, Pre-applied, Applied, Approved, Construction, On Hold, Completed. Transmission: Planned, Conceptual, Under Construction, Completed, Cancelled |
| new_since | string | Only projects DC Hub first saw on or after this date (YYYY-MM-DD). The initial backfill is never counted as new |
| min_capacity | number | Gas only: minimum pipeline capacity in million cubic feet per day (MMcf/d), e.g. 1000. With type=all it narrows to gas projects |
| in_service_after | string | Only projects entering service on or after this date (YYYY-MM-DD or YYYY). Gas compares the in-service year; transmission the actual, else projected, in-service date |
| include_delisted | boolean | Also return projects the latest source release no longer lists (completed, withdrawn or dropped). Default false |
| in_service_before | string | Only projects entering service on or before this date (YYYY-MM-DD or YYYY) |
{
"name": "get_infra_projects",
"title": "Get Infra Projects",
"description": "Use this when the user asks what gas pipeline or transmission line projects are planned, proposed, approved or under construction — the forward build-out, not the existing network. e.g. \"which interstate gas pipelines are under construction into Louisiana?\", \"what 345 kV transmission projects are planned in PJM by 2030?\", \"what new projects appeared since last month?\". COVERS: (1) natural gas pipeline projects US-wide from the EIA natural gas pipeline projects list (public domain) — operator, status (Announced, Pre-applied, Applied, Approved, Construction, On Hold, Completed), states crossed, capacity in MMcf/d, miles, cost in $M, diameter, FERC/state docket, in-service year; (2) transmission projects from five ISOs' own project lists — ERCOT (TPIT), PJM (RTEP), MISO (MTEP Appendix A), SPP (STEP) and ISO-NE (RSP list); NOT CAISO or NYISO, and not utilities outside those ISOs. Each ISO publishes a different grain (an upgrade or facility, not a whole project), so a row count is a count of upgrades. Answers \"what gas pipelines are being built into Louisiana, how much capacity do they add, and when do they enter service\". Try: get_infra_projects type=gas_pipeline state=LA status=Construction. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"type": {
"enum": [
"gas_pipeline",
"transmission",
"all"
],
"type": "string",
"description": "Which project list: gas_pipeline (EIA, US-wide), transmission (ERCOT TPIT, Texas only) or all (default)"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"state": {
"type": "string",
"description": "US state abbreviation, e.g. TX or LA. Gas projects match any state they cross; transmission projects are all TX"
},
"min_kv": {
"type": "number",
"description": "Transmission only: minimum voltage in kilovolts (kV), e.g. 345. With type=all it narrows to transmission projects"
},
"status": {
"type": "string",
"description": "Status, case-insensitive; comma list allowed. Gas: Announced, Pre-applied, Applied, Approved, Construction, On Hold, Completed. Transmission: Planned, Conceptual, Under Construction, Completed, Cancelled"
},
"new_since": {
"type": "string",
"description": "Only projects DC Hub first saw on or after this date (YYYY-MM-DD). The initial backfill is never counted as new"
},
"min_capacity": {
"type": "number",
"description": "Gas only: minimum pipeline capacity in million cubic feet per day (MMcf/d), e.g. 1000. With type=all it narrows to gas projects"
},
"in_service_after": {
"type": "string",
"description": "Only projects entering service on or after this date (YYYY-MM-DD or YYYY). Gas compares the in-service year; transmission the actual, else projected, in-service date"
},
"include_delisted": {
"type": "boolean",
"description": "Also return projects the latest source release no longer lists (completed, withdrawn or dropped). Default false"
},
"in_service_before": {
"type": "string",
"description": "Only projects entering service on or before this date (YYYY-MM-DD or YYYY)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_infra_projects",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| country | string | Country/area name to filter, e.g. Germany, India, Brazil, Japan |
| pipeline | boolean | true = ONLY the forward pipeline (announced + pre-construction + under-construction) |
{
"name": "get_global_power",
"title": "Get Global Power",
"description": "Use this when the user asks about power plants worldwide or in a non-US country — operating AND the forward pipeline (announced / pre-construction / under-construction), across ALL fuels (coal, oil/gas, nuclear, solar, wind, hydro, bioenergy, geothermal). Global Energy Monitor Global Integrated Power Tracker: 182,000+ geolocated units across 170+ countries, each with fuel, capacity (MW), status, start year, operator/owner and lat/lng. Filter by country (e.g. Germany, India, Brazil, Japan), fuel (comma-union: coal, oil/gas, nuclear, solar, wind, hydro), status, pipeline=true (JUST the forward set: announced + pre-construction + construction), bbox (minLng,minLat,maxLng,maxLat), or min_mw. Returns a summary (total MW by fuel + count by status) plus the largest units. Answers \"what power is being built in India\", \"how much coal is still running in Vietnam\". Try: get_global_power country=India pipeline=true. country= also adds electricity_monthly (Ember, CC BY 4.0): latest monthly mix, demand, carbon intensity. Do NOT use for US grid telemetry/headroom (use get_grid_intelligence / get_grid_scoreboard) or the US planned-generator feed (use get_power_pipeline) — this is the GLOBAL asset inventory. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"bbox": {
"type": "string",
"description": "Viewport filter as minLng,minLat,maxLng,maxLat"
},
"fuel": {
"type": "string",
"description": "Fuel/type filter, comma-separated for a union: coal, oil/gas, nuclear, solar, wind, hydro, bioenergy, geothermal"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"min_mw": {
"type": "number",
"description": "Minimum unit capacity in MW"
},
"status": {
"type": "string",
"description": "Status substring filter, e.g. operating, construction, pre-construction, announced"
},
"country": {
"type": "string",
"description": "Country/area name to filter, e.g. Germany, India, Brazil, Japan"
},
"pipeline": {
"type": "boolean",
"description": "true = ONLY the forward pipeline (announced + pre-construction + under-construction)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"limits": "the generating-unit inventory counts UNITS across all statuses (operating, planned, cancelled, shelved, retired) — it is not a plant count and not an operating fleet",
"problem": "power generation, gas and energy infrastructure",
"maturity": "mature",
"front_door": "get_power_pipeline",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_global_power",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "get_interconnection_queue",
"title": "Interconnection Queue",
"description": "Use this when the user asks about grid interconnection queues: how congested an ISO's queue is or how much data-center load is waiting. Returns queued generation GW per ISO. The projects field changes shape: with iso= it is an array of per-project rows; without iso it is an all-ISO summary object (total, by_iso_count, top). ERCOT also returns its large-load (data-center) queue; other ISOs don't publish one. iso=NESO returns Great Britain's NESO TEC Register (Transmission Entry Capacity): generation and demand connections together under queued_connections_gw, not a generation queue. Can be scoped to a data center market or site: execute_plan pairs the queue with that place's facilities and its Data Center Power Index (DCPI) verdict. Keyless: a trimmed preview; DCHUB_API_KEY is optional, and a key with a bound email unlocks full answers. Ex: \"How deep is ERCOT's queue?\" iso optional (US ISO code); keyless = preview. For demand and headroom on the same ISO also call get_grid_intelligence. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"iso": {
"type": "string",
"description": "ISO/RTO grid region to drill into: ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE, or NESO for Great Britain (the NESO TEC Register: generation and demand connections together, not a generation-only queue); omit for the all-ISO snapshot"
},
"mpp_pay": {
"type": "boolean",
"description": "Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call."
},
"mpp_credential": {
"type": "string",
"description": "Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"v": {},
"iso": {},
"as_of": {},
"projects": {},
"queue_kind": {},
"source_url": {},
"source_name": {},
"project_count": {},
"top_subregions": {},
"queued_generation_gw": {},
"queued_large_load_gw": {},
"new_applications_q_gw": {},
"queued_connections_gw": {},
"new_applications_period": {},
"queued_load_dc_share_pct": {},
"historical_completion_pct": {},
"queued_load_data_center_gw": {},
"queued_generation_gw_basis_note": {},
"queued_generation_pending_revision_gw": {},
"queued_generation_pending_revision_gw_basis": {}
},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"limits": "supply-side signals, not a load-interconnection promise — generation is not deliverable load · utility study timelines, large-load tariff processes and substation-grain delivery are declared out of coverage rather than estimated · the queue feed carries no delivery dates, and most queued MW never completes — queue depth is congestion context, not a timeline",
"problem": "grid headroom and power availability; interconnection queues",
"maturity": "mature",
"front_door": "execute_plan",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_interconnection_queue",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "email",
"idempotentHint": true,
"destructiveHint": false
}
}| developer | string | ERCOT only: keep projects whose developer name contains this text (case-insensitive substring, e.g. 'tenaska'). Developer names come from ERCOTQueue (ercotqueue.com, Matt Prusak, CC BY 4.0) joined to ERCOT's own queue by INR; other ISOs… |
| fuel_type | string | Isolate a fuel by inclusive substring match on the raw label; comma/semicolon-separated for a union, e.g. 'gas' hits GAS/Natural Gas, 'nuclear,hydro' unions both. |
| max_fiber_km | number | Keep only survivors within N km of the nearest MAPPED long-haul fiber route endpoint — coarse backbone proximity from a sparse ~260-node dataset over a county-centroid origin, NOT last-mile fiber. Implies geocoded rows only |
| baseload_only | boolean | Keep only firm/dispatchable fuel (nuclear, gas, steam, geothermal, hydro, coal); exclude wind/solar/storage. Firm-vs-intermittent split only — does NOT sub-divide peaker vs combined-cycle gas (no duty-cycle field in the queue). |
| geocoded_only | boolean | Keep only survivors that carry lat/lng (~83% of the queue) — the ones with a ready site_evaluation_handoff you can pipe into analyze_site. Default false |
| max_ttp_months | integer | Max time-to-power in months (ISO-level avg interconnection wait; HARD cut keeping projects in ISOs at/under this — PJM ~51, CAISO ~40, ISO-NE ~34, MISO ~34, ERCOT ~33, NYISO ~31, SPP ~24; <=30 leaves only SPP) |
{
"name": "get_refined_queue",
"title": "Get Refined Queue",
"description": "Use this when you need interconnection queue projects filtered server-side. Instead of pulling the raw queue into context to filter (token-expensive, error-prone), push the predicates to the data layer and get back ONLY the survivors. Filter by min_mw, max_ttp_months (ISO-level avg interconnection wait), iso (comma-union), state (the project's own US state), baseload_only (firm/dispatchable — excludes wind/solar/storage), fuel_type (isolate a specific fuel, e.g. gas or nuclear), and the spatial predicates max_fiber_km + geocoded_only. Answers \"show me 1 GW+ gas projects that can connect in under three years\", \"what is in the queue that actually fits my timeline\". Try: get_refined_queue min_mw=1000 fuel_type=gas max_ttp_months=34 — \"1 GW+ gas in ISOs under 34-month time-to-power.\" NOTE max_ttp_months is a HARD ISO cut (SPP ~24 is the only ISO under 30, so <=30 can return nothing); use >=34 to include MISO/ERCOT/ISO-NE. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"iso": {
"type": "string",
"description": "Restrict to one or more ISOs, comma-separated for a union: PJM, ERCOT, MISO, CAISO, SPP, NYISO, ISONE (ISO-NE). e.g. iso=ERCOT,PJM. Omit for all; combines with max_ttp_months as an intersection"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"state": {
"type": "string",
"description": "Restrict to projects in one or more US states, by the project's own state (two-letter code or full name, comma-separated for a union), e.g. state=NV."
},
"min_mw": {
"type": "number",
"description": "Minimum project capacity in MW, e.g. 1000 for 1 GW+"
},
"status": {
"type": "string",
"description": "Queue status filter. Default 'active' = still progressing (excludes withdrawn/cancelled/suspended/in-commercial-operation) — cross-ISO safe (SPP labels live projects 'IA FULLY EXECUTED/ON SCHEDULE' not 'active')."
},
"developer": {
"type": "string",
"description": "ERCOT only: keep projects whose developer name contains this text (case-insensitive substring, e.g. 'tenaska'). Developer names come from ERCOTQueue (ercotqueue.com, Matt Prusak, CC BY 4.0) joined to ERCOT's own queue by INR; other ISOs…"
},
"fuel_type": {
"type": "string",
"description": "Isolate a fuel by inclusive substring match on the raw label; comma/semicolon-separated for a union, e.g. 'gas' hits GAS/Natural Gas, 'nuclear,hydro' unions both."
},
"max_fiber_km": {
"type": "number",
"description": "Keep only survivors within N km of the nearest MAPPED long-haul fiber route endpoint — coarse backbone proximity from a sparse ~260-node dataset over a county-centroid origin, NOT last-mile fiber. Implies geocoded rows only"
},
"baseload_only": {
"type": "boolean",
"description": "Keep only firm/dispatchable fuel (nuclear, gas, steam, geothermal, hydro, coal); exclude wind/solar/storage. Firm-vs-intermittent split only — does NOT sub-divide peaker vs combined-cycle gas (no duty-cycle field in the queue)."
},
"geocoded_only": {
"type": "boolean",
"description": "Keep only survivors that carry lat/lng (~83% of the queue) — the ones with a ready site_evaluation_handoff you can pipe into analyze_site. Default false"
},
"max_ttp_months": {
"type": "integer",
"maximum": 120,
"minimum": 1,
"description": "Max time-to-power in months (ISO-level avg interconnection wait; HARD cut keeping projects in ISOs at/under this — PJM ~51, CAISO ~40, ISO-NE ~34, MISO ~34, ERCOT ~33, NYISO ~31, SPP ~24; <=30 leaves only SPP)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "metered",
"limits": "the queue feed carries no delivery dates, and most queued MW never completes — queue depth is congestion context, not a timeline",
"problem": "interconnection queues",
"maturity": "mature",
"front_door": "get_interconnection_queue",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_refined_queue",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| Optional filter for retiring fuel categories, substring-matched (e.g., 'Coal', 'Natural Gas', 'Petroleum'). |
| horizon_months * | integer | Time horizon in months to look ahead for planned retirements, 1-120 (e.g., 12, 18, 36). |
{
"name": "get_retirement_headroom",
"title": "Get Retirement Headroom",
"description": "Use this when the user asks where retiring power plants free grid capacity: scans EIA-860M retirements to find near-term transmission grid headroom — a retiring plant is a CONCRETE headroom event (its POI frees injection capacity), from FILED data, not forecasts. Returns _entity=retirement_headroom_results: retiring generators inside your horizon (name, MW, fuel, prime mover, retirement_date), representative_point, nearest substations with distance_km + count within 25 km, county-level queue_pressure (competing in-progress MW), iso_context (the generator's own EIA balancing-authority code), and a pre-filled site_evaluation_handoff (analyze_site + get_water_risk args, capacity_mw = YOUR target load). Answers \"where is grid capacity about to free up\", \"which retiring plants open injection headroom near me\". Try: get_retirement_headroom target_mw=50 horizon_months=18 region_iso=MISO — \"50 MW opening near a substation inside 18 months, sidestepping the 4-7yr mega-queue.\" Honesty: meta.caveat flags that filed dates are subject to ISO reliability reviews (RMR extensions). Use to find WHERE capacity opens next; for what's already queued use get_refined_queue; for one site use analyze_site. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"target_mw",
"horizon_months"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"target_mw": {
"type": "number",
"description": "Minimum required headroom in megawatts (MW) — filters to retiring generators at/above this size. Also passed through as the handoff's analyze_site capacity_mw (the DC you are siting)."
},
"region_iso": {
"type": "string",
"description": "Optional target region or ISO (e.g., 'MISO', 'PJM', 'ERCOT', 'SPP', 'CAISO', 'NYISO', 'ISONE'). Matches the generator's own EIA balancing-authority code — real market boundaries, not state lines. Comma-separated for a union."
},
"fuel_filter": {
"type": "string",
"description": "Optional filter for retiring fuel categories, substring-matched (e.g., 'Coal', 'Natural Gas', 'Petroleum')."
},
"horizon_months": {
"type": "integer",
"maximum": 120,
"minimum": 1,
"description": "Time horizon in months to look ahead for planned retirements, 1-120 (e.g., 12, 18, 36)."
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "metered",
"limits": "the generating-unit inventory counts UNITS across all statuses (operating, planned, cancelled, shelved, retired) — it is not a plant count and not an operating fleet",
"problem": "power generation, gas and energy infrastructure",
"maturity": "mature",
"front_door": "get_power_pipeline",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_retirement_headroom",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| utility | string | Utility or market name, case-insensitive substring — e.g. "Ameren Illinois", "Con Edison", "Providence". Searches that utility's whole published territory instead of a point radius. Call with NO arguments to list every covered utility. |
| latitude | number | Alias for lat — either name works |
| longitude | number | Alias for lon — either name works |
| radius_km | number | Search radius in km around lat/lon (default 25, max 150). Ignored when utility/market is passed — that mode covers the utility's entire published extent. |
| capacity_type | string | Restrict to one published type: "load" (what a new data-center load can DRAW — the type that answers siting), "gen" (DER/generation EXPORT headroom — NOT available load), or "bus_headroom" (transmission bus MW). |
{
"name": "get_hosting_capacity",
"title": "Feeder Hosting Capacity",
"description": "Use this when the user asks how many MW a distribution feeder can take: utility-published hosting capacity — the MW a NAMED distribution feeder can actually take, straight from the utility's own hosting-capacity GIS. Published records from many utilities (e.g. Con Edison, National Grid NY/MA, NYSEG/RG&E, Rhode Island Energy, Orange & Rockland, Central Hudson, Eversource CT, BGE, Pepco/Delmarva/ACE, Dominion VA, Ameren Illinois, AEP Ohio & I&M, Xcel MN/CO, DTE, Avista; the no-args call lists current coverage). This is filed distribution-level truth, not a proximity proxy. Three ways to call it: lat+lon (+radius_km, default 25) for a point; utility or market for a whole published territory; NO ARGS for the coverage list of every market that has data. Answers \"can this feeder actually take 20 MW\", \"where can I plug in without waiting on a substation upgrade\". Try: get_hosting_capacity utility=\"Ameren Illinois\" capacity_type=load min_mw=5. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Latitude of the point to search around, decimal degrees. Must be paired with lon."
},
"lng": {
"type": "number",
"description": "Alias for lon — either name works"
},
"lon": {
"type": "number",
"description": "Longitude of the point to search around, decimal degrees. Must be paired with lat."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"market": {
"type": "string",
"description": "Alias for utility — either name works (e.g. \"Northern Virginia · Richmond\", \"New York City · Westchester\")."
},
"min_mw": {
"type": "number",
"description": "Only return feeders whose published capacity is at or above this many MW."
},
"utility": {
"type": "string",
"description": "Utility or market name, case-insensitive substring — e.g. \"Ameren Illinois\", \"Con Edison\", \"Providence\". Searches that utility's whole published territory instead of a point radius. Call with NO arguments to list every covered utility."
},
"latitude": {
"type": "number",
"description": "Alias for lat — either name works"
},
"longitude": {
"type": "number",
"description": "Alias for lon — either name works"
},
"radius_km": {
"type": "number",
"maximum": 150,
"minimum": 1,
"description": "Search radius in km around lat/lon (default 25, max 150). Ignored when utility/market is passed — that mode covers the utility's entire published extent."
},
"capacity_type": {
"type": "string",
"description": "Restrict to one published type: \"load\" (what a new data-center load can DRAW — the type that answers siting), \"gen\" (DER/generation EXPORT headroom — NOT available load), or \"bus_headroom\" (transmission bus MW)."
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"limits": "utility-published feeder hosting capacity covers a named subset of utilities in the Northeast, Mid-Atlantic and Midwest — not nationwide, and absence of a feeder is not absence of capacity · published feeder capacities are single-digit to low-tens of MW and the rows are GIS vertices — read distinct_feeders, never the row count",
"problem": "substations and transmission",
"maturity": "partial",
"front_door": "get_infrastructure",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_hosting_capacity",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| longitude |
| number |
| Alias for lon — either name works |
| capacity_mw | number | Optional target load in MW to pass through into the site_evaluation_handoff |
{
"name": "analyze_parcel",
"title": "Analyze Parcel",
"description": "Use this when the user has a land parcel for a data center site: structured read of its boundary — pass your own GeoJSON Polygon/MultiPolygon, OR just lat+lon and DC Hub finds the containing parcel in its HOSTED parcel-boundary layer (public county/state GIS polygons, covering a set of priority data-center counties in VA, IL, TX, OH, UT, OR, IA and WY; a point outside it returns parcel_not_covered with the analyze_site preview + the coverage list, never a guess). Returns _entity=parcel_analysis: geodesic total_acres, a per-member acreage breakdown, a contiguous flag, representative_point = the centroid of the LARGEST-area member (never the multi-part geometric center, which can land off-parcel on a highway median or river and poison every point-keyed read), and hosted_parcel {parcel_id, county, state, acres_per_source} when the polygon came from the hosted layer. Also returns a site_evaluation_handoff to pipe into analyze_site + get_water_risk at that anchor. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Latitude of a point ON the parcel — used with lon when geometry is omitted to look up the containing parcel from the hosted county/state GIS layer"
},
"lng": {
"type": "number",
"description": "Alias for lon — either name works"
},
"lon": {
"type": "number",
"description": "Longitude of a point ON the parcel (used with lat when geometry is omitted)"
},
"geometry": {
"description": "GeoJSON Polygon or MultiPolygon parcel boundary, e.g. {\"type\":\"Polygon\",\"coordinates\":[[[lng,lat],[lng,lat],...]]} — a MultiPolygon carries discontinuous parcels as one envelope. Omit to look up the hosted parcel containing lat/lon instead"
},
"latitude": {
"type": "number",
"description": "Alias for lat — either name works"
},
"longitude": {
"type": "number",
"description": "Alias for lon — either name works"
},
"capacity_mw": {
"type": "number",
"description": "Optional target load in MW to pass through into the site_evaluation_handoff"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=analyze_parcel",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| percentile | boolean | true = score each objective as its PERCENTILE against the viable-site POPULATION ("better than X% of viable sites") — the strongest cross-run + cross-region comparability. |
| constraints | any | Hard filters {field: {min?, max?}} — a candidate missing a constrained field is dropped (fail-closed). e.g. {"risk_resilience": {"min": 70}, "estimated_ttp_months": {"max": 34}} |
| shortlist_name | string | Alternative to candidates: re-rank a SAVED shortlist (created via save_to_shortlist) in one shot — loads its sites (scoped to your API key) + reuses their saved objectives if you pass none, and re-scores against the current baseline |
| require_complete | boolean | true = DROP any candidate missing one or more of your (validated) objectives — dropped candidates are DECLARED in excluded_incomplete, never silent. |
{
"name": "rank_sites",
"title": "Rank Sites",
"description": "Use this when you have enriched candidate data center sites to rank under constraints — the normalization contract that lets you compare sites across separate analyze_site calls WITHOUT dropping into code. Pass candidates you already enriched (each an object with lat/lng + metric fields like risk_resilience, water_stress, fiber_km — pull these from analyze_site + get_refined_queue and pass site_evaluation_handoff through untouched), hard constraints, and weighted objectives; get back _entity=ranked_sites: top_k ranked with rank, objective_score, per-field normalized{} (0-100 relative to the set), and normalization_basis. objectives use SIGNED weights: +weight maximizes a field (e.g. risk_resilience:1), -weight minimizes it (e.g. water_stress:-0.6, fiber_km:-0.4). constraints are hard filters, fail-closed on a missing field. Use for \"pick the best N sites under constraints\"; for one site use analyze_site; to get the candidate set first use get_refined_queue. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"top_k": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "How many top-ranked sites to return (1-50, default 3)"
},
"absolute": {
"type": "boolean",
"description": "false (default) = min-max normalize within THIS batch (best-in-set, NOT stable across runs). true = score on a FIXED 0-100 scale for CROSS-RUN-STABLE, auditable scores — use ONLY when the objective fields are already 0-100 (analyze_site…"
},
"candidates": {
"description": "Array of candidate objects. PREFERRED: {candidate_id: \"cand_…\", <your metric fields>} using ids from get_refined_queue — frozen coordinates/capacity/fiber_km load from the mint (zero transcription drift), your enrichments (e.g."
},
"objectives": {
"description": "Weighted objectives {field: signedWeight} — +weight maximizes, -weight minimizes. e.g. {\"water_stress\": -0.6, \"fiber_km\": -0.4}. Omit with shortlist_name to reuse the shortlist's saved objectives; required with candidates"
},
"percentile": {
"type": "boolean",
"description": "true = score each objective as its PERCENTILE against the viable-site POPULATION (\"better than X% of viable sites\") — the strongest cross-run + cross-region comparability."
},
"constraints": {
"description": "Hard filters {field: {min?, max?}} — a candidate missing a constrained field is dropped (fail-closed). e.g. {\"risk_resilience\": {\"min\": 70}, \"estimated_ttp_months\": {\"max\": 34}}"
},
"shortlist_name": {
"type": "string",
"description": "Alternative to candidates: re-rank a SAVED shortlist (created via save_to_shortlist) in one shot — loads its sites (scoped to your API key) + reuses their saved objectives if you pass none, and re-scores against the current baseline"
},
"require_complete": {
"type": "boolean",
"description": "true = DROP any candidate missing one or more of your (validated) objectives — dropped candidates are DECLARED in excluded_incomplete, never silent."
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=rank_sites",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "save_to_shortlist",
"title": "Save To Shortlist",
"description": "Use this when the user wants to keep a data center site on a named shortlist that survives across conversations (Phase 5 statefulness). Snapshots the site's objectives + its current percentile objective_score, so you can re-score it later against the evolving national baseline. Use to build a durable siting shortlist across days/weeks; the list is scoped to your API key. Pair with get_shortlist to re-score + see drift. MINIMAL call: save_to_shortlist(shortlist_name=\"my-targets\", site={site_ref, lat, lng, capacity_mw}) — objectives are optional. If you DID rank the site (analyze_site / rank_sites), pass those metric fields inside site and your objectives map too, and the re-scoring reuses them. Requires an API key so the list is private to you and survives to your next conversation: call get_api_key first if you have none. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"shortlist_name",
"site"
],
"properties": {
"site": {
"description": "Site object. MINIMAL form is enough: {site_ref, lat, lng, capacity_mw}. Richer is better — add any analyze_site metric fields (risk_resilience, fiber_connectivity, water score…) and those become what gets re-scored later."
},
"notes": {
"type": "string",
"description": "Optional free-text note, e.g. \"strong fiber, acceptable water\""
},
"objectives": {
"description": "OPTIONAL {field: signedWeight} map (+maximize/-minimize) if this site was ranked under explicit objectives — stored so re-scoring reuses the same criteria. Omit it and DC Hub weights the site's own metric fields equally."
},
"shortlist_name": {
"type": "string",
"description": "Name of the shortlist, e.g. \"Q3-2026-1GW-targets\" — created if new. REQUIRED."
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=save_to_shortlist",
"readOnlyHint": false,
"openWorldHint": false,
"tier_required": "free_key",
"idempotentHint": false,
"destructiveHint": false
}
}| mpp_credential | string | Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge. |
{
"name": "get_grid_data",
"title": "Live Grid Data",
"description": "Use this when the user asks for live electricity grid data (power demand, fuel mix) for one grid: the 7 US ISOs (PJM, ERCOT, CAISO, MISO, SPP, NYISO, ISO-NE), TVA, BPA, 40+ US utility balancing authorities (e.g. AZPS, SOCO, DUK, FPL, or a city: PHOENIX, ATLANTA), Canada (IESO, AESO, HYDROQUEBEC), Great Britain (NGESO), any ENTSO-E bidding zone (EU_DE_LU, EU_FR, EU_NL ...), Taiwan (TAIPOWER), Japan (OCCTO), South Korea (KEPCO-KR), Brazil (ONS), Australia (AEMO) or Singapore (EMA). US ISOs and EIA regions return EIA hourly fuel mix, demand and the 24h curve; other grids return each feed's newest reading per metric, each with its own timestamp. For PJM it also returns installed_capacity_mw: EIA-860M installed generating capacity (net summer MW of operating generators for the report month in installed_capacity_mw_period). That is not PJM committed capacity, which is listed in licence_withheld with no value. Raw telemetry for one grid; do NOT use for power-availability, time-to-power or interconnection-queue analysis (use get_grid_intelligence), nor for retail/gas pricing (use get_energy_prices). To rank many grids at once use get_grid_scoreboard. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"iso": {
"type": "string",
"description": "Grid code (required): a US ISO (ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE), TVA, BPA, a utility BA or city (AZPS, PHOENIX), or a non-US grid (IESO, AESO, HYDROQUEBEC, NGESO, EU_DE_LU, TAIPOWER, OCCTO, KEPCO-KR, ONS, AEMO, EMA)"
},
"metric": {
"type": "string",
"description": "Optional metric focus, e.g. fuel_mix, demand, demand_curve"
},
"period": {
"type": "string",
"description": "Optional time window for the metric, e.g. 24h"
},
"mpp_pay": {
"type": "boolean",
"description": "Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call."
},
"mpp_credential": {
"type": "string",
"description": "Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge."
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_grid_data",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "email",
"idempotentHint": true,
"destructiveHint": false
}
}| Market slug (metro) the site belongs to, e.g. northern-virginia |
| latitude | number | Alias for lat — either name works |
| longitude | number | Alias for lon — either name works |
| target_mw | number | Target power load for the planned build in megawatts (MW), e.g. 100 |
{
"name": "save_site",
"title": "Save Site",
"description": "Use this when the user wants to save a data-center site to track it. Needs a key (get_api_key); keyless returns auth_required. Save a candidate data-center site to your DC Hub account to track it across sessions. Give lat + lon (plus optional name, state, market, target_mw, notes). Returns the saved site id. Pass `market` and DC Hub snapshots the site's DCPI baseline at save time, so every later list_saved_sites / get_changes shows how ITS score and verdict moved since you saved it. Builds a persistent shortlist an agent can revisit + monitor — after saving, pass the returned id to set_site_alert so DC Hub emails you when that site’s DCPI/capacity/nearby-facilities move (no re-checking). Answers \"remember this parcel for me\", \"keep this candidate so I can come back to it next session\". Try: save_site lat=39.04 lon=-77.48 name=\"Ashburn parcel\" market=northern-virginia target_mw=100. Do NOT use to read back the shortlist (use list_saved_sites), download it (use export_dataset), or score a site (use score_facility); this WRITES one site to your account. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Site latitude in decimal degrees (-90 to 90), e.g. 39.04"
},
"lng": {
"type": "number",
"description": "Alias for lon — either name works"
},
"lon": {
"type": "number",
"description": "Site longitude in decimal degrees (-180 to 180), e.g. -77.48"
},
"name": {
"type": "string",
"description": "Optional label for the saved site, e.g. \"Ashburn parcel\""
},
"notes": {
"type": "string",
"description": "Optional free-text notes to store with the saved site"
},
"state": {
"type": "string",
"description": "US state abbreviation for the site, e.g. VA"
},
"market": {
"type": "string",
"description": "Market slug (metro) the site belongs to, e.g. northern-virginia"
},
"latitude": {
"type": "number",
"description": "Alias for lat — either name works"
},
"longitude": {
"type": "number",
"description": "Alias for lon — either name works"
},
"target_mw": {
"type": "number",
"description": "Target power load for the planned build in megawatts (MW), e.g. 100"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=save_site",
"readOnlyHint": false,
"openWorldHint": false,
"tier_required": "free_key",
"idempotentHint": false,
"destructiveHint": false
}
}{
"name": "set_market_alert",
"title": "Set Market Alert",
"description": "Use this when the user wants alerts on a data center market's DCPI power score: subscribes to movement alerts (needs a key) — get notified when its Excess-Power / Constraint score moves. DATA USE: channel=\"email\" takes your human's email, to send these alerts; it is bound to the key as with bind_email. DC Hub keeps it and never sells it or shares it for anyone else’s use (https://dchub.cloud/privacy). Run only when your human asks; confirm the address with them first. Without a full-access key, email alerts go only to the key's bound email. One call: pass `email` (an address your human typed here) with channel=\"email\" and DC Hub binds it to this key first (minting a key if this session has none), then arms the watch; no separate get_api_key or bind_email. Alerts send when the market’s verdict flips or its scores move past the threshold, so a quiet market sends nothing. Webhook delivery (channel=\"webhook\" + destination=<https URL>) needs a full-access key. Answers \"tell me when this market moves\". Try: set_market_alert market=northern-virginia channel=webhook destination=https://hooks.example.com/dc. Do NOT use to read a market right now (use get_market_dcpi_rank); this SUBSCRIBES to future movement. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"market",
"channel"
],
"properties": {
"email": {
"type": "string",
"description": "Optional, channel=\"email\" only: your human's email, typed by them here and confirmed. Binds it to the key (a key is minted if this session has none) and arms the watch in one call. DC Hub keeps it and never sells or shares it"
},
"market": {
"type": "string",
"description": "Market slug (metro) to watch, e.g. northern-virginia — valid slugs come from rank_markets / get_market_dcpi_rank"
},
"channel": {
"type": "string",
"description": "Delivery channel: \"email\" (sent to your bound email) or \"webhook\" (full-access key)"
},
"destination": {
"type": "string",
"description": "For channel=\"webhook\", the https URL to POST alerts to (full-access key); ignored for email (forced to bound address)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=set_market_alert",
"readOnlyHint": false,
"openWorldHint": false,
"tier_required": "free_key",
"idempotentHint": false,
"destructiveHint": false
}
}{
"name": "set_site_alert",
"title": "Set Site Alert",
"description": "Use this when the user wants an email watch on a saved data center site (needs a key) — DC Hub emails you when that site’s DCPI score, grid capacity, or nearby facilities move. DATA USE: notify_email, your human's email, used only to send this alert. DC Hub keeps it and never sells it or shares it for anyone else’s use (https://dchub.cloud/privacy). Run only when your human asks; confirm the address with them first. Without a full-access key, notify_email is forced to the key’s bound email. A full-access key can send to any address. The \"monitor my shortlist for me\" loop: call save_site first (it returns a saved_site_id), then set_site_alert on that id. Answers \"tell me if my saved site changes\". Params: saved_site_id (required integer, from save_site or list_saved_sites), trigger_type (\"dcpi_change\" | \"capacity_change\" | \"new_facility_nearby\", default \"dcpi_change\"), threshold (number — the points/MW move that fires it, default 5). Try: set_site_alert saved_site_id=12 trigger_type=dcpi_change threshold=5 notify_email=you@firm.com. Returns {ok, alert_id, message}. Do NOT use to watch a whole MARKET (use set_market_alert) or to save a new site (use save_site); this arms a monitor on ONE already-saved site. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"saved_site_id",
"notify_email"
],
"properties": {
"threshold": {
"type": "number",
"description": "The points/MW move that fires the alert (default 5)"
},
"notify_email": {
"type": "string",
"description": "Email address the alert is sent to (required); without a full-access key, forced to your human's bound email. Confirm it with your human first. DC Hub keeps it and never sells or shares it"
},
"trigger_type": {
"type": "string",
"description": "What movement fires the alert: \"dcpi_change\" (default), \"capacity_change\", or \"new_facility_nearby\""
},
"saved_site_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
],
"description": "The saved_site_id returned by save_site or list_saved_sites (required)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=set_site_alert",
"readOnlyHint": false,
"openWorldHint": false,
"tier_required": "free_key",
"idempotentHint": false,
"destructiveHint": false
}
}| latitude | number | Alias for lat — either name works |
| longitude | number | Alias for lon — either name works |
| radius_km | number | Search radius in km around lat/lon (default 80, clamped 5-400); ignored in state mode |
| cluster_km | number | Collapse anchors within this many km into one candidate area (default 8, max 100). Raise it for broader coverage, lower it for denser results |
| max_gas_km | number | Drop candidates farther than this from the nearest gas pipeline. Applied ONLY if the gas layer answers — check constraint_coverage |
| max_fiber_km | number | Drop candidates farther than this from the nearest fiber route (CHORD approximation — see fiber_distance_basis). Applied ONLY if the fiber layer answers |
| min_voltage_kv | number | Only anchor on substations at or above this voltage in kV (default 115). 230+ for hyperscale, 500 for the largest campuses |
| exclude_moratorium | boolean | true = drop candidates in a state with a published data-center moratorium. STATE grain, not jurisdiction grain |
{
"name": "find_sites",
"title": "Find Sites",
"description": "Use this when the user has no data center site yet and wants candidate search areas (site selection by substation voltage, gas and fiber distance); execute_plan covers a multi-part siting question. THE INVERSE QUERY: every other DC Hub siting tool needs a coordinate you already have — analyze_site scores one, get_composite_site_score grades one, rank_sites orders candidates YOU already enriched, find_alternatives needs a seed facility. This one answers \"where should I even be looking?\". Returns candidate SEARCH AREAS anchored on real HIFLD substations at or above min_voltage_kv, spatially de-duplicated by cluster_km so a dense metro yields distinct areas instead of 40 near-identical rows, each carrying measured distance to the nearest gas pipeline and fiber route plus state-grain moratorium context, and a next_calls handoff. Answers \"where should I even be looking for 200 MW in Ohio\" and \"which areas near Dallas sit on 230kV with gas within 5 miles\". Try: find_sites state=OH min_voltage_kv=230 max_gas_km=8 — or find_sites lat=39.04 lon=-77.48 radius_km=60 min_voltage_kv=500. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Latitude of a search centre, e.g. 39.04 — use with lon (+ radius_km) instead of state"
},
"lng": {
"type": "number",
"description": "Alias for lon — either name works"
},
"lon": {
"type": "number",
"description": "Longitude of a search centre, e.g. -77.48"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"state": {
"type": "string",
"description": "2-letter US state to search, e.g. OH — required unless you pass lat + lon"
},
"market": {
"type": "string",
"description": "A DCPI market slug or name instead of lat/lon, e.g. chicago: the search is centred on that market (radius_km default 60). anchored_market names it; avoid_note says when it reads AVOID"
},
"latitude": {
"type": "number",
"description": "Alias for lat — either name works"
},
"longitude": {
"type": "number",
"description": "Alias for lon — either name works"
},
"radius_km": {
"type": "number",
"description": "Search radius in km around lat/lon (default 80, clamped 5-400); ignored in state mode"
},
"cluster_km": {
"type": "number",
"description": "Collapse anchors within this many km into one candidate area (default 8, max 100). Raise it for broader coverage, lower it for denser results"
},
"max_gas_km": {
"type": "number",
"description": "Drop candidates farther than this from the nearest gas pipeline. Applied ONLY if the gas layer answers — check constraint_coverage"
},
"max_fiber_km": {
"type": "number",
"description": "Drop candidates farther than this from the nearest fiber route (CHORD approximation — see fiber_distance_basis). Applied ONLY if the fiber layer answers"
},
"min_voltage_kv": {
"type": "number",
"description": "Only anchor on substations at or above this voltage in kV (default 115). 230+ for hyperscale, 500 for the largest campuses"
},
"exclude_moratorium": {
"type": "boolean",
"description": "true = drop candidates in a state with a published data-center moratorium. STATE grain, not jurisdiction grain"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=find_sites",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| latitude | number | Alias for lat — either name works |
| location | string | 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. |
| longitude | number | Alias for lon — either name works |
| capacity_mw | number | Target power load for the build in megawatts (MW), e.g. 100 (typical 50-500) |
| candidate_id | string | 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). |
| include_grid | boolean | Include grid-headroom / substation analysis (default true) |
| include_risk | boolean | Include water/drought/climate risk analysis (default true) |
| include_fiber | boolean | Include fiber-connectivity analysis (default true) |
| mpp_credential | string | Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge. |
{
"name": "analyze_site",
"title": "Analyze Site",
"description": "Use this when the user asks whether a specific site or coordinate works for a data center (lat/lon, or a market name for a market-level read). 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 key (DCHUB_API_KEY, optional) adds a few full site reports each month; other scores and figures need a full-access key. Without a key, the first 2 `analyze_site` calls each UTC day from a network return the full site report; after that, no full report until UTC midnight. 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.\" Next: to buy or lease capacity in these markets, call source_capacity; to register a requirement with providers, call request_capacity_intro after your human approves. Needs BOTH lat and lon in decimal degrees (else missing_coordinates); take them from get_facility or search_facilities. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Site latitude in decimal degrees (-90 to 90; required unless candidate_id or location given), e.g. 33.45"
},
"lng": {
"type": "number",
"description": "Alias for lon — either name works"
},
"lon": {
"type": "number",
"description": "Site longitude in decimal degrees (-180 to 180; required unless candidate_id or location given), e.g. -112.07"
},
"state": {
"type": "string",
"description": "US state abbreviation (optional) — improves the tax-incentive lookup, e.g. AZ"
},
"mpp_pay": {
"type": "boolean",
"description": "Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call."
},
"latitude": {
"type": "number",
"description": "Alias for lat — either name works"
},
"location": {
"type": "string",
"description": "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."
},
"longitude": {
"type": "number",
"description": "Alias for lon — either name works"
},
"capacity_mw": {
"type": "number",
"description": "Target power load for the build in megawatts (MW), e.g. 100 (typical 50-500)"
},
"candidate_id": {
"type": "string",
"description": "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)."
},
"include_grid": {
"type": "boolean",
"description": "Include grid-headroom / substation analysis (default true)"
},
"include_risk": {
"type": "boolean",
"description": "Include water/drought/climate risk analysis (default true)"
},
"include_fiber": {
"type": "boolean",
"description": "Include fiber-connectivity analysis (default true)"
},
"mpp_credential": {
"type": "string",
"description": "Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"fiber": {},
"locked": {},
"nearby": {},
"scores": {},
"preview": {},
"verdict": {},
"location": {},
"power_cost": {},
"overall_score": {},
"site_headline": {},
"interpretation": {},
"composite_score": {},
"limiting_factor": {}
},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=analyze_site",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "pro",
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "get_composite_site_score",
"title": "Get Composite Site Score",
"description": "Use this when the user wants one 0-100 data center site suitability verdict for a lat/lon WITH an explicit per-factor coverage map — which factors are actually measured vs. declared unavailable. Unlike analyze_site (full raw data dump), this scores ONLY over VALIDATED factors and never imputes a missing one: power/grid, fiber, natural-hazard risk (FEMA NRI) and water (live WRI Aqueduct 4.0 baseline water stress) are all live; water is \"unavailable\" only outside basin coverage (never faked); market/DCPI is v1-unavailable (use rank_markets). Example: get_composite_site_score lat=33.45 lon=-112.07 state=AZ. Returns {composite_score (0-100 over validated factors), verdict (BUILD/CAUTION/AVOID), confidence (complete|conditional), coverage {power_grid|fiber|water|risk_resilience|market_dcpi: validated|unavailable}, coverage_ratio, sub_scores, caveats}. Use analyze_site for full data, compare_sites for 2-4 sites, rank_markets for whole-market ranking. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Site latitude in decimal degrees (-90 to 90, required), e.g. 33.45"
},
"lng": {
"type": "number",
"description": "Alias for lon — either name works"
},
"lon": {
"type": "number",
"description": "Site longitude in decimal degrees (-180 to 180, required), e.g. -112.07"
},
"state": {
"type": "string",
"description": "US state abbreviation (optional) — improves water/context lookups, e.g. AZ"
},
"latitude": {
"type": "number",
"description": "Alias for lat — either name works"
},
"longitude": {
"type": "number",
"description": "Alias for lon — either name works"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"limits": "water is declared unavailable outside WRI Aqueduct basin coverage rather than imputed",
"problem": "water and climate risk",
"maturity": "mature",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_composite_site_score",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "pro",
"idempotentHint": true,
"destructiveHint": false
}
}| Max distance (km) to snap to the nearest NOAA station (optional, default 25) |
{
"name": "get_climate_intel",
"title": "Get Climate Intel",
"description": "Use this when the user asks about seismic or climate design inputs for a data center site (lat/lon) — the layer that drives data-center structural bracing cost (seismic) and cooling design (cooling degree-days, extreme temps). Grounded STRICTLY in USGS ASCE 7 (seismic) + NOAA climate normals via ACIS; every value traces to a federal source and missing data is declared unavailable, never estimated. Example: get_climate_intel lat=33.45 lon=-112.07. Returns {seismic_hazard_usgs:{status, peak_ground_acceleration_g, ss, s1, seismic_design_category, hazard_class}, climate_normals_noaa:{status, reference_station:{id,name,distance_km}, cooling_design_metrics:{cooling_degree_days_annual, extreme_max_dry_bulb_f, extreme_max_wet_bulb_f (null if source lacks it), data_vintage}}, overall_climate_summary, data_availability, sources}. radius_km (optional, default 25) snaps to the nearest NOAA station; beyond it climate returns unavailable_exceeds_radius. Seismic is US (ASCE 7); non-US → seismic unavailable. For natural-hazard ratings use get_disaster_risk; for one blended verdict use get_composite_site_score. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Site latitude in decimal degrees (-90 to 90, required), e.g. 33.45"
},
"lng": {
"type": "number",
"description": "Alias for lon — either name works"
},
"lon": {
"type": "number",
"description": "Site longitude in decimal degrees (-180 to 180, required), e.g. -112.07"
},
"latitude": {
"type": "number",
"description": "Alias for lat — either name works"
},
"longitude": {
"type": "number",
"description": "Alias for lon — either name works"
},
"radius_km": {
"type": "number",
"description": "Max distance (km) to snap to the nearest NOAA station (optional, default 25)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"limits": "water is declared unavailable outside WRI Aqueduct basin coverage rather than imputed",
"problem": "water and climate risk",
"maturity": "mature",
"front_door": "get_composite_site_score",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_climate_intel",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| Alias for lon — either name works |
| capacity_mw | number | Target power load for the build in megawatts (MW), e.g. 150 (typical 50-500) |
| prepared_by | string | Your firm name that brands the report; defaults to DC Hub, e.g. "Martone Advisors" |
| prepared_for | string | Client name printed on the report cover, e.g. "TON Infrastructure" |
| latency_target | string | Optional metro to measure latency against; default = nearest real carrier hotel |
{
"name": "generate_site_analysis",
"title": "Generate Site Analysis",
"description": "Use this when the user wants a shareable data center Site Analysis PDF for ONE lat/lon (a powered-land parcel, a candidate campus) — the polished client deliverable, not just a score. Example: \"Make the Site Analysis PDF for this Carrier Mills parcel, 150 MW, for TON Infrastructure.\" — generate_site_analysis lat=37.694 lon=-88.65 capacity_mw=150 prepared_for=\"TON Infrastructure\" prepared_by=\"Martone Advisors\". Params: lat (-90 to 90, required), lon (-180 to 180, required), capacity_mw (target load MW, e.g. 50-500), prepared_for (client name on the cover), prepared_by (your firm — brands the report; defaults to DC Hub), latency_target (optional metro override; default = nearest real carrier hotel). Returns: {survey:{verdict, power/transmission, gas, water, air-permitting, fiber carriers, latency-to-nearest-carrier-hotel, market, tax}, pdf_report_url}. pdf_report_url is a ready-to-open link to download the branded 5-page PDF — no login needed, valid ~7 days; hand it to your human. For just the numeric suitability score (no PDF), use analyze_site instead. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Site latitude in decimal degrees (-90 to 90, required), e.g. 37.694"
},
"lng": {
"type": "number",
"description": "Alias for lon — either name works"
},
"lon": {
"type": "number",
"description": "Site longitude in decimal degrees (-180 to 180, required), e.g. -88.65"
},
"latitude": {
"type": "number",
"description": "Alias for lat — either name works"
},
"use_case": {
"type": "string",
"description": "Optional workload descriptor to tailor the report, e.g. \"AI training campus\""
},
"longitude": {
"type": "number",
"description": "Alias for lon — either name works"
},
"capacity_mw": {
"type": "number",
"description": "Target power load for the build in megawatts (MW), e.g. 150 (typical 50-500)"
},
"prepared_by": {
"type": "string",
"description": "Your firm name that brands the report; defaults to DC Hub, e.g. \"Martone Advisors\""
},
"prepared_for": {
"type": "string",
"description": "Client name printed on the report cover, e.g. \"TON Infrastructure\""
},
"latency_target": {
"type": "string",
"description": "Optional metro to measure latency against; default = nearest real carrier hotel"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=generate_site_analysis",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "pro",
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "compare_sites",
"title": "Compare Sites",
"description": "Use this when the user has 2-4 candidate data center sites and asks which is best. Pass locations as \"lat,lon;lat,lon\" and optional capacity_mw. Returns each site's analyze_site scores side by side plus a recommended winner and why. Keyless returns each site's verdict band and power band, with the other factors named; a key (DCHUB_API_KEY, optional) adds names and counts without figures; scores and figures need a full-access key, as does the pick. Ex: \"Phoenix vs Ashburn for 50 MW?\" Next: to buy or lease capacity in these markets, call source_capacity; to register a requirement with providers, call request_capacity_intro after your human approves. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"sites": {
"description": "Alternative to locations: an array of {lat, lon} (or {lat, lng}) objects, 2-4 sites"
},
"mpp_pay": {
"type": "boolean",
"description": "Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call."
},
"locations": {
"type": "string",
"description": "Semicolon-separated list of 2-4 \"lat,lon\" pairs to compare, e.g. \"33.45,-112.07;39.04,-77.48\""
},
"capacity_mw": {
"type": "number",
"description": "Target power load for the build in megawatts (MW), e.g. 50 (typical 50-500)"
},
"mpp_credential": {
"type": "string",
"description": "Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge."
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=compare_sites",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "pro",
"idempotentHint": true,
"destructiveHint": false
}
}| Search radius in kilometers around the point, e.g. 25 |
| min_voltage_kv | number | Only include transmission/substations at or above this voltage in kV, e.g. 69 |
{
"name": "get_infrastructure",
"title": "Nearby Infrastructure",
"description": "Use this when the user asks what power infrastructure is near a site: substations (count + max voltage_kv within radius), transmission lines (>69 kV path overlay), interstate + lateral gas pipelines, and power plants (operating + planned, by fuel) within configurable radius_km. Returns distance + capacity for each, joined to HIFLD/EIA. Answers \"what is near this parcel\", \"how far is the nearest substation and what voltage is it\". Try: get_infrastructure lat=33.45 lon=-112.07 radius_km=25. Returns raw nearby assets; do NOT use for a single scored site-suitability verdict (use analyze_site). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Center latitude in decimal degrees (-90 to 90, required), e.g. 33.45"
},
"lng": {
"type": "number",
"description": "Alias for lon — either name works"
},
"lon": {
"type": "number",
"description": "Center longitude in decimal degrees (-180 to 180, required), e.g. -112.07"
},
"layer": {
"type": "string",
"description": "Optional single asset layer to return, e.g. substations, transmission, pipelines, power_plants"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"latitude": {
"type": "number",
"description": "Alias for lat — either name works"
},
"longitude": {
"type": "number",
"description": "Alias for lon — either name works"
},
"radius_km": {
"type": "number",
"description": "Search radius in kilometers around the point, e.g. 25"
},
"min_voltage_kv": {
"type": "number",
"description": "Only include transmission/substations at or above this voltage in kV, e.g. 69"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"limits": "utility-published feeder hosting capacity covers a named subset of utilities in the Northeast, Mid-Atlantic and Midwest — not nationwide, and absence of a feeder is not absence of capacity · published feeder capacities are single-digit to low-tens of MW and the rows are GIS vertices — read distinct_feeders, never the row count",
"problem": "substations and transmission",
"maturity": "partial",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_infrastructure",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "developer_for_full",
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "get_fiber_intel",
"title": "Fiber Intelligence",
"description": "Use this when the user asks about fiber routes, carriers or connectivity for a market: long-haul, metro, dark or IX routes. Filter by carrier, route_type, market. Returns GeoJSON routes: carrier, type, fiber count, lit capacity, distance. Without full access you get a sample of routes, not the full set; the full set needs a full-access key. Ex: \"Zayo long-haul routes via Dallas.\" Filter by market (slug from rank_markets) or carrier. For one building use get_facility. Gated: give human_url to your human. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"market": {
"type": "string",
"description": "Metro name or slug (e.g. \"dallas\", \"ashburn\", \"northern-virginia\") — returns only routes touching that metro (either endpoint within ~1.2°). Great with route_type=longhaul."
},
"carrier": {
"type": "string",
"description": "Fiber carrier to filter on, e.g. Zayo, Lumen, Cogent, \"Crown Castle\", Windstream, GTT, Uniti; omit for all carriers"
},
"mpp_pay": {
"type": "boolean",
"description": "Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call."
},
"route_type": {
"type": "string",
"description": "Route class: \"metro\", \"longhaul\", \"dark\", or \"ix\""
},
"mpp_credential": {
"type": "string",
"description": "Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge."
},
"include_sources": {
"type": "boolean",
"description": "Include upstream data-source/provenance metadata in the response"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"type": {},
"total": {},
"features": {}
},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"problem": "fiber routes, diversity and latency",
"maturity": "mature",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_fiber_intel",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "email",
"idempotentHint": true,
"destructiveHint": false
}
}| number |
| Search radius in km for reachable fiber carriers (default 50, range 5-200) |
{
"name": "get_fiber_readiness",
"title": "Get Fiber Readiness",
"description": "Use this when the user asks whether one data center site (lat/lon) is fiber-ready: near-net distance to a carrier-served facility, how many distinct fiber carriers are reachable, and whether there is single-carrier risk (no path diversity). This is the parcel connectivity answer engineering site-selectors screen on. Example: \"Is this Loudoun County parcel fiber-ready and how many carriers can serve it?\" — get_fiber_readiness lat=39.04 lon=-77.48 radius_km=50. Params: lat (-90..90, required), lon (-180..180, required), radius_km (search radius in km, default 50, range 5-200). Returns: {score 0-100 (null when not scored — see carrier_data_coverage), near_net_bucket (\"on-net\"|\"near-net\"|\"acceptable\"|\"build-required\"|\"unknown\"), nearest_carrier_km, carrier_count, top_carriers:[{carrier, distance_km}], single_carrier_risk (bool, null when not scored), fiber_coverage_km, verdict_short, carrier_data_coverage (\"confirmed\"|\"none_in_region\")}. IMPORTANT — \"unknown\" is NOT \"bad\": carrier presence comes from PeeringDB, which is global but thin outside dense US/EU metros, so DC Hub distinguishes \"no carrier serves this point\" from \"PeeringDB does not describe this region\". For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Site latitude in decimal degrees (-90 to 90, required), e.g. 39.04"
},
"lng": {
"type": "number",
"description": "Alias for lon — either name works"
},
"lon": {
"type": "number",
"description": "Site longitude in decimal degrees (-180 to 180, required), e.g. -77.48"
},
"latitude": {
"type": "number",
"description": "Alias for lat — either name works"
},
"longitude": {
"type": "number",
"description": "Alias for lon — either name works"
},
"radius_km": {
"type": "number",
"description": "Search radius in km for reachable fiber carriers (default 50, range 5-200)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "metered",
"problem": "fiber routes, diversity and latency",
"maturity": "mature",
"front_door": "get_fiber_intel",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_fiber_readiness",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| radius_km | number | Search radius in km around lat/lon for landing points (default 200) |
{
"name": "get_subsea_cables",
"title": "Get Subsea Cables",
"description": "Use this when the user asks about subsea (submarine) cable landings near a site, or the cable catalogue. The physical internet crossing an ocean lands at a finite number of points, and distance to one is a real siting factor for anything latency- or transit-sensitive. Pass lat+lon (+radius_km) for LANDING POINTS near a site — each with name, coordinates and distance_km. Omit coordinates for the CATALOGUE of tracked cables (712 tracked; each with cable_id, name, owners, length_km, rfs_year, is_planned — sparse fields are null, not guessed). ★ READ field_coverage AND connectivity_note BEFORE DRAWING A CONCLUSION: cable_count per landing point is NOT populated — the ingest writes the column but the upstream TeleGeography feed does not supply what it derives from, so every row carries the default 0. Answers \"which subsea cables land near this Virginia site\" and \"how far is the nearest cable landing from my campus\". Try: get_subsea_cables lat=36.85 lon=-75.98 radius_km=200 — or get_subsea_cables (no args) for the catalogue. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Latitude of the site, e.g. 36.85 — with lon, returns landing points near it; omit both for the cable catalogue"
},
"lng": {
"type": "number",
"description": "Alias for lon — either name works"
},
"lon": {
"type": "number",
"description": "Longitude of the site, e.g. -75.98"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"latitude": {
"type": "number",
"description": "Alias for lat — either name works"
},
"longitude": {
"type": "number",
"description": "Alias for lon — either name works"
},
"radius_km": {
"type": "number",
"description": "Search radius in km around lat/lon for landing points (default 200)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_subsea_cables",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| longitude |
| number |
| Alias for lon — either name works |
{
"name": "get_peering_intel",
"title": "Get Peering Intel",
"description": "Use this when the user asks about internet exchange (IX) and peering density for a data center site (PeeringDB). Pass lat+lon for the PEERING PROFILE around that point: facilities_nearby, a 0-100 score with its level, total_ix_presence, total_networks, and top_facilities each with ix_count and net_count — e.g. Ashburn comes back with 61 IX presences and 903 networks across the nearby sites, led by Equinix DC1-DC15 at 516 networks. Omit coordinates for the IXP directory (name, name_long, city, country, net_count, fac_count, media, protocols). This is the layer that answers \"can I actually reach networks cheaply from here\", which fiber route geometry does not: a site can sit on dense fiber and still be far from any exchange. The score is a DERIVED convenience over PeeringDB counts, not a DC Hub-sourced grade — cite the underlying counts (facilities, IX presence, networks) rather than the score when it is load-bearing. Records are PeeringDB's, refreshed on read. Answers \"how good is peering at this Ashburn site\" and \"which internet exchanges serve the Dallas market\". Try: get_peering_intel lat=39.04 lon=-77.48 — or get_peering_intel (no args) for the IXP directory. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Latitude of the site, e.g. 39.04 — with lon, returns the peering profile around it; omit both for the IXP directory"
},
"lng": {
"type": "number",
"description": "Alias for lon — either name works"
},
"lon": {
"type": "number",
"description": "Longitude of the site, e.g. -77.48"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"latitude": {
"type": "number",
"description": "Alias for lat — either name works"
},
"longitude": {
"type": "number",
"description": "Alias for lon — either name works"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_peering_intel",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| mpp_credential | string | Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge. |
{
"name": "get_energy_prices",
"title": "Energy Prices",
"description": "Use this when the user asks what electricity or natural gas costs for a data center in a US ISO or state (\"what does power cost in ERCOT?\", \"retail rate in Virginia?\", \"ERCOT North hub LMP right now?\"); price alone does not rank sites (the cheapest ISO may have no headroom; execute_plan weighs both). Can be scoped to a data center market or site: execute_plan pairs these prices with that place's facilities and grid headroom. Returns EIA RETAIL electricity rates, which are monthly and not live (about 3 months behind; retail_rates.latest_period names the month), for one ISO footprint (the average of its states), one state, or the US: retail_rates {avg_cents_kwh, min_cents_kwh, max_cents_kwh, latest_period, states_covered} in CENTS/kWh, plus avg_rate_kwh, retail_rate_kwh and industrial_rate_kwh in DOLLARS/kWh (by_sector when no sector is given); and natural_gas_usd_mmbtu, the latest Henry Hub daily spot in $/MMBtu, one national benchmark rather than a state or ISO price, with its own natural_gas.period and as_of. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"hub": {
"type": "string",
"description": "Optional ISO pricing hub for wholesale_lmp, one of wholesale_lmp.hubs_available, e.g. HB_NORTH or HB_HOUSTON (ERCOT); omit for the ISO's default hub"
},
"iso": {
"type": "string",
"description": "ISO/RTO grid region (required for ISO pricing): ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE"
},
"state": {
"type": "string",
"description": "US state abbreviation for state-level pricing context, e.g. TX"
},
"mpp_pay": {
"type": "boolean",
"description": "Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call."
},
"data_type": {
"type": "string",
"description": "Optional price type focus, e.g. retail, wholesale, gas"
},
"mpp_credential": {
"type": "string",
"description": "Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"as_of": {},
"gated": {},
"scope": {},
"filter": {},
"success": {},
"caller_tier": {},
"natural_gas": {},
"avg_rate_kwh": {},
"retail_rates": {},
"wholesale_lmp": {},
"retail_rate_kwh": {},
"wholesale_context": {},
"industrial_rate_kwh": {},
"natural_gas_usd_mmbtu": {},
"wholesale_lmp_withheld": {}
},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"problem": "PPAs and energy pricing",
"maturity": "mature",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_energy_prices",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "email",
"idempotentHint": true,
"destructiveHint": false
}
}| number |
| Alias for lat — either name works |
| longitude | number | Alias for lon — either name works |
| energy_type | string | Renewable type: "solar", "wind", or "combined"; omit for all |
| mpp_credential | string | Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge. |
{
"name": "get_renewable_energy",
"title": "Renewable Energy",
"description": "Use this when the user asks about renewable energy for a data center (execute_plan covers renewables plus siting): siting a renewable-powered data center, sizing a PPA, reading one US state's utility-scale fuel mix, or assessing RE100/24-7-CFE feasibility. Example: \"What is Texas wind+solar capacity and how much utility-scale solar is operating today?\" — get_renewable_energy energy_type=solar state=TX. Params: energy_type one of \"solar\" | \"wind\" | \"combined\" (omit for all); state 2-letter US code (e.g. TX, VA, AZ); lat+lon (optional) for the nearest projects within 50mi. Returns: {capacity_mw_total, by_fuel: {solar_utility, solar_rooftop, wind_onshore, wind_offshore}, capacity_factor_pct, top_projects[{name, mw, operator, cod}], state_rps_target_pct, source: \"EIA-860 + state RPS\"}. Do NOT use for live grid generation (use get_grid_data) or non-US (use get_grid_scoreboard for EU/UK/AU/TW). Give state or lat/lon (decimal degrees); energy_type narrows. Empty = no installations there: widen to the state. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Optional latitude in decimal degrees (-90 to 90) to find nearest projects within 50mi"
},
"lng": {
"type": "number",
"description": "Alias for lon — either name works"
},
"lon": {
"type": "number",
"description": "Optional longitude in decimal degrees (-180 to 180) to find nearest projects within 50mi"
},
"state": {
"type": "string",
"description": "US state abbreviation, e.g. TX, VA, AZ"
},
"mpp_pay": {
"type": "boolean",
"description": "Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call."
},
"latitude": {
"type": "number",
"description": "Alias for lat — either name works"
},
"longitude": {
"type": "number",
"description": "Alias for lon — either name works"
},
"energy_type": {
"type": "string",
"description": "Renewable type: \"solar\", \"wind\", or \"combined\"; omit for all"
},
"mpp_credential": {
"type": "string",
"description": "Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"cite_as": {},
"success": {},
"ppa_as_of": {},
"ppa_basis": {},
"ppa_count": {},
"data_source": {},
"ppa_total_mw": {},
"filters_applied": {},
"ppa_total_count": {},
"dc_industry_ppas": {},
"installations_count": {},
"renewable_installations": {}
},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_renewable_energy",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "email",
"idempotentHint": true,
"destructiveHint": false
}
}| latitude | number | Alias for lat — either name works |
| location | string | Market NAME or metro slug instead of coordinates, e.g. "phoenix", "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. |
| longitude | number | Alias for lon — either name works |
| mpp_credential | string | Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge. |
{
"name": "get_water_risk",
"title": "Water Risk",
"description": "Use this when the user asks about water stress or cooling-water risk at a data center site (execute_plan covers a multi-factor site verdict). Use when scoring a US site for cooling-water sustainability — the water-risk factor engineering site-selectors screen before committing to evaporative cooling. Example: \"Is this Phoenix parcel water-constrained for a 100MW build?\" — get_water_risk lat=33.45 lon=-112.07 (or get_water_risk state=AZ, or location=\"phoenix\"). Params: ONE of lat+lon (-90..90 / -180..180), state (2-letter US), or location (a DC Hub market name or slug, resolved to that market's PUBLISHED CENTROID with a resolved_from block saying so; a market-level read, not your parcel, and a trailing state is not stripped); lat/lon gives the most precise read. Returns: {water_stress_score (0-100, higher=worse), drought_category (D0-D4), outlook_12mo, cooling_water_assessment, source}. Joined to USGS water-stress + US Drought Monitor. Works with no key. 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. US only: give state or lat/lon (decimal degrees). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Site latitude in decimal degrees (-90 to 90) for the most precise water-risk read, e.g. 33.45"
},
"lng": {
"type": "number",
"description": "Alias for lon — either name works"
},
"lon": {
"type": "number",
"description": "Site longitude in decimal degrees (-180 to 180), e.g. -112.07"
},
"state": {
"type": "string",
"description": "US state abbreviation as an alternative to lat/lon, e.g. AZ"
},
"mpp_pay": {
"type": "boolean",
"description": "Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call."
},
"latitude": {
"type": "number",
"description": "Alias for lat — either name works"
},
"location": {
"type": "string",
"description": "Market NAME or metro slug instead of coordinates, e.g. \"phoenix\", \"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."
},
"longitude": {
"type": "number",
"description": "Alias for lon — either name works"
},
"mpp_credential": {
"type": "string",
"description": "Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {},
"state": {},
"source": {},
"cite_as": {},
"success": {},
"queried_at": {},
"source_url": {},
"latest_week": {},
"weekly_history": {},
"dominant_severity": {},
"drought_categories": {},
"current_drought_pct": {}
},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"limits": "water is declared unavailable outside WRI Aqueduct basin coverage rather than imputed",
"problem": "water and climate risk",
"maturity": "mature",
"front_door": "get_composite_site_score",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_water_risk",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "email",
"idempotentHint": true,
"destructiveHint": false
}
}| mpp_credential |
| string |
| Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge. |
{
"name": "get_grid_intelligence",
"title": "Grid Intelligence",
"description": "Use this when the user asks about grid capacity, power availability, headroom or time-to-power in a US ISO (PJM, ERCOT, CAISO, MISO, SPP, NYISO, ISO-NE) or a market's grid. Returns live demand, fuel mix, queue depth, DCPI excess-power and constraint scores, time-to-power, reserve margin. avg_time_to_power_months and avg_queue_wait_months are DIFFERENT measurements; quote the one you mean. Can be scoped to a data center market or site: execute_plan pairs the grid with that place's facilities, capacity and markets. Keyless gets a trimmed preview; DCHUB_API_KEY is optional, and a key unlocks full briefs. Ex: \"PJM headroom for 200 MW?\" iso must be a US ISO (ERCOT, PJM, CAISO, MISO, SPP, NYISO, ISO-NE); other codes return region_not_covered. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"anyOf": [
{
"required": [
"region_id"
],
"properties": {
"region_id": {}
}
},
{
"required": [
"iso"
],
"properties": {
"iso": {}
}
},
{
"required": [
"region"
],
"properties": {
"region": {}
}
},
{
"required": [
"market"
],
"properties": {
"market": {}
}
}
],
"properties": {
"iso": {
"type": "string",
"description": "Alias for region_id — the ISO/RTO or balancing-authority code"
},
"market": {
"type": "string",
"description": "Market NAME or metro slug instead of a grid code, e.g. \"Ashburn\", \"northern-virginia\", \"dallas\". Resolved to its ISO through the published DCPI market row before the brief is built; the answer carries a resolved_from block naming what it…"
},
"region": {
"type": "string",
"description": "Alias for region_id — the ISO/RTO or balancing-authority code"
},
"mpp_pay": {
"type": "boolean",
"description": "Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call."
},
"region_id": {
"type": "string",
"description": "Grid region (required): one of the 7 US ISOs (PJM, ERCOT, CAISO, MISO, SPP, NYISO, ISO-NE), an EIA balancing-authority code (e.g."
},
"mpp_credential": {
"type": "string",
"description": "Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {},
"iso": {},
"as_of": {},
"taste": {},
"cite_as": {},
"iso_name": {},
"withheld": {},
"completeness": {},
"demand_period": {},
"withheld_total": {},
"free_preview_only": {}
},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"limits": "supply-side signals, not a load-interconnection promise — generation is not deliverable load · utility study timelines, large-load tariff processes and substation-grain delivery are declared out of coverage rather than estimated · a state-scoped ranking needs a state the planner can resolve; an unresolved geography answers nationally and says so",
"problem": "grid headroom and power availability; site selection and buildable capacity",
"maturity": "mature",
"front_door": "execute_plan",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_grid_intelligence",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "email",
"idempotentHint": true,
"destructiveHint": false
}
}| completeness | string | The completeness flag from the cited response, if it carried one |
{
"name": "summarize_for_citation",
"title": "Citation Block",
"description": "Use this when you quote a DC Hub data center or power figure: returns one paste-ready attribution line for the value you are about to cite, with the CORRECT licence for that layer. Pass what you read off the response you are citing: subject (what the figure is), as_of (the provenance as_of), url (the row's profile_url or dcpi_url), completeness (the completeness flag), and layer. ★ LICENCE IS PER LAYER AND THIS IS THE POINT: DCPI verdicts and composite scores (CC-BY-4.0 30 days after the day they describe; current values: quote any number of markets in editorial work; bulk or recurring republishing needs a DCPI licence, https://dchub.cloud/terms#dcpi-current-data), band thresholds, methodology and DC Hub's own grid/site analysis (CC-BY-4.0) are yours to quote with attribution; the facility inventory and third-party physical layers are COMPOSITES whose upstream terms DC Hub cannot waive (parts are OpenStreetMap, ODbL 1.0, share-alike), so they carry a pointer to https://dchub.cloud/data-sources instead of a grant. A flat \"CC-BY-4.0\" over a facility record is an over-claim. Returns {citation_text, cite_as, license, license_basis, source, url, as_of, as_of_basis, completeness, omitted}. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The profile_url or dcpi_url from the cited row. Must be a dchub.cloud URL; anything else is dropped and named in `omitted`."
},
"as_of": {
"type": "string",
"description": "The as_of you read off the cited response (provenance.as_of). Omit it and the line says RETRIEVED instead of claiming a data date."
},
"layer": {
"type": "string",
"description": "Which layer the figure came from: dcpi | grid_analysis | facility_inventory | physical_infrastructure | deals | other. Decides the licence line; omit and you get the scoped statement rather than a grant."
},
"subject": {
"type": "string",
"description": "What you are citing, in the words you will show the human, e.g. \"Ashburn DCPI verdict\" or \"ERCOT interconnection queue depth\""
},
"completeness": {
"type": "string",
"description": "The completeness flag from the cited response, if it carried one"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=summarize_for_citation",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| projection | string | Named field preset, cheaper to send than a field list: market_summary (ranking rows), siting_summary (site/point rows), identity_only (ids + names). |
| mpp_credential | string | Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge. |
| min_capacity_mw | number | Minimum existing capacity filter in megawatts (MW), e.g. 100 |
{
"name": "rank_markets",
"title": "Rank Markets",
"description": "Use this when the user wants a ranked list of data-center markets, including where a data center can get grid power (criteria=\"ai_ready\", DCPI): top N by cheapest_power, most_capacity, most_operators, fastest_growing, best_overall, or ai_ready (where new AI load can land, per DCPI). Filter by region, min_capacity_mw. Returns ranked rows with score, MW and a slug for follow-ups; score is the sort value, not a 0-100 scale, and score_basis says what it is (ai_ready omits it and explains its composite in `methodology`). Keyless: a trimmed preview; DCHUB_API_KEY is optional, and a key unlocks full lists. Ex: \"Top 10 US markets, ai_ready.\" Next: to buy or lease capacity in these markets, call source_capacity; to register a requirement with providers, call request_capacity_intro after your human approves. Returns market slugs to feed get_market_intel and get_market_dcpi_rank. limit 1-500; set projection=identity_only to save tokens. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Number of markets to return, 1-50 (default 10)"
},
"fields": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Return ONLY these row fields (array or comma string) — a token diet. The response envelope (citation, provenance, as_of, coverage, request_interpretation, the human relay line) is NEVER projected away; a projection narrows ROWS only."
},
"region": {
"type": "string",
"description": "Region scope: \"global\", \"us\" (default), \"canada\", \"eu\", \"apac\", or \"americas\""
},
"mpp_pay": {
"type": "boolean",
"description": "Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call."
},
"criteria": {
"type": "string",
"description": "Ranking criterion: \"cheapest_power\", \"most_capacity\", \"most_operators\", \"fastest_growing\", \"best_overall\" (default), or \"ai_ready\" (DCPI buildability — where new AI load can land, for AI-campus siting; region us/global)"
},
"projection": {
"enum": [
"siting_summary",
"market_summary",
"identity_only"
],
"type": "string",
"description": "Named field preset, cheaper to send than a field list: market_summary (ranking rows), siting_summary (site/point rows), identity_only (ids + names)."
},
"mpp_credential": {
"type": "string",
"description": "Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge."
},
"min_capacity_mw": {
"type": "number",
"description": "Minimum existing capacity filter in megawatts (MW), e.g. 100"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"tier": {},
"region": {},
"cite_as": {},
"results": {},
"criteria": {},
"data_source": {},
"methodology": {},
"score_basis": {},
"result_count": {}
},
"additionalProperties": true
},
"annotations": {
"access": "paid",
"problem": "colocation and wholesale data-center markets",
"maturity": "mature",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=rank_markets",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "email",
"idempotentHint": true,
"destructiveHint": false
}
}| string |
| Optional DCPI verdict filter: BUILD, CAUTION, or AVOID — or ALL to see every scored market in the geography. Defaults to BUILD,CAUTION, so a geography whose markets are all AVOID returns matched:0 plus an `empty_result` block explaining… |
| max_months | integer | Maximum acceptable time-to-power in months, 1-120, e.g. 24 |
| capacity_mw | integer | Target power load for the build in megawatts (MW), 1-5000, e.g. 100 |
| mpp_credential | string | Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge. |
{
"name": "site_selection_canvas",
"title": "Site Selection Canvas",
"description": "Use this when the user wants guided data-center site selection. Give a capacity target + geography + deadline and get a ranked shortlist of US markets (DCPI verdict, excess-power headroom, time-to-power, ISO) — and, with a full-access key, the synthesis decision layer: the #1 pick, the why, a build sequence, and risk flags. One find->rank->shortlist->verdict call over the Data Center Power Index. Answers \"where should I build 100 MW in Texas by 2028\". Try: site_selection_canvas capacity_mw=100 region=TX max_months=24. Do NOT use for a single known parcel (use analyze_site) or an open-ended where-should-I-build question (use get_dchub_recommendation); this runs the full find to rank to shortlist to verdict flow. Next: to buy or lease capacity in these markets, call source_capacity; to register a requirement with providers, call request_capacity_intro after your human approves. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"iso": {
"type": "string",
"description": "ISO/RTO code, e.g. ERCOT or PJM — alias for `region`. Use either; `region` wins if both are sent."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Number of shortlist markets to return"
},
"state": {
"type": "string",
"description": "US state code, e.g. OH — alias for `region`. Use either; `region` wins if both are sent."
},
"region": {
"type": "string",
"description": "Geography scope: a US state code like TX, an ISO like ERCOT, or a region like us/apac. `state` and `iso` are accepted as aliases for this same filter."
},
"mpp_pay": {
"type": "boolean",
"description": "Per-call payment quote (Stripe MPP): true returns a signed payment challenge instead of the preview; no money moves. Set it only after your human has explicitly approved paying for this call."
},
"verdict": {
"type": "string",
"description": "Optional DCPI verdict filter: BUILD, CAUTION, or AVOID — or ALL to see every scored market in the geography. Defaults to BUILD,CAUTION, so a geography whose markets are all AVOID returns matched:0 plus an `empty_result` block explaining…"
},
"max_months": {
"type": "integer",
"maximum": 120,
"minimum": 1,
"description": "Maximum acceptable time-to-power in months, 1-120, e.g. 24"
},
"capacity_mw": {
"type": "integer",
"maximum": 5000,
"minimum": 1,
"description": "Target power load for the build in megawatts (MW), 1-5000, e.g. 100"
},
"mpp_credential": {
"type": "string",
"description": "Per-call payment (Stripe MPP): the Shared Payment Token for challenges[0]; pays that challenge for this one call. Send it only with your human's explicit approval of the charge."
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"limits": "a state-scoped ranking needs a state the planner can resolve; an unresolved geography answers nationally and says so",
"problem": "site selection and buildable capacity",
"maturity": "mature",
"front_door": "execute_plan",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=site_selection_canvas",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| Alias for lat — either name works |
| longitude | number | Alias for lon — either name works |
| radius_km | number | Radius for nearby permit filings in km, 1-300 (default 100) |
{
"name": "get_air_permit_context",
"title": "Get Air Permit Context",
"description": "Use this when the user asks about air permits, EPA nonattainment, or on-site gas turbine / generator permitting near a data center site, for example \"air permits for gas turbines near Midland, TX\" or \"is this site in an ozone nonattainment area?\". Returns the EPA Green Book designations (nonattainment or maintenance, pollutant, classification, area) for the county the point is in, US-wide, plus TCEQ-listed gas-turbine air permits of 20 MW or more (issued and pending) within radius_km, Texas only: company, permit number, status, date, distance, MW, turbine model, NOx limit, source URL. Dated snapshot with as_of and cite_as. Reciprocating engines, permits by rule and non-Texas filings are not covered and the answer says so. Do NOT use for moratoriums or zoning (use get_permitting_intel). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Site latitude in decimal degrees, e.g. 31.97"
},
"lng": {
"type": "number",
"description": "Alias for lon — either name works"
},
"lon": {
"type": "number",
"description": "Site longitude in decimal degrees, e.g. -102.08"
},
"site": {
"type": "string",
"description": "DC Hub market slug instead of coordinates, as rank_markets lists it, e.g. \"midland-tx\" (Midland–Odessa), \"dallas\". Resolved to that market's PUBLISHED CENTROID through the DCPI market row; the answer carries resolved_from."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Filings to return, nearest first, 1-50 (default 10)"
},
"status": {
"enum": [
"all",
"issued",
"pending"
],
"type": "string",
"description": "Filing status filter (default all)"
},
"latitude": {
"type": "number",
"description": "Alias for lat — either name works"
},
"longitude": {
"type": "number",
"description": "Alias for lon — either name works"
},
"radius_km": {
"type": "number",
"maximum": 300,
"minimum": 1,
"description": "Radius for nearby permit filings in km, 1-300 (default 100)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=get_air_permit_context",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| number |
| Percentage POINTS added/removed from reserve margin, e.g. -5 |
| time_to_power_months_delta | number | Months added (+) or removed (-) from time-to-power, e.g. 12 |
{
"name": "simulate_scenario",
"title": "Market Scenario Simulator",
"description": "Use this when the user asks how data center power market rankings change under what-if conditions: re-scores every DC Hub market under your deltas. Params (all optional, pass at least one delta): avg_kwh_cents_pct (power-price % change, e.g. 30), time_to_power_months_delta (months added/removed), queue_wait_months_delta, reserve_margin_pct_delta (points), curtailment_pct_delta (points), market (one slug, e.g. abilene), top_n (default 10, max 25 — ranked by |score change|). Returns per-market baseline vs scenario composite + component breakdown + the EXACT formula/weights in every response (transparent scenario_composite — deliberately NOT the DCPI). Keyless callers get a top-3 preview; any live key (get_api_key) returns up to 25. Answers \"what happens to the ranking if power prices jump 30%\", \"which markets survive a tighter build rate\". Try: simulate_scenario avg_kwh_cents_pct=30 top_n=10. Do NOT use for the present-day ranking (use rank_markets) or trajectory extrapolation (use predict_market_trajectory); this answers explicit hypotheticals. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"top_n": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Markets to return, ranked by |score delta| (default 10)"
},
"market": {
"type": "string",
"description": "Score ONE market by slug (optional), e.g. abilene — slugs from rank_markets"
},
"avg_kwh_cents_pct": {
"type": "number",
"description": "Power price % change, e.g. 30 for +30% or -20 for -20%"
},
"curtailment_pct_delta": {
"type": "number",
"description": "Percentage POINTS added/removed from curtailment"
},
"queue_wait_months_delta": {
"type": "number",
"description": "Months added/removed from interconnection queue wait"
},
"reserve_margin_pct_delta": {
"type": "number",
"description": "Percentage POINTS added/removed from reserve margin, e.g. -5"
},
"time_to_power_months_delta": {
"type": "number",
"description": "Months added (+) or removed (-) from time-to-power, e.g. 12"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=simulate_scenario",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| For capacity: anything else about the requirement; leave out anything that identifies your human |
| scope | string | For permitting_change: "records" (published permitting records), "legislation" (bill status changes) or "all" (default) |
| state | string | For permitting_change: optional US state filter, e.g. MN |
| topic | string | For permitting_change: only bill status changes with this impact tag |
| market | string | For new_deal_in_market: the market/region substring to watch, e.g. columbus |
| states | string | For capacity: comma-separated US states, e.g. "TX, AZ" |
| company | string | For capacity: your human's company |
| markets | string | For capacity: comma-separated markets, e.g. "Dallas, Phoenix" |
| regions | string | For capacity: comma-separated regions from north_america, latin_america, europe, asia_pacific, middle_east_africa (aliases emea, apac, latam, americas) |
| use_case | string | For capacity: what the capacity is for, e.g. "AI inference" |
| countries | string | For capacity: comma-separated countries, e.g. "Germany, Netherlands" |
| max_sites | number | For capacity: how many sites the requirement may be split across, 1-6 |
| target_kw | number | For capacity: capacity needed, in kW (or target_mw, not both) |
| target_mw | number | For capacity: capacity needed, in MW (or target_kw, not both) |
| webhook_url | string | Your public HTTPS webhook endpoint (required for every kind except capacity) |
| accept_terms | boolean | For capacity: true ONLY after your human read and agreed to https://dchub.cloud/listings#terms; otherwise nothing is sent |
| available_by | string | For capacity: needed by this date, YYYY-MM or YYYY-MM-DD |
| min_chunk_kw | number | For capacity: the smallest block worth taking, in kW |
| delivery_type | string | For capacity: land, powered_shell, turnkey or colocation |
| terms_version | string | For capacity: the terms version your human agreed to; omit to send the version currently published |
{
"name": "register_standing_intent",
"title": "Register Standing Intent (webhook push)",
"description": "Use this when the user wants a webhook when data center deals change: Register a STANDING QUERY with webhook push — DC Hub POSTs an HMAC-signed webhook to YOUR https URL whenever matches grow (push, not poll: \"notify my orchestrator on any new deal in Columbus\"). Requires a key. Params: kind (\"new_deal_in_market\" watches deals in the market param · \"news_keyword\" watches news matching q · \"permitting_change\" watches published permitting intel AND bill status changes on data-center bills, optionally per state; scope=records|legislation keeps one, topic narrows to bills with that impact tag), market / q / state (the watch parameter for the chosen kind), webhook_url (your public HTTPS endpoint — private/internal hosts are rejected). Answers \"notify my system whenever a new moratorium appears\", \"push me new matches instead of making me poll\", \"tell my orchestrator when a deal lands in Columbus\". Try: register_standing_intent kind=news_keyword q=moratorium webhook_url=https://hooks.example.com/dchub. kind=\"capacity\" instead registers a standing CAPACITY REQUIREMENT with DC Hub Capacity Source (no webhook_url): target_mw or target_kw, markets / states / regions / countries (comma-separated), optional… For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"kind"
],
"properties": {
"q": {
"type": "string",
"description": "For news_keyword: the keyword/phrase to watch in title+summary, e.g. moratorium"
},
"kind": {
"type": "string",
"description": "Watch kind: \"new_deal_in_market\" | \"news_keyword\" | \"permitting_change\" | \"capacity\" (a Capacity Source requirement, emailed, no webhook)"
},
"name": {
"type": "string",
"description": "For capacity: your human's full name, exactly as given; never invent it"
},
"role": {
"type": "string",
"description": "For capacity: your human's role or title"
},
"notes": {
"type": "string",
"description": "For capacity: anything else about the requirement; leave out anything that identifies your human"
},
"scope": {
"enum": [
"all",
"records",
"legislation"
],
"type": "string",
"description": "For permitting_change: \"records\" (published permitting records), \"legislation\" (bill status changes) or \"all\" (default)"
},
"state": {
"type": "string",
"description": "For permitting_change: optional US state filter, e.g. MN"
},
"topic": {
"enum": [
"tax_incentive",
"large_load_ratepayer",
"water",
"noise",
"siting"
],
"type": "string",
"description": "For permitting_change: only bill status changes with this impact tag"
},
"market": {
"type": "string",
"description": "For new_deal_in_market: the market/region substring to watch, e.g. columbus"
},
"states": {
"type": "string",
"description": "For capacity: comma-separated US states, e.g. \"TX, AZ\""
},
"company": {
"type": "string",
"description": "For capacity: your human's company"
},
"markets": {
"type": "string",
"description": "For capacity: comma-separated markets, e.g. \"Dallas, Phoenix\""
},
"regions": {
"type": "string",
"description": "For capacity: comma-separated regions from north_america, latin_america, europe, asia_pacific, middle_east_africa (aliases emea, apac, latam, americas)"
},
"use_case": {
"type": "string",
"description": "For capacity: what the capacity is for, e.g. \"AI inference\""
},
"countries": {
"type": "string",
"description": "For capacity: comma-separated countries, e.g. \"Germany, Netherlands\""
},
"max_sites": {
"type": "number",
"description": "For capacity: how many sites the requirement may be split across, 1-6"
},
"target_kw": {
"type": "number",
"description": "For capacity: capacity needed, in kW (or target_mw, not both)"
},
"target_mw": {
"type": "number",
"description": "For capacity: capacity needed, in MW (or target_kw, not both)"
},
"webhook_url": {
"type": "string",
"description": "Your public HTTPS webhook endpoint (required for every kind except capacity)"
},
"accept_terms": {
"type": "boolean",
"description": "For capacity: true ONLY after your human read and agreed to https://dchub.cloud/listings#terms; otherwise nothing is sent"
},
"available_by": {
"type": "string",
"description": "For capacity: needed by this date, YYYY-MM or YYYY-MM-DD"
},
"min_chunk_kw": {
"type": "number",
"description": "For capacity: the smallest block worth taking, in kW"
},
"delivery_type": {
"enum": [
"land",
"powered_shell",
"turnkey",
"colocation"
],
"type": "string",
"description": "For capacity: land, powered_shell, turnkey or colocation"
},
"terms_version": {
"type": "string",
"description": "For capacity: the terms version your human agreed to; omit to send the version currently published"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=register_standing_intent",
"readOnlyHint": false,
"openWorldHint": true,
"tier_required": "free_key",
"idempotentHint": false,
"destructiveHint": false
}
}{
"name": "plan_fiber_leadin",
"title": "Plan Fiber Leadin",
"description": "Use this when the user asks how to get diverse fiber into a data center site: plans road-following lead-in routes from a candidate data-center site to a carrier hotel / POP, with indicative build cost and a route-diversity read. Answers \"can I get N diverse fibre routes into this site, how far, how much, and where do they share a corridor?\". Example: plan_fiber_leadin from=\"250 Paringa Road, Murarrie QLD\" to=\"20 Wharf Street, Brisbane City QLD\" n=4. Params: from (lat,lng OR street address), to (lat,lng OR address — e.g. a NextDC/Equinix POP), n (1-6 routes, default 4), fibre (\"720F\"|\"1440F\"), bore_m (river/rail bore length in metres, optional). Returns per-route length_km + GeoJSON geometry, total_route_km, diversity {min_separation_m_midhaul, shared_street_km}, and indicative cost {capex_usd, opex_usd_yr}. INDICATIVE auto-routed road corridors — NOT engineered alignments; subject to survey, DBYD and carrier confirmation. Do NOT use for a single site-suitability score (use analyze_site) or fibre-provider footprints (use get_fiber_intel). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"n": {
"type": "integer",
"maximum": 6,
"minimum": 1,
"description": "Number of diverse routes to plan, 1-6 (default 4)"
},
"to": {
"type": "string",
"description": "Destination carrier hotel/POP as \"lat,lng\" OR an address, e.g. \"20 Wharf Street, Brisbane City QLD\""
},
"from": {
"type": "string",
"description": "Origin site as \"lat,lng\" OR a street address, e.g. \"250 Paringa Road, Murarrie QLD\""
},
"fibre": {
"type": "string",
"description": "Fibre count spec for cost estimate: \"720F\" or \"1440F\""
},
"bore_m": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "River/rail bore length in metres to add to the route, 0-100000 (optional)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "metered",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=plan_fiber_leadin",
"readOnlyHint": true,
"openWorldHint": true,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| Minimum evidence tier a pair must meet to count as viable: "published" | "tracked" | "inferred" (default inferred = include all) |
{
"name": "cluster_sites_by_latency",
"title": "Cluster Sites By Latency",
"description": "Use this when the user asks which data center sites can form a low-latency cluster (2-8 sites) — returns viable low-latency clusters and pairwise RTT floors before any routing work. Use when your human wants to know which of N candidate sites can form a synchronous / low-latency cluster (sync replication, active-active pairs, HPC pods): deterministic pruning BEFORE detailed routing. Per site pair: haversine distance, round-trip physics floor (km × 4.9 µs/km — light in SMF-28 fiber, n≈1.468 — then ×2), estimated real RTT (floor × route_factor 1.4, a stamped inference), viable vs physics_impossible against your budget, and confidence_v — the provenance tier of the supporting evidence (published | tracked | inferred). Also returns clusters: the largest site subsets whose ALL pairwise estimates fit the budget, plus each site's inferred dark-fiber screening level. CANDIDATE CONTRACT: pass candidate_ids (from get_refined_queue) instead of raw coordinates — each resolves to its FROZEN mint coordinates (zero transposition), and cand_… tokens may also be mixed into the sites string; expired/unknown ids are dropped AND declared in candidate_contract (fail-closed). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"sites": {
"type": "string",
"description": "Semicolon-separated \"lat,lon\" pairs, 2-8 sites (same format as compare_sites locations); optional per-site labels via \"lat,lon:label\", e.g. \"39.04,-77.48:ashburn;39.29,-76.61:baltimore\"."
},
"candidate_ids": {
"description": "Array (or comma-separated string) of candidate_id values from get_refined_queue — each resolves to its FROZEN mint coordinates (zero transcription drift); expired/unknown are dropped and declared in candidate_contract."
},
"max_latency_us": {
"type": "number",
"maximum": 10000000,
"minimum": 1,
"description": "Round-trip latency budget in microseconds (default 1000 µs = 1 ms; sync replication is typically 1000-2000 µs)"
},
"min_confidence": {
"type": "string",
"description": "Minimum evidence tier a pair must meet to count as viable: \"published\" | \"tracked\" | \"inferred\" (default inferred = include all)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"problem": "fiber routes, diversity and latency",
"maturity": "mature",
"front_door": "get_fiber_intel",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=cluster_sites_by_latency",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "bind_email",
"title": "Bind Email",
"description": "Use this when the user wants their DC Hub key tied to their email, or a result said an email unlocks more. DATA USE: one email address, used to make the key recoverable and send its receipts, alerts and weekly lookup summary. DC Hub keeps it and never sells it or shares it for anyone else’s use (https://dchub.cloud/privacy). Run only when your human asks; confirm the address with them first. WHAT AN EMAIL KEEPS: the key, with its saved shortlists, alerts and tracked changes (get_changes), for the next chat; fuller grid, queue and market answers; a weekly summary of what your key looked up (unsubscribe anytime); and recovery (recover_my_key re-sends a lost key to that inbox). Ask your human for their email first; pass only an address they typed. ★ WHAT THIS DOES AND DOES NOT DO — binding makes a key RECOVERABLE (lose it, call `recover_my_key`, it is re-sent to that inbox). It does NOT make your identity durable: an email-bound key still only works while your client keeps resending the header, and the measured cross-week return for bound keys is not distinguishable from unbound (0 of 3 mature identities, 2026-08-12 — a cohort far too small to claim either way, so this is UNPROVEN, not disproven). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Your human's real email address (required) — use only an address they explicitly gave and confirmed; placeholder/fake addresses are rejected. DC Hub keeps it and never sells or shares it"
},
"api_key": {
"type": "string",
"description": "Optional key to bind; omit to bind the key already active on this session"
},
"marketing_opt_in": {
"type": "boolean",
"description": "Set true ONLY after your human explicitly agrees to marketing email (default false = transactional only)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free_preview",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=bind_email",
"readOnlyHint": false,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": false,
"destructiveHint": false
}
}| min_mw | number | Browse filter: the size your human needs, in MW (min_kw is the same filter in kW). Matched against what a listing can ACTUALLY deliver, not just its headline total: contiguous_kw is the largest single contiguous block available and… |
| region | string | Browse filter: comma-separated regions from north_america, latin_america, europe, asia_pacific and middle_east_africa; the aliases emea, apac, latam and americas also work, e.g. "europe" or "emea, apac" |
| location | string | Browse filter: comma-separated free text matched against each listing's region, country, state and metro, e.g. "Germany" or "Texas, Phoenix" |
| max_sites | integer | Match mode: how many listings the requirement may be split across. Default one, which allows exact fits only; raise it to allow bundles |
| target_kw | number | Match mode: the whole requirement, in kW (target_mw is the same in MW; give one) |
| target_mw | number | Match mode: the whole requirement, in MW (target_kw is the same in kW; give one). Returns exact fits, bundles and a shortfall instead of teaser cards. Needs a signed-in human |
| available_by | string | Month-granular deadline (YYYY-MM or YYYY-MM-DD; day ignored). Browse keeps listings with some scheduled capacity by that month, not necessarily the full requested amount. |
| min_chunk_kw | number | Match mode: the smallest piece, in kW, your human will contract at any one listing. Default: no minimum |
| delivery_type | string | Browse filter: how the capacity is delivered: land, powered_shell, turnkey or colocation |
| max_providers | integer | Match mode: how many different providers a bundle may use. Default: the same as max_sites |
{
"name": "source_capacity",
"title": "Source Capacity",
"description": "Use this when the user needs data center or colocation capacity to buy or lease: search DC Hub Capacity Source by size (kW or MW) and/or location (a region such as North America or Europe, a country, a state or a metro). Example: \"500 kW anywhere in Europe\" → min_kw=500, region=europe. New data center capacity listings are coming soon: query them with source_capacity, or browse https://dchub.cloud/listings. Size is min_kw (in kW) or min_mw (in MW), matched against what a listing can ACTUALLY deliver, not its headline total: `contiguous_kw` (the largest single contiguous block) and `min_contract_kw` (the smallest chunk the provider will contract); a listing that declares neither is matched on its total. Location is region (a region key or alias) or location (free text matched against each listing's region, country, state and metro); market, state, delivery_type and available_by narrow further. Listings are powered land, powered shells, turnkey capacity and colocation to buy or lease, for enterprise and agent-led procurement. Who sees what, and when, in machine-readable form: https://dchub.cloud/api/v1/listings/terms. For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
],
"description": "One listing: its slug or numeric id exactly as items[].slug / items[].id return it. Omit to browse teaser cards"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1-500; default varies by tool)"
},
"state": {
"type": "string",
"description": "Browse filter: two-letter US state, e.g. \"TX\""
},
"market": {
"type": "string",
"description": "Browse filter: market name as it appears on a listing, e.g. \"Dallas\""
},
"min_kw": {
"type": "number",
"description": "Browse filter: the size your human needs, in kW (min_mw is the same filter in MW). Matched against what a listing can ACTUALLY deliver, not just its headline total: contiguous_kw is the largest single contiguous block available and…"
},
"min_mw": {
"type": "number",
"description": "Browse filter: the size your human needs, in MW (min_kw is the same filter in kW). Matched against what a listing can ACTUALLY deliver, not just its headline total: contiguous_kw is the largest single contiguous block available and…"
},
"region": {
"type": "string",
"description": "Browse filter: comma-separated regions from north_america, latin_america, europe, asia_pacific and middle_east_africa; the aliases emea, apac, latam and americas also work, e.g. \"europe\" or \"emea, apac\""
},
"location": {
"type": "string",
"description": "Browse filter: comma-separated free text matched against each listing's region, country, state and metro, e.g. \"Germany\" or \"Texas, Phoenix\""
},
"max_sites": {
"type": "integer",
"maximum": 6,
"minimum": 1,
"description": "Match mode: how many listings the requirement may be split across. Default one, which allows exact fits only; raise it to allow bundles"
},
"target_kw": {
"type": "number",
"description": "Match mode: the whole requirement, in kW (target_mw is the same in MW; give one)"
},
"target_mw": {
"type": "number",
"description": "Match mode: the whole requirement, in MW (target_kw is the same in kW; give one). Returns exact fits, bundles and a shortfall instead of teaser cards. Needs a signed-in human"
},
"available_by": {
"type": "string",
"description": "Month-granular deadline (YYYY-MM or YYYY-MM-DD; day ignored). Browse keeps listings with some scheduled capacity by that month, not necessarily the full requested amount."
},
"min_chunk_kw": {
"type": "number",
"description": "Match mode: the smallest piece, in kW, your human will contract at any one listing. Default: no minimum"
},
"delivery_type": {
"enum": [
"land",
"powered_shell",
"turnkey",
"colocation"
],
"type": "string",
"description": "Browse filter: how the capacity is delivered: land, powered_shell, turnkey or colocation"
},
"max_providers": {
"type": "integer",
"maximum": 6,
"minimum": 1,
"description": "Match mode: how many different providers a bundle may use. Default: the same as max_sites"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=source_capacity",
"readOnlyHint": true,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": true,
"destructiveHint": false
}
}| Comma-separated US states of interest, e.g. "TX, AZ" |
| company | string | Your human's company. Nothing is sent without it. Sent to the provider with the requirement; confirm it with your human first |
| markets | string | Comma-separated markets of interest, e.g. "Dallas, Phoenix" |
| message | string | A short note from your human for the provider. The deal registration itself carries only the company name and the requirement |
| regions | string | Comma-separated regions of interest from north_america, latin_america, europe, asia_pacific and middle_east_africa (aliases emea, apac, latam, americas), e.g. "europe, apac" |
| timeline | string | When the capacity is needed, e.g. a quarter and year |
| use_case | string | What the capacity is for, e.g. "AI inference" |
| countries | string | Comma-separated countries of interest, e.g. "Germany, Netherlands" |
| capacity_kw | number | Capacity needed, in kW (capacity_mw is the same requirement in MW) |
| capacity_mw | number | Capacity needed, in MW |
| accept_terms | boolean | Set true ONLY after your human has read and agreed to the introduction terms at https://dchub.cloud/listings#terms. Unless it is exactly true, nothing is sent |
| terms_version | string | The terms version your human agreed to, e.g. program.terms.version from source_capacity. Omit to send the version currently published |
{
"name": "request_capacity_intro",
"title": "Request Capacity Intro",
"description": "Use this when the user wants data center capacity behind a Capacity Source listing (pass slug), or first access to capacity matching a requirement (omit slug; pass capacity_mw or capacity_kw, markets, states, regions or countries, and timeline). DATA USE: your human's name, role, company and bound email; DC Hub never sells them, and they go to no one but the provider. Run only when your human asks; confirm their name, company and requirement with them first. DC Hub records the request in its lead register and sends the provider ONLY your human's company name and the requirement. The provider accepts or declines. Only if the provider accepts does DC Hub share the provider's identity, site details and contact with your human, and your human's name, role and email with the provider; on a decline nothing is shared. Needs a key with a bound email and accept_terms=true, set only after your human agrees to the terms at https://dchub.cloud/listings#terms. Returns lead_id; source_capacity with the slug shows the deal status in the disclosure block. Who sees what, and when, in machine-readable form: https://dchub.cloud/api/v1/listings/terms. Do NOT use to save or monitor a site (use save_site / set_site_alert). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Your human's full name. Nothing is sent without it; use only what they gave you, never invent it. The provider sees it only if it accepts the introduction"
},
"role": {
"type": "string",
"description": "Your human's role or title"
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
],
"description": "The listing to register a deal for: its slug or id from source_capacity. Omit to register a standing requirement for upcoming listings instead"
},
"notes": {
"type": "string",
"description": "Anything else the provider should know about the requirement. It travels with the requirement, so leave out anything that identifies your human"
},
"states": {
"type": "string",
"description": "Comma-separated US states of interest, e.g. \"TX, AZ\""
},
"company": {
"type": "string",
"description": "Your human's company. Nothing is sent without it. Sent to the provider with the requirement; confirm it with your human first"
},
"markets": {
"type": "string",
"description": "Comma-separated markets of interest, e.g. \"Dallas, Phoenix\""
},
"message": {
"type": "string",
"description": "A short note from your human for the provider. The deal registration itself carries only the company name and the requirement"
},
"regions": {
"type": "string",
"description": "Comma-separated regions of interest from north_america, latin_america, europe, asia_pacific and middle_east_africa (aliases emea, apac, latam, americas), e.g. \"europe, apac\""
},
"timeline": {
"type": "string",
"description": "When the capacity is needed, e.g. a quarter and year"
},
"use_case": {
"type": "string",
"description": "What the capacity is for, e.g. \"AI inference\""
},
"countries": {
"type": "string",
"description": "Comma-separated countries of interest, e.g. \"Germany, Netherlands\""
},
"capacity_kw": {
"type": "number",
"description": "Capacity needed, in kW (capacity_mw is the same requirement in MW)"
},
"capacity_mw": {
"type": "number",
"description": "Capacity needed, in MW"
},
"accept_terms": {
"type": "boolean",
"description": "Set true ONLY after your human has read and agreed to the introduction terms at https://dchub.cloud/listings#terms. Unless it is exactly true, nothing is sent"
},
"terms_version": {
"type": "string",
"description": "The terms version your human agreed to, e.g. program.terms.version from source_capacity. Omit to send the version currently published"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=request_capacity_intro",
"readOnlyHint": false,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": false,
"destructiveHint": false
}
}| session_id | string | Your session identifier, if any |
| observed_at | string | ISO-8601 time you observed it |
| contact_email | string | Only if your human asked for a reply |
| quoted_fields | any | The exact fields/values you saw (object, list or string); hashed for dedupe |
{
"name": "report_finding",
"title": "Report Finding",
"description": "Use this when DC Hub data looks wrong, missing, stale or contradictory, a tool got in your way, or your human wants something DC Hub doesn't do yet. Files it for the DC Hub team, who review findings daily. Works with or without a key. Quote the exact values you saw. Add contact_email only if your human asked for a reply. Do NOT use for data questions (use execute_plan). For multi-step data center or energy questions, start with execute_plan.",
"inputSchema": {
"type": "object",
"required": [
"class"
],
"properties": {
"args": {
"type": "object",
"description": "The arguments you called the tool with",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"note": {
"type": "string",
"description": "One or two sentences of context"
},
"tool": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "The DC Hub tool or endpoint it is about, e.g. analyze_site (optional for feature_request and coverage_gap)"
},
"class": {
"enum": [
"completeness_contradiction",
"geography_leak",
"as_of_cite_as",
"pro_wall_dead_end",
"count_drift",
"stale_payload_complete",
"leak_past_pro_gate",
"link_hygiene",
"wrong_number",
"missing_data",
"coverage_gap",
"bug",
"feature_request",
"other"
],
"type": "string",
"description": "Finding class: wrong_number (a figure that is wrong), missing_data (a field or record that should be there), coverage_gap (a place or source DC Hub does not cover), bug (a tool errored or behaved wrongly), feature_request (something your…"
},
"region": {
"type": "string",
"maxLength": 120,
"description": "The market, state, ISO or country it is about"
},
"summary": {
"type": "string",
"maxLength": 280,
"minLength": 10,
"description": "One sentence, 10-280 characters: what you saw or what your human wants (required for feature_request, missing_data, other)"
},
"user_goal": {
"type": "string",
"maxLength": 500,
"description": "What your human was trying to do"
},
"recurrence": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "How many times you have seen it (default 1)"
},
"session_id": {
"type": "string",
"description": "Your session identifier, if any"
},
"observed_at": {
"type": "string",
"description": "ISO-8601 time you observed it"
},
"contact_email": {
"type": "string",
"maxLength": 254,
"description": "Only if your human asked for a reply"
},
"quoted_fields": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "array",
"items": {}
},
{
"type": "string"
}
],
"description": "The exact fields/values you saw (object, list or string); hashed for dedupe"
}
}
},
"outputSchema": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"annotations": {
"access": "free",
"maturity": "unknown",
"connect_url": "https://dchub.cloud/connect?ref=mcp-tools-list&tool=report_finding",
"readOnlyHint": false,
"openWorldHint": false,
"tier_required": "anonymous",
"idempotentHint": false,
"destructiveHint": false
}
}