MCP Tool Schemas Are Eating Your Context

Ok-Tooth1667 · reddit · 2026-07-12

The author noticed that connecting multiple MCP servers to an agent causes tool selection accuracy to steadily decline as tool count increases, showing a near-linear correlation with the number of servers.

The root cause: every tool's name, description, and full JSON Schema are serialized into the context during each request. For example, 4 servers with 60 tools consume about 11–12k tokens just for definitions, while the system prompt itself is under 2k.

Their practical fix wasn't reducing the total number of tools, but reducing the number of tools visible to the model at any given time:

Results:

The author concludes that the real bottleneck isn't the total number of tools, but the volume of serialized schemas in the active context.

Related event: MCP Tool Schema Overload Impairs Agent Accuracy(3 posts)→

Original post →

More from coding & agent

coding & agent channel →