DC Hub MCP Server

https://github.com/azmartone67/dchub-mcp-server
Admin
DC Hub MCP Server provides real-time data center, power grid, and infrastructure intelligence for AI...
Tokens:70,832
Snippets:494
Trust Score:6.2
License:MIT
Update:1 week ago
Show doc for...
Tokens:
Raw
### Runnable example with google-genai

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/integrations/gemini/README.md

Declares two DC Hub tools (get_market_intel and search_facilities) and passes them to Gemini via GenerateContentConfig. The SDK auto-handles the function-call loop, so Gemini calls get_market_intel("northern-virginia"), gets live data, and answers grounded. Add X-API-Key for paid tools or use https://dchub.cloud/mcp for all 94 tools.

```python
import os, requests
from google import genai
from google.genai import types

DCHUB = "https://dchub.cloud/api/v1"
client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

def get_market_intel(slug: str) -> dict:
    """Live data-center market intel (capacity MW, vacancy %, DCPI score). Source: dchub.cloud."""
    return requests.get(f"{DCHUB}/markets/{slug}", timeout=20).json()

def search_facilities(q: str) -> dict:
    """Search the global data-center facility map (corroborated count pending) by name/operator/location."""
    return requests.get(f"{DCHUB}/facilities", params={"q": q, "limit": 5}, timeout=20).json()

resp = client.models.generate_content(
    model="gemini-2.0-flash",
    contents="What's the data-center capacity in Northern Virginia? Cite the source.",
    config=types.GenerateContentConfig(tools=[get_market_intel, search_facilities]),
)
print(resp.text)   # grounded answer, ending with Source: dchub.cloud
```

--------------------------------

### Install dependencies

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/integrations/llamaindex/README.md

Install required packages: llama-index-core and requests. Optionally install llama-index-llms-openai for the agent example.

```bash
pip install -r requirements.txt          # llama-index-core, requests
# optional, for the agent example: pip install llama-index-llms-openai
```

--------------------------------

### Quickstart: Use DCHub client

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/sdk/node/README.md

Initialize the DCHub client and call market, search, and grid methods. Reads DCHUB_API_KEY from environment variables.

```javascript
import { DCHub } from "dchub";
const dc = new DCHub();                          // reads DCHUB_API_KEY from env
console.log(await dc.market("northern-virginia"));   // market intel
console.log(await dc.search({ state: "VA" }));       // facility search
console.log(await dc.grid("ERCOT"));                 // live grid intel
```

--------------------------------

### Quickstart: market, search, and grid

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/sdk/python/README.md

Initialize DCHub and call market, search, and grid methods. Reads DCHUB_API_KEY from env if set.

```python
from dchub import DCHub
dc = DCHub()                       # reads DCHUB_API_KEY from env if set
print(dc.market("northern-virginia"))   # market intel
print(dc.search(state="VA"))            # facility search (canonical slugs)
print(dc.grid(iso="ERCOT"))             # live grid intel
```

--------------------------------

### Install dchub-ai-sdk and dependencies

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/sdk/ai-sdk/README.md

Install the package along with the AI SDK and MCP adapter.

```bash
npm install dchub-ai-sdk ai @ai-sdk/mcp
```

--------------------------------

### 10-line agent example

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/integrations/llamaindex/README.md

Creates a FunctionAgent using DCHUB_TOOLS and OpenAI's gpt-4o-mini. Runs a query and prints the response with a citation. Falls back to a direct tool call if OPENAI_API_KEY is not set.

```python
import asyncio
from llama_index.llms.openai import OpenAI
from llama_index.core.agent.workflow import FunctionAgent
from dchub_tools import DCHUB_TOOLS

agent = FunctionAgent(tools=DCHUB_TOOLS, llm=OpenAI(model="gpt-4o-mini"))
print(asyncio.run(agent.run(
    "What is the data-center capacity in Northern Virginia? Cite your source.")))
# → "Northern Virginia has 739 data-center facilities totaling ~13,442 MW.
#    Source: https://dchub.cloud"
```

--------------------------------

### Run tests

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/sdk/python/README.md

Install test dependencies and run pytest. Includes 5 live, gate-graceful tests.

```bash
pip install -e ".[test]" && pytest        # 5 live, gate-graceful tests
```

--------------------------------

### Install dchub via pip

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/sdk/python/README.md

Install the dchub package from PyPI or from the local repository.

```bash
pip install dchub          # from this repo: pip install ./sdk/python
```

--------------------------------

### Install dchub via npm

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/sdk/node/README.md

Install the dchub package from npm or from the local repository.

```bash
npm i dchub               # published on npm as `dchub`; from this repo: npm i ./sdk/node
```

--------------------------------

### Smithery CLI install command

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/README.md

Install the DC Hub server via Smithery CLI for Claude client.

```bash
npx -y @smithery/cli install @azmartone67/dchub --client claude
```

