Hermes Agent Ships Tool Search for MCP: Anthropic Evals Show 49% to 74% Accuracy Gain on Opus 4

Nous Research’s open-source Hermes Agent now ships a Tool Search feature. It directly addresses a growing bottleneck in AI agent systems: too many MCP tools filling up the context window. In this explainer article, we will breaks down what Tool Search does, how it works, and when to use it.

The Problem: MCP Tools Are Eating Your Context Window

When you connect multiple MCP (Model Context Protocol) servers to an AI agent, every tool’s JSON schema gets sent to the model on every turn. This happens even if the model only needs one or two tools for a given task.

Real-world deployments feel this immediately. A Hermes deployment with five MCP servers and 34 tools shows average prompt sizes of 45,000 tokens per turn. Roughly 22,000 of those tokens — around 50% — are tool schema overhead alone.

Anthropic’s own engineering data shows tool definitions can consume 134,000 tokens before optimization. Tool Attention measures the “MCP Tools Tax” at 15,000–60,000 tokens per turn for typical multi-server deployments.

This creates two distinct problems:

Cost: Cache-miss generations at session start can cost $0.07–$0.10 per turn.** Accuracy loss**: Decision paralysis sets in when the model sees hundreds of irrelevant tool options simultaneously.

What is Tool Search?

Tool Search is Hermes Agent’s opt-in progressive-disclosure layer for MCP and non-core plugin tools. Instead of every tool schema upfront, the model loads only what it needs — on demand, per turn.

When Tool Search activates, MCP and plugin tools are replaced in the model-visible tools array by three bridge tools:

tool_search(query, limit?)   — search the deferred-tool catalog
tool_describe(name)          — load the full schema for one tool
tool_call(name, arguments)   — invoke a deferred tool

A typical interaction looks like this:

Model: tool_search("create a github issue")
  → { matches: [{ name: "mcp_github_create_issue", ... }] }
Model: tool_describe("mcp_github_create_issue")
  → { parameters: { type: "object", properties: { ... } } }
Model: tool_call("mcp_github_create_issue", { title: "...", body: "..." })
  → { ok: true, issue_number: 42 }

The model searches for what it needs, loads the schema, then calls the tool. All hooks, guardrails, and approval prompts run against the real underlying tool name — not against the bridge.

The Accuracy Numbers

This is not just a token-saving feature. Tool Search also improves model accuracy on MCP evaluations.

According to Anthropic’s internal MCP evals:

Claude Opus 4: accuracy improved from** 49% → 74%with Tool Search enabled Claude Opus 4.5**: accuracy improved from** 79.5% → 88.1%**with Tool Search enabled

Large tool catalogs create “decision paralysis” — the model gets confused choosing among many irrelevant options. Removing those options from the context window reduces false positives. Anthropic’s data also shows an 85% reduction in tool-definition token usage while maintaining access to the full tool library.

How the Retrieval Works: BM25 + Fallback

Under the hood, Hermes uses BM25 — a classic information retrieval algorithm — to match the model’s query against a catalog of tool names, descriptions, and parameter names.

If BM25 returns no positive-score hits, the system falls back to a literal substring match on the tool name. This protects against zero-IDF degenerate cases, such as searching for "github"

in a catalog where every tool name contains “github.”

The catalog is stateless across turns. It rebuilds from the current tool-defs list on every assembly. This prevents drift bugs where a stored catalog goes out of sync with the live tool registry.

When Does Tool Search Activate?

By default, Tool Search runs in auto

mode. It activates only when the deferrable tool schemas would consume at least 10% of the active model’s context window.

Below that threshold, the tools-array assembly is a pure pass-through. You pay no overhead.

This decision is re-evaluated on every turn:

• A session with just a few MCP tools and a long-context model may never activate Tool Search.
• A session with many MCP servers attached (15+ tools typically) starts activating it.
• Removing servers mid-session correctly returns to direct tool exposure on the next assembly.

Configuration Reference

Add this to your hermes.yaml

to control the behavior:

tools:
  tool_search:
    enabled: auto        # auto (default), on, or off
    threshold_pct: 10    # % of context at which auto mode kicks in
    search_default_limit: 5
    max_search_limit: 20

You can also use a simple boolean shorthand:

tools:
  tool_search: true   # equivalent to {enabled: auto}

Marktechpost’s Visual Explainer

Key Takeaways

• Tool Search defers MCP tool schemas until the model actually needs them — using a tool_search

/tool_describe

/tool_call

bridge. Anthropic's evals show accuracy gains from 49% → 74% on Claude Opus 4 with large tool catalogs.- BM25 retrieval over tool name + description + parameter names powers the search, with substring fallback for zero-IDF edge cases. auto

mode (default) is self-tuning — activates only when tool schemas exceed 10% of the context window.- Core Hermes tools are never deferred; only MCP and non-core plugin tools are eligible.

Check out the ** Hermes Agent Tool Search Documentation** and

Also, feel free to follow us on

Anthropic Advanced Tool Use.and don’t forget to join ourTwitter

and Subscribe to

150k+ ML SubReddit. Wait! are you on telegram?

our Newsletter

now you can join us on telegram as well.Need to partner with us for promoting your GitHub Repo OR Hugging Face Page OR Product Release OR Webinar etc.? Connect with us