io.github.shinpr/sub-agents-mcp

io.github.shinpr/sub-agents-mcp·v0.7.1·AI & LLMs

Quality Score

/100

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

Repository →

§01 Install

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "sub-agents-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sub-agents-mcp"
      ],
      "env": {
        "AGENTS_DIR": "<agents_dir>",
        "AGENT_TYPE": "<agent_type>",
        "EXECUTION_TIMEOUT_MS": "<execution_timeout_ms>",
        "SESSION_ENABLED": "<session_enabled>",
        "SESSION_DIR": "<session_dir>",
        "SESSION_RETENTION_DAYS": "<session_retention_days>",
        "AGENTS_SETTINGS_PATH": "<agents_settings_path>"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "sub-agents-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sub-agents-mcp"
      ],
      "env": {
        "AGENTS_DIR": "<agents_dir>",
        "AGENT_TYPE": "<agent_type>",
        "EXECUTION_TIMEOUT_MS": "<execution_timeout_ms>",
        "SESSION_ENABLED": "<session_enabled>",
        "SESSION_DIR": "<session_dir>",
        "SESSION_RETENTION_DAYS": "<session_retention_days>",
        "AGENTS_SETTINGS_PATH": "<agents_settings_path>"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

npx -y sub-agents-mcp

§02 Environment variables

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', or 'gemini'

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.

§03 MCP Quality Score · methodology

freshness

completeness

installability

documentation

stability

§04 Alternatives in AI & LLMs

OpenAI Tools MCP Server

ai.com.mcp/openai-tools

Focused MCP server for OpenAI image/audio generation (v2.0.0). Wraps endpoints via HAPI CLI.

ai.llmse/mcp

Public MCP server for the LLM Search Engine

Perplexity API Platform

ai.perplexity/mcp-server

Real-time web search, reasoning, and research through Perplexity's API