Synopsis
Description
list-servers reads every found MCP config that is JSON or Codex TOML (~/.codex/config.toml), extracts servers from each (JSON: mcpServers; Codex: mcp_servers per the Codex config reference), and prints a single table. You see every MCP server (app, server name, command, args) from Claude Desktop, Cursor, Cline, Codex, and any other supported app that uses JSON or Codex TOML—all in one view.
Configs that are not JSON or Codex TOML (e.g. YAML for Goose or Continue.dev) are skipped for this command; they are still listed by list-clients.
Options
None.Example
Output
A table with columns:| Column | Description |
|---|---|
| APP | The app that owns the config (e.g. Claude Desktop, Cursor, OpenAI Codex). |
| SERVER | The MCP server name as defined in the config. |
| COMMAND | The command used to run the server. |
| ARGS | Optional arguments for the command. |
mcpServers / mcp_servers result in an empty server list for that config; they do not cause the command to fail.
See also
- list-clients — List where config files are located.
- add-server — Add a server to JSON or Codex TOML configs.
- Supported apps — Which configs are used for list-servers and add-server.