Command reference ยท Cursor CLI
agent mcp list
Lists configured MCP servers and their status (connected/disconnected, source, transport).
agent mcp list is a terminal subcommand of the Cursor CLI and is called directly in the shell. It opens an interactive menu with all configured MCP servers and shows, for each server, name, connection status (connected/disconnected), configuration source (project or global config), and transport method (stdio, HTTP, or SSE).
The underlying configuration lives in .cursor/mcp.json (project) or ~/.cursor/mcp.json (global) and, according to the documentation, follows the same structure as in the Cursor IDE.
In interactive mode, /mcp list provides the same overview as a pager within the running session, including login, enable, and tool browsing directly from the menu. agent mcp list is thus the terminal variant for use outside a session, for example to check via script which servers are currently reachable before starting a task.
โ WHEN TO USE IT?
Check server status before a task
Run agent mcp list to see whether a required server is connected
Clarify a server's configuration source
Open agent mcp list to check whether a server is configured at the project or global level
โ WHEN NOT TO?
View a server's tool parameters
agent mcp list only shows server status, not tool details.
Better: Use agent mcp list-tools <identifier> for a specific server
SOURCES
- Cursor Docs โ CLI Reference: Parameters โ cursor.com
- Cursor Docs โ CLI MCP โ cursor.com
MORE COMMANDS ยท Cursor CLI