Add input_examples to tool schemas — it beats JSON Schema alone on messy parameters (72% → 90%)

Anthropic Engineering·medium signal

Beyond the JSON Schema, attach an "input_examples" array of 1–5 realistic calls showing minimal, partial, and full specification plus format conventions (date formats, ID patterns, kebab-case labels). Anthropic's internal testing lifted complex-parameter accuracy from 72% to 90%. The non-obvious part: examples teach parameter correlations and domain conventions that a schema can't express, so this is the cheapest fix for tools with many optional or nested fields.