Skip to main content

Command Palette

Search for a command to run...

Your agent has 40 tools and it still picks the wrong one

Every integration adds another MCP server. The agent now has 40 tools, and half the time it calls the wrong one. Tool count is not capability.

Updated
•2 min read•View as Markdown

We kept adding MCP servers. Git, GitHub, Postgres, Slack, a search tool, a browser, three internal APIs. Each one felt like a win — the agent could do more.

Six weeks later it could do less.

What actually happened

The tool list grew past what the model could reason about in one pass. Two tools sounded interchangeable. One was described as "search the codebase," another as "find references." The agent started picking by vibes, and every wrong call cost a retry loop and a confused human reading the trace.

Tool count is not capability. It's a tax on every decision the agent makes, because it has to hold the whole list in context and choose.

The failure modes are predictable

Generic descriptions are the first rot. "Get data from the API" could mean four of the tools you installed. Naming collisions are the second: two tools both called search, one over files and one over tickets. The third is scope creep — a tool that was meant for one job grew three optional parameters until nobody knew when to call it.

The agent doesn't tell you it's guessing. It just calls the closest-sounding one and moves on.

The fix is subtraction, not more tools

We cut the list in half. Merged the two search tools into one with a clear purpose. Rewrote every description to say when NOT to use it. A tool that says "use this for repo files, not tickets" prevents more wrong calls than a longer tool ever enabled.

For API work this was the clearest win: one well-described tool that runs a spec against a live endpoint beat three scattered fetch-and-parse tools, because the agent stopped having to decide which one applied. We ended up keeping that flow local rather than wiring it through yet another server.

Worth auditing this week

Open your agent's tool list and read every description out loud. If two could plausibly be the same call, merge them. If a description doesn't say when to skip it, rewrite it. You'll ship a slower-looking setup that gets more right on the first try.

How many tools does your agent actually have — and how many of them have you used in the last week?