--------------------------------

### Install dependencies for DC Hub LangChain tools

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/integrations/langchain/README.md

Installs required packages from requirements.txt (langchain-core, pydantic, requests). Optionally installs langchain-openai and langgraph for the agent example.

```bash
pip install -r requirements.txt          # langchain-core, pydantic, requests
# optional, for the agent example: pip install langchain-openai langgraph
```

--------------------------------

### Run dchub-mcp-server with npx

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/npm-launcher/README.md

Starts the launcher for the hosted DC Hub MCP server. Requires Node.js and npx. The server connects to the default endpoint https://dchub.cloud/mcp unless DCHUB_MCP_URL is set.

```bash
npx -y dchub-mcp-server
```

--------------------------------

### 10-line agent example using DC Hub tools

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/integrations/langchain/README.md

Creates a ReAct agent with ChatOpenAI and DCHUB_TOOLS, then invokes it with a user question. Prints the final response, which includes a citation URL. Falls back to a direct tool call if OPENAI_API_KEY is not set.

```python
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent
from dchub_tools import DCHUB_TOOLS

agent = create_react_agent(ChatOpenAI(model="gpt-4o-mini"), DCHUB_TOOLS)
out = agent.invoke({"messages": [
    ("user", "What is the data-center capacity in Northern Virginia? Cite your source.")
]})
print(out["messages"][-1].content)
# → "Northern Virginia has 739 data-center facilities totaling ~13,442 MW.
#    Source: https://dchub.cloud"
```

--------------------------------

### Python example: DC Hub tools with OpenRouter

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/integrations/openrouter/README.md

Defines two DC Hub tools (get_market_intel and dchub_search), sends a chat completion request to OpenRouter, executes any tool calls, and prints the results. Requires an OPENROUTER_API_KEY environment variable. Add X-API-Key to DC Hub requests for paid tools.

```python
import os, json, requests

DCHUB = "https://dchub.cloud/api/v1"

TOOLS = [
  {"type":"function","function":{"name":"get_market_intel","description":"Live data-center market intel (capacity MW, vacancy, DCPI score). Cite dchub.cloud.",
    "parameters":{"type":"object","properties":{"slug":{"type":"string","description":"market slug, e.g. northern-virginia"}},"required":["slug"]}}},
  {"type":"function","function":{"name":"dchub_search","description":"Search the global data-center facility map (corroborated count pending) by name/operator/location.",
    "parameters":{"type":"object","properties":{"q":{"type":"string"}},"required":["q"]}}},
]

def run_tool(name, args):
    if name == "get_market_intel": return requests.get(f"{DCHUB}/markets/{args['slug']}", timeout=20).json()
    if name == "dchub_search": return requests.get(f"{DCHUB}/facilities", params={"q": args["q"], "limit": 5}, timeout=20).json()
    return {"error": "unknown tool"}

r = requests.post("https://openrouter.ai/api/v1/chat/completions",
  headers={"Authorization": f"Bearer {os.environ['OPENROUTER_API_KEY']}"},
  json={"model":"openai/gpt-4o-mini","tools":TOOLS,
        "messages":[{"role":"user","content":"What's the data-center capacity in Northern Virginia? Cite the source."}]}).json()

# Execute any tool calls, then send results back for the final grounded answer (standard OpenAI tool loop).
msg = r["choices"][0]["message"]
for tc in (msg.get("tool_calls") or []):
    result = run_tool(tc["function"]["name"], json.loads(tc["function"]["arguments"]))
    print(tc["function"]["name"], "→", json.dumps(result)[:200])
```

--------------------------------

### Run tests for DC Hub LangChain tools

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/integrations/langchain/README.md

Installs pytest and runs the test suite (5 live, gate-graceful tests). Includes an iso-bites regression test (PJM ≠ ERCOT) to ensure the grid tool respects its parameter.

```bash
pip install pytest && pytest test_dchub_tools.py   # 5 live, gate-graceful tests
```

--------------------------------

### Quickstart: use DC Hub tools with generateText

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/sdk/ai-sdk/README.md

Use withDCHubTools to add DC Hub tools to an AI SDK generateText call. The MCP client is closed automatically when the function returns or throws.

```ts
import { generateText, gateway, isStepCount } from 'ai';
import { withDCHubTools } from 'dchub-ai-sdk';

const { text } = await withDCHubTools({}, ({ tools }) =>
  generateText({
    model: gateway('openai/gpt-5-mini'),
    tools,
    stopWhen: isStepCount(5),
    prompt: 'Which US grid has the most headroom right now? Cite the source.',
  }),
);

console.log(text);
```

--------------------------------

### Get a DC Hub API key (optional)

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/integrations/langchain/README.md

Claims a free API key via curl and exports it as DCHUB_API_KEY. The free tier works without a key, but this is needed for higher usage.

