MCP Server for generating VITI lesson presentations from markdown
Server has 5 tools with complete input schemas and descriptions, but quality is inconsistent. Tool names follow verb_noun convention (generate_, get_, update_, list_). Descriptions are present but generic (avg ~80 chars, below 194-char baseline). Parameters lack descriptions in 2/5 tools (update_instructor has no descriptions for rank/name params). No output schemas documented. Error handling returns plain text, not structured guidance. Missing parameter constraints (enums, ranges). No tool annotations (readOnlyHint/destructiveHint). Composition is reasonable but update_instructor has optional required params (empty required array despite having params).
Generate a PPTX presentation from markdown content. Returns path to the generated file.
Get current presentation configuration (colors, fonts, instructor info)
Get an example markdown template showing the correct format for creating presentations
List all generated presentations in the output folder
Update instructor information in the configuration
update_instructor has parameters (rank, name) with no descriptions and empty required array, violating parameter documentation rule. LLM cannot infer what rank/name control or whether they are mandatory.
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract structured data. Responses are plain text, not typed objects.
Error handling returns plain text ('❌ Помилка: ...') without recovery guidance. LLM cannot determine if error is retryable, user-fixable, or fatal.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). LLM cannot distinguish safe reads from destructive writes (generate_presentation, update_instructor are state-modifying but unmarked).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 53 | 2026-07-28+ | v2 |
generate_presentation accepts free-form markdown and filename with no validation constraints. No regex patterns, length limits, or format guidance in descriptions.