← 2.1.7 Test inconclusive · runtime-test

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.

Primary source
⎘ 2.1.7/tests/03-mcp-auto-search/TEST-RESULTS.mdverbatim from the corpus

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 MCPSearch to disallowedTools in settings

Test Result: NOT TESTED

Would need:

  1. Multiple MCP servers with many tools (>10% context)
  2. Verify tools aren't loaded upfront
  3. Verify MCPSearch discovers them on-demand

Most users won't hit the 10% threshold with typical MCP setups.

Use Cases

  1. Heavy MCP users - Many tools configured
  2. Large tool descriptions - Verbose MCP servers
  3. Context optimization - Free up context for actual work
  4. 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)

Evidence & receipt
◇ ed25519 receipt
idtest_da4e72bf2e50b83240282fb0
alged25519
pubkey9b87705613b1e2fd064d57fa75a6b679d2856ceafad6b1daa8f982493871b6dd
sigbcab981a04a19de3ef9ae9b5f8cbf20c06e1c409413e61e4054654e2c5ad62f415c2c548299f30a8990cfdcc3dcbce3b4c7e9ebfcdcb8309c5326bb1fc31a102

Signed 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.

Connected