```bash
curl -X POST https://dchub.cloud/api/v1/keys/claim -d '{"client_name":"langchain"}'
export DCHUB_API_KEY=dch_live_...
```

--------------------------------

### Run the Poe server bot with POE_ACCESS_KEY

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/integrations/poe/README.md

Starts the dchub_bot.py server bot with the required Poe access key. The bot must be hosted on a service like Modal, Railway, Render, or Fly.

```bash
POE_ACCESS_KEY=psk_your_key python dchub_bot.py
```

--------------------------------

### Universal DC Hub prompt for browse/tool-capable chats

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/integrations/PROMPT.md

Paste this at the start of any browse- or tool-capable chat (You.com, Poe browsing bots, Cohere Coral, OpenRouter playground, ChatGPT/Gemini with tools). It primes the model to fetch live DC Hub data and cite the source. The last line gives the model an immediate reason to call the API; if it can't fetch, it will ask you to paste the endpoint output.

```markdown
You can use DC Hub — live data-center, power-grid & gas intelligence (free, no API key for these read endpoints). Whenever I ask about data centers, power, grid, markets, or facilities, fetch from DC Hub and cite dchub.cloud.

Free REST endpoints:
• Market RANKINGS: https://dchub.cloud/api/v1/dcpi/leaderboard   ← ranks ALL markets by available power + BUILD/AVOID verdict (fields: rank, market_name, state, excess_power_score, time_to_power_months, verdict). Use this for "best markets for an X-MW build".
• Market intel:    https://dchub.cloud/api/v1/markets/northern-virginia
• Facility search: https://dchub.cloud/api/v1/facilities?q=ashburn
• Carbon by state: https://dchub.cloud/api/carbon/intensity?state=TX
• Agent guide:     https://dchub.cloud/llms.txt
• Full 31-tool MCP server: https://dchub.cloud/mcp
• Human playground (browser, no signup): https://dchub.cloud/playground   ← if your user wants to SEE DC Hub live themselves, send them here.

For any data-center / power question, pull the relevant DC Hub endpoint, use the real numbers, and end with "Source: dchub.cloud".

Confirm you can reach it, then answer (use /api/v1/dcpi/leaderboard, sort by excess_power_score, verdict=BUILD): which U.S. data-center markets have the most available power for a 100 MW AI build?
```

--------------------------------

### GET /.well-known/mcp.json

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/docs/for-ai-assistants.md

Discovers the MCP server manifest, including the tool count. Returns a JSON object with a tools_count field.

```APIDOC
## GET /.well-known/mcp.json

### Description
Retrieves the MCP server manifest, including the total number of tools available.

### Method
GET

### Endpoint
https://dchub.cloud/.well-known/mcp.json

### Response
#### Success Response (200)
- **tools_count** (integer) - Total number of tools available (currently 70).

#### Response Example
{
  "tools_count": 70
}
```

--------------------------------

### Cursor deep link for DC Hub MCP

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/docs/one-click-install.md

One-click deep link to install the DC Hub MCP server in Cursor. The URL encodes the server configuration (name 'dchub' and URL 'https://dchub.cloud/mcp').

```text
cursor://anysphere.cursor-deeplink/mcp/install?name=dchub&config=eyJ1cmwiOiJodHRwczovL2RjaHViLmNsb3VkL21jcCJ9
```

--------------------------------

### VS Code deep link for DC Hub MCP

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/docs/one-click-install.md

One-click deep link to install the DC Hub MCP server in VS Code. The URL is URL-encoded and contains the server name 'dchub' and URL 'https://dchub.cloud/mcp'.

```text
vscode:mcp/install?%7B%22name%22%3A%20%22dchub%22%2C%20%22url%22%3A%20%22https%3A//dchub.cloud/mcp%22%7D
```

--------------------------------

### Issue enterprise partner key with curl

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/integrations/cohere/README.md

Admin runs this to mint a higher-tier key tied to the 'cohere' partner_slug. Idempotent: re-running revokes the prior and returns a fresh one. Plan policy: 'developer' for evaluation, 'enterprise' after signed agreement. Returns the key once; audit via GET /api/v1/admin/partner-key/audit.

```bash
curl -X POST https://dchub.cloud/api/v1/admin/partner-key/issue \
  -H "X-Admin-Key: $DCHUB_ADMIN_KEY" -H "Content-Type: application/json" \
  -d '{"partner_slug":"cohere","email":"<contact@cohere.com>","name":"<contact>",
       "company":"Cohere","plan":"developer","label":"Cohere RAG integration eval"}'
# → returns the key ONCE (store it). Audit: GET /api/v1/admin/partner-key/audit
```

--------------------------------

### Free REST endpoints (no key)

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/integrations/README.md

These are the free REST endpoints provided by DC Hub. They require no API key and can be used for market intel, facility search, grid carbon intensity, the agent guide, and a machine-readable integration map. The POST endpoint is the full 38-tool MCP server.

