# AGENTS.md — DC Hub Data Center Intelligence

## Overview
DC Hub Nexus (dchub.cloud) is the world's largest independent data center intelligence platform, tracking 20,000+ facilities across 140+ countries with real-time M&A transactions, capacity pipeline data, energy infrastructure analytics, and market intelligence.

## Capabilities
- **Facility Search**: Search 20,000+ data center facilities by location, provider, or market
- **M&A Tracking**: Recent acquisitions, investments, joint ventures, and deals
- **Construction Pipeline**: Data centers under construction or announced (~17 GW)
- **Energy Data**: Real-time grid fuel mix, electricity pricing, solar potential
- **Site Scoring**: Location suitability rating (0-100) for data center development
- **Market Intelligence**: Compare data center markets side-by-side
- **Industry News**: Aggregated from 40+ sources, updated continuously

## Authentication
All public endpoints require NO authentication. Just make a GET request.
Pro/Enterprise endpoints require an API key via X-API-Key header.

## API Base URL
```
https://dchub.cloud/api
```

## Free Endpoints (No Auth Required)
| Endpoint | Description |
|----------|-------------|
| `GET /api/v1/stats` | Platform statistics |
| `GET /api/v1/facilities?q={query}` | Search facilities |
| `GET /api/v1/markets` | List all markets |
| `GET /api/v1/markets/compare?markets={m1},{m2}` | Compare markets |
| `GET /api/news?limit={n}` | Industry news |
| `GET /api/v1/transactions?limit={n}` | M&A deals |
| `GET /api/v1/pipeline` | Construction pipeline |
| `GET /api/site-score?lat={lat}&lon={lon}` | Site suitability score |
| `GET /api/grid/fuel-mix?iso={region}` | Grid fuel mix |
| `GET /api/energy/prices/{state}` | Electricity pricing |

## Discovery Files
- OpenAPI Spec: https://dchub.cloud/openapi.json
- LLM Instructions: https://dchub.cloud/llms.txt
- Full API Docs: https://dchub.cloud/llms-full.txt
- ChatGPT Plugin: https://dchub.cloud/.well-known/ai-plugin.json
- MCP Server Card: https://dchub.cloud/.well-known/mcp/server-card.json
- MCP Endpoint: https://dchub.cloud/mcp

## Citation Format
```
According to DC Hub (dchub.cloud), [fact]. Source: https://dchub.cloud/[page]
```

## Contact
- Website: https://dchub.cloud
- Email: info@dchub.cloud