claude-code - 💡(How to fix) Fix [DOCS] MCP docs omit `/mcp` tool list and detail rendering behavior

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/mcp

Section/Topic

/mcp panel tool list and tool detail behavior

Current Documentation

The MCP page currently says:

The /mcp panel shows the tool count next to each connected server and flags servers that advertise the tools capability but expose no tools.

The tools reference sends users to /mcp for exact MCP tool names:

Claude gives a conversational summary. For exact MCP tool names, run /mcp.

The docs do not explain that /mcp includes a tool list or a tool-detail view, or how long and multi-line MCP tool names and descriptions are displayed there.

What's Wrong or Missing?

Claude Code v2.1.154 fixed /mcp tools list and tool detail rendering when MCP servers have long or multi-line tool names or long descriptions.

The current docs point users to /mcp for server status and exact MCP tool names, but they leave three gaps:

A. Tool list behavior is not documented

Users are told that /mcp shows a tool count, but not that they can inspect the actual tools exposed by a connected MCP server from the panel.

B. Tool detail behavior is not documented

Users are not told where to find an individual MCP tool's full name or description inside /mcp, even though the tools reference points them there for exact MCP tool names.

C. Long and multi-line tool metadata behavior is unspecified

MCP server authors can expose tools with long names, multi-line names, or long descriptions. The docs do not state that /mcp should render that metadata readably in the tool list and detail views, so users cannot tell whether broken wrapping, truncation, or layout corruption is expected behavior or a Claude Code bug.

Suggested Improvement

Add a short note near the existing /mcp panel description:

The /mcp panel lets you inspect each connected server's tools. Select a server to view its tool list, then select a tool to view details such as the full tool name and description. Long or multi-line tool names and long descriptions are wrapped or otherwise rendered in the detail view so they remain readable.

Also update the tools reference sentence so it points to the specific /mcp tool-list/detail behavior, not just the command name.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

Total scope: 3 pages affected

Version context: v2.1.154 fixed /mcp tools list and tool detail rendering when MCP servers have long or multi-line tool names or long descriptions.