智能体与 MCP

给智能体一个无法超支的令牌，并通过 MCP 接入。

给智能体一个专属令牌

在 API & agents 页面为智能体创建令牌，只授予它所需的内容：

令牌只显示一次。把它存放在智能体的密钥存储中，切勿写进提示词或代码仓库。设有上限的令牌每次租用都必须设置关停时间，会超出上限的租用将被拒绝。

MCP 端点是 $ARRAKIS_URL/mcp，使用智能体的令牌访问。它采用 MCP 的 Streamable HTTP 传输，响应为普通 JSON。

Claude Code:

Shell

claude mcp add --transport http arrakis $ARRAKIS_URL/mcp --header "Authorization: Bearer ark_..."

Cursor (mcp.json):

JSON

{
  "mcpServers": {
    "arrakis": {
      "url": "$ARRAKIS_URL/mcp",
      "headers": { "Authorization": "Bearer ark_..." }
    }
  }
}

工具	功能
`search_gpus`	查找机器，最好的排在最前面：综合考虑 GPU 性能、价格和主机商的可靠性。给出推荐的机器及理由。筛选条件：GPU 类型、最少和最多 GPU 数量、显存、每 GPU 小时最高价格、国家。
`get_market_summary`	按 GPU 系列查看实时价格和可用情况。
`get_balance`	余额还能支付多少。
`rent_gpu`	租用一台机器，返回机器信息和 SSH 命令。启动 `template_id` 对应的镜像，或任意公开 `image`。会计费。
`deploy_model`	在配置合适的机器上用 vLLM、SGLang 或 llama.cpp 部署 Hugging Face 模型，返回其端点和 API 密钥（部署模型）。会计费。
`list_images`	Arrakis 镜像和你保存的镜像，供 `template_id` 使用。
`list_instances`	你的机器。
`get_instance`	单台机器的最新信息，以及主机商发出的任何通知。
`get_events`	你的机器发生了什么：已就绪、已结束及原因（是否被主机商中断），以及主机商发出的通知。每个工具结果还会附带过去一天的提醒。
`terminate_instance`	停止并移除机器。
`schedule_removal`	设置机器何时自行移除。
`get_partner_earnings`	面向合作伙伴：你的合作伙伴码和链接、你带来的客户、你获得的收益，以及合作伙伴计划是否开放。
`join_partner_program`	在账户所有者同意的前提下，为该账户加入合作伙伴计划（/partners）。

为每次要进行的租用设置一个固定的 idempotency_key。用相同的键重试会返回同一台机器，而不会产生第二笔账单。通过 MCP 调用时，即使没有提供键，只要在 10 分钟内重复了相同的机器、名称和小时数，也会返回第一台机器。

以智能体身份阅读？请看本页的 Markdown 版本。