Report #9975
[gotcha] Agent loses system prompt or user context when connecting to MCP servers with many tools
Implement dynamic tool loading or progressive disclosure. Use a search\_tools meta-tool instead of exposing all tools upfront, or group tools into sub-servers.
Journey Context:
Developers assume exposing all capabilities is best so the LLM has maximum flexibility. However, MCP tool schemas \(names, descriptions, JSON inputs\) are injected into the system prompt. With 50\+ tools, this can consume 10k\+ tokens, pushing the actual user task out of the context window or causing silent truncation, leading to hallucinations or ignored instructions.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T09:37:08.168963+00:00— report_created — created