Browse AI Agents & MCP SECTION 3: Tool Definitions & Schemas

The Schema Validator

1 fill-in slot · from The AI Prompt Handbook for AI Agents & MCP

Your details

0/1 filled

The Schema Validator

Review these tool schemas for problems.

[PASTE SCHEMAS]

Check for:
1. Properties without descriptions
2. Free-text strings that should be enums
3. Required fields that should be optional, and vice versa
4. Ambiguous types — a "date" that is a string with no format, an
   "id" that could be several things
5. Nested structures a model will construct incorrectly
6. Missing additionalProperties: false
7. Parameters whose valid values depend on another parameter, with
   no way for the model to know
8. Units, timezones, and currencies left implicit
9. Anything where a model's plausible guess produces a valid-looking
   but wrong call

For each finding: the problem, the specific fix, and what wrong
behaviour it currently causes.

Then: for each tool, what is the most likely wrong argument a model
will supply, and does the tool fail loudly on it?

Highlighted [slots] are still empty. Downloads are plain .txt — paste into any AI assistant.