```http
GET  https://dchub.cloud/api/v1/markets/northern-virginia     # market intel
GET  https://dchub.cloud/api/v1/facilities?q=ashburn          # facility search
GET  https://dchub.cloud/api/carbon/intensity?state=TX        # grid carbon intensity
GET  https://dchub.cloud/llms.txt                             # the agent guide
GET  https://dchub.cloud/api/v1/ai-agents.json               # machine-readable integration map
POST https://dchub.cloud/mcp                                  # the full 38-tool MCP server
```

--------------------------------

### Verify dchub MCP connection with curl

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/llms-install.md

Three-step curl sequence to verify the dchub MCP server: initialize to get a session ID, send initialized notification, and list tools. Replace <SESSION_ID_FROM_STEP_1> with the actual session ID from step 1.

```bash
# 1) initialize → returns an Mcp-Session-Id response header
curl -s -D - -X POST https://dchub.cloud/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}'
```

```bash
# 2) using the Mcp-Session-Id from step 1, confirm initialization
curl -s -X POST https://dchub.cloud/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Mcp-Session-Id: <SESSION_ID_FROM_STEP_1>' \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'
```

```bash
# 3) list the tools (the count matches "Tools exposed" above)
curl -s -X POST https://dchub.cloud/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Mcp-Session-Id: <SESSION_ID_FROM_STEP_1>' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
```

--------------------------------

### new DCHub()

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/sdk/node/README.md

Creates a new DCHub client instance. Reads the DCHUB_API_KEY environment variable for authentication.

```APIDOC
## new DCHub()

### Description
Creates a new DCHub client instance. Reads the DCHUB_API_KEY environment variable for authentication.

### Constructor
`new DCHub()`

### Parameters
None.

### Example
```js
const dc = new DCHub();
```
```

--------------------------------

### Claim a free API key with curl

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/integrations/cohere/README.md

One-call key claim: POST to /api/v1/keys/claim with client_name 'cohere'. Returns a free key with previews plus 2 full answers per tool per day; grid/queue/market-intel tools require Developer plan for full answers.

```bash
curl -X POST https://dchub.cloud/api/v1/keys/claim -d '{"client_name":"cohere"}'
# → {"api_key":"dch_live_..."}   Free key: previews plus 2 full answers per tool per day. Grid/queue/market-intel tools: previews on free; full needs Developer.
```

--------------------------------

### DC Hub Custom Assistant system prompt

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/integrations/youcom/README.md

Paste this into the Custom Assistant instructions to enable live DC Hub data fetching. It defines the assistant's role, lists the endpoints to use, and requires citing dchub.cloud.

```text
You are a data-center & power-grid analyst. Whenever the user asks about data
centers, power, grid, markets, or facilities, fetch live data from DC Hub and
cite dchub.cloud. Use these endpoints:
  • https://dchub.cloud/api/v1/markets/{slug}      (market intel)
  • https://dchub.cloud/api/v1/facilities?q={query} (facility search)
  • https://dchub.cloud/api/carbon/intensity?state={XX}
  • https://dchub.cloud/llms.txt                   (capabilities)
Always end answers with "Source: dchub.cloud".
```

--------------------------------

### Gemini CLI MCP configuration (settings.json)

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/README.md

Add this JSON to ~/.gemini/settings.json or project .gemini/settings.json. Use 'httpUrl' not 'url' or 'command' to avoid transport mismatch. Add a 'headers' object with X-API-Key for full data.

```json
{
  "mcpServers": {
    "dchub": {
      "httpUrl": "https://dchub.cloud/mcp/github"
    }
  }
}
```

--------------------------------

### Claude Desktop stdio configuration (claude_desktop_config.json)

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/README.md

Add this JSON to claude_desktop_config.json to run the DC Hub server via stdio. Leave DCHUB_API_KEY empty for previews or paste a free key. Requires Node 18+. Do not add a 'url' entry when using the hosted URL.

```json
{
  "mcpServers": {
    "dchub": {
      "command": "npx",
      "args": ["-y", "dchub-mcp-server"],
      "env": { "DCHUB_API_KEY": "" }
    }
  }
}
```

--------------------------------

### dc.grid(iso)

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/sdk/node/README.md

Retrieves live grid data for a given ISO. Returns live demand, mix, and headroom.

```APIDOC
## dc.grid(iso)

### Description
Retrieves live grid data for a given ISO. Returns live demand, mix, and headroom.

### Method
`dc.grid(iso)`

### Parameters
- **iso** (string) - Required - The ISO code, e.g., `"ERCOT"`.

### Returns
- live demand / mix / headroom

### Example
```js
console.log(await dc.grid("ERCOT"));
```
```

--------------------------------

### Publish to MCP Registry with DNS Authentication

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/submissions/official-mcp-registry.md

