agent mcp list-tools <identifier>
列出某个具体 MCP 服务器上可用的工具及其参数。
agent mcp list-tools <identifier> 是 Cursor CLI 的一个终端子命令——你在 Shell 中以 cursor-agent mcp list-tools <identifier> 的形式直接调用它,而不是在运行中的会话内作为斜杠命令使用。在会话内,/mcp list-tools 提供了类似的功能。
该命令会展示某个已配置好的 MCP 服务器所提供的全部工具:名称、描述,以及各自的参数(含必填/可选状态和类型)。<identifier> 对应你 mcp.json 中的服务器名称;包含空格的名称同样受支持。
由此,该命令与 agent mcp list 有所不同——后者只列出已配置的服务器及其连接状态,不提供工具细节。配置的优先级顺序与编辑器中一致:项目级优先于全局级,全局级优先于嵌套配置。
✅ 什么时候用?
在首次使用某个 MCP 工具前检查其参数
cursor-agent mcp list-tools playwright
修改 mcp.json 后查看某个服务器目前提供哪些工具
cursor-agent mcp list-tools github
⛔ 什么时候不该用?
还不知道服务器的标识符
agent mcp list-tools 需要一个具体的标识符作为参数。
更好的选择: 先使用 cursor-agent mcp list 查看已配置的标识符
只是想快速确认某个服务器是否已连接
list-tools 展示的是工具细节,而不是服务器的连接状态。
更好的选择: 使用 cursor-agent mcp list
来源
- Cursor 官方文档——CLI 参考:参数(Parameters) ↗ cursor.com
- Cursor 官方文档——CLI MCP ↗ cursor.com