list command reads the configuration files of all detected AI coding agents and prints every MCP server they have installed, along with each server’s identity — its URL for remote servers, or its package/command for stdio servers. Use it to get a quick overview of what is installed and where.
Usage
Options
flag
List servers from user-level (global) config files instead of the project-level configs in the current directory.
string (repeatable)
Filter output to one or more specific agents (e.g.
-a cursor). The specified agent is shown even if it is not currently detected in the project. Can be repeated for multiple agents.Behavior
Without any options,list scans the current directory for project-level config files (.cursor/mcp.json, .mcp.json, .vscode/mcp.json, etc.) and reports every MCP server found in each detected agent’s config.
For each agent the output shows:
- The agent display name as a heading.
- Each installed server’s name and identity (URL or package name) in parentheses.
no servers configured message. If no agents are detected at all, the CLI prints a hint suggesting --global or -a to investigate further.
When you pass
-a to target a specific agent, that agent is always shown in the output — even if no config file exists for it in the current directory.