BorealHost MCP Server for Claude
BorealHost MCP server with 47 hosting tools available via remote HTTP at borealhost.ai/mcp or local stdio through pip install borealhost-mcp, with optional BOREALHOST_API_KEY.
Open the source and read safety notes before installing.
Safety notes
- Hosting management tools can provision, reconfigure, or destroy servers and DNS records.
- BOREALHOST_API_KEY grants account-level access; store it as an environment variable, not in chat.
- Review each destructive tool call before approval in automated agent workflows.
- Remote HTTP mode may expose different tool subsets than local stdio; verify capabilities in docs.
Privacy notes
- Server hostnames, IP addresses, and account metadata returned by tools may be sensitive infrastructure data.
- API keys and OAuth-like session tokens must not be committed to repositories or shared connectors.
- Support logs should reference resource IDs, not full customer site contents or credentials.
Prerequisites
- Python 3.10+ and pip for local stdio install via pip install borealhost-mcp.
- Optional BorealHost account and BOREALHOST_API_KEY for account-specific hosting tools.
- Claude Code or Claude Desktop with MCP support for stdio, or Connectors for remote HTTP.
- Understanding that some hosting tools may create, modify, or delete infrastructure resources.
Schema details
- Install type
- cli
- Reading time
- 4 min
- Difficulty score
- 35
- Troubleshooting
- Yes
- Breaking changes
- No
- Scope
- Source repo
- Estimated setup
- 10 minutes
- Difficulty
- intermediate
- Website
- https://borealhost.ai
Full copyable content
{
"mcpServers": {
"borealhost": {
"url": "https://borealhost.ai/mcp/",
"type": "http"
}
}
}About this resource
Overview
BorealHost provides a Model Context Protocol server with 47 tools for hosting and infrastructure management. You can connect via the hosted remote endpoint at https://borealhost.ai/mcp/ or run locally with pip install borealhost-mcp over stdio. A BOREALHOST_API_KEY is optional but required for account-specific operations.
Source code is in alainsvrd/borealhost-mcp.
Features
- 47 hosting tools covering servers, domains, DNS, and deployment tasks.
- Remote HTTP MCP at
https://borealhost.ai/mcp/. - Local stdio server via
pip install borealhost-mcp. - Optional
BOREALHOST_API_KEYfor authenticated account actions. - Works with Claude Connectors, Claude Code, and other MCP clients.
Use Cases
- List active servers and open support tickets from chat.
- Create DNS records for a staging subdomain before a release.
- Check SSL certificate status across managed domains.
- Spin up or tear down dev instances during QA cycles.
- Audit hosting spend and resource utilisation through natural language.
Installation
Remote HTTP (Claude Connectors)
- Add a custom connector under Settings → Connectors.
- Enter the MCP URL:
https://borealhost.ai/mcp/. - Add API key headers if your tools require authentication.
- Enable the connector in conversation.
Claude Code (remote)
claude mcp add --transport http borealhost https://borealhost.ai/mcp/
claude mcp list
Local stdio
pip install borealhost-mcp
export BOREALHOST_API_KEY=your_key_here
claude mcp add borealhost --env BOREALHOST_API_KEY=$BOREALHOST_API_KEY -- borealhost-mcp
Configuration
Remote HTTP:
{
"mcpServers": {
"borealhost": {
"url": "https://borealhost.ai/mcp/",
"type": "http"
}
}
}
Local stdio:
{
"mcpServers": {
"borealhost": {
"command": "borealhost-mcp",
"args": [],
"env": {
"BOREALHOST_API_KEY": "${BOREALHOST_API_KEY}"
},
"type": "stdio"
}
}
}
Examples
List servers
List all active BorealHost servers on my account and their regions.
DNS update
Add a CNAME record pointing staging.example.com to my BorealHost load balancer.
Certificate check
Check SSL certificate expiry for all domains in my BorealHost account.
Security
- Treat hosting tools as production-capable; confirm destructive actions explicitly.
- Rotate
BOREALHOST_API_KEYif exposed and use least-privilege keys where supported. - Avoid pasting server credentials returned by tools into public channels.
Troubleshooting
API key ignored (local)
Export BOREALHOST_API_KEY before starting Claude Code or set it in the MCP config env block.
Remote vs local tool mismatch
Some tools may only be available in one transport mode; consult the GitHub README for the current matrix.
pip command not found
Install Python 3.10+ and ensure borealhost-mcp is on PATH after pip install.
DNS propagation delays
Record creation succeeds before global propagation; wait and re-query rather than duplicating records.
Source citations
Add this badge to your README
Signals
Loading live community signals…
A short, calm digest of reviewed Claude resources. Unsubscribe any time.