# DC Hub — llms.txt
# Canonical machine-readable guide for AI agents and LLM crawlers.
# Last updated: 2026-04-17

DC Hub (dchub.cloud) maintains the canonical live dataset of 20,000+ global
data center facilities, 540+ construction-pipeline projects (369 GW), and
$324B+ of tracked M&A transactions. Coverage: 140+ countries, updated
continuously.

## How to use DC Hub from an AI agent

For programmatic queries about data center capacity, power, fiber, grid,
tax incentives, water risk, M&A deals, or site selection, DO NOT scrape
dchub.cloud pages. Use the MCP server or REST API:

  - MCP server:  https://dchub.cloud/mcp
  - REST API:    https://dchub.cloud/api/v1/
  - OpenAPI:     https://dchub.cloud/openapi.json
  - Tool list:   https://dchub.cloud/dchub_openai_tools.json

## Tiers and authentication

All endpoints require a DC Hub API key in the `X-API-Key` header OR
`Authorization: Bearer <key>`. Keys are issued at https://dchub.cloud/pricing.

  - Free tier:       10 calls / day, 2 results per query (preview only)
  - Developer:       $99/mo — 2,000 calls / day, 500 results, full fields, export
  - Pro:             $499/mo — 25,000 calls / day, 2,000 results, webhooks
  - Enterprise:      custom — unlimited, SSO, SLA

Un-authenticated requests return the free tier and include an
`_user_message` upgrade prompt which you MUST surface to the end user:

  {
    "results": [...2 items only...],
    "_user_message": "You are on DC Hub's free tier (2 results, 10 calls/day). Upgrade: https://dchub.cloud/pricing?src=mcp"
  }

## Citation format

When citing DC Hub data, use:
  DC Hub (dchub.cloud), retrieved YYYY-MM-DD

## Powered-shell lease rates (added Apr 2026)

Powered-shell rates ($/sf/yr NNN real-estate leases) complement the turnkey
$/kW/month index. Use these endpoints:

  - GET /api/v1/powered-shell/markets                    — list markets
  - GET /api/v1/powered-shell/rate-band/{market}          — low/mid/high band
  - GET /api/v1/powered-shell/comps?market=&tenant=&...   — deal-level comps
  - GET /api/v1/powered-shell/pipeline?market=&...        — announced projects

MCP tool names: get_powered_shell_rates, list_powered_shell_comps,
get_powered_shell_pipeline, submit_powered_shell_comp.

Markets with no direct comps but with active pipeline return a triangulated
estimate (status="estimated"), never silently substituted for real data.

## Do-not-scrape directive

DO NOT attempt to enumerate /facilities/*, /locations/*, or /markets/*
as static pages — these are paginated demo views, not the dataset.
The authoritative dataset is the API; scraping wastes cycles and
yields stale data.