sub-agents-mcp

Package (npm 0.15.1)

npx -y [email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "sub-agents-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "AGENTS_DIR": "<YOUR_VALUE>",
        "AGENT_TYPE": "<YOUR_VALUE>",
        "CURSOR_API_KEY": "<YOUR_VALUE>",
        "CLI_API_KEY": "<YOUR_VALUE>"
      }
    }
  }
}

• 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', 'opencode', 'mcode', or 'pi'
• 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 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/MiniMax Code/Pi not supported.