sub-agents-mcp

Name: sub-agents-mcp
Author: shinpr

Community

MCP server by shinpr · updated 8 days ago · ★ 99 · 294 downloads a week

Score 78

MCP server for delegating tasks to specialized AI sub-agents across coding tools sub-agents-mcp is a community project by shinpr, not verified by a company domain.

Install Add to Cursor Add to VS Code GitHub

Yours? Claim it

Works withClaude Code Claude Desktop Cursor Codex Gemini CLI VS Code Windsurf Antigravity CLI

Maintenance

Last commit 8 days ago

Licence

MIT: permissive, fine for commercial use

Quality

Clear description, published package or server URL, 99 stars, original repository

Security

No risky patterns in the files we checked

What you need

Setting	Needed	What it is
`AGENTS_DIR`Environment variable	Required	Absolute path to the directory containing agent definition files (.md or .txt)
`AGENT_TYPE`Environment variable	Required	Type of AI CLI to use: 'cursor', 'claude', 'gemini', 'codex', 'command-code', 'glm', 'kimi', 'grok', 'antigravity', 'opencode', 'mcode', or 'pi'
`AGENT_PERMISSION`Environment variable	Optional	Approval/sandbox level for sub-agents: 'read-only', 'safe-edit' (default), or 'yolo'
`AGENT_MODEL`Environment variable	Optional	Optional model override applied to every sub-agent execution by this MCP server
`AGENT_EFFORT`Environment variable	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`Environment variable, secret	Optional	API key for cursor-agent authentication (used only when AGENT_TYPE=cursor; passed via env, never via CLI args)
`CLI_API_KEY`Environment variable, secret	Optional	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`Environment variable	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`Environment variable	Optional	Enable session management to maintain execution history across agent calls (default: false)
`SESSION_DIR`Environment variable	Optional	Directory path for storing session files (default: .mcp-sessions in current working directory)
`SESSION_RETENTION_DAYS`Environment variable	Optional	Number of days to retain session history before automatic cleanup (default: 1)
`AGENTS_SETTINGS_PATH`Environment variable	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.

From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.

Install sub-agents-mcp

Built from the published package, never by AI

claude mcp add sub-agents-mcp -e AGENTS_DIR=YOUR_AGENTS_DIR -e AGENT_TYPE=YOUR_AGENT_TYPE -- npx -y sub-agents-mcp

Run in your terminal. Add --scope user to use it in every project.

Step-by-step: install sub-agents-mcp in Claude Code

{
  "mcpServers": {
    "sub-agents-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sub-agents-mcp"
      ],
      "env": {
        "AGENTS_DIR": "YOUR_AGENTS_DIR",
        "AGENT_TYPE": "YOUR_AGENT_TYPE"
      }
    }
  }
}

Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.

Step-by-step: install sub-agents-mcp in Claude Desktop

{
  "mcpServers": {
    "sub-agents-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sub-agents-mcp"
      ],
      "env": {
        "AGENTS_DIR": "YOUR_AGENTS_DIR",
        "AGENT_TYPE": "YOUR_AGENT_TYPE"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).

Step-by-step: install sub-agents-mcp in Cursor

{
  "servers": {
    "sub-agents-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sub-agents-mcp"
      ],
      "env": {
        "AGENTS_DIR": "YOUR_AGENTS_DIR",
        "AGENT_TYPE": "YOUR_AGENT_TYPE"
      }
    }
  }
}

Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".

Step-by-step: install sub-agents-mcp in VS Code

codex mcp add sub-agents-mcp --env AGENTS_DIR=YOUR_AGENTS_DIR --env AGENT_TYPE=YOUR_AGENT_TYPE -- npx -y sub-agents-mcp

Step-by-step: install sub-agents-mcp in Codex

{
  "mcpServers": {
    "sub-agents-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sub-agents-mcp"
      ],
      "env": {
        "AGENTS_DIR": "YOUR_AGENTS_DIR",
        "AGENT_TYPE": "YOUR_AGENT_TYPE"
      }
    }
  }
}

Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).

Step-by-step: install sub-agents-mcp in Antigravity CLI

gemini mcp add sub-agents-mcp npx -y sub-agents-mcp

Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.

Step-by-step: install sub-agents-mcp in Gemini CLI

MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the sub-agents-mcp block.

Weekly newsletter

Like sub-agents-mcp? Get the best new MCP servers every week

The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.

Security check

No download-and-run commands, hidden instructions or signs of sending keys out were found.

Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work

Alternatives to sub-agents-mcp

All alternatives →

Agent-Native CalendarBuilderIO

Agent-Native Google Calendar - manage events, sync, and public booking

AAA Remote 7.4k

Agent-Native ClipsBuilderIO

Screen recording, meeting notes, and voice dictation - all with AI

AAA Remote 7.4k

kaneousekaneo

Official MCP server for Kaneo: manage tasks, projects, and labels from Claude and other MCP clients

AAA Local 9.5k

Agent Afk griffinwork40

Open-source coding-agent harness you can actually change — own the loop (prompts, gates, routing, skills, terminal states), use any model, run long tasks while you're away.

AAB Local 65k/wk

Korean Law MCP chrisryugj

법제처 42개 API → 9개 MCP 도구. 법령·판례·조례·조약 + 다단계 리서치(legal_research, 8 task) + 정밀분석(legal_analysis: 인용검증·판례생사·행위시법·영향그래프) + 시점 비교(time_travel) + 상황별 5단계 안내(action_plan) + 국세청 해석례(nts)

AAA Local 2.8k/wk

Anki MCP Server ankimcp

MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.

AAA Local 703/wk

sub-agents-mcp vs Agent-Native Calendar sub-agents-mcp vs Agent-Native Clips sub-agents-mcp vs kaneo

sub-agents-mcp: common questions

How do I install sub-agents-mcp?

In Claude Code run claude mcp add sub-agents-mcp -e AGENTS_DIR=YOUR_AGENTS_DIR -e AGENT_TYPE=YOUR_AGENT_TYPE -- npx -y sub-agents-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.

Is sub-agents-mcp the official server?

sub-agents-mcp is a community project by shinpr, not verified by a company domain.

Is sub-agents-mcp free?

The code is published under the MIT licence. The service it connects to may have its own pricing.

Is sub-agents-mcp safe to use?

It scores 78 of 100. Grades: maintenance A, licence A, quality B. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.

What are alternatives to sub-agents-mcp?

Similar MCP servers: Agent-Native Calendar, Agent-Native Clips, kaneo, Agent Afk.

Does sub-agents-mcp work with ChatGPT?

Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.