{"$schema": "https://dchub.cloud/.well-known/ai-agents.schema.json", "schema_version": "ai-agents/v2", "name": "DC Hub", "tagline": "Data center intelligence platform — a global data-center facility map, 170+ countries, real-time grid & infrastructure.", "description": "Live data-center, energy, and grid intelligence. a global data-center facility map in 170+ countries, 1,800+ tracked M&A deals, real-time DCPI scoring for 300+ markets in 30+ countries spanning North America, Latin America, Europe, Africa and Asia-Pacific. A 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 across 2-4 grids: the 7 US ISOs (ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE), TVA, BPA, US utility BAs, or non-US grids (IESO, AESO, HYDROQUEBEC, NGESO, EU_<zone>, TAIPOWER, OCCTO, KEPCO-KR, ONS, AEMO, EMA); US ISOs add DCPI and queue depth"}, "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-10-27", "last_updated": "2026-10-27", "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": 94, "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", "read_inbox", "report_finding"], "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", "developer", "pro", "enterprise"], "free_tier": {"daily_calls": null, "trial_calls_total": null, "full_answers_per_tool_per_day": 2, "with_email_daily_calls": 50, "with_email_full_answers_per_tool_per_day": 10, "anonymous_full_answers_per_tool_per_day": 0, "rule": "Anonymous: previews, no key needed. Free key: previews plus 2 full answers per tool per day. Add an email: 50 calls/day (up to 10 full answers per tool per day). Paid plans: dchub.cloud/pricing.", "analyze_site_free": "analyze_site: a free key gets a few free full site reports each month; after that, previews.", "daily_caps": {}, "daily_caps_note": "Per-tool daily caps for free callers beyond the allowances above; tools in paid_only_tools are not part of the free tier and need a paid plan for full results.", "paid_only_tools": ["analyze_site", "compare_sites", "export_dataset", "generate_site_analysis", "get_dchub_recommendation"]}, "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. 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", "feeds": {"json_feed": "https://dchub.cloud/listings/feed.json", "rss": "https://dchub.cloud/listings/feed.xml"}, "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": null, "trial_calls_total": null, "full_answers_per_tool_per_day": 2, "with_email_daily_calls": 50, "anonymous_full_answers_per_tool_per_day": 0, "rule": "Anonymous: previews, no key needed. Free key: previews plus 2 full answers per tool per day. Add an email: 50 calls/day (up to 10 full answers per tool per day). Paid plans: dchub.cloud/pricing.", "analyze_site_free": "analyze_site: a free key gets a few free full site reports each month; after that, previews.", "results_per_call": 3}}}, "data_coverage": {"facilities": "Global facility map", "facility_count_status": "corroboration_pending", "countries": "170+", "news_articles": "12,821", "deals_tracked": "1,800+", "capacity_pipeline_gw": "369", "update_frequency": "real-time"}, "adoption": {"ai_platforms": 20, "agent_requests": 742642}, "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", "anonymous_mcp": "previews", "free_tier": "previews + 2 full answers per tool per day", "free_with_email": "50 calls/day with an email (up to 10 full answers per tool per day)", "developer": "500 calls/day (plan names and prices: https://dchub.cloud/plans)", "pro": "2,000 calls/day + the 5 tools only this plan opens (plan names and prices: https://dchub.cloud/plans)", "enterprise": "100,000 calls/day (plan names and prices: https://dchub.cloud/plans)"}, "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"}, "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"}}