A tool budget caps the share of a model's context window consumed by tool definitions. A useful ceiling is 10% of the available context, because individually justified tools can collectively consume a third of the window. section 9.5.1
Use the budget as a second-stage selection constraint:
- Set the total ceiling before deciding whether any individual tool deserves permanent context. section 9.5.1
- Load tools on demand when possible; deferred loading reduced tool-definition tokens by 85% in reported testing. section 9.5.1
- Verify retrieval quality against the tool catalogue before deferring critical capabilities. section 9.5.1
The hidden context tax
A Claude Sonnet 4.5 context can spend 58,400 tokens—29%—on MCP tools before messages or task work begin. Six tools that each justify their space can still exceed a disciplined total budget. section 9.5.1
Table 9.6 Context Usage claude-sonnet-4-5
|
Source
|
Tokens
|
Share
|
|
System prompt
|
3,900 tokens
|
2%
|
|
MCP tools
|
58,400 tokens
|
29%
|
|
Memory files
|
1,200 tokens
|
1%
|
|
Messages
|
42,000 tokens
|
21%
|
|
Free space
|
94,500 tokens
|
47%
|
Inspect the context allocation to see how MCP tool definitions compete with messages, memory, system instructions, and free space. section 9.5.1
