promptgarten 🌱

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

Compare all 28 tasks β†’

βœ… 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

MORE COMMANDS Β· Cursor CLI

/plugin/config/copy/sandbox/bedrock/add-dir/save-workspace/load-workspace/auto-review/context/full-conversation/btw

All commands Β· Cursor CLI β†’

Share:𝕏inπŸ’¬