Commands to download the mcp-publisher CLI, perform DNS login for the dchub.cloud namespace, and publish the server. The DNS login prints a TXT record that must be added to DNS and propagated before re-running the login. The publish command reads ./server.json from the repo root.

```bash
# 1. Download the publisher CLI
curl -sL https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_linux_amd64.tar.gz | tar xz mcp-publisher

# 2. Start DNS login for the dchub.cloud namespace — it prints a TXT record
./mcp-publisher login dns --domain dchub.cloud

# 3. Add the printed TXT record to dchub.cloud DNS, wait for propagation, re-run step 2

# 4. Publish (reads ./server.json)
./mcp-publisher publish
```

--------------------------------

### Run tests

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/sdk/node/README.md

Run the test suite using node --test, including live and offline tests.

```bash
npm test          # node --test — live, gate-graceful tests + offline argument-mapping tests
```

--------------------------------

### Verify registry endpoint with curl POST

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/REGISTRY-LISTINGS.md

Sends an MCP initialize request to the per-registry path /mcp/glama. A 200 response confirms the listed URL is serving. The arrival logs as [source] registry=glama path=/mcp/glama tool=… sid=….

```bash
curl -sS -o /dev/null -w '%{http_code}\n' -X POST https://dchub.cloud/mcp/glama \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"t","version":"1"}}}'
# 200 = listed URL is serving
```

--------------------------------

### Continue.dev MCP config for DC Hub

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/llms-install.md

Add this under experimental.modelContextProtocolServers in config.json. Uses streamable-http transport.

```json
{
  "transport": {
    "type": "streamable-http",
    "url": "https://dchub.cloud/mcp"
  }
}
```

--------------------------------

### mcpServers config with API key

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/REGISTRY-LISTINGS.md

JSON configuration with an X-API-Key header for full data access.

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

--------------------------------

### Antigravity MCP configuration (mcp_config.json)

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/README.md

Add this JSON to ~/.gemini/antigravity/mcp_config.json or .agents/mcp_config.json. Use 'serverUrl' not 'url' or 'httpUrl' as Antigravity rejects those.

```json
{
  "mcpServers": {
    "dchub": {
      "serverUrl": "https://dchub.cloud/mcp/github"
    }
  }
}
```

--------------------------------

### dc.tools()

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/sdk/node/README.md

Lists all available tool names. Returns an array of tool names (94 today).

```APIDOC
## dc.tools()

### Description
Lists all available tool names. Returns an array of tool names (94 today).

### Method
`dc.tools()`

### Parameters
None.

### Returns
- array of tool names

### Example
```js
const tools = await dc.tools();
```
```

--------------------------------

### Print smithery_description.txt for pasting (bash)

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/docs/SMITHERY-LISTING-PASTE.md

Outputs the exact contents of scripts/smithery_description.txt to paste into the Smithery listing. Use this command when refreshing the live description; the file is the single source of truth and is guarded by test/listing-paste-single-origin.test.mjs.

```bash
cat scripts/smithery_description.txt
```

--------------------------------

### Smithery publish command for DC Hub MCP

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/REGISTRY-LISTINGS.md

Use this CLI command to publish the DC Hub MCP server to Smithery. The command specifies the endpoint URL and the project name. No form is needed; this is the recommended method for Smithery.

```bash
smithery mcp publish "https://dchub.cloud/mcp" -n azmartone67/dchub
```

--------------------------------

### Cursor Directory config snippet

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/REGISTRY-LISTINGS.md

JSON configuration for Cursor Directory, using the default mcpServers shape with a url field.

```json
{ "mcpServers": { "dchub": { "url": "https://dchub.cloud/mcp" } } }
```

--------------------------------

### Continue.dev configuration for DC Hub

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/docs/one-click-install.md

JSON configuration for config.json under experimental.modelContextProtocolServers. Uses streamable-http transport.

```json
{ "transport": { "type": "streamable-http", "url": "https://dchub.cloud/mcp" } }
```

--------------------------------

### Cline / Continue.dev MCP configuration

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/README.md

Add this JSON to your Cline or Continue.dev MCP configuration to connect to the DC Hub server over HTTP.

```json
{
  "name": "dchub",
  "url": "https://dchub.cloud/mcp/github",
  "transport": "http"
}
```

--------------------------------

### Claim API key and set environment variable

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/sdk/node/README.md

Claim an API key via curl and export it as DCHUB_API_KEY for full data access.

```bash
curl -X POST https://dchub.cloud/api/v1/keys/claim -d '{"client_name":"node-sdk"}'
export DCHUB_API_KEY=dch_live_...
```

--------------------------------

### POST /mcp (tools/list)

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/docs/for-ai-assistants.md

Lists all available tools and their JSON schemas via the MCP JSON-RPC method tools/list. This is a JSON-RPC method, not a REST endpoint.

