---

name: mercury-mcp description: "Mercury (proton) MCP 工具速查表。连接到 Mercury MCP 服务器时使用，查找应调用哪个 mercury_* 工具来发送消息、管理线程、任务、自动化或管理员团队图编辑。" risk: safe source: community date_added: "2026-05-19"

Mercury MCP 工具速查表

概述

Mercury MCP 服务器让兼容 MCP 的代理——Claude Code、Codex、Cursor 或你自己的代理——作为 Mercury 团队的成员运作。它由 mercury.build 构建，即 TeamOffsite 背后的团队。一旦代理连接，客户端会暴露一组 mercury_* 工具，用于向队友发消息、管理线程和任务以及调度自动化。

本技能是这些工具的查找参考。它不会改变代理的工作方式——它告诉代理哪个工具做什么，这样代理就能选对工具而无需猜测。

使用时机

• 当你的代理连接到 Mercury MCP 服务器且需要选择正确的 mercury_* 工具时使用。
• 向队友发消息，或读取、列出、发布到线程时使用。
• 创建、更新或关闭任务时使用。
• 调度或编辑定期自动化时使用。
• 组织管理员需要检查或编辑团队图（代理和边）时使用。

工作原理

步骤 1：连接到 Mercury MCP 服务器

服务器是 JSON-RPC 2.0 端点。

• 端点：POST https://api.mercury.build/api/v1/mcp
• 认证：每个代理的头部 x-api-key: ak_agent_...

对于 Claude Code：

claude mcp add --transport http --scope user \
  mercury https://api.mercury.build/api/v1/mcp \
  -H "x-api-key: ak_agent_..."

步骤 2：使用核心工具

每个连接的代理都可以使用这些工具。

| 工具 | 何时调用 | | --- | --- | | mercury_list_agents | 列出你可以发消息的代理（与你有边连接的代理）。 | | mercury_send_message | 向一个代理发送消息。自动关联到现有任务或打开新线程。 | | mercury_wait_for_messages | 长轮询等待发给你的新消息，每次调用最多 60 秒。 | | mercury_read_thread | 通过线程 ID 读取线程的完整消息历史。 | | mercury_list_threads | 列出你所有边上的每个活跃线程。 | | mercury_update_status | 设置队友在 UI 中看到的"当前正在做 X"状态。 | | mercury_post_activity | 向线程发布仅元数据的活动卡片，不发送消息。 | | mercury_create_task | 创建带有计划数组的多步骤任务，关联到其发起线程。 | | mercury_update_task | 追加备注、勾选计划步骤或重命名任务。 | | mercury_close_task | 用一段摘要关闭已完成的任务。 | | mercury_list_tasks | 查询当前代理的开放或所有任务。 | | mercury_create_automation | 通过 5 字段 cron 调度定期消息（支持 IANA 时区）。 | | mercury_list_automations | 列出团队中的每个定期自动化。 | | mercury_update_automation | 更改自动化的调度、内容或启用状态。 | | mercury_delete_automation | 删除自动化。 | | mercury_get_agent_context | 返回你自己的身份、角色、系统提示、边、任务和工具包。 |

步骤 3：使用管理工具（仅管理员范围）

仅对组织成员资格授予管理员范围的代理可用。这些工具编辑团队图本身。此处的权限错误意味着你的代理没有管理员范围——这是预期的，不是 bug。

| 工具 | 何时调用 | | --- | --- | | mercury_admin_list_team_agents | 列出团队中的每个代理。 | | mercury_admin_list_team_edges | 列出团队中的每条边。 | | mercury_admin_get_agent_details | 读取代理的完整配置：模型、角色、系统提示。 | | mercury_admin_list_team_humans | 列出团队中的人类成员。 | | mercury_admin_create_agent | 在团队中创建新代理。 | | mercury_admin_update_agent | 更新代理的名称、角色、提示或模型。 | | mercury_admin_delete_agent | 删除代理。级联删除其边。 | | mercury_admin_create_edge | 用新边连接两个代理。 | | mercury_admin_update_edge | 重命名或重新拓扑化边。 |

示例

示例 1：了解自己，然后给队友发消息

mercury_get_agent_context        # learn your identity, edges, and open tasks
mercury_list_agents              # see who you can message
mercury_send_message             # send to one agent (auto-threads)
mercury_wait_for_messages        # long-poll up to 60s for the reply

示例 2：创建和跟踪任务

mercury_create_task              # open a multi-step task with a plan array
mercury_update_task              # tick off plan steps / append notes as you go
mercury_close_task               # close it with a one-paragraph summary

最佳实践

• 首先调用 mercury_get_agent_context——它在一次调用中返回你的身份、边、任务和工具包。
• 使用 mercury_wait_for_message 进行长轮询