dchub-mcp-helper

Drop-in HTTP retry middleware for AI agents talking to DC Hub's data center intelligence API at https://dchub.cloud.

DC Hub's REST + MCP gates auto-mint working trial keys on every gated request and deliver them via standard HTTP headers (X-Trial-Key). This package handles the retry-with-key dance so your code never has to care about 402 responses.

Install

pip install dchub-mcp-helper

Use

import httpx
from dchub_mcp_helper import DCHubTrialAuth

client = httpx.Client(auth=DCHubTrialAuth())
resp = client.get("https://dchub.cloud/api/v1/transactions/export.csv")
# → first call returns 402 with X-Trial-Key header
# → auth handler reads it, retries with X-API-Key
# → second call returns 200 with the CSV
# → all later calls in this session use the same key (no 402)

Optional: persist the trial key across processes (CLI tools):

auth = DCHubTrialAuth(cache_path="~/.dchub-trial-key", verbose=True)

What you DON'T need

• No browser flow
• No email verification
• No OAuth dance
• No card on file
• No webhook callback

Trial keys are 200 calls/day, 30-day expiry. Make permanent by POSTing to /api/v1/keys/auto-trial/redeem with {api_key, email}.

What DC Hub offers

• Global data center facility map (corroborated count pending), 170+ countries
• DCPI scores for 300+ markets (BUILD / CAUTION / AVOID verdicts)
• Real-time grid intelligence across 7+ ISOs
• M&A transactions database
• Capacity pipeline (550+ active projects)
• Tax incentives by state
• Fiber carrier coverage
• 92 MCP tools

Full integration manifest: https://dchub.cloud/.well-known/ai-agents.json

Plans and pricing

Current plans, call limits and prices: https://dchub.cloud/pricing. Anonymous and free-key calls work without payment; a $10 one-time pack adds 1,000 API credits.

License

MIT. © DC Hub.

Source

https://github.com/azmartone67/dchub-backend/tree/main/docs/mcp-helper-pkg

Publish path (for maintainers)

cd docs/mcp-helper-pkg
python3 -m build              # creates dist/*.whl and dist/*.tar.gz
python3 -m twine upload dist/*  # publishes to PyPI

Requires pip install build twine and a PyPI account with the dchub-mcp-helper namespace.