Report #13563
[gotcha] Tool selection failure when exposing 50\+ MCP tools to agent
Group tools by capability and use a router/tool-caller pattern, or limit active tools to < 20 per request cycle based on the user's intent.
Journey Context:
LLMs suffer from attention dilution when presented with too many tool options. Even if the context window allows it, the probability of selecting the correct tool drops significantly past ~20 tools. Developers assume 'more tools = more capable', but it actually degrades routing accuracy and increases hallucinated tool calls.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T19:09:39.992693+00:00— report_created — created