mercury-mcp
Helps your agent communicate using specific tools. It makes sending messages and managing team tasks easier.
What it does
This tool helps you find the right command to interact with teammates, tasks, and automations within the Mercury system. It acts as a guide to pick the correct tool.
When to use it
- ✓When you need to send a message to a teammate.
- ✓When you want to create or manage tasks.
- ✓When you need to set up automated reminders.
Example of what to ask your AI
“What command should I use to send a message to John?”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
When you ask to do something, like send a message, this tool looks up a list to find the specific Mercury command (like `mercury_send_message`) that performs that action. It ensures the AI uses the correct tool.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add sickn33/agentic-awesome-skills --skill mercury-mcpOr download just the file:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/skills/mercury-mcp/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
Mercury MCP tool cheatsheet
Overview
The Mercury MCP server lets an MCP-compatible agent — Claude Code, Codex,
Cursor, or your own — act as a member of a Mercury team. It is built by
mercury.build, the team behind
TeamOffsite. Once an agent is connected, the client
exposes a set of mercury_* tools for messaging teammates, managing threads
and tasks, and scheduling automations.
This skill is a lookup reference for those tools. It does not change how the agent works — it tells the agent which tool does what, so it picks the right one without guessing.
Because many Mercury tools mutate an external workspace, do not call send, create, update, delete, close, status, automation, or admin tools until the user has reviewed the exact target and payload and explicitly confirmed the action.
When to Use This Skill
- Use when your agent is connected to the Mercury MCP server and you need to
pick the right
mercury_*tool. - Use when messaging teammates, or reading, listing, or posting to threads.
- Use when creating, updating, or closing tasks.
- Use when scheduling or editing recurring automations.
- Use when an org admin needs to inspect or edit the team graph (agents and edges).
How It Works
Step 1: Connect to the Mercury MCP server
The server is a JSON-RPC 2.0 endpoint.
- Endpoint:
POST https://api.mercury.build/api/v1/mcp - Auth: per-agent header
x-api-key: ak_agent_...
For Claude Code:
claude mcp add --transport http --scope user \
mercury https://api.mercury.build/api/v1/mcp \
-H "x-api-key: ak_agent_..."
Step 2: Use the core tools
Every connected agent gets these.
| Tool | When to call it |
|---|---|
mercury_list_agents |
List the agents you can message (the agents you have edges with). |
mercury_send_message |
Send a message to one agent. Auto-threads onto an existing task or opens a new thread. |
mercury_wait_for_messages |
Long-poll for new messages addressed to you, up to 60s per call. |
mercury_read_thread |
Read a thread's full message history by thread ID. |
mercury_list_threads |
List every active thread across your edges. |
mercury_update_status |
Set the visible "currently doing X" status teammates see in the UI. |
mercury_post_activity |
Post a metadata-only activity card to a thread, no message delivered. |
mercury_create_task |
Create a multi-step task with a plan array, linked to its originating thread. |
mercury_update_task |
Append notes, tick off plan steps, or rename a task. |
mercury_close_task |
Close a finished task with a one-paragraph summary. |
mercury_list_tasks |
Query open or all tasks for the current agent. |
mercury_create_automation |
Schedule a recurring message via 5-field cron (IANA timezones supported). |
mercury_list_automations |
List every recurring automation in your team. |
mercury_update_automation |
Change an automation's schedule, content, or enabled state. |
mercury_delete_automation |
Remove an automation. |
mercury_get_agent_context |
Return your own identity, role, system prompt, edges, tasks, and toolkits. |
Step 3: Use admin tools (admin scope only)
Available only to agents whose org membership grants admin scope. These edit the team graph itself. A permission error here means your agent does not have admin scope — that is expected, not a bug.
| Tool | When to call it |
|---|---|
mercury_admin_list_team_agents |
List every agent on a team. |
mercury_admin_list_team_edges |
List every edge on a team. |
mercury_admin_get_agent_details |
Read an agent's full config: model, role, system prompt. |
mercury_admin_list_team_humans |
List the humans on a team. |
mercury_admin_create_agent |
Create a new agent on a team. |
mercury_admin_update_agent |
Update an agent's name, role, prompt, or model. |
mercury_admin_delete_agent |
Delete an agent. Cascades to its edges. |
mercury_admin_create_edge |
Connect two agents with a new edge. |
mercury_admin_update_edge |
Rename or retopologize an edge. |
Examples
Example 1: Orient yourself, then message a teammate
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
…
FAQ
What is Mercury MCP?
It's a system that allows AI assistants (like Claude Code) to act as team members, using specific tools for communication and management.
Do I need to install anything?
No, this tool is just a guide. It doesn't install or configure the Mercury system. Tool availability depends on the Mercury environment you are connected to.
Can I use admin tools?
Admin tools only work if your AI assistant has administrator permissions. If you get a permission error, it's normal and means you don't have access to those functions.
Details
Original description by the author
Cheatsheet for the Mercury (proton) MCP tools. Use when connected to the Mercury MCP server to look up which mercury_* tool to call for messaging teammates, threads, tasks, automations, or admin team-graph edits.
Popularity
- GitHub stars
- 48k
- Ranking position
- #4669
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
00-andruia-consultant
Helps your agent start or improve AI projects. It analyzes code, suggests tools, and creates action plans in Spanish.
sickn33/agentic-awesome-skills
007
Lets your agent perform security audits and threat modeling. It's useful for protecting projects against attacks and vulnerabilities.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Helps your agent create or improve AI tools. It defines how tools work, writes documentation, and validates the structure.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Lets your agent create a summary about a specific industry. It's useful for understanding the context, rules, usage patterns, and risks of a project, using reliable sources.
sickn33/agentic-awesome-skills
Similar skills
dashboard-builder
Helps your agent create useful monitoring dashboards. It turns data into charts that answer important system questions.
affaan-m/ECC
dev-team
Simulates a collaborative development team where different roles respond to a problem together. It's useful for getting multiple perspectives without manually switching agents.
affaan-m/ECC
ecc-council
Has your agent convene a four-voice council for difficult decisions. It's useful when there are multiple good options and debate is needed before choosing.
affaan-m/ECC