[FEATURE] Add configuration option to force MCP tool lazy loading (Tool Search)
Resolved 💬 2 comments Opened Jan 16, 2026 by ryo1sato Closed Jan 16, 2026
Preflight Checklist
- [x] I have searched existing requests and this feature hasn't been requested yet
- [x] This is a single feature request (not multiple features)
Problem Statement
When working with moderate numbers of MCP tools (~50) that fall just under the 10% context threshold, there's no way to enable lazy loading. Users who are context-conscious would benefit from lazy loading even when not strictly required, preserving context for actual work rather than tool schemas that may not be used.
Proposed Solution
Add a setting in settings.json:
{
"mcpToolSearch": "auto" | "always" | "never"
}
auto(default): Current behavior, triggers at 10% thresholdalways: Force lazy loading regardless of tool countnever: Always load all tool schemas upfront
Alternative Solutions
- Artificially inflate MCP tool count to cross the 10% threshold (not practical)
- Lower the threshold percentage globally (less flexible than explicit user control)
- No workaround currently exists for users who want lazy loading with moderate tool counts
Priority
Medium - Would be very helpful
Feature Category
CLI commands and flags
Use Case Example
Example scenario:
- I have 2 MCP servers with ~50 total tools (claude-in-chrome + playwright)
- These tools fall just under the 10% context threshold
- With this feature, I could set
"mcpToolSearch": "always"to force lazy loading - This would save context for actual coding work instead of tool schemas I may not use in a given session
Additional Context
_No response_
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