mcpbeat Sign in

Sub Agents MCP Server

local only

Sub Agents MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 217 installs a week from npm. Last commit 10 Sep 2026.

MCP server for delegating tasks to specialized AI sub-agents across coding tools

Installs per day peak 237 · avg 57 · +101% w/w
a month agotoday
217
Installs / week
npm · sub-agents-mcp
98
Stars
0 open issues
10 Sep 2026
Last commit
0 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 19 h ago · rules 3dff92dd89df

Capabilities

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.

Runs an external command src/execution/AgentExecutor.ts:964
      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.

Three servers free · no card

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.

run in your terminal
claude mcp add sub-agents-mcp -- npx -y sub-agents-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "sub-agents-mcp": {
      "args": [
        "-y",
        "sub-agents-mcp"
      ],
      "command": "npx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.sub-agents-mcp]
command = "npx"
args = ["-y", "sub-agents-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "sub-agents-mcp": {
      "args": [
        "-y",
        "sub-agents-mcp"
      ],
      "command": "npx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "sub-agents-mcp": {
      "args": [
        "-y",
        "sub-agents-mcp"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: 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', or 'opencode'), 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, and opencode.), 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 not supported.). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Sub Agents MCP

same job, measured the same way
Qodercli MCP
by cantbeblank96

MCP server mode for Qoder CLI — delegate coding tasks to local Qoder agents from any MCP client.

105 installs/wk local only
Citadel MCP
by sustinbebustin

A growing Citadel of stack-specific docs, served as MCP tools for AI coding agents.

44 installs/wk local only
Bridgeguard MCP
by kota1026

BridgeGuard MCP Server - Cross-chain bridge security audit tools for AI coding agents. Scan bri...

54 installs/wk local only
Safari DevTools MCP
by hayodev

MCP server for Safari DevTools — browser debugging and automation for AI coding agents

55 installs/wk local only
Asc MCP Server
by muhammetali

App Store Connect MCP Server for AI coding agents

51 installs/wk local only
Defiguard MCP
by kota1026

DeFiGuard MCP Server - DeFi protocol risk analysis tools for AI coding agents. Analyze token co...

33 installs/wk local only
CLEO MCP Server
by kryptobaseddev

Task management for AI coding agents — CQRS 2-gateway pattern, 200 ops across 10 domains

1 077 installs/wk local only
Everstake
by everstake

MCP server connecting AI agents to non-custodial staking data across 130+ networks.

11 tools answering

Sub Agents MCP — questions

Answers built from our own checks of this server.

Why is there no uptime for Sub Agents MCP?
Sub Agents MCP runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package sub-agents-mcp was installed 217 times last week.
How do I connect Sub Agents MCP?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls sub-agents-mcp straight from npm; nothing to host, nothing to sign up for.
How many people use Sub Agents MCP?
The npm package sub-agents-mcp was installed 217 times in the last week. Week over week that is +101%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Sub Agents MCP open source?
Yes — it is published under the MIT licence, written in TypeScript and 98 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.