sub-agents-mcp

sub-agents-mcp is a local MCP server: MCP server for delegating tasks to specialized AI sub-agents across coding tools. Install it from npm as sub-agents-mcp.

Claude CodeCodexAntigravity

commandprompt

Terminal

claude mcp add sub-agents-mcp -e AGENTS_DIR=... -e AGENT_TYPE=... -e AGENT_PERMISSION=... -e AGENT_MODEL=... -e AGENT_EFFORT=... -e CURSOR_API_KEY=... -e CLI_API_KEY=... -e EXECUTION_TIMEOUT_MS=... -e SESSION_ENABLED=... -e SESSION_DIR=... -e SESSION_RETENTION_DAYS=... -e AGENTS_SETTINGS_PATH=... -- npx -y sub-agents-mcp

Run in your project folder. Add --scope user to use it everywhere.

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "sub-agents-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sub-agents-mcp"
      ],
      "env": {
        "AGENTS_DIR": "...",
        "AGENT_TYPE": "...",
        "AGENT_PERMISSION": "...",
        "AGENT_MODEL": "...",
        "AGENT_EFFORT": "...",
        "CURSOR_API_KEY": "...",
        "CLI_API_KEY": "...",
        "EXECUTION_TIMEOUT_MS": "...",
        "SESSION_ENABLED": "...",
        "SESSION_DIR": "...",
        "SESSION_RETENTION_DAYS": "...",
        "AGENTS_SETTINGS_PATH": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

• Runtime: Node.js 18+ (runs with npx).
• MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
• Environment variables: AGENTS_DIR, AGENT_TYPE, AGENT_PERMISSION, AGENT_MODEL, AGENT_EFFORT, CURSOR_API_KEY, CLI_API_KEY, EXECUTION_TIMEOUT_MS, SESSION_ENABLED, SESSION_DIR, SESSION_RETENTION_DAYS, AGENTS_SETTINGS_PATH