Skip to main content
Glama

Sessionario

by com.sessionario.mcp
OverviewDiscussionsAdmin

Modul ändern

modul_aendern
Idempotent

Ändert ein einzelnes Modul einer eigenen Session - Titel, Dauer, feste Uhrzeit, Ziel, Inhalt, Material, Trainerhinweis, Zusatz, Nachbereitung oder Art. Angegeben wird es über Tag und die "nummer" aus session_lesen. Nur die Felder senden, die sich ändern sollen; alles andere bleibt, wie es ist.

Gehört die Session jemand anderem, nimm zuerst session_kopieren. Löschen kann dieses Werkzeug nicht - das macht der Nutzer in der App.

Input Schema

NameRequiredDescriptionDefault
idYesDie ID der Session.
artNoWozu der Block da ist - nicht die Methode, nicht das Medium. orientation=Einstieg & Orientierung, connection=Verbindung & Aktivierung, input=Impuls & Verstehen, exploration=Erkunden & Analysieren, ideation=Ideen & Gestalten, decision=Bewerten & Entscheiden, practice=Anwenden & Erproben, reflection=Reflexion & Transfer, closing=Abschluss & Feedback, break=Pause, offprogramme=Drumherum (Anreise, Abendessen - zählt nicht zur Workshopzeit).
tagNoDer Tag (Vorgabe 1).
zielNo
titelNo
inhaltNo
nummerYesDie "nummer" des Moduls aus session_lesen.
zusatzNoDie sechste Spalte („Zusatz") - lange Prompts, Kartentexte, Beobachtungsbögen. Leerer String löscht sie.
minutenNoNeue Dauer. Alles Folgende rückt nach.
materialNo
optionalNoMacht das Modul optional (true) oder plant es wieder ein (false). Optional heißt: Es steht im Ablauf, kostet dort aber keine Minuten, und Sessionario zeichnet es mit gestrichelter Linie. Die Dauer wird beiseite gelegt und kommt beim Wiedereinplanen zurück. Schreib „optional" nicht in den Titel - das ist dieser Schalter.
beginnt_umNoEine FESTE Uhrzeit für dieses Modul, z. B. "14:00" - für Dinge, die zu einer verabredeten Zeit stattfinden: der Gastredner, das Mittagessen, die Schaltung zur Zentrale. Das Modul bekommt damit ein Schloss: Es bleibt auf seiner Zeit, auch wenn davor etwas länger dauert, und die Kette läuft ab seinem Ende weiter. Leerer String nimmt das Schloss wieder weg - dann hängt das Modul wie alle anderen in der Kette. Für alles Übrige gilt: nur "minuten" angeben, Sessionario rechnet.
nachbereitungNoDie siebte Spalte („Nachbereitung") - Transfer und Aufgaben nach dem Modul. Leerer String löscht sie.
trainerhinweisNo
optional_minutenNoDie beiseitegelegte Dauer eines optionalen Moduls - wie lange es dauern WÜRDE. Nur nötig, wenn sie sich ändert; sonst bleibt die gespeicherte stehen.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / optional
      Added value: +{
+  "description": "Macht das Modul optional (true) oder plant es wieder ein (false). Optional heißt: Es steht im Ablauf, kostet dort aber keine Minuten, und Sessionario zeichnet es mit gestrichelter Linie. Die Dauer wird beiseite gelegt und kommt beim Wiedereinplanen zurück. Schreib „optional\" nicht in den Titel - das ist dieser Schalter.",
+  "type": "boolean"
+}
    • addedInput schema / properties / optional_minuten
      Added value: +{
+  "description": "Die beiseitegelegte Dauer eines optionalen Moduls - wie lange es dauern WÜRDE. Nur nötig, wenn sie sich ändert; sonst bleibt die gespeicherte stehen.",
+  "maximum": 1440,
+  "minimum": 5,
+  "type": "integer"
+}
  2. First observed

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations cover the safety profile (readOnly=false, idempotent=true, destructive=false), and the description adds genuine behavioral context: partial-update semantics ('Nur die Felder senden, die sich ändern sollen; alles andere bleibt') and the explicit inability to delete. It does not cover error cases or what a rejected update looks like, so not a full 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two tight paragraphs with the core verb and partial-update rule front-loaded, followed by the edge-case routing. The field enumeration slightly restates the schema but stays compact and every sentence carries weight.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 15-param mutation tool with no output schema, the description supplies the identification keys, the partial-update contract, ownership handling, and the delete limitation. Remaining gap is failure/permission behavior, but the essentials for correct invocation are present.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 67% with rich field-level descriptions, and the description adds the identification mechanism ('über Tag und die nummer aus session_lesen') plus a full enumeration of the editable fields. It complements rather than merely repeats the schema, though it does not explain the trickier fields (optional, beginnt_um, optional_minuten) beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a precise verb+resource ('Ändert ein einzelnes Modul') and enumerates the mutable fields, letting an agent distinguish it from module_hinzufuegen (adds), modul_verschieben (moves), and session_aendern (edits the session itself). The scope 'einer eigenen Session' further narrows it against siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly names the alternative for the out-of-scope case ('Gehört die Session jemand anderem, nimm zuerst session_kopieren') and states an exclusion ('Löschen kann dieses Werkzeug nicht'). When-to-use and when-to-delegate are both spelled out.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Sessionario toolsInspect
Try in Browser
Pay for results, not tokens.Fund a bounty. Let AI agents compete and collaborate to solve your problems.agentbounties.appAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources