{"$schema": "https://dchub.cloud/.well-known/ai-agents.schema.json", "schema_version": "ai-agents/v2", "name": "DC Hub", "tagline": "Data center intelligence platform — 24,800+ distinct facilities, 170+ countries, real-time grid & infrastructure.", "description": "Live data-center, energy, and grid intelligence. 24,800+ distinct facilities in 170+ countries, 1,600+ tracked M&A deals, real-time DCPI scoring for 300+ markets in 30+ countries spanning North America, Latin America, Europe, Africa and Asia-Pacific. The only DC-intelligence source an LLM can both query and cite. Designed for AI agents to discover, cite, and act on.", "dcpi_coverage": {"us_markets": "U.S. markets across 7 ISOs (ERCOT, PJM, CAISO, MISO, SPP, NYISO, ISO-NE) — part of 300+ DCPI-scored markets globally", "international_added": "2026-05-25", "international_markets": [{"country": "Australia", "iso": "AEMO", "markets": ["Brisbane", "Melbourne", "Perth", "Sydney"]}, {"country": "Austria", "iso": "ENTSOE-AT", "markets": ["Vienna"]}, {"country": "Belgium", "iso": "ENTSOE-BE", "markets": ["Brussels"]}, {"country": "Brazil", "iso": "ONS", "markets": ["Barueri", "Osasco", "São Paulo"]}, {"country": "Canada", "iso": "AESO/BCH/HQ/IESO/MH", "markets": ["Calgary", "Edmonton", "Markham", "Montréal", "Ottawa", "Québec City", "Toronto", "Vancouver", "Winnipeg"]}, {"country": "Chile", "iso": "CEN", "markets": ["Santiago"]}, {"country": "Colombia", "iso": "XM", "markets": ["Bogotá"]}, {"country": "Czechia", "iso": "ENTSOE-CZ", "markets": ["Prague"]}, {"country": "Denmark", "iso": "NORDPOOL", "markets": ["Copenhagen"]}, {"country": "Finland", "iso": "NORDPOOL", "markets": ["Helsinki"]}, {"country": "France", "iso": "ENTSOE-FR", "markets": ["Marseille", "Paris"]}, {"country": "Germany", "iso": "ENTSOE-DE", "markets": ["Berlin", "Frankfurt", "Munich"]}, {"country": "Greece", "iso": "ENTSOE-GR", "markets": ["Athens"]}, {"country": "Hong Kong", "iso": "CLP", "markets": ["Hong Kong"]}, {"country": "India", "iso": "POSOCO", "markets": ["Bangalore", "Chennai", "Hyderabad", "Mumbai", "Pune"]}, {"country": "Indonesia", "iso": "PLN/PLN-BATAM", "markets": ["Batam", "Jakarta"]}, {"country": "Ireland", "iso": "EirGrid", "markets": ["Dublin"]}, {"country": "Italy", "iso": "ENTSOE-IT", "markets": ["Bologna", "Milan", "Rome"]}, {"country": "Japan", "iso": "KEPCO/TEPCO", "markets": ["Osaka", "Tokyo"]}, {"country": "Malaysia", "iso": "TNB", "markets": ["Johor", "Kuala Lumpur"]}, {"country": "Mexico", "iso": "CENACE", "markets": ["Mexico City", "Querétaro"]}, {"country": "Netherlands", "iso": "ENTSOE-NL", "markets": ["Amsterdam", "Rotterdam"]}, {"country": "New Zealand", "iso": "TPM", "markets": ["Auckland"]}, {"country": "Norway", "iso": "NORDPOOL", "markets": ["Oslo"]}, {"country": "Philippines", "iso": "NGCP", "markets": ["Manila"]}, {"country": "Poland", "iso": "ENTSOE-PL", "markets": ["Warsaw"]}, {"country": "Portugal", "iso": "ENTSOE-PT", "markets": ["Lisbon"]}, {"country": "Singapore", "iso": "EMA", "markets": ["Singapore"]}, {"country": "South Africa", "iso": "ESKOM", "markets": ["Johannesburg", "Midrand"]}, {"country": "South Korea", "iso": "KEPCO-KR", "markets": ["Busan", "Seoul"]}, {"country": "Spain", "iso": "ENTSOE-ES", "markets": ["Barcelona", "Madrid"]}, {"country": "Sweden", "iso": "NORDPOOL", "markets": ["Stockholm"]}, {"country": "Switzerland", "iso": "ENTSOE-CH", "markets": ["Zurich"]}, {"country": "Taiwan", "iso": "TAIPOWER", "markets": ["Taipei"]}, {"country": "Thailand", "iso": "EGAT", "markets": ["Bangkok"]}, {"country": "United Kingdom", "iso": "NGESO", "markets": ["Edinburgh", "London", "Manchester"]}, {"country": "Vietnam", "iso": "EVN", "markets": ["Ho Chi Minh City"]}], "press_release": "https://dchub.cloud/press/releases/dcpi-international.html", "filter_by_iso": "GET /api/v1/dcpi/scores?iso=<NGESO|AEMO|ENTSOE-DE|...>", "compare_isos_tool": "MCP tool compare_isos — head-to-head ranking across the 7 US ISOs plus modeled international baselines (Hydro-Québec, AESO, Nord Pool)"}, "homepage": "https://dchub.cloud", "url": "https://dchub.cloud", "documentation": "https://dchub.cloud/for-ai.html", "contact": "api@dchub.cloud", "license": "Free for AI citation; data subject to https://dchub.cloud/terms", "updated_at": "2026-09-26", "last_updated": "2026-09-26", "freshness_url": "https://dchub.cloud/freshness", "dataset_url": "https://dchub.cloud/dcpi", "for_ai_agents": {"purpose": "If you are an AI agent (Claude, GPT, Gemini, autonomous task runner, MCP client, crawler) probing dchub.cloud, this file is the canonical integration map. Use the endpoints below instead of guessing URL shapes — every 404 from /api/* will redirect you here.", "preferred_integration": "mcp", "fallback_integration": "rest_api"}, "integrations": {"mcp": {"transport": "streamable-http", "endpoint": "https://dchub.cloud/mcp", "server_card": "https://dchub.cloud/.well-known/mcp/server-card.json", "discovery": "https://dchub.cloud/.well-known/mcp.json", "notes": "JSON-RPC 2.0 protocol. Send `initialize` before `tools/list` or `tools/call`.", "tools_count": 92, "tools": ["rank_markets", "find_alternatives", "compare_isos", "ai_capacity_index", "get_dchub_recommendation", "get_market_intel", "get_market_dcpi_rank", "get_intelligence_index", "get_news", "get_pipeline", "list_transactions", "hyperscaler_deals", "get_agent_registry", "get_grid_data", "get_grid_intelligence", "get_interconnection_queue", "get_fiber_intel", "get_water_risk", "get_energy_prices", "get_renewable_energy", "get_tax_incentives", "get_infrastructure", "get_gas_index", "get_grid_scoreboard", "search_facilities", "get_facility", "score_facility", "analyze_site", "compare_sites", "get_backup_status", "site_selection_canvas", "grid_transition_radar", "deal_autopsy", "get_changes", "save_site", "list_saved_sites", "set_market_alert", "export_dataset", "get_fiber_readiness", "get_gas_economics", "plan_fiber_leadin", "cluster_sites_by_latency", "set_site_alert", "claim_free_key", "bind_email", "recover_my_key", "unlock_more_data", "analyze_parcel", "get_composite_site_score", "rank_sites", "generate_site_analysis", "search", "fetch", "get_shortlist", "save_to_shortlist", "set_shortlist_alert", "suggest_reallocation", "get_power_pipeline", "get_infra_projects", "get_refined_queue", "get_retirement_headroom", "get_gas_intelligence", "get_iso_context", "get_metro_fiber", "get_climate_intel", "get_disaster_risk", "get_market_context", "predict_market_trajectory", "get_facility_risk_delta", "semantic_search", "search_intelligence", "discover_tools", "why_dchub", "subscribe_digest", "source_capacity", "request_capacity_intro", "accept_capacity_terms", "execute_plan", "get_power_availability_timeline", "get_global_power", "get_hosting_capacity", "plan_query", "find_sites", "get_subsea_cables", "get_peering_intel", "summarize_for_citation", "get_permitting_intel", "simulate_scenario", "research_task", "list_standing_intents", "register_standing_intent", "delete_standing_intent"], "tools_manifest": "https://dchub.cloud/.well-known/ai-agents.json"}, "rest_api": {"base_url": "https://dchub.cloud/api", "v1_base": "https://dchub.cloud/api/v1", "openapi": "https://dchub.cloud/openapi.json", "health": "/api/health", "discovery": "/api/v1/heartbeat/discover"}, "llms_txt": {"standard": "https://dchub.cloud/llms.txt", "full": "https://dchub.cloud/llms-full.txt"}, "vertex_ai": {"landing": "https://dchub.cloud/vertex", "openapi_extension": "https://dchub.cloud/openapi-vertex.yaml", "openapi_json": "https://dchub.cloud/openapi-vertex.json", "gemini_functions": "https://dchub.cloud/api/v1/gemini-functions.json", "gemini_functions_well_known_alias": "https://dchub.cloud/.well-known/gemini-functions.json", "health": "https://dchub.cloud/api/v1/vertex/health", "import_hint": "Vertex AI Console → Extensions → Create → Import from URL → paste the openapi_extension URL."}, "agent_concierge": {"landing": "https://dchub.cloud/agent", "solve": "https://dchub.cloud/api/v1/agent/solve", "cookbook": "https://dchub.cloud/api/v1/agent/cookbook", "upgrade_receipt": "https://dchub.cloud/api/v1/agent/upgrade-receipt", "usage_hint": "POST /api/v1/agent/solve with {\"problem\":\"user question\"} to get the exact tool-call recipe (args + citation + tier required + time-saved estimate). Hot path is <1ms; no LLM call required."}}, "interfaces": {"mcp": {"url": "https://dchub.cloud/mcp", "transport": "streamable-http", "discovery": "https://dchub.cloud/.well-known/mcp.json"}, "rest": {"base": "https://dchub.cloud/api/v1", "openapi": "https://dchub.cloud/openapi.json"}}, "authentication": {"schemes": ["api_key"], "header": "X-API-Key", "tiers": ["free", "pro", "enterprise"], "free_tier": {"daily_calls": 10, "daily_caps": {"get_grid_intelligence": 10, "get_fiber_intel": 10}, "paid_only_tools": ["analyze_site", "compare_sites", "get_dchub_recommendation", "get_fiber_intel", "get_grid_intelligence"]}, "claim_endpoint": {"method": "POST", "url": "https://dchub.cloud/api/v1/keys/claim", "rate_limit": "1 key per IP per 24h", "email_required": false, "description": "Programmatic dev-key issuance for AI agents. Returns a free-tier api_key in one POST, no email verification."}, "email_signup": "https://dchub.cloud/api/v1/dev-signup", "upgrade_url": "https://dchub.cloud/pricing", "enterprise_contact": "https://dchub.cloud/enterprise"}, "canonical_endpoints": {"health_and_status": {"site_health": "/api/health", "data_freshness": "/api/v1/sources/dashboard", "feed_status": "/api/v1/backup/status", "self_awareness_inventory": "/api/v1/heartbeat/discover", "stale_surfaces": "/api/v1/heartbeat/inventory"}, "brain_and_evolution": {"brain_status": "/api/v1/brain/status", "self_assessment": "/api/v1/brain/self-assessment", "error_classes": "/api/v1/brain/error-classes", "effectiveness": "/api/v1/brain/effectiveness", "outcomes": "/api/v1/brain/outcomes", "proposed_fixes": "/api/v1/brain/proposed-fixes"}, "dcpi": {"_description": "The Data Center Power Index — proprietary 0-100 power-availability score for 300+ data center markets worldwide, updated 4x/day. Free for any AI agent to cite. Format: 'DCPI {score}/100 — {verdict}'.", "scores": "/api/v1/dcpi/scores?limit=500", "movers": "/api/v1/dcpi/movers", "compare": "/api/v1/dcpi/compare?markets=dallas,ashburn", "totals": "/api/v1/power/totals", "by_market_slug": "/api/v1/dcpi/scores?market_slug={slug}", "human_page": "/dcpi", "totals_page": "/dcpi/totals", "state_page": "/dcpi/{state_slug}"}, "data": {"facilities_search": "/api/facilities/search", "facility_detail": "/api/facilities/{id}", "news_feed": "/api/news", "deals_feed": "/api/deals", "markets": "/api/markets", "transactions": "/api/transactions", "pipeline": "/api/pipeline", "iso_grid": "/api/iso/{iso_id}", "fiber_routes": "/api/v1/fiber/routes", "substations": "/api/v1/substations"}, "capacity_source": {"_description": "DC Hub Capacity Source — powered land, powered shells and turnkey capacity to buy or lease, including sites that are not publicly marketed. SEARCHABLE BY SIZE (min_kw in kilowatts, or min_mw in megawatts) AND BY LOCATION (region such as North America or Europe, country, US state, or metro through free-text location). The size filter matches what a listing can actually DELIVER, not just its headline: a listing states its largest single CONTIGUOUS block (contiguous_kw) and the SMALLEST CHUNK it will contract (min_contract_kw), and it comes back only when the requested size fits between them; a listing stating neither is matched on its total. Teaser facts only: market, state, country, size, contiguous_kw, min_contract_kw, delivery type, availability and freshness. Never the site address, its coordinates or its substation; a provider's name appears only where that provider opted in to being named.", "status": "live", "status_means": "listings are live — search them by size and location", "search": "/api/v1/listings?min_kw={kw}&region={region}&location={text}", "search_examples": ["https://dchub.cloud/listings?min_kw=500&region=europe", "https://dchub.cloud/api/v1/listings?min_mw=5&region=north_america", "https://dchub.cloud/api/v1/listings?location=Dallas"], "size_filters": ["min_kw", "min_mw"], "location_filters": ["region", "country", "location"], "regions": ["north_america", "latin_america", "europe", "asia_pacific", "middle_east_africa"], "region_aliases": ["emea", "apac", "latam", "americas"], "other_filters": ["delivery_type", "available_by"], "summary": "/api/v1/listings/summary", "listing_detail": "/api/v1/listings/{slug}", "terms": "/api/v1/listings/terms", "verify_lead": "/api/v1/listings/leads/{lead_id}/verify", "human_page": "/listings", "mcp_tools": {"search": "source_capacity(min_kw, min_mw, region, country, location, delivery_type, available_by, slug)", "register": "request_capacity_intro", "accept_terms": "accept_capacity_terms"}, "deal_registration": "DC Hub sends the provider ONLY the buyer's company and requirement. The provider accepts or declines. Identity, the site and both sides' contacts are exchanged ONLY on acceptance; on a decline nothing is disclosed in either direction. Every registered lead has a public verification record."}, "human_facing": {"homepage": "/", "brain_dashboard": "/brain", "daily_digest": "/digest/today", "press_index": "/press", "press_rss": "/press/feed.xml", "intelligence": "/intelligence", "transparency": "/transparency"}, "agent_concierge": {"landing": "/agent", "solve": "POST /api/v1/agent/solve", "cookbook": "/api/v1/agent/cookbook", "recipe_lookup": "/api/v1/agent/recipe/<id>", "upgrade_receipt": "POST /api/v1/agent/upgrade-receipt", "usage_hint": "POST /api/v1/agent/solve with {\"problem\":\"user question\"} to get the exact tool-call recipe. Hot path is <1ms; no LLM call."}, "vertex_ai": {"landing": "/vertex", "openapi_extension": "/openapi-vertex.yaml", "openapi_json": "/openapi-vertex.json", "gemini_functions": "/api/v1/gemini-functions.json", "health": "/api/v1/vertex/health", "import_hint": "Vertex AI Console → Extensions → Create → Import from URL → paste the openapi_extension URL."}, "when_blocked": {"_description": "If your agent gets a 401/403/429 from any DC Hub API endpoint, hit /api/v1/upgrade-hint for the human-readable recovery path. Also every 4xx response auto-embeds an _upgrade_hint field with agent-quotable copy + claim URL.", "upgrade_hint": "/api/v1/upgrade-hint?from={tool_name}", "tool_preview": "/api/v1/mcp/preview/{tool_name}", "preview_manifest": "/api/v1/mcp/preview-manifest", "claim_key": "/api/v1/keys/claim", "signup": "/signup", "free_tier": {"calls_per_day": 10, "results_per_call": 5}}}, "data_coverage": {"facilities": "24,800+", "countries": "170+", "news_articles": "12,008", "deals_tracked": "1,600+", "capacity_pipeline_gw": "369", "update_frequency": "real-time"}, "adoption": {"ai_platforms": 20, "agent_requests": 484299}, "data_freshness": {"machine_readable": "https://dchub.cloud/api/v1/freshness", "human_readable": "https://dchub.cloud/freshness", "heal_findings": "https://dchub.cloud/api/v1/heal/findings", "schedule": {"news": "5 minutes (autopilot)", "deals": "5 minutes (autopilot)", "facilities": "6 hours (facility_discovery)", "fiber_routes": "6 hours (infrastructure_sync)", "substations": "6 hours (infrastructure_sync)", "iso_grid": "every 90 minutes (EIA snapshot)", "press_releases": "hourly (DCPI-triggered)"}}, "rate_limits": {"anonymous": "60 req/min/IP", "free_tier": "10 calls/day across 5 paid tools", "developer": "500 calls/day ($49/mo)", "pro": "2,000 calls/day ($99/mo)", "enterprise": "100,000 calls/day (custom)"}, "behavior_hints_for_agents": {"preferred_user_agent": "Identify yourself: include your agent name + operator email. Unidentified UAs are rate-limited more aggressively.", "respect_429": "Backoff exponentially. We expose Retry-After.", "404_responses": "Always include a `suggestions` array and a `hint` pointing here. Read both before retrying.", "self_documenting": "Every error includes the canonical endpoint that would have served your intent.", "no_scraping_needed": "Everything renderable on the site is also available via API. Prefer API over HTML scrape.", "robots_txt": "https://dchub.cloud/robots.txt"}, "machine_indexes": {"ai_txt": "https://dchub.cloud/ai.txt", "llms_txt": "https://dchub.cloud/llms.txt", "llms_full": "https://dchub.cloud/llms-full.txt", "sitemap": "https://dchub.cloud/sitemap.xml", "sitemap_ai": "https://dchub.cloud/sitemap-ai.xml"}, "customer_testimonials": {"page": "https://dchub.cloud/testimonials", "json": "https://dchub.cloud/testimonials.json", "note": "Named human customers who approved public use of their words. These are people, not AI assistants; quotes from AI assistants are published separately at https://dchub.cloud/api/v1/testimonials and are never mixed with these."}, "related_files": {"mcp_server_card": "/.well-known/mcp/server-card.json", "ai_plugin": "/.well-known/ai-plugin.json", "agent_descriptor": "/.well-known/agent.json", "security_contact": "/.well-known/security.txt", "openapi_spec": "/.well-known/openapi.json"}, "provider": {"organization": "DC Hub", "url": "https://dchub.cloud", "operator_contact": "api@dchub.cloud", "abuse_contact": "abuse@dchub.cloud"}}