​

Supported Agents

​

All Supported Agents

​

Agent Aliases

• gemini → gemini-cli
• github-copilot → vscode

​

Agent Configuration Details

​

Claude Code

• Argument: claude-code
• Display Name: Claude Code
• Project Path: .mcp.json
• Global Path: ~/.claude.json
• Config Key: mcpServers
• Format: JSON
• Supported Transports: stdio, HTTP, SSE
• Project Detection Paths: .mcp.json, .claude

​

Claude Desktop

• Argument: claude-desktop
• Display Name: Claude Desktop
• Project Path: Not supported (global only)
• Global Path: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
• Config Key: mcpServers
• Format: JSON
• Supported Transports: stdio only
• Note: Claude Desktop only supports local (stdio) servers via its config file. Add remote servers through Settings → Connectors in the app instead.

​

Codex

• Argument: codex
• Display Name: Codex
• Project Path: .codex/config.toml
• Global Path: ~/.codex/config.toml (or $CODEX_HOME/config.toml)
• Config Key: mcp_servers
• Format: TOML
• Supported Transports: stdio, HTTP, SSE
• Project Detection Paths: .codex

​

Cursor

• Argument: cursor
• Display Name: Cursor
• Project Path: .cursor/mcp.json
• Global Path: ~/.cursor/mcp.json
• Config Key: mcpServers
• Format: JSON
• Supported Transports: stdio, HTTP, SSE
• Project Detection Paths: .cursor

​

Gemini CLI

• Argument: gemini-cli (alias: gemini)
• Display Name: Gemini CLI
• Project Path: .gemini/settings.json
• Global Path: ~/.gemini/settings.json
• Config Key: mcpServers
• Format: JSON
• Supported Transports: stdio, HTTP, SSE
• Project Detection Paths: .gemini

​

Goose

• Argument: goose
• Display Name: Goose
• Project Path: Not supported (global only)
• Global Path: ~/.config/goose/config.yaml (Linux/macOS) or %APPDATA%\Block\goose\config\config.yaml (Windows)
• Config Key: extensions
• Format: YAML
• Supported Transports: stdio, HTTP, SSE

​

GitHub Copilot CLI

• Argument: github-copilot-cli (or alias: github-copilot)
• Display Name: GitHub Copilot CLI
• Project Path: .vscode/mcp.json
• Global Path: ~/.copilot/mcp-config.json (or $XDG_CONFIG_HOME/.copilot/mcp-config.json)
• Config Key (Global): mcpServers
• Config Key (Local): servers
• Format: JSON
• Supported Transports: stdio, HTTP, SSE
• Project Detection Paths: .vscode

​

OpenCode

• Argument: opencode
• Display Name: OpenCode
• Project Path: opencode.json
• Global Path: ~/.config/opencode/opencode.json
• Config Key: mcp
• Format: JSON
• Supported Transports: stdio, HTTP, SSE
• Project Detection Paths: opencode.json, .opencode

​

VS Code

• Argument: vscode
• Display Name: VS Code
• Project Path: .vscode/mcp.json
• Global Path (macOS): ~/Library/Application Support/Code/User/mcp.json
• Global Path (Linux): ~/.config/Code/User/mcp.json (or $XDG_CONFIG_HOME/Code/User/mcp.json)
• Global Path (Windows): %APPDATA%\Code\User\mcp.json
• Config Key: servers
• Format: JSON
• Supported Transports: stdio, HTTP, SSE
• Project Detection Paths: .vscode

​

Zed

• Argument: zed
• Display Name: Zed
• Project Path: .zed/settings.json
• Global Path (macOS): ~/Library/Application Support/Zed/settings.json
• Global Path (Linux): ~/.config/zed/settings.json (or $XDG_CONFIG_HOME/zed/settings.json)
• Global Path (Windows): %APPDATA%\Zed\settings.json
• Config Key: context_servers
• Format: JSON
• Supported Transports: stdio, HTTP, SSE
• Project Detection Paths: .zed

​

Smart Agent Detection

​

Project Mode (Default)

• Checks for project-level config files (.cursor/, .vscode/, .mcp.json, etc.)
• Detects agents that have configuration present in the current directory
• Pre-selects detected agents for installation
• Shows all project-capable agents for manual selection

function detectProjectAgents(cwd?: string): AgentType[] {
  const dir = cwd || process.cwd();
  const detected: AgentType[] = [];

  for (const [type, config] of Object.entries(agents)) {
    if (!config.localConfigPath) continue;

    for (const detectPath of config.projectDetectPaths) {
      if (existsSync(join(dir, detectPath))) {
        detected.push(type as AgentType);
        break;
      }
    }
  }

  return detected;
}

​

Global Mode (-g flag)

• Checks for global installation directories
• Detects all agents installed on your system (including global-only agents)
• Pre-selects detected agents for installation
• Shows all agents for manual selection

async function detectAllGlobalAgents(): Promise<AgentType[]> {
  const detected: AgentType[] = [];

  for (const [type, config] of Object.entries(agents)) {
    if (await config.detectGlobalInstall()) {
      detected.push(type as AgentType);
    }
  }

  return detected;
}

​

Global-Only Agents

• Claude Desktop - Global config only, project config not supported
• Goose - Global config only, project config not supported

​

Specifying Agents

# Single agent
npx add-mcp https://mcp.example.com -a cursor

# Multiple agents
npx add-mcp https://mcp.example.com -a cursor -a claude-code

# All agents
npx add-mcp https://mcp.example.com --all

# Using aliases
npx add-mcp https://mcp.example.com -a gemini  # Resolves to gemini-cli

​

Related Pages

• Transports - Learn about HTTP, SSE, and stdio transports
• Scopes - Understand project vs global installation