Define task-specific AI sub-agents in Markdown for any MCP-compatible tool.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add sub-agents --env AGENTS_DIR='<AGENTS_DIR>' --env AGENT_TYPE='<AGENT_TYPE>' --env CURSOR_API_KEY='<CURSOR_API_KEY>' --env CLI_API_KEY='<CLI_API_KEY>' -- npx -y sub-agents-mcp~/.codex/config.toml
[mcp_servers.sub-agents]
command = "npx"
args = ["-y", "sub-agents-mcp"]
env = { AGENTS_DIR = "<AGENTS_DIR>", AGENT_TYPE = "<AGENT_TYPE>", CURSOR_API_KEY = "<CURSOR_API_KEY>", CLI_API_KEY = "<CLI_API_KEY>" }
# codex mcp add sub-agents --env AGENTS_DIR='<AGENTS_DIR>' --env AGENT_TYPE='<AGENT_TYPE>' --env CURSOR_API_KEY='<CURSOR_API_KEY>' --env CLI_API_KEY='<CLI_API_KEY>' -- npx -y sub-agents-mcp~/.cursor/mcp.json
{
"mcpServers": {
"sub-agents": {
"command": "npx",
"args": [
"-y",
"sub-agents-mcp"
],
"env": {
"AGENTS_DIR": "<AGENTS_DIR>",
"AGENT_TYPE": "<AGENT_TYPE>",
"CURSOR_API_KEY": "<CURSOR_API_KEY>",
"CLI_API_KEY": "<CLI_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"sub-agents": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"sub-agents-mcp"
],
"env": {
"AGENTS_DIR": "<AGENTS_DIR>",
"AGENT_TYPE": "<AGENT_TYPE>",
"CURSOR_API_KEY": "<CURSOR_API_KEY>",
"CLI_API_KEY": "<CLI_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"sub-agents": {
"command": "npx",
"args": [
"-y",
"sub-agents-mcp"
],
"env": {
"AGENTS_DIR": "<AGENTS_DIR>",
"AGENT_TYPE": "<AGENT_TYPE>",
"CURSOR_API_KEY": "<CURSOR_API_KEY>",
"CLI_API_KEY": "<CLI_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"sub-agents": {
"command": "npx",
"args": [
"-y",
"sub-agents-mcp"
],
"env": {
"AGENTS_DIR": "<AGENTS_DIR>",
"AGENT_TYPE": "<AGENT_TYPE>",
"CURSOR_API_KEY": "<CURSOR_API_KEY>",
"CLI_API_KEY": "<CLI_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"sub-agents": {
"command": "npx",
"args": [
"-y",
"sub-agents-mcp"
],
"env": {
"AGENTS_DIR": "<AGENTS_DIR>",
"AGENT_TYPE": "<AGENT_TYPE>",
"CURSOR_API_KEY": "<CURSOR_API_KEY>",
"CLI_API_KEY": "<CLI_API_KEY>"
}
}
}
}Environment variables
AGENTS_DIRAGENT_TYPECURSOR_API_KEYCLI_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.