Skip to content
BENIBIX Learn

ToolSearch Tool

AI⌨️ Claude CodeBuilt-in Tools

Also known as ToolSearch, Deferred tools

The tool that loads a held-back tool when Claude needs it.

Think of it like

It is like a library desk. You ask for a book, and they fetch it from the back room.

Example

Jack has ten MCP servers with two hundred tools. Claude sees only their names, searches for the Slack one when he asks, and loads just that.

Why it matters

Lots of tools can sit ready. They do not fill up the context until they are used.

Definition

The ToolSearch tool finds and loads tools that were held back at the start. When tool search is on, Claude Code lists only the names of many MCP tools, not their full details, to save room in the context. When Claude needs one, it searches by name or by keyword, and the tool's full details load so Claude can call it. It never asks for permission.
ToolSearch loads a held-back tool when it is needed.

Common mistake

Thinking a held-back tool is missing. It is only waiting, and loads the moment Claude searches for it.

Key takeaways

  1. 1
    Names first. Details later.
  2. 2
    Search to load. By name or keyword.
  3. 3
    Saves context. For the real work.

Learn it properly