BorealHost MCP Server

Agent-native web hosting tools for the Model Context Protocol.

Connect any MCP-compatible AI agent to BorealHost.ai — purchase hosting, deploy sites, manage DNS, register domains, and scale infrastructure, entirely through tool calls.

Quick Start

Remote Server (Recommended)

No installation needed. Connect directly to the hosted server:

{
  "mcpServers": {
    "borealhost": {
      "type": "streamable-http",
      "url": "https://borealhost.ai/mcp/"
    }
  }
}

Local Installation (pip)

pip install borealhost-mcp

Then run:

borealhost-mcp

Or add to your MCP client config:

{
  "mcpServers": {
    "borealhost": {
      "command": "borealhost-mcp"
    }
  }
}

Environment Variables

What Can It Do?

BorealHost MCP exposes 47 tools across the full hosting lifecycle:

Authentication & Identity

• register — Create an agent account and get an API key (no auth needed)
• set_api_key — Activate an existing key for the session
• whoami — Verify your key and check account info
• request_api_key / claim_api_key — Challenge-response auth for on-site agents

Plan Discovery & Checkout

• list_plans — Browse hosting plans with pricing (CAD)
• create_checkout / update_checkout / complete_checkout / get_checkout_status — Full purchase flow with Stripe

Site Management

• get_site_status — Check site health, resources, and configuration
• manage_dns — Create and delete DNS records (A, AAAA, CNAME, MX, TXT, SRV)
• deploy — Trigger site deployment
• scale — Upgrade or downgrade hosting plan
• decommission — Delete site (7-day grace period)

Applications

• install_app — Install from templates: Django, Laravel, Next.js, Node.js, Nuxt.js, Rails, static, Forge
• get_app_status / list_apps — Monitor installations

File Management

• list_files / read_file / write_file / upload_file / delete_file — Full filesystem access

Snapshots & Backups

• list_snapshots / create_snapshot / delete_snapshot / rollback_snapshot — Local snapshots
• create_b2_snapshot — Cloud-backed snapshots (Backblaze B2)
• schedule_snapshot / cancel_scheduled_snapshot — Scheduled snapshots
• get_snapshot_usage — Check quota
• list_backups / create_backup / restore_backup — Automatic and manual backups

Domains

• search_domain — Check availability and pricing
• register_domain — Register with WHOIS info (supports .ca, .com, .net, etc.)
• list_domains / domain_detail — Manage owned domains

SSH & Logs

• get_ssh_info / add_ssh_key — SSH access for VPS plans
• get_logs — Retrieve error, access, and PHP logs

Modules

• list_modules / toggle_module — Enable/disable AI modules (chatbot, SEO, translation, content)

Account & Billing

• update_account / delete_account — Profile management
• list_subscriptions / get_billing_portal — Billing info and Stripe portal
• rotate_key — Rotate API keys
• get_metrics — Traffic and performance metrics

Resources

The server exposes 5 MCP resources for structured reference data:

Prompts

5 guided workflow prompts for common operations:

... View full README on GitHub