{
  "markdown": "# BorealHost MCP Server\n\n<!-- mcp-name: ai.borealhost/mcp -->\n\nAgent-native web hosting tools for the [Model Context Protocol](https://modelcontextprotocol.io).\n\nConnect any MCP-compatible AI agent to [BorealHost.ai](https://borealhost.ai) — purchase hosting, deploy sites, manage DNS, register domains, and scale infrastructure, entirely through tool calls.\n\n## Quick Start\n\n### Remote Server (Recommended)\n\nNo installation needed. Connect directly to the hosted server:\n\n```json\n{\n  \"mcpServers\": {\n    \"borealhost\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://borealhost.ai/mcp/\"\n    }\n  }\n}\n```\n\n### Local Installation (pip)\n\n```bash\npip install borealhost-mcp\n```\n\nThen run:\n\n```bash\nborealhost-mcp\n```\n\nOr add to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"borealhost\": {\n      \"command\": \"borealhost-mcp\"\n    }\n  }\n}\n```\n\n### Environment Variables\n\n| Variable | Description |\n|----------|-------------|\n| `BOREALHOST_BASE_URL` | API base URL (default: `https://borealhost.ai`) |\n| `BOREALHOST_API_KEY` | Pre-configured API key (optional — you can also call `register()` or `set_api_key()` at runtime) |\n\n## What Can It Do?\n\nBorealHost MCP exposes **47 tools** across the full hosting lifecycle:\n\n### Authentication & Identity\n- `register` — Create an agent account and get an API key (no auth needed)\n- `set_api_key` — Activate an existing key for the session\n- `whoami` — Verify your key and check account info\n- `request_api_key` / `claim_api_key` — Challenge-response auth for on-site agents\n\n### Plan Discovery & Checkout\n- `list_plans` — Browse hosting plans with pricing (CAD)\n- `create_checkout` / `update_checkout` / `complete_checkout` / `get_checkout_status` — Full purchase flow with Stripe\n\n### Site Management\n- `get_site_status` — Check site health, resources, and configuration\n- `manage_dns` — Create and delete DNS records (A, AAAA, CNAME, MX, TXT, SRV)\n- `deploy` — Trigger site deployment\n- `scale` — Upgrade or downgrade hosting plan\n- `decommission` — Delete site (7-day grace period)\n\n### Applications\n- `install_app` — Install from templates: Django, Laravel, Next.js, Node.js, Nuxt.js, Rails, static\n- `get_app_status` / `list_apps` — Monitor installations\n\n### File Management\n- `list_files` / `read_file` / `write_file` / `upload_file` / `delete_file` — Full filesystem access\n\n### Snapshots & Backups\n- `list_snapshots` / `create_snapshot` / `delete_snapshot` / `rollback_snapshot` — Local snapshots\n- `create_b2_snapshot` — Cloud-backed snapshots (Backblaze B2)\n- `schedule_snapshot` / `cancel_scheduled_snapshot` — Scheduled snapshots\n- `get_snapshot_usage` — Check quota\n- `list_backups` / `create_backup` / `restore_backup` — Automatic and manual backups\n\n### Domains\n- `search_domain` — Check availability and pricing\n- `register_domain` — Register with WHOIS info (supports .ca, .com, .net, etc.)\n- `list_domains` / `domain_detail` — Manage owned domains\n\n### SSH & Logs\n- `get_ssh_info` / `add_ssh_key` — SSH access for VPS plans\n- `get_logs` — Retrieve error, access, and PHP logs\n\n### Modules\n- `list_modules` / `toggle_module` — Enable/disable AI modules (SEO, translation, content)\n\n### Account & Billing\n- `update_account` / `delete_account` — Profile management\n- `list_subscriptions` / `get_billing_portal` — Billing info and Stripe portal\n- `rotate_key` — Rotate API keys\n- `get_metrics` — Traffic and performance metrics\n\n## Resources\n\nThe server exposes 5 MCP resources for structured reference data:\n\n| URI | Description |\n|-----|-------------|\n| `borealhost://api/errors` | Error codes with HTTP status and recovery guidance |\n| `borealhost://api/scopes` | API key scope hierarchy and tool requirements |\n| `borealhost://api/enums` | Valid enum values (checkout status, DNS types, log types, etc.) |\n| `borealhost://api/response-format` | API response envelope documentation |\n| `borealhost://plans` | Live plan catalog with current pricing |\n\n## Prompts\n\n5 guided workflow prompts for common operations:\n\n- **`purchase_hosting`** — Step-by-step plan purchase flow\n- **`setup_site`** — Post-purchase site configuration\n- **`manage_dns`** — Common DNS operations\n- **`register_domain`** — Domain registration with WHOIS checklist\n- **`claim_site_key`** — Challenge-response key claiming\n\n## Example Workflow\n\n```\nAgent: register()\n→ {\"api_key\": \"bh_...\", \"scopes\": [\"read\", \"write\"]}\n\nAgent: list_plans()\n→ [{\"slug\": \"starter\", \"price_monthly\": 9.99, ...}, ...]\n\nAgent: create_checkout(\"bh_site_starter_monthly\")\n→ {\"checkout_id\": \"chk_...\", \"checkout_secret\": \"...\"}\n\nAgent: update_checkout(\"chk_...\", requested_slug=\"my-new-site\")\n→ {\"status\": \"ready\"}\n\nAgent: complete_checkout(\"chk_...\")\n→ {\"payment_url\": \"https://borealhost.ai/pay/chk_.../?s=...\",\n   \"confirmation_url\": \"https://borealhost.ai/pay/chk_.../confirmation/?s=...\"}\n  # show payment_url to the human; paying provisions the site\n\nAgent: get_checkout_status(\"chk_...\")  # poll until completed\n→ {\"status\": \"completed\", \"api_key\": \"bh_...\",   # shown ONCE\n   \"site\": {\"slug\": \"my-new-site\", \"status\": \"active\"}}\n\nAgent: get_site_status(\"my-new-site\")\n→ {\"status\": \"active\", \"url\": \"https://my-new-site.borealhost.ai\"}\n```\n\n## Authentication\n\n- **API key format:** `bh_` + 48 hex characters\n- **Scopes:** `read` (view) → `write` (modify) → `admin` (delete/scale)\n- **No auth needed** for: `list_plans`, `create_checkout`, `update_checkout`, `complete_checkout`, `get_checkout_status`\n- Keys are shown **once** on creation — store immediately\n\n## Requirements\n\n- Python 3.10+\n- Dependencies: `mcp[cli]>=1.2.0`, `httpx>=0.27.0`\n\n## Links\n\n- [BorealHost.ai](https://borealhost.ai)\n- [API Documentation](https://borealhost.ai/api/)\n- [Full LLM Reference](https://borealhost.ai/llms-full.txt)\n\n## License\n\nProprietary. Copyright 2025-2026 BorealHost.ai. All rights reserved.\n",
  "bytes": 5813,
  "sha": "38957e2c8e8a023880c7dc2fdcb1b75f24ac21d8f3087be566f192a729cad11a",
  "repo_slug": "alainsvrd/borealhost-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_borealhost_mcp_b9b02b27/readme"
}