Writing tool definitions and schemas

A good tool definition is half the battle. This guide shows how to write input and output schemas that validate cleanly, document themselves, and stay friendly to the model calling them.

We cover naming, required vs optional fields, and the small structural choices that make a tool obvious to use instead of a guessing game.