Skip to main content

​
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: Invalid JSON/TOML or configs without 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.