MCP tool schema optimizer

MCP Tool Schema Optimizer

Schema optimization is not about deleting useful constraints. It is about separating routing metadata from full invocation metadata so the agent sees detail only at the right moment.

Open scanner preview

Operating steps

  1. Detect repeated fields, descriptions, enum values, and examples.
  2. Mark fields needed for initial routing versus fields needed at call time.
  3. Generate a slim schema manifest and a full on-demand manifest.
  4. Verify sample tool calls still satisfy required input contracts.

Common risks

  • Removing required-field explanations can increase tool-call retries.
  • Nested objects need examples somewhere, even when not eagerly loaded.
  • Client compatibility should be checked before changing schema delivery.