Sub Agents MCP

Write a reviewer, test writer, or investigator in Markdown, then ask your assistant to use it. The MCP server runs that agent with the coding CLI you choose and returns the result to the same conversation. It runs locally over stdio via the published package.

People who work with codex, developer tools and multi agent and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-10 · ★ 98 · #12 OF 160 MAINTAINED PRODUCTIVITY · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install Sub Agents MCP

before you install - you'll need

Set AGENTS_DIR, AGENT_TYPE before connecting.

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.14.2 · 2026-09-06

Fixed · Cleaning up expired session files wrote to stdout and could break the MCP connection. · Cancelling a request left the agent process running. Shutting down the server now stops in-flight agents too. · A response…

v0.14.1 · 2026-09-01

OpenCode agents in read-only mode can now use shell commands while direct edits remain disabled.

v0.14.0 · 2026-08-30

Highlights · Added Command Code as a supported agent backend. · Added permission mapping, model and effort overrides, turn limits, and structured output handling for Command Code executions.

04 · Who maintains Sub Agents MCP

sub-agents-mcp is maintained by shinpr. We track 3 MCP servers from shinpr - 3 actively maintained, 662 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 #12 of 160 actively-maintained productivity servers as of 2026-09-18.
release cadence: 10+ releases in the last 90 days (latest 2026-09-06)
registry: io.github.shinpr/sub-agents-mcp (active, first published 2025-11-02 · 27 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-09-18, its last commit was 2026-09-10 and it shipped 10+ 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 2 environment variables (AGENTS_DIR, AGENT_TYPE) to set first. Set AGENTS_DIR, AGENT_TYPE before connecting. 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 · Seek Link · Mnemex · Skillfed MCP · Saga MCP · Agy Bridge

More TypeScript MCP servers · L402 Kit · Codebase Chat · Ship Static · Seminara · Shrike · see all