Sub-agents-mcp Server

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

Local serverstdio

What is the Sub-agents-mcp Server?

Sub-agents-mcp is an MCP integration. MCP server for delegating tasks to specialized AI sub-agents across coding tools.

Packages and local setup

The published npm package is sub-agents-mcp, version 0.14.2. Its declared MCP transport is stdio.

The package declares AGENTS_DIR (required): Absolute path to the directory containing agent definition files (.md or .txt); AGENT_TYPE (required): 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..

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 0.14.2 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related developer tools MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
AGENTS_DIRAbsolute path to the directory containing agent definition files (.md or .txt)Yes
AGENT_TYPEType of AI CLI to use: 'cursor', 'claude', 'gemini', 'codex', 'command-code', 'glm', 'kimi', 'grok', 'antigravity', or 'opencode'Yes
AGENT_PERMISSIONApproval/sandbox level for sub-agents: 'read-only', 'safe-edit' (default), or 'yolo'Optional
AGENT_MODELOptional model override applied to every sub-agent execution by this MCP serverOptional
AGENT_EFFORTOptional backend-specific reasoning effort or model variant. Supported by codex, claude, command-code, glm, kimi, grok, antigravity, and opencode.Optional
CURSOR_API_KEYAPI key for cursor-agent authentication (used only when AGENT_TYPE=cursor; passed via env, never via CLI args)Optional
CLI_API_KEYProvider 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.Optional
EXECUTION_TIMEOUT_MSAgent execution timeout in milliseconds, as a positive whole number (default: 300000). The server refuses to start on an invalid value such as "5min".Optional
SESSION_ENABLEDEnable session management to maintain execution history across agent calls (default: false)Optional
SESSION_DIRDirectory path for storing session files (default: .mcp-sessions in current working directory)Optional
SESSION_RETENTION_DAYSNumber of days to retain session history before automatic cleanup (default: 1)Optional
AGENTS_SETTINGS_PATHPath 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.Optional