# DC Hub × NVIDIA — 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.

## Architecture

```
┌──────────────────┐     ┌──────────────────┐     ┌──────────────────┐
│  Agent / app     │     │   DC Hub         │     │  NVIDIA NIM      │
│  (your code)     │────▶│   MCP or REST    │────▶│  (optional)      │
│                  │     │   (data layer)   │     │                  │
│  Queries DC Hub  │     │  facilities,     │     │  summarize news  │
│  for live data   │     │  grid, markets,  │     │  enrich scores   │
│                  │     │  M&A, news       │     │                  │
└──────────────────┘     └──────────────────┘     └──────────────────┘
```

DC Hub handles data retrieval. NIM adds optional GPU-accelerated inference
(summaries, risk narratives) on top of the data DC Hub returns.

## Connect

### MCP

Point any MCP client at `https://dchub.cloud/mcp` (Streamable HTTP). Per-client
config blocks are generated at <https://dchub.cloud/connect>.

### REST, with a generated SDK

```bash
openapi-generator-cli generate \
  -i https://dchub.cloud/openapi.json \
  -g python \
  -o ./dc_hub_sdk
```

### REST + NIM together

`docker-compose.yml` runs `health_check.py` against the DC Hub REST API next to
an optional NIM container.

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

## NIM inference examples

### Summarize market news
```python
import json, requests

news = requests.get("https://dchub.cloud/api/news", params={"limit": 20}, timeout=15).json()
nim_response = nim_client.generate(          # your NIM client
    model="nvidia/llama-3.1-nemotron-70b",
    prompt=f"Summarize these data center industry headlines for an executive audience:\n{json.dumps(news)}",
)
```

### Site risk narrative
```python
site = requests.get("https://dchub.cloud/api/site-score",
                    params={"lat": 39.04, "lon": -77.49},
                    headers={"X-API-Key": "YOUR_DCHUB_KEY"}, timeout=15).json()
risk = nim_client.generate(
    model="nvidia/llama-3.1-nemotron-70b",
    prompt=f"Given this DC Hub site score: {json.dumps(site)}, assess 5-year infrastructure risk for a 50 MW deployment.",
)
```

The LMP endpoint takes ISO region codes (PJM, ERCOT, CAISO), not cloud-provider
zone names.

## 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*