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

### Function calling (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.

### MCP

> **This platform is not an MCP client.** It has no field for a custom MCP
> server, so no config block applies here.
>
> **Install:** reach DC Hub over the REST API —
> `curl https://dchub.cloud/api/agent/facilities?q=Equinix&country=US`
> (keyless at free-tier depth; send `X-API-Key` for a higher allowance).
> Full reference: <https://dchub.cloud/api-docs>
>
> Clients that *do* take an MCP config file, each generated from canon:
> [Claude Desktop](https://dchub.cloud/install/claude-desktop) ·
> [Claude Code](https://dchub.cloud/install/claude-code) ·
> [Cursor](https://dchub.cloud/install/cursor) ·
> [Cline](https://dchub.cloud/install/cline) ·
> [VS Code](https://dchub.cloud/install/vscode) ·
> [Windsurf](https://dchub.cloud/install/windsurf) ·
> [Gemini CLI](https://dchub.cloud/install/gemini-cli) ·
> [Antigravity](https://dchub.cloud/install/antigravity)

### Direct REST

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

```python
import os, requests

API_KEY = os.getenv("DC_HUB_API_KEY")          # optional; keyless works at free-tier depth
HEADERS = {"Accept": "application/json", **({"X-API-Key": API_KEY} if API_KEY else {})}

def query_dchub(path, params=None):
    r = requests.get(f"https://dchub.cloud/api{path}",
                     headers=HEADERS, params=params, timeout=15)
    r.raise_for_status()
    return r.json()

facilities = query_dchub("/agent/facilities", {"q": "Equinix", "country": "US"})
deals = query_dchub("/transactions", {"limit": 10})
lmp = query_dchub("/v1/lmp/prices")
```

## Using DC Hub alongside search

When a question is about data center infrastructure:

1. Query DC Hub for structured facts
2. Use web search for context and news
3. Cite DC Hub for the capacity, pricing and deal figures it returned

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