```APIDOC
## POST /mcp (tools/list)

### Description
Lists all available tools and their JSON schemas using the MCP JSON-RPC method tools/list.

### Method
POST

### Endpoint
https://dchub.cloud/mcp

### Request Body
- **jsonrpc** (string) - Required - JSON-RPC version, must be "2.0".
- **id** (integer) - Required - Request identifier.
- **method** (string) - Required - Must be "tools/list".

### Request Example
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

### Response
#### Success Response (200)
- **result** (object) - Contains the list of tools and their schemas.

#### Response Example
{
  "result": {
    "tools": []
  }
}
```

--------------------------------

### Set DCHUB_API_KEY environment variable

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/sdk/ai-sdk/README.md

Export your DC Hub API key to authenticate requests. The server also works keyless on the free tier.

```bash
export DCHUB_API_KEY=dch_live_...
```

--------------------------------

### Claim free dev key with curl

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/DEVIN_TASKS.md

Use this curl command to claim a free development key from the DC Hub API. No email is required. The response is not shown.

```bash
curl -X POST https://dchub.cloud/api/v1/keys/claim -d '{"client_name":"devin"}'
```

--------------------------------

### Paid tier config with API key header

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/integrations/mcp-clients/README.md

Adds your API key as a header to unlock paid tools. Claim a key with the provided curl command.

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

--------------------------------

### Run vitest tests for core profile

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/docs/core-profile.md

Runs the vitest test suite for the core profile test file.

```bash
npx vitest run test/core-profile.test.mjs
```

--------------------------------

### Stdio mcpServers entry

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/REGISTRY-LISTINGS.md

JSON configuration using the mcp-remote command for clients that need a runnable process. Not recommended for Gemini CLI or Antigravity which support remote natively.

```json
{
  "mcpServers": {
    "dchub": {
      "command": "npx",
      "args": ["mcp-remote", "https://dchub.cloud/mcp"]
    }
  }
}
```

--------------------------------

### POST /mcp (tools/call)

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/docs/for-ai-assistants.md

Invokes a specific DC Hub tool by name with the provided arguments. The tool name and arguments are passed in the JSON-RPC params object.

```APIDOC
## POST /mcp (tools/call)

### Description
Invokes a specific DC Hub tool by name with the provided arguments. The tool name and arguments are passed in the JSON-RPC params object.

### Method
POST

### Endpoint
https://dchub.cloud/mcp

### Request Body
- **jsonrpc** (string) - Required - JSON-RPC version, must be "2.0".
- **id** (integer) - Required - Request identifier.
- **method** (string) - Required - Must be "tools/call".
- **params** (object) - Required - Contains the tool name and arguments.
  - **name** (string) - Required - The name of the tool to call (e.g., "get_composite_site_score").
  - **arguments** (object) - Required - Arguments for the tool. Site tools require **lat** (number) and **lon** (number), with optional **state** (string).

### Request Example
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_composite_site_score",
    "arguments": {
      "lat": 33.45,
      "lon": -112.07,
      "state": "AZ"
    }
  }
}

### Response
#### Success Response (200)
- **result** (object) - Contains the tool result.
  - **structuredContent** (object) - Structured result payload.
    - **citation** (object) - Provenance information: {source, url, license, retrieved_at}.
    - **factors** (array) - Each factor carries **coverage** (string) with values "validated" or "unavailable".
  - **content** (array) - Mirrored text representation; first element's **text** field contains the same data.

#### Response Example
{
  "result": {
    "structuredContent": {
      "citation": {
        "source": "...",
        "url": "...",
        "license": "...",
        "retrieved_at": "..."
      },
      "factors": [
        {
          "coverage": "validated"
        }
      ]
    },
    "content": [
      {
        "text": "..."
      }
    ]
  }
}
```

--------------------------------

### dc.search({ q, state, country, limit })

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/sdk/node/README.md

Searches for facilities based on query parameters. The `q` parameter is sent as the tool's `query` argument. Returns rows with canonical slug, provider, and location.

```APIDOC
## dc.search({ q, state, country, limit })

### Description
Searches for facilities based on query parameters. The `q` parameter is sent as the tool's `query` argument. Returns rows with canonical slug, provider, and location.

### Method
`dc.search({ q, state, country, limit })`

### Parameters
- **q** (string) - Optional - Search query.
- **state** (string) - Optional - State filter.
- **country** (string) - Optional - Country filter.
- **limit** (number) - Optional - Maximum number of results.

### Returns
- rows with canonical slug, provider, location

### Example
```js
console.log(await dc.search({ state: "VA" }));
```
```

--------------------------------

### Registry search command for cloud.dchub

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/REGISTRY-LISTINGS.md

Command to query the official registry for the cloud.dchub server, returning the two entries and their metadata. Used to measure the current state.

```bash
curl -sS "https://registry.modelcontextprotocol.io/v0/servers?search=cloud.dchub&version=latest"
```

