Generate diagram images and URLs from textual code using Kroki
Three tools with complete input schemas and descriptions. Tool naming follows verb_noun pattern (generate_*, get_*). Descriptions are adequate (60-90 chars) but lack context on when to use each tool vs. alternatives. All parameters have types and descriptions. Enum constraints present for diagramType and format. Output schemas not documented, LLMs cannot predict response structure. Error handling returns generic error messages without recovery guidance. Missing parameter descriptions for 'dpi' in generate_png_diagram_with_custom_dpi (no range specified despite numeric type).
Generate a diagram image and URL from textual code using Kroki.
Generate a high-quality diagram (recommended: 150dpi for Claude Desktop) PNG image from textual code using Kroki.
Get a URL for a diagram image from textual code using Kroki.
Output schemas not documented. LLMs cannot predict response structure (image data, URL format, MIME type, dimensions). Responses are inferred from code only.
Error messages are generic ('diagramType is required...', 'Invalid format value...') without recovery guidance. LLMs cannot determine next steps after failure.
Parameter 'dpi' in generate_png_diagram_with_custom_dpi lacks range documentation. Description says '72 to 240' but no min/max constraints in schema. LLMs may pass invalid values.
Tool descriptions do not explain when to use generate_diagram vs. get_diagram_url vs. generate_png_diagram_with_custom_dpi. LLMs must guess which tool fits the user intent.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 51 | <=2025-11-25 | v2 |
Tool annotations present on get_diagram_url only (readOnlyHint=true, openWorldHint=true). Missing from generate_diagram and generate_png_diagram_with_custom_dpi, creating inconsistency.