Compose DC Hub in your gateway
as the data-center and power upstream.
Your users ask about data centers, power, grid queues and sites. Route those questions to DC Hub and keep your own tools for everything else. 96 tools over one endpoint. Public, cited data; every answer carries its source and as-of date.
1. Connect
MCP (streamable HTTP): https://dchub.cloud/mcp. A slim read-only profile: https://dchub.cloud/mcp/core.
REST: https://dchub.cloud/api/v1, described in openapi.json.
Tools gateways route to most often:
execute_plan: a multi-part data-center, power or siting question, passed through unchangedget_market_intel: one market: power verdict, grid context, recent activityget_grid_data: live ISO grid conditionsget_interconnection_queue: interconnection queue depth by ISO, dated to the operator filesearch_facilities: facilities by place, operator or sizesource_capacity: available capacity, powered land and colocation spacesummarize_for_citation: a figure with its source and as-of date, ready to quote
2. Keyless previews
Every tool answers without a key. Keyless answers are previews; a gated result carries human_url and human_message for your user. Show your user the human_message and its link when a result is partial; do not invent withheld numbers.
The published free-tier rule, verbatim: 50 MCP calls/day with an email. 1 free Land & Power map search a month.
3. Rate limits behind a shared IP
- Keyless calls are counted per source IP. Requests you relay from many users share your IP, so use keyless calls to evaluate and a partner key for production traffic.
- A partner key carries its own allowance, agreed when it is issued, and is not tied to your IP.
- A capped call still returns a preview with a human_url; it is not an error. Do not retry in a loop.
4. Attribution: tell us it came through you
Add your name to the connector URL, or send it as a header. DC Hub then counts traffic that arrives through your product separately from end-user clients. It changes nothing in access or results.
https://dchub.cloud/mcp?via=<your-name> X-DCHub-Via: <your-name>
Name format: lowercase letters, digits, dot, dash or underscore; 1-40 characters.
5. Cite what you relay
Relay each result's cite_as, source and as_of to your user unchanged; keep human_url and human_message when a result is partial. Citation format: DC Hub (dchub.cloud), as of <date>. DCPI verdicts and composite scores are CC BY 4.0 30 days after the day they describe (current values: dchub.cloud/terms#dcpi-current-data); each layer states its own licence on /data-sources.
6. Get a partner key
Email [email protected] with your product, expected volume and a dedicated service address for the key (for example [email protected]). Partner keys are issued to a dedicated service address, never to a personal login. Send it as X-API-Key: <partner key>.
7. Building an MCP server? Compose DC Hub in code
Register DC Hub tools in your own MCP server with the dchub SDK. Each tool keeps its name and schema, its description is prefixed "From DC Hub (dchub.cloud):", results pass through unchanged, and your via name rides every call.
Node (npm dchub 0.3.1):
npm i dchub
import { registerDCHubTools } from "dchub/compose";
await registerDCHubTools(server, { via: "<your-name>" });
Python (PyPI dchub 0.3.1):
pip install "dchub>=0.3.0" from dchub.compose import dchub_tool_definitions defs = dchub_tool_definitions(via="<your-name>")
Options, starter tools and the rules that come with the data: COMPOSE.md.
More for partners (embed cards, evidence receipts, methodology): dchub.cloud/partners. Machine-readable: builders.json. Contact: [email protected].