scobees-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SCOBEES_PASSWORD | No | Your scobees password for password-based login. | |
| SCOBEES_USERNAME | No | Your scobees username for password-based login. | |
| SCOBEES_REFRESH_TOKEN | No | A refresh token used as a transitional option for accounts that sign in only via Microsoft 365 or Eduplaces and therefore cannot use password login. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| scobees_meA | Zeigt das eigene scobees-Konto (ID, Rolle, Schule) und prüft die Anmeldung. |
| scobees_list_workspacesA | Listet alle Lernbereiche (Kacheln in der Bib) mit ihren Fächern. Nur lesen – Verwaltung bleibt beim Administrator. |
| scobees_list_subjectsA | Listet Fächer (Kurse), optional gefiltert auf einen Lernbereich. Die Lehrkraft wählt hieraus das Fach, in dem ein Lernpfad angelegt wird. |
| scobees_list_tagsA | Listet Jahrgänge und Differenzierungsstufen der Schule (für create_lernpfad / create_aufgabe). |
| scobees_list_lernpfadeA | Listet Lernpfade eines Fachs (oder alle) mit ID, Name, Status, Jahrgängen. Zum Finden bestehender Kurse, die erweitert werden sollen. |
| scobees_get_lernpfadA | Lädt einen Lernpfad mit vollständigem Aufbau (Gliederungen → Aufgaben) als kompakten Baum. IDs daraus werden für Änderungen benötigt. |
| scobees_get_aufgabeA | Lädt eine einzelne Aufgabe inkl. Arbeitsblatt (Serlo) als Markdown, Links und Anhängen. Für Änderungen an bestehenden Aufgaben. |
| scobees_create_lernpfadA | Legt einen neuen Lernpfad in einem Fach an (Wurzel). Danach Gliederungen und Aufgaben mit den anderen Werkzeugen hinzufügen. Der Pfad erscheint in der schuleigenen Bib (published) und hat Status INACTIVE, bis eine Lehrkraft ihn in der Weboberfläche einer Lerngruppe zuweist. |
| scobees_update_lernpfadA | Ändert einen bestehenden Lernpfad (Wurzel): Name, Beschreibung, Jahrgänge, Stichwörter, Titelbild, Reihenfolge. Nicht angegebene Felder bleiben erhalten. in_bib: Schalter „In schuleigener Bib veröffentlichen“. Fach bleibt beim Administrator, Zuweisung an Lerngruppen in der Weboberfläche. |
| scobees_create_gliederungB | Legt eine Gliederungsstruktur (Ordner/Phase) in einem Lernpfad oder einer anderen Gliederung an. Beschreibung ist HTML (h2, p, strong, em, u, a, span style=color). |
| scobees_update_gliederungB | Ändert Name und/oder Beschreibung einer Gliederungsstruktur. (Gleicher Aufruf wie Anlegen, mit id – live geprüft.) |
| scobees_create_wahlpflichtA | Legt eine Wahlpflichtaufgabe an: ein Container, aus dem Lernende eine Mindestanzahl an Unteraufgaben lösen. Unteraufgaben danach mit scobees_create_aufgabe (parent_id = diese ID). |
| scobees_update_wahlpflichtB | Ändert eine Wahlpflichtaufgabe (Name, Beschreibung, Mindestanzahl, Farbe, Titelbild). Nicht angegebene Felder bleiben erhalten. |
| scobees_upload_bildA | Lädt ein Bild (png/jpg/gif/webp/svg) für ein interaktives Arbeitsblatt hoch und liefert die URL, die im Markdown als |
| scobees_create_aufgabeA | Legt eine Aufgabe in einer Gliederung/Wahlpflicht/einem Lernpfad an. art: info (nur lesen), selbstkontrolle (Serlo-Quiz mit Selbstkontrolle), abgabe_optional, abgabe_pflicht (Datei-Abgabe), abgabe_optional_sc. Das Arbeitsblatt kommt als Markdown (arbeitsblatt_markdown, inkl. ```quiz-sc/quiz-mc/quiz-input/quiz-blanks/quiz-text-Blöcken) oder als fertiges serlo_json. Dateien danach mit scobees_upload_material anhängen. |
| scobees_update_aufgabeA | Ändert eine bestehende Aufgabe. Nur übergebene Felder werden geändert; arbeitsblatt_markdown/serlo_json ersetzen das Arbeitsblatt komplett (vorher mit scobees_get_aufgabe lesen). |
| scobees_upload_materialB | Hängt eine lokale Datei an eine Aufgabe an – als Material (PDF, Bild, HTML-Simulation, interaktive Seite, GeoGebra-Datei …) oder als Musterlösung. |
| scobees_moveA | Verschiebt eine Aufgabe/Gliederung/Wahlpflicht an eine Position (sort_order, 0-basiert) – auch in eine andere Gliederung desselben Lernpfads. |
| scobees_deleteB | Löscht eine Aufgabe, Gliederung, Wahlpflichtaufgabe oder einen ganzen Lernpfad (inkl. Unterelementen!). Erfordert confirm=true. |
| scobees_markdown_vorschauA | Wandelt Markdown testweise in das Serlo-Format um (ohne etwas zu speichern) und zeigt die erzeugten Bausteine. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 20 tools
Each resource (Lernpfad, Gliederung, Aufgabe, Wahlpflicht) has a clear get/list/create/update split, and the descriptions distinguish read-versus-write intent well. Minor overlap remains: upload_bild vs. upload_material both attach media (image inline vs. file as Material/Musterlösung), and the polymorphic move/delete tools don't state their target type in the name, so an agent must read descriptions to avoid misuse.
Nearly all tools follow a scobees_ + verb_noun pattern (get_lernpfad, list_aufgabe-style names, create_/update_ pairs), which makes the family easy to scan. A few outliers break the pattern: scobees_me (no verb), scobees_delete and scobees_move (verb without object), and scobees_markdown_vorschau (noun phrase), though all stay snake_case and readable.
20 tools is on the heavy side, but the domain (learning paths with nested structures, tasks, elective-task containers, and two upload flows) genuinely needs this surface, and CRUD is factored across distinct resource families. A few tools could arguably be merged, but nothing feels redundant.
Full lifecycle coverage exists for Lernpfade, Gliederungen, Aufgaben, and Wahlpflicht (list/get/create/update/move/delete), plus a markdown preview to validate Serlo content before saving. Gaps are minor: no way to remove an already-uploaded image/Material attachment, no duplicate/copy operation, and no reordering helper beyond move — all workable around the UI or by re-posting.