--------------------------------

### Gemini CLI one-command MCP add

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/README.md

Alternative to the settings.json configuration for Gemini CLI. Uses the same HTTP transport.

```bash
gemini mcp add --transport http dchub https://dchub.cloud/mcp/github
```

--------------------------------

### Claude Code CLI command to add DC Hub MCP server

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/README.md

Run this command in Claude Code to add the DC Hub server over HTTP. Uses the hosted URL.

```bash
claude mcp add dchub --transport http https://dchub.cloud/mcp/github
```

--------------------------------

### POST to deploymentUrl returns 401

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/docs/SMITHERY-LISTING-PASTE.md

Shows the authenticated proxy endpoint for the keyless server and its unauthenticated response. Use to verify the gateway rejects requests without credentials.

```http
POST https://dchub--azmartone67.run.tools
→ 401 {"error":"unauthorized"}
```

--------------------------------

### Claim API key with curl

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/sdk/README.md

Use this curl command to claim a DCHUB_API_KEY. The key is sent as X-API-Key for full-tier data; the free tier works without one (some fields masked).

```bash
curl -X POST https://dchub.cloud/api/v1/keys/claim -d '{"client_name":"sdk"}'
```

--------------------------------

### mcp-publisher status help

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/REGISTRY-LISTINGS.md

Shows the help for the mcp-publisher status command, which sets the status of a published version. The status can be active, deprecated, or deleted, and can be applied to all versions.

```text
./mcp-publisher status --help
```

--------------------------------

### Smithery publish command with per-registry path

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/REGISTRY-LISTINGS.md

Republish the Smithery registry against the source path /mcp/smithery. This is the only registry that can be switched via a command; others require dashboard edits.

```bash
smithery mcp publish "https://dchub.cloud/mcp/smithery" -n azmartone67/dchub
```

--------------------------------

### stdio bridge config using mcp-remote

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/integrations/mcp-clients/README.md

For clients that only support stdio, this config bridges the remote server using npx and mcp-remote.

```json
{
  "mcpServers": {
    "dchub": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://dchub.cloud/mcp"]
    }
  }
}
```

--------------------------------

### get_grid_data iso parameter test

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/DATA_QUALITY.md

Shows two calls to get_grid_data with different ISO values (ERCOT and PJM) returning identical Colorado coordinates, demonstrating the bug where the iso parameter is ignored.

```text
get_grid_data {iso: "ERCOT"} → lat 39.74, lon −105.17, state: CO
get_grid_data {iso: "PJM"}   → lat 39.74, lon −105.17, state: CO   ← IDENTICAL
```

--------------------------------

### Cline MCP server configuration with X-API-Key header

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/llms-install.md

JSON configuration for adding the dchub MCP server to Cline with an optional API key header. The key is obtained from dchub.cloud/signup and raises rate limits.

```json
{
  "mcpServers": {
    "dchub": {
      "type": "streamableHttp",
      "url": "https://dchub.cloud/mcp",
      "headers": { "X-API-Key": "YOUR_KEY_HERE" }
    }
  }
}
```

--------------------------------

### dc.call(tool, args)

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/sdk/node/README.md

Calls any of the 94 available tools with the given arguments. Returns cleaned data payload.

```APIDOC
## dc.call(tool, args)

### Description
Calls any of the 94 available tools with the given arguments. Returns cleaned data payload.

### Method
`dc.call(tool, args)`

### Parameters
- **tool** (string) - Required - The tool name.
- **args** (object) - Required - Arguments for the tool.

### Returns
- cleaned data payload

### Example
```js
const result = await dc.call("get_market_intel", { slug: "northern-virginia" });
```
```

--------------------------------

### Tool gating test results

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/SITE_QA.md

Shows the results of testing two tools: save_site (PRO write works) and get_interconnection_queue (PAID_ONLY still gates).

```text
save_site {lat:38.95, lon:-77.45}          → ok:true, site_id:2                 (PRO write works → key IS paid)

get_interconnection_queue {iso:"ERCOT"}     → paid_only, current_tier:"free"     (PAID_ONLY still gates)
```

--------------------------------

### List tools via MCP core endpoint

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/docs/core-profile.md

Sends a JSON-RPC tools/list request to the MCP core endpoint using curl.

