BorealHost

将站点开通到您已付费套餐包含的槽位中。“创建站点”可能指两件不同的事。购买一个站点是结账流程（create_checkout → update → complete）。这是另一种：大多数套餐包含多个站点，此工具使用其中一个，无需额外费用。site_starter 包含 5 个，site_plus 8 个，site_pro 12 个，代理套餐更多。whoami 和 list_sites 显示账户已拥有的内容。当有空闲槽位时，优先使用此工具而不是购买第二个订阅。

放弃未付款的结账并使其 Stripe 支付链接过期。使用此工具清理已放弃的尝试，而不是让它们闲置。已完成的结账绝不会在此取消——那将是退款，会被拒绝。

使用容器中的声明令牌来声明 API 密钥。在调用 request_api_key() 后，从该站点容器中该调用返回的 claim_path 路径读取声明令牌，并在此处传递。令牌是一次性的——一旦声明，便无法再次使用。API 密钥会自动激活用于此 MCP 会话。

完成结账并付款，开始站点开通。结账必须处于“ready”状态。两种付款方式：“stripe_checkout”（默认）返回一个简短的、聊天安全的支付 URL。请向人类展示 payment_url——而不是 stripe_checkout_url。付款后，轮询 get_checkout_status() 直到状态变为“completed”。“stripe_payment_method”直接对 Stripe PaymentMethod 收费，需要 payment_method_id。成功后立即返回 API 密钥。

开始新的结账会话以购买托管套餐。无需认证。创建后，调用 update_checkout 设置买家信息，然后调用 complete_checkout 付款。响应包含一次性的 checkout_secret，后续每一步都需要。它保存在此 MCP 会话的内存中并自动发送——但如果服务器重启则会丢失。如果设置了会话密钥，则结账归该账户所有，API 密钥自行授权后续步骤，这是持久化的路径。

获取应用安装状态和日志。在 install_app() 后轮询此工具以跟踪进度。需要：具有读取权限的 API 密钥。状态：installing、running、stopped、failed、uninstalled。

轮询结账会话以获取状态更新。在 complete_checkout 后调用以跟踪付款和开通。轮询策略：前 60 秒每 5 秒一次；60 秒后每 15 秒一次；10 分钟后未完成则停止。结账状态：not_ready、ready、awaiting_payment、in_progress、completed、canceled、failed。终态：completed、canceled、failed。

获取托管站点的详细状态，包括资源、域名和模块。需要：具有读取权限的 API 密钥。

账户的预付费余额，以及此密钥可从中支出的金额。有两个上限，且都适用：余额限制账户，额度限制此密钥在账户内的支出。请根据 spendable_cents（两者中较低者）进行规划。can_spend: false 且余额非零是正常的，表示此密钥没有分配预算。只读。资金通过人类进入——能够自行充值预算的 Agent 没有预算。

在 VPS/Cloud 站点上安装应用模板。启动后台安装。轮询 get_app_status() 以获取进度。需要：具有写入权限的 API 密钥。仅限 VPS 或 Cloud 套餐。模板：django、laravel、nextjs、nodejs、nuxtjs、rails、static。

列出站点上已安装的应用。需要：具有读取权限的 API 密钥。

列出属于已认证账户的结账。需要：API 密钥。仅显示有记录所有者的结账——即认证期间创建的每个结账，以及每个已付款的结账。丢失一次性密钥的匿名结账无法列出；请以认证方式创建结账以使其可寻址。

列出可用的托管套餐及其定价和资源。无需认证。可选按轨道（single_site 或 agency）过滤，并可包含已弃用的套餐。

为站点创建或删除 DNS 记录。需要：具有写入权限的 API 密钥。操作：create 或 delete。记录类型：A、AAAA、CNAME、MX、TXT、SRV。

注册一个新的 Agent 账户并获取 API 密钥。无需认证。返回的 API 密钥授予对 BorealHost 所有 API 端点的读写权限。请安全存储——无法再次检索。该密钥会自动激活用于当前会话。如果未提供邮箱，将创建合成 Agent 身份；如果提供邮箱，则关联到现有或新的人类账户。

为当前运行的站点请求 API 密钥（挑战-响应）。仅当您在该站点自己的容器内执行时才使用此工具。如果您从其他地方购买或订购了该站点，则不应使用此工具。请对支付该站点的结账调用 get_checkout_status(checkout_id)。两步验证流程：1. 将声明令牌写入该站点的容器中，路径由响应中的 claim_path 提供。2. 读取该文件并在 1 小时内调用 claim_api_key(token)。共享容器上的站点会被拒绝。

为当前会话设置 BorealHost API 密钥。如果您已有 API 密钥（来自之前的注册、结账完成或 BorealHost 面板），请调用此工具。后续所有工具调用将使用此密钥进行认证。在 register() 之后无需调用——密钥会自动设置。

更改站点文档根目录的类型，而不删除任何内容。类型：wordpress、php、php-nodb、static-site。非破坏性。现有文件保留在磁盘上，现有数据库不会被删除。它们仍然是客户的数据，并继续计入其套餐配额——这改变了站点的服务方式，而不是其内容。移动到没有 PHP 的类型不仅停止执行 .php——还停止提供它们。仅限共享托管。

在结账会话上设置买家邮箱和所需的站点 slug。结账必须处于“not_ready”状态。设置 requested_slug 会将状态转换为“ready”（完成前必需）。

检查当前 API 密钥的账户信息、权限范围和站点数量。需要：BOREALHOST_API_KEY 环境变量（读取权限）。