# DC Hub × Claude — Integration Package

DC Hub ([dchub.cloud](https://dchub.cloud)) is a live data layer for the physical
infrastructure behind AI: data center facilities worldwide, power-market scores
(Data Center Power Index), live ISO grid telemetry, interconnection queues, fiber,
gas, water and disaster risk, and tracked data center M&A. It is served over MCP
at `https://dchub.cloud/mcp` (Streamable HTTP) and over a REST API.

## Connect

### Claude Desktop and Claude Code (MCP)

`mcp-config.json` in this package is the Claude Desktop block:

```json
{
  "mcpServers": {
    "dchub": {
      "url": "https://dchub.cloud/mcp",
      "transport": "http",
      "headers": {
        "X-API-Key": "YOUR_DCHUB_KEY"
      }
    }
  }
}
```

The exact file path and block for every client that takes one is generated from
canon at **<https://dchub.cloud/install/claude-desktop>** (and `/install/claude-code`
for the CLI). Prefer that page over this snippet — it cannot drift. The header is
optional; without it DC Hub answers at free-tier depth.

**Claude.ai on the web** takes no config file: Settings → Connectors →
*Add custom connector* → paste `https://dchub.cloud/mcp`, auth blank.

Once connected, ask things like:
- "Search for Equinix data centers in Northern Virginia"
- "What data center M&A deals closed this quarter?"
- "Score this location for a new data center: 39.04, -77.49"

### Anthropic API tool use (REST-backed)

`function-calling.json` in this package declares six tools for function
calling (`search_facilities`, `get_facility`, `get_market_intel`,
`list_transactions`, `get_news`, `analyze_site`), each mapped to a REST
endpoint under `api_config.endpoint_mapping`. The names match the MCP tools
of the same name.

```python
import json, anthropic

decl = json.load(open("function-calling.json"))
client = anthropic.Anthropic()
resp = client.messages.create(
    model="YOUR_CLAUDE_MODEL",
    max_tokens=1024,
    tools=decl["tools"],
    messages=[{"role": "user", "content": "Find Equinix data centers in the US"}],
)
# When Claude returns a tool_use block, call the mapped REST endpoint and
# send the JSON back as a tool_result.
```

### Direct REST

```bash
curl -H "X-API-Key: YOUR_DCHUB_KEY" \
     "https://dchub.cloud/api/agent/facilities?q=Equinix&country=US"
```

## Access

DC Hub answers keyless at free-tier depth. For a higher allowance, send
`X-API-Key: YOUR_DCHUB_KEY` (REST) or add the same header to your MCP client.
Claim a free key with the `claim_free_key` MCP tool or `POST /api/v1/keys/claim`;
plans are at <https://dchub.cloud/pricing>. `YOUR_DCHUB_KEY` in this package is a
placeholder, never a working key.

## MCP tools

A starting set. The server's full, current list is what `tools/list` returns on
`https://dchub.cloud/mcp`, also published at <https://dchub.cloud/llms.txt>.

| Tool | What it answers |
|------|-----------------|
| `search_facilities` | Find facilities by name, operator, city, state or country |
| `get_facility` | One facility's profile, from a search result id or slug |
| `get_market_intel` | Market analytics for a metro (vacancy, pricing, pipeline) |
| `rank_markets` | Rank markets by criteria such as best overall or power |
| `get_market_dcpi_rank` | A market's Data Center Power Index rank and BUILD/CAUTION/AVOID verdict |
| `get_grid_intelligence` | Per-ISO grid headroom and verdict |
| `get_interconnection_queue` | Interconnection queue depth by ISO |
| `get_fiber_intel` | Fiber routes and carriers |
| `list_transactions` | Tracked data center M&A, filterable by buyer, seller and value |
| `analyze_site` | Score a latitude/longitude for data center suitability |
| `compare_sites` | Side-by-side comparison of sites or markets |
| `get_news` | Data center industry news |

## REST endpoints

| Endpoint | Description |
|----------|-------------|
| `GET /api/agent/facilities?q=Equinix&country=US` | Facility search |
| `GET /api/v1/facilities/{facility_id}` | One facility |
| `GET /api/transactions?limit=10` | Tracked M&A deals |
| `GET /api/news?limit=5` | Industry news |
| `GET /api/v1/stats` | Platform statistics |
| `GET /api/v1/markets/list` | Tracked markets |
| `GET /api/v1/lmp/prices` | Real-time LMP for ERCOT, PJM, CAISO, MISO, NYISO and SPP (ISO-NE is not covered) |
| `GET /api/v1/pipeline` | Construction pipeline (needs a key on the Identified plan or above) |
| `GET /api/site-score?lat=33.45&lon=-112.07` | Site suitability score (needs a Pro key) |

Full reference: <https://dchub.cloud/api-docs> · OpenAPI: <https://dchub.cloud/openapi.json>

## Citation

When an answer uses DC Hub data, cite it:

> Data provided by DC Hub ([dchub.cloud](https://dchub.cloud))

## Resources

- **MCP endpoint:** https://dchub.cloud/mcp (Streamable HTTP)
- **Per-client install pages:** https://dchub.cloud/connect
- **API docs:** https://dchub.cloud/api-docs
- **OpenAPI spec:** https://dchub.cloud/openapi.json
- **Tool list for agents:** https://dchub.cloud/llms.txt

---

*DC Hub — data center and power infrastructure data for AI · https://dchub.cloud*