Definition
MCP tool schema bloat is the excessive consumption of agent context tokens by tool definition schemas loaded from multiple MCP servers at session startup, reducing the context available for actual work and increasing per-session LLM costs.
In Depth
Every MCP server registered in an agent's configuration contributes tool schemas to the context window at session start. Each tool definition includes a name, description, and JSON Schema for parameters. A well-designed server with 5 tools might add 400-600 tokens. A sprawling server with 20+ tools can add 2000-4000 tokens. With 5 MCP servers enabled, schema overhead can reach 5000-15000 tokens before the agent does any work. On Claude Opus at ~$15/million tokens, 10K tokens of schema bloat costs ~$0.15 per session. At 50 sessions/day, that is $7.50/day or $225/month in pure overhead. Mitigation strategies: 1) Audit and disable unused MCP servers per project (not every project needs every server). 2) Use conditional loading where the agent framework supports it. 3) Prefer servers with fewer, well-scoped tools over kitchen-sink registries. 4) Use pre-tool-use filtering (Gandalf pattern) so the agent only 'sees' relevant tool schemas per turn. Scavio's MCP server registers 11 tools for 5 platforms, which is a moderate footprint (~900 tokens) compared to servers that register 30+ tools.
Example Usage
A developer runs Claude Code with 8 MCP servers enabled: search, browser, memory, git, database, file system, image generation, and documentation. Total tool schema overhead: ~12,000 tokens. After auditing, they disable browser, image generation, and database servers for coding tasks. New overhead: ~5,000 tokens. Context available for code and conversation increases by 7,000 tokens per session.
Platforms
MCP Tool Schema Bloat is relevant across the following platforms, all accessible through Scavio's unified API:
Related Terms
Model Context Protocol (MCP)
Model Context Protocol (MCP) is an open standard that defines how large language models discover and invoke external too...
MCP Server Registry
An MCP server registry is the collection of tool schemas (names, descriptions, parameter definitions) that an MCP-compat...
Context Bloat
Context bloat is the accumulation of tokens in an LLM's context window before the user has asked anything — usually from...