Command reference ยท Cursor CLI
agent mcp list-tools <identifier>
Lists the available tools and their parameters for a specific MCP server.
agent mcp list-tools <identifier> is a terminal subcommand of the Cursor CLI โ you call it as cursor-agent mcp list-tools <identifier> directly in the shell, not as a slash command within a running session. Within a session, /mcp list-tools provides comparable functionality.
The command shows all tools provided by a single, already-configured MCP server: names, descriptions, and the associated parameters with required/optional status and type. The <identifier> corresponds to the server name from your mcp.json; names with spaces are also supported.
This distinguishes the command from agent mcp list, which only lists the configured servers along with connection status but doesn't provide tool details. The configuration follows the same precedence order as in the editor: project before global before nested.
โ WHEN TO USE IT?
Check parameters before using an MCP tool for the first time
cursor-agent mcp list-tools playwright
Check which tools a server offers now after changes to mcp.json
cursor-agent mcp list-tools github
โ WHEN NOT TO?
You don't know the server identifier yet
agent mcp list-tools requires a specific identifier as an argument.
Better: use cursor-agent mcp list first to see the configured identifiers
You just want to quickly know whether a server is connected at all
list-tools shows tool details, not a server's connection status.
Better: use cursor-agent mcp list
SOURCES
- Cursor Docs โ CLI Reference: Parameters โ cursor.com
- Cursor Docs โ CLI MCP โ cursor.com
MORE COMMANDS ยท Cursor CLI