MCP Tool Search Auto Mode — runtime test
Hands-on runtime battle-test of MCP Tool Search Auto Mode. Result: INCONCLUSIVE.
MCP Tool Search Auto Mode — runtime test
MCP Tool Search Auto Mode is a Claude 2.1.7+ feature that defers MCP tool loading until runtime if tool descriptions would consume more than 10% of context, then discovers tools on-demand via the MCPSearch mechanism.
What the test attempted
The test design was sound: verify that when MCP tool metadata exceeds 10% of context, tools are NOT loaded upfront but instead discovered on-demand via MCPSearch. The payload would be significant—multiple MCP servers with many verbose tool descriptions—to trigger the threshold.
Result: INCONCLUSIVE
The test was not executed. The authors noted that achieving the 10% threshold requires "multiple MCP servers with many tools," a configuration most users don't deploy. Without a realistic heavy-MCP setup in place, the behavior could not be verified against the feature specification.
Why it matters
For heavy MCP users, this feature reduces context overhead: instead of all tools loading upfront (consuming context linearly with tool count), only discovery metadata stays resident. As MCP adoption scales, this becomes material. The 10% threshold acts as a reasonable circuit breaker—typical setups remain unaffected while power users benefit from graceful scaling.
Caveats
This remains untested at runtime. The 10% boundary itself is unverified. Actual MCPSearch latency and completeness on large tool inventories are unknown. Users with large MCP deployments would need to empirically confirm tool availability in the runtime, not just trust the feature exists.
Users can disable the feature by adding MCPSearch to disallowedTools in settings.
Status: Runtime test needed. Setup: heavy MCP servers with ≥10% context tool descriptions, then request an operation that would benefit from lazy tool loading.
Test Results: MCP Tool Search Auto Mode
Feature: MCP tool search auto mode enabled by default
Tested: 2026-01-16 Version: 2.1.7 features on 2.1.9
Feature Description
When MCP tool descriptions exceed 10% of context window:
- Tools are NOT loaded upfront
- Instead, discovered via MCPSearch tool on-demand
- Reduces context usage for users with many MCP tools
Behavior
- Before 2.1.7: All MCP tools loaded into context upfront
- After 2.1.7: Auto-deferred when >10% context would be used
- Disable: Add
MCPSearchtodisallowedToolsin settings
Test Result: NOT TESTED
Would need:
- Multiple MCP servers with many tools (>10% context)
- Verify tools aren't loaded upfront
- Verify MCPSearch discovers them on-demand
Most users won't hit the 10% threshold with typical MCP setups.
Use Cases
- Heavy MCP users - Many tools configured
- Large tool descriptions - Verbose MCP servers
- Context optimization - Free up context for actual work
- Graceful scaling - Tool count doesn't linearly consume context
Notes
Smart optimization. As MCP adoption grows, this becomes more important. The 10% threshold is reasonable - most users won't notice, heavy users benefit.
Status: NOT TESTED (needs heavy MCP setup)
test_da4e72bf2e50b83240282fb0ed255199b87705613b1e2fd064d57fa75a6b679d2856ceafad6b1daa8f982493871b6ddbcab981a04a19de3ef9ae9b5f8cbf20c06e1c409413e61e4054654e2c5ad62f415c2c548299f30a8990cfdcc3dcbce3b4c7e9ebfcdcb8309c5326bb1fc31a102Signed with an ed25519 key held off the repo. Anyone can verify against the published public key; nobody without the secret key can forge it. Click verify: it recomputes the signature in your browser. The signature proves integrity and authorship of this exact content — not a third-party timestamp or that the underlying claim is objectively true. signedAt is when the @f3/attest pipeline ran, not when the work happened; the evidence refs carry the source dates.
- verifies MCP Tool Search Auto Mode Primitive