Sub-Agents MCP

An MCP server that allows users to define reusable, task-specific AI sub-agents using Markdown files. It delegates coding tasks such as code review, test writing, and investigation to specialized agents via supported coding CLIs like Codex, Claude Code, or Cursor, returning results to the MCP client conversation.

Package and access

Local package with source-attributed installation metadata. Koskamo does not execute packages during review.

Community listingLocal stdioSource reviewed; not executedPublished by shinpr

You need:You need Node.js 22 or later, an MCP-compatible client, and one supported coding CLI installed and signed in.

Vendor documentation

What you can do with it

Delegate code review to a focused agent
Use a test writer agent to add unit tests
Run a bug investigator to find failure causes
Document public API changes with a doc writer

Source and maintenance

Community listingRegistry 0.15.1

mcp-registry: io.github.shinpr/sub-agents-mcp@0.15.1 Source repository

Maintenance checked: Oct 31, 2026, 10:27 PM UTC

Packages and installation

Source-provided package data. Koskamo has not executed or live-probed this package.

sub-agents-mcp 0.15.1

npm

sub-agents-mcp package definition

{
  "version": "0.15.1",
  "transport": "stdio",
  "identifier": "sub-agents-mcp",
  "registryType": "npm",
  "registryBaseUrl": "https://registry.npmjs.org",
  "environmentVariables": [
    {
      "name": "AGENTS_DIR",
      "format": "string",
      "isRequired": true,
      "description": "Absolute path to the directory containing agent definition files (.md or .txt)"
    },
    {
      "name": "AGENT_TYPE",
      "format": "string",
      "isRequired": true,
      "description": "Type of AI CLI to use: 'cursor', 'claude', 'gemini', 'codex', 'command-code', 'glm', 'kimi', 'grok', 'antigravity', 'opencode', 'mcode', or 'pi'"
    },
    {
      "name": "AGENT_PERMISSION",
      "format": "string",
      "description": "Approval/sandbox level for sub-agents: 'read-only', 'safe-edit' (default), or 'yolo'"
    },
    {
      "name": "AGENT_MODEL",
      "format": "string",
      "description": "Optional model override applied to every sub-agent execution by this MCP server"
    },
    {
      "name": "AGENT_EFFORT",
      "format": "string",
      "description": "Optional backend-specific reasoning effort or model variant. Supported by codex, claude, command-code, glm, kimi, grok, antigravity, opencode, mcode, and pi."
    },
    {
      "name": "CURSOR_API_KEY",
      "format": "string",
      "description": "API key for cursor-agent authentication (used only when AGENT_TYPE=cursor; passed via env, never via CLI args)"
    },
    {
      "name": "CLI_API_KEY",
      "format": "string",
      "description": "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."
    },
    {
      "name": "EXECUTION_TIMEOUT_MS",
      "format": "string",
      "description": "Agent execution timeout in milliseconds, as a positive whole number (default: 300000). The server refuses to start on an invalid value such as \"5min\"."
    },
    {
      "name": "SESSION_ENABLED",
      "format": "string",
      "description": "Enable session management to maintain execution history across agent calls (default: false)"
    },
    {
      "name": "SESSION_DIR",
      "format": "string",
      "description": "Directory path for storing session files (default: .mcp-sessions in current working directory)"
    },
    {
      "name": "SESSION_RETENTION_DAYS",
      "format": "string",
      "description": "Number of days to retain session history before automatic cleanup (default: 1)"
    },
    {
      "name": "AGENTS_SETTINGS_PATH",
      "format": "string",
      "description": "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."
    }
  ]
}

Tools

Reported by the attributed source; not independently observed by Koskamo.

No tool definitions available.

Connect from your client

Each snippet configures the same source-provided package; replace placeholders before use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Cursor

Merge this local stdio configuration, replace every placeholder environment value, and restart Cursor. Koskamo has not executed this package.

Cursor configuration

{
  "mcpServers": {
    "sub-agents-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sub-agents-mcp@0.15.1"
      ],
      "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>"
      }
    }
  }
}

Cline

Merge this local stdio configuration, replace every placeholder environment value, and restart Cline. Koskamo has not executed this package.

Cline configuration

{
  "mcpServers": {
    "sub-agents-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sub-agents-mcp@0.15.1"
      ],
      "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>"
      }
    }
  }
}

VS Code

Merge this local stdio configuration, replace every placeholder environment value, and restart VS Code. Koskamo has not executed this package.

VS Code configuration

{
  "servers": {
    "sub-agents-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "sub-agents-mcp@0.15.1"
      ],
      "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>"
      }
    }
  }
}

Claude Desktop

Merge this local stdio configuration, replace every placeholder environment value, and restart Claude Desktop. Koskamo has not executed this package.

Claude Desktop configuration

{
  "mcpServers": {
    "sub-agents-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sub-agents-mcp@0.15.1"
      ],
      "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>"
      }
    }
  }
}

Let your agent find its tools

Find servers like Sub-Agents MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 7,347