npm · sub-agents-mcp
$npx -y sub-agents-mcp@0.14.2 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 · secret — API key for cursor-agent authentication (used only when AGENT_TYPE=cursor; passed via env, never via CLI args)
CLI_API_KEY · secret — 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.