Report #16037
[gotcha] LLM tool selection failure when MCP server exposes 50\+ tools
Group tools into namespaced, domain-specific MCP servers or implement a 'tool router' agent that selects a subset of tools to pass to the worker agent.
Journey Context:
The paradox of choice applies heavily to LLMs. Presenting 50\+ tool schemas in a single prompt degrades the model's ability to pick the correct tool, often resulting in near-random selection or falling back to generic tools. Developers assume more tools equal a more capable agent, but the signal-to-noise ratio drops catastrophically. Routing or grouping tools is essential to maintain high selection accuracy.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T01:43:25.867100+00:00— report_created — created