Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Subagentsplan and execute a data analysis pipeline for customer feedback"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-subagents
MCP stdio server that exposes a planner tool plus recursive code/analysis subagents. It is built for Codex MCP-server mode: start the process and point your MCP-capable client at stdio.
Features
Planner tool that decomposes tasks and delegates.
Code and analysis subagents that can delegate recursively (depth limited).
Session-aware scratchpad persisted to
data/sessions/*.json.Uses MCP client sampling (no server-side API key needed).
Includes a patch-package fix for GHSA-8r9q-7v3j-jr4g (UriTemplate ReDoS) in
@modelcontextprotocol/sdk@1.25.1.
Requirements
Node 18.18+.
MCP client capable of
createMessage(Codex CLI covers this).
Quickstart
cd my-repos/mcp-subagents
npm install
npm run dev # or: npm run start after npm run buildExpose via Codex MCP server mode by pointing to the stdio command above.
Tools
planner(task, context?, session_id?, max_depth?)– orchestrates the plan and delegates.subagent(role, objective, context?, session_id?, max_depth?)– run a specific role directly.session_log(session_id?)– read persisted scratchpad.session_clear(session_id?)– drop persisted scratchpad.
max_depth defaults to AGENT_MAX_DEPTH env (3). Session IDs let multiple conversations stay isolated.
This server cannot be installed
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.