Skip to content
BENIBIX Learn

MCP Tool Search

AI⌨️ Claude CodeClaude Code Concepts

Also known as Tool search, ToolSearch, ENABLE_TOOL_SEARCH

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

Think of it like

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

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.

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.
Only names at the start. Full details when a tool is chosen.

Common mistake

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

Key takeaways

  1. 1
    Names first. Details later.
  2. 2
    On by default. Saves context.
  3. 3
    Search when needed. Then load.

Learn it properly