JSON validator with optional JSON Schema validation and structure stats.
Single tool with adequate naming and schema, but description lacks LLM-optimization guidance. Tool name 'data_validate_json' is clear and verb-prefixed. Input schema is present with required field and property descriptions. However, the description is overly long (280+ chars) and includes cross-tool references that belong in agent configuration, not the tool description itself. Output schema is completely undocumented, LLMs cannot plan downstream calls without knowing what fields are returned. Error handling is absent from the definition.
Use this when you need to validate JSON syntax or validate JSON data against a JSON Schema. Returns validity status, parse errors, formatted JSON, and structure stats (depth, key count, arrays, total size). Do NOT use for password checking — use security_check_password. Do NOT use for hash generation — use crypto_generate_hash. Do NOT use for cron expressions — use util_parse_cron.
Output schema not documented. Tool returns validity status, parse errors, formatted JSON, and structure stats, but LLMs cannot see the response structure. This prevents downstream tool chaining and forces agents to guess field names.
Tool description includes cross-tool routing ('Do NOT use for password checking, use security_check_password'). This belongs in agent system prompts or tool selection logic, not the tool definition. It inflates description length (280 chars vs. recommended 50-200) and wastes tokens.
No error handling guidance. If JSON parsing fails, what does the tool return? If schema validation fails, is it a structured error or a string? LLMs need explicit error classification (retryable, user-fixable, fatal) to plan recovery.
Inferred effective spec: 2025-06-18+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | 2025-06-18+ | v2 |
Optional 'schema' parameter lacks format guidance. JSON Schema is complex; the description should clarify: 'JSON Schema draft version expected? Are $ref and allOf supported? What happens if schema is invalid?'
No result limits or pagination documented. If a user passes a 10MB JSON file, does the tool return the entire formatted output? This could blow context windows. Baseline: cap results at 50KB and document the limit.