io.github.shinpr

sub-agents-mcp

MCP server for AI sub-agent delegation across Cursor, Claude, Codex, Gemini, GLM, Grok, and OpenCode

stdiocommunityinfra

Package Details

Transportstdio

Environment Variables

AGENTS_DIR(str)
Required

Absolute path to the directory containing agent definition files (.md or .txt)

AGENT_TYPE(str)
Required

Type of AI CLI to use: 'cursor', 'claude', 'gemini', 'codex', 'glm', 'grok', or 'opencode'

AGENT_PERMISSION(str)

Approval/sandbox level for sub-agents: 'read-only', 'safe-edit' (default), or 'yolo'

AGENT_MODEL(str)

Optional model override applied to every sub-agent execution by this MCP server

AGENT_EFFORT(str)

Optional backend-specific reasoning effort or model variant. Supported by codex, claude, glm, grok, and opencode.

CURSOR_API_KEY(str)
Secret

API key for cursor-agent authentication (used only when AGENT_TYPE=cursor; passed via env, never via CLI args)

CLI_API_KEY(str)
Secret

Z.ai API token for AGENT_TYPE=glm (passed to the claude binary via env, never via CLI args). Restart/reconnect the MCP server after changing it.

EXECUTION_TIMEOUT_MS(str)

Maximum execution time for agents in milliseconds (default: 300000, max: 600000)

SESSION_ENABLED(str)

Enable session management to maintain execution history across agent calls (default: false)

SESSION_DIR(str)

Directory path for storing session files (default: .mcp-sessions in current working directory)

SESSION_RETENTION_DAYS(str)

Number of days to retain session history before automatic cleanup (default: 7)

AGENTS_SETTINGS_PATH(str)

Path to CLI settings file/directory. Claude: --settings arg, Cursor: CURSOR_CONFIG_DIR, Codex: CODEX_HOME. Gemini/Grok/OpenCode not supported.