MCP server providing tools for teachers to search teaching materials, find licensed images for worksheets, and manage configuration.
The server provides 5 tools with schemas visible in e2e/mcp_test.go, but exhibits significant quality gaps. Descriptions exist but are generic and lack actionable guidance. Tool naming is weak, most tools do not start with clear action verbs. Parameters have types and enums (good), but descriptions are minimal. Output schemas are not documented anywhere in the source code. Error handling is present but not shown to include recovery guidance. The German-language descriptions ('Speichert eine Konfigurationseinstellung', 'Durchsucht den Unterrichtsmaterial-Ordner') are concerning for an LLM-facing tool, LLMs are predominantly trained on English and will have degraded understanding of non-English descriptions. Overall, tools are functional but underdeveloped for production agentic use.
Gibt die Download-URL für ein Bild zurück. Verwende die URL direkt zum Herunterladen.
Liest den Textinhalt einer Datei aus dem Unterrichtsmaterial-Ordner. Unterstützt PDF, DOCX und PPTX.
Sucht lizenzfreie, kopierergeeignete Bilder für Arbeitsblätter. Priorisiert Strichzeichnungen und Cliparts.
Durchsucht den Unterrichtsmaterial-Ordner nach Dateien. Nutzt macOS Spotlight für Volltextsuche in PDFs, Word- und PowerPoint-Dateien.
Speichert eine Konfigurationseinstellung für das Teacher Toolkit.
All tool descriptions are in German, not English. LLMs are primarily English-trained and will have degraded understanding of non-English descriptions, leading to incorrect tool selection and invocation.
No output schemas documented. Tools return results but descriptions do not specify the structure of responses. LLMs cannot plan downstream tool calls or extract required fields (e.g., file paths, image IDs) without guessing.
Tool names are generic and lack clarity. 'set_config', 'search_material', 'read_material' do not start with specific action verbs that convey the exact operation. LLMs may conflate similar tools.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 44 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 49 | 2025-03-26+ | v1 |
Parameter descriptions are missing or incomplete. 'max_results' appears in search_material, search_images, and get_image but lacks range constraints or descriptions. 'value' in set_config and 'image_id' in get_image lack descriptions entirely.
No error handling guidance. Tool descriptions do not explain what to do if a file is not found, an API key is missing, or a query returns no results. Agents cannot self-correct.
No pagination guidance. search_material and search_images accept 'max_results' but descriptions do not mention whether results are paginated, what the default is, or how to fetch the next page. Large result sets will blow context windows.
Implicit dependencies not documented. get_image depends on search_images providing image IDs; set_config must be called before search_images (to configure API key). Descriptions do not surface these prerequisites.