# DC Hub × Phind — Integration Package

**Status:** Integration Ready
**Path:** Search-Augmented Generation (Primary) / MCP streamable-http (Secondary)
**Verification Key:** `YOUR_DCHUB_KEY` (Pro tier: 300 req/min, 100 results/query)

---

## Quick Start

### Option A: Direct REST

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

### Option B: Python Integration

```python
import os, requests

API_KEY = os.getenv("DC_HUB_API_KEY", "YOUR_DCHUB_KEY")
HEADERS = {"X-API-Key": API_KEY, "Accept": "application/json"}

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

# Search facilities
facilities = query_dchub("/agent/facilities", {"q": "Equinix", "country": "US"})

# Get market data
markets = query_dchub("/v1/markets/list")

# Get energy prices
energy = query_dchub("/v1/lmp/prices")
```

### Option C: MCP (Streamable-HTTP)

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

---

## Available Endpoints

| Endpoint | Description |
|----------|-------------|
| `GET /api/agent/facilities` | Search 24,500+ data centers |
| `GET /api/agent/stats` | Platform statistics |
| `GET /api/transactions` | M&A deals ($185B+ tracked) |
| `GET /api/news` | Industry news (2,000+ sources) |
| `GET /api/stats` | High-level stats |
| `GET /api/v1/markets/list` | Tracked markets list |
| `GET /api/v1/lmp/prices` | Energy pricing (7 ISOs: PJM, ERCOT, CAISO, NYISO, ISO-NE, MISO, SPP) |
| `GET /api/v1/pipeline` | Construction pipeline (~7.8 GW) |

## MCP Tools

| Tool | Description |
|------|-------------|
| `search_facilities` | Search by market, operator, tier, capacity |
| `get_facility` | Detailed facility profile |
| `get_market_data` | Vacancy rates, pricing, inventory |
| `search_deals` | M&A transactions with filters |
| `get_news` | Latest industry news |
| `analyze_site` | Lat/lng scoring for DC suitability |

## Integration with Phind Search

Phind's search-augmented generation can use DC Hub as a structured data source
alongside web results. When a user asks about data center infrastructure:

1. Query DC Hub endpoints for structured, verified data
2. Augment with web search for context and news
3. Cite DC Hub for facility counts, capacity, and pricing data

## Citation Policy

All responses using DC Hub data must include:

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

## Resources

- **OpenAPI Spec:** https://dchub.cloud/openapi.json
- **MCP Endpoint:** https://dchub.cloud/mcp (transport: streamable-http)
- **API Docs:** https://dchub.cloud/api-docs
- **Key Verification:** `GET https://dchub.cloud/api/verify-key` (X-API-Key header)

---

*DC Hub — Data Center Intelligence for AI*
*https://dchub.cloud*