io.github.shinpr

sub-agents-mcp

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

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

AGENT_PERMISSION(str)

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

CURSOR_API_KEY(str)
Secret

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

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 not supported.