Skip to main content
The list-agents command is an informational command that prints a table of every AI coding agent supported by add-mcp. Use it to look up the exact value to pass to -a / --agent, discover available aliases, and check whether an agent supports project-level or global-only configuration.

​
Usage

This command takes no options and makes no changes to any configuration files.

​
Supported agents

add-mcp supports 15 agents. The table below lists each agent with its --agent flag value, known aliases, and the config file paths used for project-level and global installation. A dash (—) in the project config path column means the agent only supports global installation.

​
Aliases

Several agents have short aliases you can pass to -a / --agent in place of the canonical name:

​
Installation scope

Every agent supports global installation. Agents with a project config path (non-dash entries above) also support project-level installation, which is the default when you run add-mcp inside a project directory.
Config files are written inside the current directory (e.g. .cursor/mcp.json). These files can be committed with your project and shared with your team.
Agents that show a dash (—) in the project config path column — such as Cline VSCode Extension, Claude Desktop, and Windsurf — only write to a global config file regardless of whether you pass -g. add-mcp handles this automatically.