# MCP Tool Search

> Loading an MCP tool's details only when Claude needs that tool.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** Tool search, ToolSearch, ENABLE_TOOL_SEARCH

## Think of it like

It is like a library that shows just the book names. You get a book when you ask for it.

## Definition

MCP tool search is how Claude Code keeps MCP servers from filling the context. At the start, it loads only each tool's name and the server's short instructions. When Claude decides it needs a tool, it searches for it and loads the full details then. Tool search is on by default. Without it, every tool's full description would load at the start, even tools that are never used.

## Example

Jack has five MCP servers with eighty tools in all. With tool search on, his session starts with plenty of free context, because only the names load.

## Why it matters

You can add lots of servers. You do not pay for all their tools in each session.

## Common mistake

Turning it off to fix a slow tool call. That brings back every tool description and fills the context.

## Three principles

- **Names first.** Details later.
- **On by default.** Saves context.
- **Search when needed.** Then load.

## Related terms

- [Model Context Protocol (MCP)](https://learn.benibix.com/term/ai/model-context-protocol)
- [MCP Server](https://learn.benibix.com/term/ai/mcp-server)
- [Context Window](https://learn.benibix.com/term/ai/context-window)
- [Tool Use (Function Calling)](https://learn.benibix.com/term/ai/tool-use)
- [ToolSearch Tool](https://learn.benibix.com/term/ai/tool-search-tool)

## Taught in

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

![At the start only tool names load. The full description of a tool loads when Claude decides to use it.](https://learn.benibix.com/diagrams/cc-mcp-tool-search.svg)

---

Source: https://learn.benibix.com/term/ai/mcp-tool-search
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-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
