Command reference Β· Cursor CLI
/mcp
Manages MCP servers via an interactive menu: log in, list, view tools.
/mcp opens an interactive menu for managing Model Context Protocol servers in the Cursor CLI (agent). As a slash command, the documented syntax is /mcp [list|list-tools] [identifier]; outside the interactive session, the same functions exist as standalone terminal subcommands: agent mcp list, agent mcp list-tools <identifier>, agent mcp login <identifier>, agent mcp enable <identifier>, and agent mcp disable <identifier>.
The configuration lives in mcp.json, project-related under .cursor/mcp.json or globally under ~/.cursor/mcp.json; the CLI uses exactly the same configuration as the Cursor editor and resolves it in the order project before global before nested folders. A server entry defines the connection type (stdio, SSE, or Streamable HTTP), start command, arguments, and environment variables; for OAuth servers, login runs through its own callback flow.
enable puts a server on the locally approved list, disable only prevents it from loading or asking for approval β the configuration entry remains. Before every MCP tool call, Cursor asks for confirmation by default, unless a run mode allows this automatically.
π THE SAME TASK (βMANAGE MCP SERVERSβ) ON OTHER PLATFORMS
β WHEN TO USE IT?
Check the tools of a new MCP server before use
/mcp list-tools playwright
Perform OAuth login for a server configured in mcp.json
agent mcp login <identifier> in the terminal, or /mcp in the interactive menu, select the server and log in
Get an overview of the status and origin of all configured servers
/mcp list β shows connection status (connected/disconnected) and configuration source (project or global) per server
β WHEN NOT TO?
All MCP servers should be automatically approved at startup
/mcp is designed for interactive management, not automated approval in scripts.
Better: Use --approve-mcps at startup
A server should be permanently removed from the configuration
agent mcp disable only deactivates a server locally, the entry remains in mcp.json.
Better: Delete the server entry directly in mcp.json
SOURCES
- Cursor Docs β Slash Commands β cursor.com