SERVER
Sub Agents MCP
Rank #707io.github.shinpr/sub-agents-mcp
MCP server for delegating tasks to specialized AI sub-agents across coding tools
First listed
Nov 2, 2025
Last publish date
Aug 30, 2026
OVERVIEW
Sub Agents MCP is a Model Context Protocol (MCP) server published by shinpr. It ranks #707 of 115,591 servers tracked on MCP Toplist, and its repository has 96 GitHub stars. Sub Agents MCP is listed across 3 registries — Official MCP, PulseMCP and Glama, with 21 tracked versions. It was first listed on Nov 2, 2025 and most recently updated on Aug 30, 2026.
STANDING
#707of 115,591 tracked serversTop 1%
Ranks ahead of 114,884 of 115,591 servers on MCP Toplist.
Recent momentum
+13GitHub stars since Apr 27 (+16%)
CONNECT
Use Sub Agents MCP
API keyNeeds credentials
Requires user-supplied configuration before first use — typically an API key, token or connection string set via environment variables.
npm package
claude mcp add sub-agents-mcp -e "AGENTS_DIR=<your AGENTS_DIR>" -e "AGENT_TYPE=<your AGENT_TYPE>" -e "AGENT_PERMISSION=<your AGENT_PERMISSION>" -e "AGENT_MODEL=<your AGENT_MODEL>" -e "AGENT_EFFORT=<your AGENT_EFFORT>" -e "CURSOR_API_KEY=<your CURSOR_API_KEY>" -e "CLI_API_KEY=<your CLI_API_KEY>" -e "EXECUTION_TIMEOUT_MS=<your EXECUTION_TIMEOUT_MS>" -e "SESSION_ENABLED=<your SESSION_ENABLED>" -e "SESSION_DIR=<your SESSION_DIR>" -e "SESSION_RETENTION_DAYS=<your SESSION_RETENTION_DAYS>" -e "AGENTS_SETTINGS_PATH=<your AGENTS_SETTINGS_PATH>" -- npx -y sub-agents-mcpReplace each placeholder with your own value before saving.
npm package
[mcp_servers.sub-agents-mcp]
command = "npx"
args = ["-y", "sub-agents-mcp"]
[mcp_servers.sub-agents-mcp.env]
AGENTS_DIR = "<your AGENTS_DIR>"
AGENT_TYPE = "<your AGENT_TYPE>"
AGENT_PERMISSION = "<your AGENT_PERMISSION>"
AGENT_MODEL = "<your AGENT_MODEL>"
AGENT_EFFORT = "<your AGENT_EFFORT>"
CURSOR_API_KEY = "<your CURSOR_API_KEY>"
CLI_API_KEY = "<your CLI_API_KEY>"
EXECUTION_TIMEOUT_MS = "<your EXECUTION_TIMEOUT_MS>"
SESSION_ENABLED = "<your SESSION_ENABLED>"
SESSION_DIR = "<your SESSION_DIR>"
SESSION_RETENTION_DAYS = "<your SESSION_RETENTION_DAYS>"
AGENTS_SETTINGS_PATH = "<your AGENTS_SETTINGS_PATH>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
npm package
{
"mcpServers": {
"sub-agents-mcp": {
"command": "npx",
"args": [
"-y",
"sub-agents-mcp"
],
"env": {
"AGENTS_DIR": "<your AGENTS_DIR>",
"AGENT_TYPE": "<your AGENT_TYPE>",
"AGENT_PERMISSION": "<your AGENT_PERMISSION>",
"AGENT_MODEL": "<your AGENT_MODEL>",
"AGENT_EFFORT": "<your AGENT_EFFORT>",
"CURSOR_API_KEY": "<your CURSOR_API_KEY>",
"CLI_API_KEY": "<your CLI_API_KEY>",
"EXECUTION_TIMEOUT_MS": "<your EXECUTION_TIMEOUT_MS>",
"SESSION_ENABLED": "<your SESSION_ENABLED>",
"SESSION_DIR": "<your SESSION_DIR>",
"SESSION_RETENTION_DAYS": "<your SESSION_RETENTION_DAYS>",
"AGENTS_SETTINGS_PATH": "<your AGENTS_SETTINGS_PATH>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
npm package
{
"mcpServers": {
"sub-agents-mcp": {
"command": "npx",
"args": [
"-y",
"sub-agents-mcp"
],
"env": {
"AGENTS_DIR": "<your AGENTS_DIR>",
"AGENT_TYPE": "<your AGENT_TYPE>",
"AGENT_PERMISSION": "<your AGENT_PERMISSION>",
"AGENT_MODEL": "<your AGENT_MODEL>",
"AGENT_EFFORT": "<your AGENT_EFFORT>",
"CURSOR_API_KEY": "<your CURSOR_API_KEY>",
"CLI_API_KEY": "<your CLI_API_KEY>",
"EXECUTION_TIMEOUT_MS": "<your EXECUTION_TIMEOUT_MS>",
"SESSION_ENABLED": "<your SESSION_ENABLED>",
"SESSION_DIR": "<your SESSION_DIR>",
"SESSION_RETENTION_DAYS": "<your SESSION_RETENTION_DAYS>",
"AGENTS_SETTINGS_PATH": "<your AGENTS_SETTINGS_PATH>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
npm package
{
"servers": {
"sub-agents-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"sub-agents-mcp"
],
"env": {
"AGENTS_DIR": "<your AGENTS_DIR>",
"AGENT_TYPE": "<your AGENT_TYPE>",
"AGENT_PERMISSION": "<your AGENT_PERMISSION>",
"AGENT_MODEL": "<your AGENT_MODEL>",
"AGENT_EFFORT": "<your AGENT_EFFORT>",
"CURSOR_API_KEY": "<your CURSOR_API_KEY>",
"CLI_API_KEY": "<your CLI_API_KEY>",
"EXECUTION_TIMEOUT_MS": "<your EXECUTION_TIMEOUT_MS>",
"SESSION_ENABLED": "<your SESSION_ENABLED>",
"SESSION_DIR": "<your SESSION_DIR>",
"SESSION_RETENTION_DAYS": "<your SESSION_RETENTION_DAYS>",
"AGENTS_SETTINGS_PATH": "<your AGENTS_SETTINGS_PATH>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
npm package
{
"mcpServers": {
"sub-agents-mcp": {
"command": "npx",
"args": [
"-y",
"sub-agents-mcp"
],
"env": {
"AGENTS_DIR": "<your AGENTS_DIR>",
"AGENT_TYPE": "<your AGENT_TYPE>",
"AGENT_PERMISSION": "<your AGENT_PERMISSION>",
"AGENT_MODEL": "<your AGENT_MODEL>",
"AGENT_EFFORT": "<your AGENT_EFFORT>",
"CURSOR_API_KEY": "<your CURSOR_API_KEY>",
"CLI_API_KEY": "<your CLI_API_KEY>",
"EXECUTION_TIMEOUT_MS": "<your EXECUTION_TIMEOUT_MS>",
"SESSION_ENABLED": "<your SESSION_ENABLED>",
"SESSION_DIR": "<your SESSION_DIR>",
"SESSION_RETENTION_DAYS": "<your SESSION_RETENTION_DAYS>",
"AGENTS_SETTINGS_PATH": "<your AGENTS_SETTINGS_PATH>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
npm package
{
"mcpServers": {
"sub-agents-mcp": {
"command": "npx",
"args": [
"-y",
"sub-agents-mcp"
],
"env": {
"AGENTS_DIR": "<your AGENTS_DIR>",
"AGENT_TYPE": "<your AGENT_TYPE>",
"AGENT_PERMISSION": "<your AGENT_PERMISSION>",
"AGENT_MODEL": "<your AGENT_MODEL>",
"AGENT_EFFORT": "<your AGENT_EFFORT>",
"CURSOR_API_KEY": "<your CURSOR_API_KEY>",
"CLI_API_KEY": "<your CLI_API_KEY>",
"EXECUTION_TIMEOUT_MS": "<your EXECUTION_TIMEOUT_MS>",
"SESSION_ENABLED": "<your SESSION_ENABLED>",
"SESSION_DIR": "<your SESSION_DIR>",
"SESSION_RETENTION_DAYS": "<your SESSION_RETENTION_DAYS>",
"AGENTS_SETTINGS_PATH": "<your AGENTS_SETTINGS_PATH>"
}
}
}
}Replace each placeholder with your own value before saving.
BADGE
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
Markdown
[](https://mcptoplist.com/server/io.github.shinpr%2Fsub-agents-mcp)HTML
<a href="https://mcptoplist.com/server/io.github.shinpr%2Fsub-agents-mcp"><img src="https://mcptoplist.com/badge/io.github.shinpr%2Fsub-agents-mcp.svg" alt="MCP Toplist: Top 1% of 115,591" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
REGISTRIES
Listed on 1 registry (2 delisted)
ORGANIZATION
shinpr
MORE FROM THIS PUBLISHER
Other servers by shinpr
View all shinpr servers →VERSIONS
Available versions (21)
| Version | Published |
|---|---|
| 0.14.0 | Aug 30, 2026 |
| 0.13.0 | Aug 23, 2026 |
| 0.12.1 | Aug 8, 2026 |
| 0.12.0 | Jul 29, 2026 |
| 0.8.0 | May 7, 2026 |
| 0.7.1 | Apr 20, 2026 |
| 0.7.0 | Mar 30, 2026 |
| 0.6.0 | Mar 29, 2026 |
| 0.5.3 | Feb 4, 2026 |
| 0.5.2 | Jan 14, 2026 |
| 0.5.1 | Jan 8, 2026 |
| 0.5.0 | Jan 3, 2026 |
| 0.4.1 | Jan 2, 2026 |
| 0.4.0 | Dec 12, 2025 |
| 0.3.0 | Dec 8, 2025 |
| 0.2.3 | Dec 5, 2025 |
| 0.2.2 | Dec 2, 2025 |
| 0.2.0 | Nov 22, 2025 |
| 0.1.5 | Nov 9, 2025 |
| 0.1.4 | Nov 2, 2025 |
| 0.1.0 | Nov 25, 2024 |
FAQ
Frequently asked questions
- Who maintains Sub Agents MCP?
- Sub Agents MCP is maintained by shinpr, which publishes 3 MCP servers (92 total versions) tracked on MCP Toplist.
- Is Sub Agents MCP listed on the Official MCP Registry?
- Yes — Sub Agents MCP is listed on the Official MCP Registry, alongside PulseMCP and Glama.
- How many versions does Sub Agents MCP have?
- MCP Toplist tracks 21 versions of Sub Agents MCP, most recently published on Aug 30, 2026.
- Where can I find the source code for Sub Agents MCP?
- The source code for Sub Agents MCP is hosted at github.com/shinpr/sub-agents-mcp.
EXPLORE