Sub Agents MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 456 installs a week from npm. Last commit 23 Oct 2026.
MCP server for delegating tasks to specialized AI sub-agents across coding tools
What the code does
We read the source, 1 d ago · rules 995398eba69f
What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.
childProcess = spawn(command, args, {
Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.
This code can reach further than it looks
We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.
Connect this server
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add sub-agents-mcp -e 'AGENTS_DIR=<AGENTS_DIR>' -e 'AGENT_TYPE=<AGENT_TYPE>' -- npx -y sub-agents-mcp{
"mcpServers": {
"sub-agents-mcp": {
"command": "npx",
"args": [
"-y",
"sub-agents-mcp"
],
"env": {
"AGENTS_DIR": "<AGENTS_DIR>",
"AGENT_TYPE": "<AGENT_TYPE>"
}
}
}
}[mcp_servers.sub-agents-mcp]
command = "npx"
args = ["-y", "sub-agents-mcp"]
env = { AGENTS_DIR = "<AGENTS_DIR>", AGENT_TYPE = "<AGENT_TYPE>" }{
"mcpServers": {
"sub-agents-mcp": {
"command": "npx",
"args": [
"-y",
"sub-agents-mcp"
],
"env": {
"AGENTS_DIR": "<AGENTS_DIR>",
"AGENT_TYPE": "<AGENT_TYPE>"
}
}
}
}{
"servers": {
"sub-agents-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"sub-agents-mcp"
],
"env": {
"AGENTS_DIR": "<AGENTS_DIR>",
"AGENT_TYPE": "<AGENT_TYPE>"
}
}
}
}Put your own values in place of
<AGENTS_DIR> (Absolute path to the directory containing agent definition files (.md or .txt)), <AGENT_TYPE> (Type of AI CLI to use: 'cursor', 'claude', 'gemini', 'codex', 'command-code', 'glm', 'kimi', 'grok', 'antigravity', 'opencode', 'mcode', or 'pi').
The author’s registry entry marks them as required.
Optional settings from the registry entry, left out of the block above:
AGENT_PERMISSION (Approval/sandbox level for sub-agents: 'read-only', 'safe-edit' (default), or 'yolo'), AGENT_MODEL (Optional model override applied to every sub-agent execution by this MCP server), AGENT_EFFORT (Optional backend-specific reasoning effort or model variant. Supported by codex, claude, command-code, glm, kimi, grok, antigravity, opencode, mcode, and pi), CURSOR_API_KEY (API key for cursor-agent authentication (used only when AGENT_TYPE=cursor; passed via env, never via CLI args)), CLI_API_KEY (Provider API key for AGENT_TYPE=glm or kimi (passed to the claude binary via env, never via CLI args). Restart/reconnect the MCP server after changing it), EXECUTION_TIMEOUT_MS (Agent execution timeout in milliseconds, as a positive whole number (default: 300000). The server refuses to start on an invalid value such as "5min"), SESSION_ENABLED (Enable session management to maintain execution history across agent calls (default: false)), SESSION_DIR (Directory path for storing session files (default: .mcp-sessions in current working directory)), SESSION_RETENTION_DAYS (Number of days to retain session history before automatic cleanup (default: 1)), AGENTS_SETTINGS_PATH (Path to CLI settings file/directory. Claude: --settings arg, Cursor: CURSOR_CONFIG_DIR, Codex: CODEX_HOME. GLM/Kimi/Gemini/Grok/Antigravity/OpenCode/Command Code/MiniMax Code/Pi not supported).
Alternatives to Sub Agents MCP
same job, measured the same wayMCP server mode for Qoder CLI — delegate coding tasks to local Qoder agents from any MCP client.
A growing Citadel of stack-specific docs, served as MCP tools for AI coding agents.
BridgeGuard MCP Server - Cross-chain bridge security audit tools for AI coding agents. Scan bri...
MCP server for Safari DevTools — browser debugging and automation for AI coding agents
App Store Connect MCP Server for AI coding agents
DeFiGuard MCP Server - DeFi protocol risk analysis tools for AI coding agents. Analyze token co...
Task management for AI coding agents — CQRS 2-gateway pattern, 200 ops across 10 domains
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
Sub Agents MCP — questions
Answers built from our own checks of this server.