# ToolSearch Tool

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

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** ToolSearch, Deferred tools

## Think of it like

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

## 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.

## 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.

## Common mistake

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

## Three principles

- **Names first.** Details later.
- **Search to load.** By name or keyword.
- **Saves context.** For the real work.

## Related terms

- [MCP Tool Search](https://learn.benibix.com/term/ai/mcp-tool-search)
- [MCP Tool](https://learn.benibix.com/term/ai/mcp-tool)
- [Context Window](https://learn.benibix.com/term/ai/context-window)

## Taught in

- [MCP Tools in Claude Code](https://learn.benibix.com/learn/ai-claude-code/mcp-tools-in-claude-code): Claude Code, 13/16

![MCP servers offer tools and resources. ToolSearch loads a tool when it is needed, and the resource tools list and read files.](https://learn.benibix.com/diagrams/ct-mcp-tools.svg)

---

Source: https://learn.benibix.com/term/ai/tool-search-tool
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
