liveBook · Manning

Tool budget

As explained in Vibe Engineering

A tool budget is a configured limit on the portion of a model context window allocated to tool definitions.

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

How Vibe Engineering covers it

How deep it goes
Defines a 10% ceiling, compares permanent and deferred loading, and stops short of prescribing a universal tool catalogue.
Examples
Uses 58,400 MCP tokens consuming 29% of a Claude Sonnet 4.5 context as the concrete failure case.
What you can do after
Configure tool exposure by budgeting total schema space, deferring loading, and testing retrieval for critical tools.
How it connects
Connects tool selection with context windows, MCP, CLI interfaces, and deferred tool loading.

This explainer was generated by Manning's knowledge graph from the text of Vibe Engineering. The section links point to the parts of the book it draws on.