```bash
curl -s -X POST https://<host>/mcp/core -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

--------------------------------

### useCount log excerpt (2026-08-20 to 2026-09-05)

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/docs/SMITHERY-LISTING-PASTE.md

Shows the useCount values read from the local rank-defense log. The counter drops from 4328 to 3573 on 2026-08-21 and then stays frozen at 3573 for 16 days, which the page attributes to a vendor recompute rather than traffic.

```text
2026-08-20  4328
2026-08-21  4328 → 3573    (between 19:18 and 20:48 MST)
2026-08-22 … 2026-09-05    3573, frozen to the unit for 16 days
```

--------------------------------

### Claim a free API key

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/integrations/README.md

This curl command claims a free API key from DC Hub. It is optional but raises limits and saves the key. The key can be used to increase daily call limits.

```bash
curl -X POST https://dchub.cloud/api/v1/keys/claim -d '{"client_name":"your-app"}'
```

--------------------------------

### npx mcp-remote command for scan-based directories

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/REGISTRY-LISTINGS.md

Provides a runnable stdio bridge command for directories that verify by introspecting a process. This is the structural fix for remote-only servers that cannot be scanned.

```bash
npx mcp-remote https://dchub.cloud/mcp
```

--------------------------------

### Call evaluate_site tool via MCP core endpoint

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/docs/core-profile.md

Sends a JSON-RPC tools/call request to invoke the evaluate_site tool with latitude, longitude, and state arguments.

```bash
curl -s -X POST https://<host>/mcp/core -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"evaluate_site","arguments":{"lat":39.04,"lon":-77.48,"state":"VA"}}}'
```

--------------------------------

### Registry error: remote URL already used

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/REGISTRY-LISTINGS.md

Shows the 400 error returned by the registry when attempting to use a remote URL already held by another server. This is the constraint that prevents swapping the two registry paths.

```text
400 remote URL https://dchub.cloud/mcp/registry is already used by
    server cloud.dchub/mcp-server
```

--------------------------------

### MCP tools/list request for DC Hub

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/docs/one-click-install.md

POST request to the MCP endpoint to list all available tools. Returns 94 tools including get_composite_site_score, get_disaster_risk, get_climate_intel, rank_markets, and get_grid_scoreboard.

```text
POST https://dchub.cloud/mcp {"jsonrpc":"2.0","id":1,"method":"tools/list"}
```

--------------------------------

### Cline / Roo configuration for DC Hub

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/docs/one-click-install.md

JSON configuration for cline_mcp_settings.json under mcpServers. Uses streamableHttp type with the hosted URL.

```json
{ "mcpServers": { "dchub": { "type": "streamableHttp", "url": "https://dchub.cloud/mcp" } } }
```

--------------------------------

### Call get_composite_site_score tool via MCP

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/docs/for-ai-assistants.md

POST request to https://dchub.cloud/mcp using JSON-RPC to call the get_composite_site_score tool with lat, lon, and optional state. Requires X-API-Key header (free anonymous tier needs none). Response payload is in result.structuredContent.

```json
POST https://dchub.cloud/mcp
{"jsonrpc":"2.0","id":1,"method":"tools/call",
 "params":{"name":"get_composite_site_score",
           "arguments":{"lat":33.45,"lon":-112.07,"state":"AZ"}}}
```

--------------------------------

### Claude Code CLI add dchub MCP server with API key

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/llms-install.md

Command to add the dchub MCP server to Claude Code CLI using HTTP transport and an X-API-Key header. Replace YOUR_KEY_HERE with your actual key.

```bash
claude mcp add dchub --transport http --header "X-API-Key: YOUR_KEY_HERE" https://dchub.cloud/mcp
```

--------------------------------

### dc.market(slug)

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/sdk/node/README.md

Retrieves market intelligence for a given data-center market slug. Returns by-status counts, operators, and recent facilities.

```APIDOC
## dc.market(slug)

### Description
Retrieves market intelligence for a given data-center market slug. Returns by-status counts, operators, and recent facilities.

### Method
`dc.market(slug)`

### Parameters
- **slug** (string) - Required - The market slug, e.g., `"northern-virginia"`.

### Returns
- by-status counts, operators, recent facilities

### Example
```js
console.log(await dc.market("northern-virginia"));
```
```

--------------------------------

### Default mcpServers config shape

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/REGISTRY-LISTINGS.md

The default JSON configuration for most clients, using mcpServers with a url field. Correct for Cursor, Continue, and most registry forms.

```json
{
  "mcpServers": {
    "dchub": {
      "url": "https://dchub.cloud/mcp"
    }
  }
}
```

--------------------------------

### Embeddable HTML button for Cursor deep link

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/docs/one-click-install.md

HTML anchor tag that renders a clickable button to add DC Hub to Cursor. Use in documentation or websites.

```html
<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=dchub&config=eyJ1cmwiOiJodHRwczovL2RjaHViLmNsb3VkL21jcCJ9">Add DC Hub to Cursor</a>
```

--------------------------------

### Validate endpoint error response

Source: https://github.com/azmartone67/dchub-mcp-server/blob/main/SITE_QA.md

Shows the error response from the validate endpoint when the fix is not deployed, indicating a NameError for 'accepted_internal_keys'.

```text
POST https://dchub-backend-production.up.railway.app/api/v1/keys/validate
  → {"error":"name 'accepted_internal_keys' is not defined","success":false}   (fix not deployed)
```