Commit 7d615af
feat: Add comprehensive .describe() annotations to all Zod schemas
Add 82 parameter descriptions using Zod's .describe() method to improve
AI agent understanding of tool parameters. This enables LLMs to better
understand parameter usage, types, formats, and recommended values.
Changes:
- Add descriptions to all 56 tool parameters across 8 tools
- Include examples, default values, and recommended ranges
- Document nested schemas (location, actions, formats, parsers, webhook)
- Add descriptions to all enum values and object properties
Benefits for AI agents:
- Clear understanding of what each parameter does
- Concrete examples for proper usage
- Default value documentation
- Recommended value ranges to avoid issues
- Format specifications (ISO codes, UUID, etc.)
All descriptions are visible in the JSON Schema output via tools/list,
enabling any MCP client to provide better parameter guidance.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>1 parent 0d798a8 commit 7d615af
1 file changed
+95
-81
lines changed
0 commit comments