Sub Agents Mcp

io.github.shinpr/sub-agents-mcp · v0.15.1

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

Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add sub-agents-mcp -e AGENTS_DIR=<AGENTS_DIR> -e AGENT_TYPE=<AGENT_TYPE> -e AGENT_PERMISSION=<AGENT_PERMISSION> -e AGENT_MODEL=<AGENT_MODEL> -e AGENT_EFFORT=<AGENT_EFFORT> -e CURSOR_API_KEY=<CURSOR_API_KEY> -e CLI_API_KEY=<CLI_API_KEY> -e EXECUTION_TIMEOUT_MS=<EXECUTION_TIMEOUT_MS> -e SESSION_ENABLED=<SESSION_ENABLED> -e SESSION_DIR=<SESSION_DIR> -e SESSION_RETENTION_DAYS=<SESSION_RETENTION_DAYS> -e AGENTS_SETTINGS_PATH=<AGENTS_SETTINGS_PATH> -- npx -y [email protected]

claude_desktop_config.json

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

~/.cursor/mcp.json

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

.vscode/mcp.json

{
  "servers": {
    "sub-agents-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "AGENTS_DIR": "<AGENTS_DIR>",
        "AGENT_TYPE": "<AGENT_TYPE>",
        "AGENT_PERMISSION": "<AGENT_PERMISSION>",
        "AGENT_MODEL": "<AGENT_MODEL>",
        "AGENT_EFFORT": "<AGENT_EFFORT>",
        "CURSOR_API_KEY": "<CURSOR_API_KEY>",
        "CLI_API_KEY": "<CLI_API_KEY>",
        "EXECUTION_TIMEOUT_MS": "<EXECUTION_TIMEOUT_MS>",
        "SESSION_ENABLED": "<SESSION_ENABLED>",
        "SESSION_DIR": "<SESSION_DIR>",
        "SESSION_RETENTION_DAYS": "<SESSION_RETENTION_DAYS>",
        "AGENTS_SETTINGS_PATH": "<AGENTS_SETTINGS_PATH>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

Name	Description
`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` Optional	Approval/sandbox level for sub-agents: 'read-only', 'safe-edit' (default), or 'yolo'
`AGENT_MODEL` Optional	Optional model override applied to every sub-agent execution by this MCP server
`AGENT_EFFORT` Optional	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` Optional, secret	API key for cursor-agent authentication (used only when AGENT_TYPE=cursor; passed via env, never via CLI args)
`CLI_API_KEY` Optional, 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` Optional	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` Optional	Enable session management to maintain execution history across agent calls (default: false)
`SESSION_DIR` Optional	Directory path for storing session files (default: .mcp-sessions in current working directory)
`SESSION_RETENTION_DAYS` Optional	Number of days to retain session history before automatic cleanup (default: 1)
`AGENTS_SETTINGS_PATH` Optional	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.

Details

Package	`[email protected]` (NPM, stdio)
First published	22 Oct 2026
Last updated	22 Oct 2026
Registry name	`io.github.shinpr/sub-agents-mcp`

More ai and media servers See all

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use Sub Agents Mcp often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-shinpr-sub-agents-mcp/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-shinpr-sub-agents-mcp)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.