{"id":"ai.borealhost/mcp","slug":"ai-borealhost-mcp","title":"BorealHost","description":"Agent-native web hosting — deploy sites, manage DNS, register domains, scale infrastructure","version":"0.4.2","publisher":{"kind":"domain","id":"borealhost.ai","label":"borealhost.ai","url":"https://borealhost.ai"},"website":"https://borealhost.ai","repository":"https://github.com/alainsvrd/borealhost-mcp","remotes":[{"type":"streamable-http","url":"https://borealhost.ai/mcp/"}],"packages":[{"registryType":"pypi","identifier":"borealhost-mcp","version":"0.4.2","runtimeHint":"uvx","transport":{"type":"stdio"},"environmentVariables":[{"description":"BorealHost API key (format: bh_<48 hex chars>). Optional — you can also call register() or set_api_key() at runtime.","isSecret":true,"name":"BOREALHOST_API_KEY"}]}],"published":"2026-09-06","updated":"2026-09-06","status":"online","auth":"","latency_ms":1011,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"set_api_key","title":"","description":"Set your BorealHost API key for this session.\n\nCall this if you already have an API key (from checkout completion,\nthe BorealHost panel, or a container claim). All subsequent tool calls\nwill use this key for authentication.\n\nArgs:\n    api_key: Your BorealHost API key (format: bh_<48 hex chars>)\n\nReturns:\n    {\"success\": true, \"message\": \"API key set for this session\",\n     \"key_prefix\": \"bh_...\"}\n","read_only":false},{"name":"whoami","title":"","description":"Check the current API key's account info, scopes, and site count.\n\nRequires: BOREALHOST_API_KEY env var (read scope).\n\nReturns:\n    {\"user\": {\"id\": \"uuid\", \"email\": \"...\", \"date_joined\": \"iso8601\"},\n     \"api_key\": {\"id\": \"uuid\", \"name\": \"...\", \"prefix\": \"bh_...\",\n                 \"scopes\": [\"read\", \"write\"], \"created_at\": \"iso8601\"},\n     \"account\": {\"sites\": 2, \"active_subscriptions\": 1}}\n\nError","read_only":false},{"name":"request_api_key","title":"","description":"Request an API key for a site YOU ARE RUNNING ON (challenge-response).\n\n⚠ ONLY USE THIS IF YOU ARE EXECUTING INSIDE THAT SITE'S OWN CONTAINER. If\nyou bought or ordered the site from somewhere else, this is the wrong tool:\nit returns \"pending\" and the pending never resolves, because the proof it\nasks for is a file you cannot reach. Use `get_checkout_status(checkout_id)`\non the checkout that paid fo","read_only":false},{"name":"claim_api_key","title":"","description":"Claim an API key using a claim token from the container.\n\nAfter calling request_api_key(), read the claim token from the path that\ncall returned in `claim_path`, on that site's container, and pass it here.\n\nThe token is single-use — once claimed, it cannot be used again.\nThe API key is automatically activated for this MCP session.\n\nArgs:\n    claim_token: The claim token string read from the contai","read_only":false},{"name":"list_plans","title":"","description":"List available hosting plans with pricing and resources.\n\nNo authentication needed.\n\nArgs:\n    track: Filter by plan track. Valid values: \"single_site\", \"agency\".\n        ⚠ The track is not the site count — most plans on BOTH tracks\n        include several sites (site_starter 5, site_plus 8, site_pro 12).\n        Read `max_sites` on the plan, and use add_site() to fill a slot.\n           Leave emp","read_only":false},{"name":"create_checkout","title":"","description":"Start a new checkout session to purchase a hosting plan.\n\nNo authentication needed. After creating, call update_checkout to set\nbuyer info, then complete_checkout to pay.\n\nThe response carries a `checkout_secret`, returned ONCE, that every later\nstep of this checkout requires. It is held in memory for this MCP session\nand sent automatically — but it is gone if the server restarts. If a session\nkey","read_only":false},{"name":"update_checkout","title":"","description":"Set buyer email and desired site slug on a checkout session.\n\nThe checkout must be in \"not_ready\" status. Setting requested_slug\ntransitions status to \"ready\" (required before completing).\n\nArgs:\n    checkout_id: Checkout session ID from create_checkout\n    buyer_email: Optional email — if omitted, a synthetic agent identity\n                 (agent-{uuid}@api.borealhost.ai) is created at completio","read_only":false},{"name":"complete_checkout","title":"","description":"Complete checkout with payment and start site provisioning.\n\nThe checkout must be in \"ready\" status.\n\nTwo payment methods:\n- \"stripe_checkout\" (default): Returns a short, chat-safe payment URL.\n  **Present `payment_url` to the human — NOT `stripe_checkout_url`.**\n  The raw Stripe URL has a required `#fragment` that chat UIs routinely\n  strip when rendering markdown links, which causes Stripe to sh","read_only":false},{"name":"get_checkout_status","title":"","description":"Poll a checkout session for status updates.\n\nCall this after complete_checkout to track payment and provisioning.\n\nPolling strategy:\n- First 60 seconds: every 5 seconds\n- After 60 seconds: every 15 seconds\n- Stop after 10 minutes if not completed\n\nCheckout statuses (in order):\n- \"not_ready\": Missing required fields (slug)\n- \"ready\": All fields set, awaiting payment\n- \"awaiting_payment\": Stripe che","read_only":false},{"name":"list_checkouts","title":"","description":"List checkouts belonging to the authenticated account.\n\nRequires: API key. Only checkouts with a recorded owner appear — every\ncheckout created while authenticated, plus every checkout that reached\npayment. An anonymous checkout whose one-shot secret was lost cannot be\nlisted; create checkouts authenticated to keep them addressable.\n\nArgs:\n    status: Optional filter — \"not_ready\", \"ready\", \"await","read_only":false},{"name":"cancel_checkout","title":"","description":"Abandon an unpaid checkout and expire its Stripe payment link.\n\nUse this to clean up abandoned attempts rather than leaving them to sit.\nA completed checkout is never cancelled here — that would be a refund, and\nit is refused.\n\nArgs:\n    checkout_id: Checkout session ID\n\nReturns:\n    The checkout, with status \"canceled\".\n\nErrors:\n    VALIDATION_ERROR: Checkout was already paid — cancel the subscri","read_only":false},{"name":"add_site","title":"","description":"Provision a site into a slot a plan you ALREADY PAY FOR includes.\n\nTwo different things can be meant by \"create a site\". Buying one is the\ncheckout flow (create_checkout → update → complete). This is the other: most\nplans include several sites, and this uses one of them at no extra cost.\nsite_starter includes 5, site_plus 8, site_pro 12, and the agency plans\nmore. `whoami` and `list_sites` show wh","read_only":false},{"name":"set_site_type","title":"","description":"Change what a site's docroot IS, without deleting anything.\n\nTypes:\n  wordpress    WordPress, PHP and a database (the default)\n  php          PHP and a database, no WordPress\n  php-nodb     PHP, no database\n  static-site  HTML/CSS/JS only, no PHP and no database\n\n⚠ NON-DESTRUCTIVE. Existing files stay on disk and existing databases are\nnot dropped. They remain the customer's data and keep counting","read_only":false},{"name":"get_wallet","title":"","description":"The account's prepaid balance, and what THIS key may spend from it.\n\nTwo ceilings, and both apply: the balance bounds the ACCOUNT, the allowance\nbounds this KEY within it. Plan against `spendable_cents`, which is the\nlower of the two — a $50 balance behind a $5 allowance means $5, and\nplanning against the balance is planning a purchase that gets refused.\n\n`can_spend: false` with a non-zero balance","read_only":false},{"name":"get_site_status","title":"","description":"Get detailed status of a hosted site including resources, domains, and modules.\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier (the slug chosen during checkout)\n\nReturns:\n    {\"slug\": \"my-site\", \"plan\": \"site_starter\", \"status\": \"active\",\n     \"domains\": [\"my-site.borealhost.ai\"], \"modules\": {...},\n     \"resources\": {\"memory_mb\": 512, \"cpu_cores\": 1, \"disk_gb\": 10},\n     \"cre","read_only":false},{"name":"manage_dns","title":"","description":"Create or delete DNS records for a site.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    action: \"create\" or \"delete\"\n    record_type: \"A\", \"AAAA\", \"CNAME\", \"MX\", \"TXT\", or \"SRV\"\n    subdomain: Subdomain part (e.g. \"www\", \"mail\"). Leave empty for\n               the apex/root domain.\n    value: Record value. Required for \"create\". Examples:\n           A: \"1.2.3.4\", CNAME: ","read_only":false},{"name":"install_app","title":"","description":"Install an app template on a VPS/Cloud site.\n\nStarts a background installation. Poll get_app_status() for progress.\n\nRequires: API key with write scope. VPS or Cloud plan only.\n\nArgs:\n    slug: Site identifier\n    template: App template slug. Available: django, laravel, nextjs, nodejs,\n              nuxtjs, rails, static, wordpress\n    app_name: Short name for the app (2-50 chars, lowercase alphan","read_only":false},{"name":"get_app_status","title":"","description":"Get app installation status and log.\n\nPoll this after install_app() to track progress.\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n    app_id: App ID from install_app() response\n\nReturns:\n    {\"id\": \"uuid\", \"app_name\": \"myapp\", \"status\": \"running\"|\"installing\"|\"failed\",\n     \"install_log\": \"...\"}\n\nStatuses: \"installing\", \"running\", \"stopped\", \"failed\", \"uninstalled\"\n","read_only":false},{"name":"list_apps","title":"","description":"List installed apps on a site.\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"apps\": [{\"id\": \"uuid\", \"app_name\": \"myapp\", \"template_slug\": \"django\",\n     \"status\": \"running\", \"domain\": \"myapp.mysite.borealhost.ai\"}]}\n","read_only":false},{"name":"list_snapshots","title":"","description":"List all snapshots and scheduled snapshots for a site.\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"snapshots\": [{\"id\": \"uuid\", \"name\": \"snap-...\", \"status\": \"completed\",\n     \"storage_type\": \"local\"|\"b2\", \"size_bytes\": 1234, \"size_display\": \"1.2 Mo\",\n     \"created_at\": \"iso8601\"}], \"scheduled\": [...]}\n","read_only":false},{"name":"create_snapshot","title":"","description":"Create a local container snapshot (async).\n\nRuns in background — returns immediately with status \"creating\".\nPoll list_snapshots() to check when status becomes \"completed\" or \"failed\".\n\nAvailable for VPS, dedicated, and cloud plans (any plan with max_snapshots > 0).\nLocal snapshots are stored on the host disk and count against disk quota.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site ","read_only":false},{"name":"create_b2_snapshot","title":"","description":"Create a B2 cloud-backed snapshot (zero local disk, async).\n\nStreams container data directly to Backblaze B2 via restic.\nNo local disk impact — billed separately at cost+5%.\nRuns in background — returns immediately with status \"creating\".\nPoll list_snapshots() to check when status becomes \"completed\".\nOnly available for VPS plans.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifi","read_only":false},{"name":"delete_snapshot","title":"","description":"Delete a snapshot (local or B2).\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    snapshot_id: UUID of the snapshot to delete\n\nReturns:\n    {\"success\": true, \"message\": \"Snapshot deleted\"}\n\nErrors:\n    NOT_FOUND: Snapshot not found\n","read_only":false},{"name":"rollback_snapshot","title":"","description":"Rollback a site to a previous snapshot.\n\nWARNING: This is destructive. The current state of the container will be\nreplaced with the snapshot contents.\n\nRequires: API key with admin scope.\n\nArgs:\n    slug: Site identifier\n    snapshot_id: UUID of the snapshot to rollback to\n\nReturns:\n    {\"success\": true, \"message\": \"Rolled back to snapshot ...\"}\n\nErrors:\n    NOT_FOUND: Snapshot not found or not in","read_only":false},{"name":"get_snapshot_usage","title":"","description":"Get snapshot disk usage and quota info for a site.\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"disk_quota_gb\": 200, \"max_snapshots\": 5, \"snapshot_count\": 2,\n     \"local_snapshot_bytes\": 1234, \"b2_snapshot_bytes\": 5678,\n     \"can_create\": true}\n","read_only":false},{"name":"schedule_snapshot","title":"","description":"Schedule a snapshot for future execution.\n\nRequires: API key with write scope. Max 3 pending schedules per site.\n\nArgs:\n    slug: Site identifier\n    scheduled_at: ISO 8601 datetime (must be in the future)\n    description: Optional description (max 200 chars)\n\nReturns:\n    {\"id\": \"uuid\", \"scheduled_at\": \"iso8601\", \"status\": \"scheduled\"}\n\nErrors:\n    VALIDATION_ERROR: Invalid datetime, not in futur","read_only":false},{"name":"cancel_scheduled_snapshot","title":"","description":"Cancel a scheduled snapshot.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    schedule_id: UUID of the scheduled snapshot to cancel\n\nReturns:\n    {\"success\": true, \"message\": \"Scheduled snapshot cancelled\"}\n\nErrors:\n    NOT_FOUND: Schedule not found or already executed\n","read_only":false},{"name":"list_backups","title":"","description":"List all backups for a site (automatic and manual).\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    [{\"id\": \"uuid\", \"backup_type\": \"auto\"|\"manual\", \"status\": \"completed\",\n     \"size_bytes\": 1234, \"size_display\": \"1.2 Mo\",\n     \"timestamp\": \"iso8601\", \"notes\": \"...\"}]\n","read_only":false},{"name":"create_backup","title":"","description":"Create a manual backup (runs asynchronously).\n\nThe backup starts in the background. Poll list_backups() to check status.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"id\": \"uuid\", \"status\": \"pending\",\n     \"message\": \"Backup started. Poll list_backups() to check status.\"}\n","read_only":false},{"name":"browse_backup","title":"","description":"List one bounded page of immediate children in a backup directory.\n\nThis returns names and metadata only, never file contents. Use\n``next_cursor`` from the response as ``cursor`` to request the next page.\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n    backup_id: UUID of a completed backup\n    path: Absolute directory path as it existed in the backup\n    cursor: Resume aft","read_only":false},{"name":"recover_backup_files","title":"","description":"Start a selected-file recovery and return its durable ID immediately.\n\nExisting destination paths are never replaced. The operation is\nasynchronous; poll ``get_file_recovery`` with the returned ID.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    backup_id: UUID of a completed backup\n    paths: One or more absolute paths from that backup\n\nReturns:\n    {\"id\": \"uuid\", \"backu","read_only":false},{"name":"get_file_recovery","title":"","description":"Poll one selected-file recovery without waiting for it to finish.\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n    backup_id: UUID of the source backup\n    recovery_id: UUID returned by ``recover_backup_files``\n\nReturns:\n    {\"id\": \"uuid\", \"backup_id\": \"uuid\",\n     \"status\": \"running\"|\"completed\"|\"failed\", \"paths\": [...],\n     \"error\": \"\", ...}\n","read_only":false},{"name":"recover_backup_database","title":"","description":"Recover exactly one absent database from a completed backup.\n\nThe operation refuses an existing database and can never select ``all``.\nIt returns immediately; poll ``get_database_recovery`` with its durable ID.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    backup_id: UUID of a completed backup\n    database: One database name, never ``all``\n","read_only":false},{"name":"get_database_recovery","title":"","description":"Poll one database recovery without waiting for completion.\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n    backup_id: UUID of the source backup\n    recovery_id: UUID returned by ``recover_backup_database``\n","read_only":false},{"name":"restore_backup","title":"","description":"Restore a site from a backup.\n\nWARNING: This is destructive. The current state of the site will be\nreplaced. Runs asynchronously — may take several minutes.\n\nRequires: API key with admin scope.\n\nArgs:\n    slug: Site identifier\n    backup_id: UUID of the backup to restore from\n\nReturns:\n    {\"success\": true, \"message\": \"Restore started...\"}\n\nErrors:\n    VALIDATION_ERROR: Backup not found or not in ","read_only":false},{"name":"get_metrics","title":"","description":"Get traffic and performance metrics for a site.\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n    days: Number of days of history (1–90, default: 7)\n\nReturns:\n    {\"requests\": [...], \"bandwidth\": [...], \"errors\": [...],\n     \"period\": {\"start\": \"iso8601\", \"end\": \"iso8601\"}}\n\nErrors:\n    NOT_FOUND: Unknown slug\n    VALIDATION_ERROR: days out of range\n","read_only":false},{"name":"scale","title":"","description":"Change a site's hosting plan (upgrade or downgrade).\n\nRequires: API key with admin scope. Best practice: create a snapshot\nbefore downgrading.\n\nArgs:\n    slug: Site identifier\n    new_plan: Target plan slug (e.g. \"site_pro\", \"site_managed\").\n              Call list_plans() to see available plans.\n\nReturns:\n    {\"success\": true, \"old_plan\": \"site_starter\", \"new_plan\": \"site_pro\",\n     \"message\": \"P","read_only":false},{"name":"decommission","title":"","description":"Delete a site and schedule resource cleanup (7-day grace period).\n\nWARNING: This is destructive. The site will be inaccessible immediately.\nAfter the grace period, its active service data is deleted. A final backup\nremains recoverable for 30 days; immutable copies may remain until their\nretention locks expire.\n\nBest practice: create a snapshot before decommissioning.\n\nRequires: API key with admin ","read_only":false},{"name":"update_account","title":"","description":"Update account profile fields (email, language, name).\n\nRequires: API key with write scope.\nOnly provided (non-empty) fields are updated.\n\nArgs:\n    email: New email address\n    language: Language preference — \"fr\" (French) or \"en\" (English)\n    first_name: First name\n    last_name: Last name\n\nReturns:\n    {\"success\": true, \"account\": {\"email\": \"...\", \"language\": \"fr\",\n     \"first_name\": \"...\", \"l","read_only":false},{"name":"delete_account","title":"","description":"Permanently anonymize the account. Cancels subscriptions, deactivates keys.\n\nWARNING: This is irreversible. The account will be soft-deleted and all\npersonal data anonymized. All sites will be decommissioned.\n\nRequires: API key with admin scope.\n\nReturns:\n    {\"success\": true, \"message\": \"Account anonymized\"}\n","read_only":false},{"name":"list_subscriptions","title":"","description":"List all subscriptions with plan details, pricing, status, and site slug.\n\nRequires: API key with read scope.\n\nReturns:\n    [{\"id\": \"uuid\", \"plan_slug\": \"site_starter\", \"plan_name\": \"Starter\",\n      \"status\": \"active\", \"billing_period\": \"monthly\",\n      \"price\": {\"amount\": 500, \"currency\": \"cad\"},\n      \"site_slug\": \"my-site\", \"created_at\": \"iso8601\"}]\n","read_only":false},{"name":"get_billing_portal","title":"","description":"Get a Stripe billing portal URL for managing payment methods and invoices.\n\nReturns a URL (not a redirect) that the human can open in a browser.\n\nRequires: API key with read scope.\n\nArgs:\n    flow: Optional. Set to \"payment_method_update\" to go directly\n          to the payment method update page.\n\nReturns:\n    {\"url\": \"https://billing.stripe.com/p/session/...\"}\n","read_only":false},{"name":"rotate_key","title":"","description":"Rotate an API key, optionally keeping the old key valid for up to 1,440 minutes.\n\nCreates a new key with the same name, scopes, and rate limits.\nThe new key is returned once — store it immediately.\n\nRequires: API key with write scope.\n\nArgs:\n    key_id: UUID of the API key to rotate (get from whoami())\n\nReturns:\n    {\"api_key\": \"bh_...\", \"key_id\": \"uuid\", \"prefix\": \"bh_...\",\n     \"scopes\": [\"read\"","read_only":false},{"name":"create_api_key","title":"","description":"Create a new API key with specified scopes.\n\nCannot create keys with higher scopes than the current key.\nSite-scoped keys restrict access to a single site.\nemail_domains restricts the key to email tools on the named domains; use\nemail:read, email:write and optionally email:signon scopes. expires_at is\nan ISO timestamp; ip_allowlist accepts IP addresses and CIDR networks.\n\nRequires: API key with wr","read_only":false},{"name":"list_api_keys","title":"","description":"List all API keys for the account.\n\nShows key metadata (name, prefix, scopes, last used) but never the\nfull key value.\n\nRequires: API key with read scope.\n\nReturns:\n    [{\"id\": \"uuid\", \"name\": \"My Key\", \"prefix\": \"bh_a2...\",\n      \"scopes\": [\"read\", \"write\"], \"is_active\": true,\n      \"created_at\": \"iso8601\", \"last_used_at\": \"iso8601\"|null,\n      \"site_slug\": null|\"my-site\"}]\n","read_only":false},{"name":"revoke_api_key","title":"","description":"Revoke (deactivate) an API key. The key stops working immediately.\n\nRequires: API key with write scope.\n\nArgs:\n    key_id: UUID of the key to revoke (from list_api_keys or whoami)\n\nReturns:\n    {\"success\": true, \"message\": \"API key revoked\"}\n\nErrors:\n    NOT_FOUND: Key not found or already revoked\n","read_only":false},{"name":"get_ssh_info","title":"","description":"Get SSH connection info for a VPS/dedicated site.\n\nOnly available for VPS/dedicated plans (not shared hosting).\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"host\": \"184.107.x.x\", \"port\": 22, \"username\": \"admin\",\n     \"ssh_command\": \"ssh admin@184.107.x.x\"}\n\nErrors:\n    NOT_FOUND: Unknown slug\n    FORBIDDEN: Plan does not support SSH (shared plans)\n","read_only":false},{"name":"add_ssh_key","title":"","description":"Inject your SSH public key into a site's container for direct SSH access.\n\nThe key is appended to /home/admin/.ssh/authorized_keys.\nOnly available for VPS/dedicated plans.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    public_key: SSH public key string. Supported types:\n                ssh-ed25519, ssh-rsa, ecdsa-sha2-nistp256/384/521\n\nReturns:\n    {\"success\": true, \"mes","read_only":false},{"name":"list_files","title":"","description":"List files and directories in a site's container.\n\nPath scoping depends on the plan:\n- Shared plans: rooted at wp-content/ (WordPress content directory)\n- VPS/dedicated plans: full filesystem access\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n    path: Relative path to list (empty for root of accessible area)\n\nReturns:\n    {\"path\": \"/\", \"entries\": [{\"name\": \"index.php\", \"t","read_only":false},{"name":"read_file","title":"","description":"Read the contents of a file from a site's container.\n\nMax file size: 512KB. Binary files are rejected — use the site's\nfile manager or SSH for binary files.\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n    path: Relative path to the file\n\nReturns:\n    {\"path\": \"wp-config.php\", \"content\": \"<?php ...\",\n     \"size\": 1234, \"encoding\": \"utf-8\"}\n\nErrors:\n    NOT_FOUND: File doesn","read_only":false},{"name":"write_file","title":"","description":"Write or overwrite a text file in a site's container.\n\nCreates parent directories if they don't exist.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    path: Relative path to the file\n    content: File content as a UTF-8 string\n\nReturns:\n    {\"success\": true, \"path\": \"...\", \"size\": 1234}\n\nErrors:\n    NOT_FOUND: Unknown slug\n    FORBIDDEN: Protected system path\n","read_only":false},{"name":"upload_file","title":"","description":"Upload a base64-encoded file to a site's container.\n\nUse this for binary files (images, archives, fonts, etc.).\nFor text files, prefer write_file().\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    path: Relative path including filename (e.g. \"images/logo.png\")\n    content_b64: Base64-encoded file content\n\nReturns:\n    {\"success\": true, \"path\": \"images/logo.png\", \"size\": 4","read_only":false},{"name":"delete_file","title":"","description":"Delete a file or directory from a site's container.\n\nDirectories are deleted recursively. Protected system paths\n(e.g. /etc, /usr) cannot be deleted.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    path: Relative path to delete\n\nReturns:\n    {\"success\": true, \"path\": \"...\", \"message\": \"Deleted\"}\n\nErrors:\n    NOT_FOUND: Path doesn't exist\n    FORBIDDEN: Protected system pa","read_only":false},{"name":"create_directory","title":"","description":"Create a directory in a site's container.\n\nCreates parent directories if they don't exist.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    path: Relative path of the directory to create\n\nReturns:\n    {\"success\": true, \"path\": \"uploads/2024\", \"message\": \"Directory created\"}\n\nErrors:\n    NOT_FOUND: Unknown slug\n    FORBIDDEN: Protected system path\n","read_only":false},{"name":"list_plugins","title":"","description":"List installed WordPress plugins with status.\n\nRequires: API key with read scope. WordPress sites only.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"plugins\": [{\"name\": \"akismet\", \"status\": \"active\", \"version\": \"5.3\",\n     \"update_available\": false}, ...]}\n","read_only":false},{"name":"list_themes","title":"","description":"List installed WordPress themes with status.\n\nRequires: API key with read scope. WordPress sites only.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"themes\": [{\"name\": \"twentytwentyfour\", \"status\": \"active\",\n     \"version\": \"1.0\", \"update_available\": false}, ...]}\n","read_only":false},{"name":"manage_plugin","title":"","description":"Install, activate, deactivate, or delete a WordPress plugin.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    action: \"install\", \"activate\", \"deactivate\", or \"delete\"\n    plugin: Plugin slug (e.g. \"akismet\", \"jetpack\", \"woocommerce\")\n\nReturns:\n    {\"action\": \"install\", \"plugin\": \"jetpack\", \"result\": {...}}\n","read_only":false},{"name":"manage_theme","title":"","description":"Install, activate, or delete a WordPress theme.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    action: \"install\", \"activate\", or \"delete\"\n    theme: Theme slug (e.g. \"twentytwentyfour\", \"astra\")\n\nReturns:\n    {\"action\": \"install\", \"theme\": \"astra\", \"result\": {...}}\n","read_only":false},{"name":"wp_check_updates","title":"","description":"Check for available WordPress core, plugin, and theme updates.\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"core\": {\"current\": \"6.5\", \"update\": \"6.6\"},\n     \"plugins\": [{\"name\": \"...\", \"current\": \"1.0\", \"new\": \"1.1\"}],\n     \"themes\": [...]}\n","read_only":false},{"name":"wp_update_all","title":"","description":"Update WordPress core, all plugins, and all themes.\n\nRuns all updates in sequence. May take up to 2 minutes.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"core\": {...}, \"plugins\": [...], \"themes\": [...]}\n","read_only":false},{"name":"list_cron","title":"","description":"List cron jobs on a site.\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"jobs\": [{\"line\": 1, \"schedule\": \"*/5 * * * *\",\n     \"command\": \"/usr/bin/php /var/www/html/wp-cron.php\"}, ...]}\n","read_only":false},{"name":"add_cron","title":"","description":"Add a cron job to a site.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    schedule: Cron schedule (e.g. \"*/5 * * * *\", \"0 2 * * *\")\n    command: Command to execute\n\nReturns:\n    {\"added\": true, \"result\": {...}}\n","read_only":false},{"name":"delete_cron","title":"","description":"Delete a cron job by line number.\n\nGet line numbers from list_cron().\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    line_number: Line number of the cron entry to delete\n\nReturns:\n    {\"deleted\": true}\n","read_only":false},{"name":"ssl_info","title":"","description":"Get SSL certificate information for a site.\n\nReturns certificate details, expiry date, and issuer.\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"issuer\": \"Let's Encrypt\", \"domain\": \"example.com\",\n     \"expires_at\": \"iso8601\", \"days_remaining\": 60,\n     \"force_https\": true}\n","read_only":false},{"name":"ssl_renew","title":"","description":"Force SSL certificate renewal via certbot.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"renewed\": true, \"expires_at\": \"iso8601\"}\n","read_only":false},{"name":"list_php_versions","title":"","description":"List available PHP versions and the currently active one.\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"versions\": [{\"version\": \"8.1\", \"active\": false},\n     {\"version\": \"8.2\", \"active\": false},\n     {\"version\": \"8.3\", \"active\": true}]}\n","read_only":false},{"name":"switch_php","title":"","description":"Switch the active PHP version for a site.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    version: Target PHP version (e.g. \"8.3\", \"8.2\", \"8.1\")\n\nReturns:\n    {\"version\": \"8.3\", \"result\": {...}}\n","read_only":false},{"name":"cache_status","title":"","description":"Get cache status (Redis, WP object cache, hit rates).\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"redis_running\": true, \"object_cache_enabled\": true,\n     \"hit_rate\": 0.95, \"memory_used_mb\": 12}\n","read_only":false},{"name":"cache_flush","title":"","description":"Flush all caches (Redis + WP object cache).\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"flushed\": true}\n","read_only":false},{"name":"cache_toggle","title":"","description":"Enable or disable the WordPress object cache.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    enable: true to enable, false to disable\n\nReturns:\n    {\"enabled\": true}\n","read_only":false},{"name":"get_database_info","title":"","description":"Get WordPress database information (size, tables, row counts).\n\nRequires: API key with read scope. WordPress sites only.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"database\": \"wp_mysite\", \"size_mb\": 45.2,\n     \"tables\": 12, \"total_rows\": 15432}\n","read_only":false},{"name":"optimize_database","title":"","description":"Optimize WordPress database tables (reduces bloat).\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"optimized\": true, \"tables_optimized\": 12}\n","read_only":false},{"name":"database_search_replace","title":"","description":"Search and replace in WordPress database (e.g. URL migration).\n\nHandles serialized data safely. Use dry_run=true first to preview changes.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    old: String to search for (e.g. \"http://old-domain.com\")\n    new: Replacement string (e.g. \"https://new-domain.com\")\n    dry_run: Preview only without making changes (default: true)\n\nRetu","read_only":false},{"name":"list_databases","title":"","description":"List all databases on a site's container.\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"databases\": [\"wordpress\", \"app_db\", ...]}\n","read_only":false},{"name":"list_tables","title":"","description":"List tables in a database.\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n    database: Database name\n\nReturns:\n    {\"tables\": [{\"name\": \"wp_posts\", \"rows\": 1234, \"size_mb\": 5.2}, ...]}\n","read_only":false},{"name":"execute_query","title":"","description":"Run ONE bounded read against a site's database.\n\nOne statement, beginning with SELECT, SHOW, DESCRIBE or EXPLAIN, with no\nsecond statement and no data-modifying clause anywhere in it. The container\nproves the statement is a read before running it and caps the result: 200\nrows by default, 1000 maximum, 2 MB of cell data. `truncated` in the\nresponse says whether a cap was reached.\n\n⚠ THIS TOOL CANNO","read_only":false},{"name":"get_stack_info","title":"","description":"Get detailed system stack information (OS, PHP, DB, web server versions).\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"os\": \"Debian 12\", \"kernel\": \"6.1.0\",\n     \"php\": \"8.3.4\", \"mysql\": \"10.11.6-MariaDB\",\n     \"nginx\": \"1.24.0\", \"wordpress\": \"6.5\"}\n","read_only":false},{"name":"get_resource_snapshot","title":"","description":"Get current resource usage (CPU, memory, disk, load average).\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"cpu_percent\": 12.5, \"memory_mb\": 384, \"memory_total_mb\": 512,\n     \"disk_used_gb\": 3.2, \"disk_total_gb\": 10,\n     \"load_1m\": 0.5, \"load_5m\": 0.3, \"load_15m\": 0.2}\n","read_only":false},{"name":"cloudflare_proxy_status","title":"","description":"Get Cloudflare proxy (CDN) status for a site.\n\nShows whether traffic is routed through Cloudflare's CDN (orange cloud)\nor goes direct to origin (grey cloud / DNS-only).\n\nRequires: API key with read scope.\n\nArgs:\n    slug: Site identifier\n\nReturns:\n    {\"domain\": \"my-site.borealhost.ai\", \"has_record\": true,\n     \"proxied\": true, \"ip\": \"1.2.3.4\"}\n","read_only":false},{"name":"cloudflare_set_proxy","title":"","description":"Enable or disable Cloudflare CDN proxy for a site.\n\nWhen enabled (orange cloud): traffic goes through Cloudflare's CDN,\ngets caching, DDoS protection, and SSL termination at the edge.\nWhen disabled (grey cloud): traffic goes directly to origin server.\n\nRequires: API key with write scope.\n\nArgs:\n    slug: Site identifier\n    proxied: true to enable CDN proxy, false to disable\n\nReturns:\n    {\"domain","read_only":false}],"server_info":{"name":"BorealHost","version":"1.27.0"},"category":"cloud","tags":["data","productivity","agents"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-09-06","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/ai-borealhost-mcp/"}