Sub Agents MCP

Bring Claude Code–style sub-agents to any MCP-compatible tool. Define task-specific AI agents such as "test-writer" or "code-reviewer" in Markdown files. The server runs them through Cursor CLI, Claude Code, Codex, Google Antigravity, Gemini CLI, GLM, Kimi, Grok Build, or OpenCode. It runs locally over stdio via the published package.

People connecting productivity tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-23 · ★ 96 · #9 OF 139 MAINTAINED PRODUCTIVITY · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Sub Agents MCP

before you install - you'll need

Set AGENTS_DIR, EXECUTION_TIMEOUT_MS, AGENTS_SETTINGS_PATH, GEMINI_API_KEY before connecting. AGENT_TYPE, SESSION_ENABLED, SESSION_DIR, SESSION_RETENTION_DAYS are optional or environment-specific per the README.

Claude Code

claude mcp add shinpr-sub-agents-mcp -- npx -y sub-agents-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "shinpr-sub-agents-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sub-agents-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package sub-agents-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.shinpr is GitHub-verified and matches the repo owner

03 · What Sub Agents MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.13.1 · 2026-08-23

Enabled Cursor CLI workspace sandboxing for read-only and safe-edit sub-agents. read-only remains in plan mode, while yolo remains unsandboxed.

v0.13.0 · 2026-08-23

Added Google Antigravity support through Antigravity CLI (agy 1.1.12 or later), including permission modes and model/effort overrides. · AGENT_TYPE is now required and no longer defaults to cursor. Set it explicitly in…

v0.12.1 · 2026-08-08

Added backend-aware stream parsing for all supported CLI providers. · Improved terminal result validation to prevent premature process termination. · Preserved agent errors correctly instead of reporting them as…

04 · Who maintains Sub Agents MCP

sub-agents-mcp is maintained by shinpr. We track 3 MCP servers from shinpr - 3 actively maintained, 622 combined GitHub stars, oldest repo from Aug 2025. Full record: all servers from shinpr.

05 · Facts

repository: github.com/shinpr/sub-agents-mcp
category: productivity - ranked #9 of 139 actively-maintained productivity servers as of 2026-08-25.
release cadence: 8 releases in the last 90 days (latest 2026-08-23)
registry: io.github.shinpr/sub-agents-mcp (active, first published 2025-11-02 · 24 versions)
packages: npm:sub-agents-mcp

06 · Sub Agents MCP FAQ

What is Sub Agents MCP?

Is Sub Agents MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-23 and it shipped 8 releases in the last 90 days. We re-verify nightly.

How do I install Sub Agents MCP?

Run `npx -y sub-agents-mcp`. The README documents 8 environment variables (AGENTS_DIR, AGENT_TYPE, EXECUTION_TIMEOUT_MS…) to set first. Set AGENTS_DIR, EXECUTION_TIMEOUT_MS, AGENTS_SETTINGS_PATH, GEMINI_API_KEY before connecting. AGENT_TYPE, SESSION_ENABLED, SESSION_DIR, SESSION_RETENTION_DAYS are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Sub Agents MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Sub Agents MCP

Alternatives to Sub Agents MCP

Maintained productivity servers if Sub Agents MCP isn't the fit.

Pairs well with

Servers that cover what Sub Agents MCP doesn't - only shown when the pairing reason fits the companion.

More productivity MCP servers · Mnemex · Skillfed MCP · Saga MCP · Agy Bridge · Stack Fiesta

More TypeScript MCP servers · L402 Kit · Ship Static · Vecline · Sidclaw Governance MCP · Infrawise · see all