agent mcp

Parent command for managing configured MCP servers (login, list, tools, enable/disable).

agent mcp groups all subcommands for managing Model Context Protocol servers: login, list, list-tools, enable, disable. The CLI uses the same mcp.json configuration as the Cursor editor (project and global level) and picks up servers from parent directories automatically. agent mcp list (or /mcp list in interactive mode) opens an interactive selection menu.

✅ WHEN TO USE IT?

Get an overview of which MCP servers are configured at all

agent mcp list

Skip all MCP approval prompts during a scripted run

agent --approve-mcps -p "query my database for recent errors"

⛔ WHEN NOT TO?

An MCP tool should be used directly, not just managed

agent mcp only manages server configuration, it doesn't call tools itself.

Better: Send a normal prompt to agent or agent -p — MCP tools are picked up automatically when relevant

A new MCP server needs to be set up for the first time

agent mcp only manages servers already entered in mcp.json.

Better: First add the server to .cursor/mcp.json or ~/.cursor/mcp.json, then approve it with agent mcp enable

SOURCES

Cursor Docs — CLI Reference: Parameters ↗ cursor.com
Cursor Docs — CLI MCP ↗ cursor.com