MCP Server

io.github.shinpr/sub-agents-mcp MCP Server

Name: io.github.shinpr/sub-agents-mcp MCP Server
Author: io.github.shinpr

io.github.shinpr/sub-agents-mcp

Repository Registry

What is the io.github.shinpr/sub-agents-mcp MCP server?

MCP server for delegating tasks to specialized AI assistants in Cursor, Claude, and Gemini

How to install io.github.shinpr/sub-agents-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

AGENTS_DIR
required
Absolute path to the directory containing agent definition files (.md or .txt)
AGENT_TYPE
required
Type of AI CLI to use: 'cursor', 'claude', 'gemini', or 'codex'
AGENT_PERMISSION
Approval/sandbox level for sub-agents: 'read-only', 'safe-edit' (default), or 'yolo'
CURSOR_API_KEY
secret
API key for cursor-agent authentication (used only when AGENT_TYPE=cursor; passed via env, never via CLI args)
EXECUTION_TIMEOUT_MS
Maximum execution time for agents in milliseconds (default: 300000, max: 600000)
SESSION_ENABLED
Enable session management to maintain execution history across agent calls (default: false)
SESSION_DIR
Directory path for storing session files (default: .mcp-sessions in current working directory)
SESSION_RETENTION_DAYS
Number of days to retain session history before automatic cleanup (default: 7)
AGENTS_SETTINGS_PATH
Path to CLI settings file/directory. Claude: --settings arg, Cursor: CURSOR_CONFIG_DIR, Codex: CODEX_HOME. Gemini not supported.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "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>",
        "CURSOR_API_KEY": "<YOUR_CURSOR_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>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "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>",
        "CURSOR_API_KEY": "<YOUR_CURSOR_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>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "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>",
        "CURSOR_API_KEY": "<YOUR_CURSOR_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

.vscode/mcp.json

{
  "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>",
        "CURSOR_API_KEY": "<YOUR_CURSOR_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 Code

claude mcp add sub-agents-mcp --env AGENTS_DIR=<YOUR_AGENTS_DIR> --env AGENT_TYPE=<YOUR_AGENT_TYPE> --env AGENT_PERMISSION=<YOUR_AGENT_PERMISSION> --env CURSOR_API_KEY=<YOUR_CURSOR_API_KEY> --env EXECUTION_TIMEOUT_MS=<YOUR_EXECUTION_TIMEOUT_MS> --env SESSION_ENABLED=<YOUR_SESSION_ENABLED> --env SESSION_DIR=<YOUR_SESSION_DIR> --env SESSION_RETENTION_DAYS=<YOUR_SESSION_RETENTION_DAYS> --env AGENTS_SETTINGS_PATH=<YOUR_AGENTS_SETTINGS_PATH> -- npx -y sub-agents-mcp

Related MCP servers

io.github.shinpr/mcp-image

AI image generation and editing with prompt optimization and quality presets

View repository →

io.github.shinpr/mcp-local-rag

Easy-to-setup local RAG server with minimal configuration

View repository →