Referencia de comandos · Cursor CLI
agent mcp list
Lista los servidores MCP configurados y su estado (conectado/desconectado, origen, transporte).
agent mcp list es un subcomando de terminal de la Cursor CLI y se invoca directamente en la shell. Abre un menú interactivo con todos los servidores MCP configurados y muestra para cada servidor el nombre, el estado de conexión (conectado/desconectado), la fuente de configuración (config de proyecto o global) y el método de transporte (stdio, HTTP o SSE).
La configuración subyacente está en .cursor/mcp.json (proyecto) o ~/.cursor/mcp.json (global) y, según la documentación, sigue la misma estructura que en la Cursor IDE.
En el modo interactivo, /mcp list ofrece la misma vista como pager dentro de la sesión en curso, incluyendo login, enable y exploración de herramientas directamente desde el menú. agent mcp list es, por tanto, la variante de terminal para usarla fuera de una sesión, por ejemplo para comprobar mediante un script, antes de iniciar una tarea, qué servidores están accesibles en ese momento.
✅ ¿CUÁNDO USARLO?
Comprobar el estado del servidor antes de una tarea
Ejecuta agent mcp list para ver si un servidor necesario está conectado
Aclarar la fuente de configuración de un servidor
Abre agent mcp list para comprobar si un servidor está configurado a nivel de proyecto o global
⛔ ¿CUÁNDO MEJOR NO?
Ver los parámetros de herramientas de un servidor
agent mcp list solo muestra el estado del servidor, no detalles de las herramientas.
Mejor: Usa agent mcp list-tools <identifier> para un servidor concreto
FUENTES
- Documentación de Cursor — CLI Reference: Parameters ↗ cursor.com
- Documentación de Cursor — CLI MCP ↗ cursor.com
MÁS COMANDOS · Cursor CLI