Sessionplan

Create Sessionplan

create_session_link

Read-onlyIdempotent

Use this when the user wants a new Sessionplan for a workshop, training, meeting, event, or other timed session, or a revised link after decoding an existing Sessionplan. Pass a complete session object matching inputSchema; partial updates and patches are not accepted. The returned structuredContent.link is an opaque snapshot URL and must be presented verbatim.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "session": "<session>"
    },
    "name": "create_session_link"
  }
}

Input Schema

Name	Required	Description	Default
`session`	Yes	Canonical format for newly generated Sessionplan documents. Include all required fields and only documented properties. Use declared category/person IDs and the supported item hierarchy.

Output Schema

Name	Required	Description	Default
`link`	Yes	Opaque, directly openable Sessionplan snapshot URL. Present this exact value verbatim; do not reconstruct, normalize, shorten, decode, or modify it.
`summary`	No	Optional compact summary of the encoded session.

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedNov 4, 2026

addedInput schema / $defs / day

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "date": {
+      "description": "Optional calendar date of this day (YYYY-MM-DD). Omit in days[0].",
+      "format": "date",
+      "pattern": "^(?!0000)[0-9]{4}-[0-9]{2}-[0-9]{2}$(?![\\s\\S])",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "description": {
+      "description": "Optional description or facilitator notes for this day. Omit in days[0]; the first day's description stays in workshop.description.",
+      "type": "string"
+    },
+    "durationLocked": {
+      "description": "Whether this day's target duration is locked. Omit in days[0].",
+      "type": "boolean"
+    },
+    "id": {
+      "description": "Unique day ID.",
+      "minLength": 1,
+      "type": "string"
+    },
+    "items": {
+      "description": "Ordered top-level blocks, groups or breakouts of this day. Omit in days[0].",
+      "items": {
+        "$ref": "#/$defs/item"
+      },
+      "maxItems": 500,
+      "type": "array"
+    },
+    "startTime": {
+      "description": "Optional local start time of this day (HH:MM). Omit in days[0].",
+      "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$(?![\\s\\S])",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "targetDuration": {
+      "description": "Optional target duration of this day in minutes. Omit in days[0].",
+      "minimum": 0,
+      "type": "number"
+    },
+    "title": {
+      "description": "Optional day label, e.g. 'Kick-off'. Defaults to 'Day n' when omitted.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "id"
+  ],
+  "type": "object"
+}

addedInput schema / properties / session / properties / days

Added value: +{
+  "description": "Optional, only for plans spanning several days. Omit it for single-day plans. days[0] describes the first day and contains only id and optional title; the first day's items, description, date, startTime and target stay in 'items' and 'workshop'. Every further entry is a complete day with its own items. Item IDs must be unique across all days, and all days together may contain at most 500 items.",
+  "items": {
+    "$ref": "#/$defs/day"
+  },
+  "maxItems": 14,
+  "type": "array"
+}

Changed49 schema fields changedSep 15, 2026

addedInput schema / $defs / blockType / properties / color / description

Added value: +"CSS color, commonly a hexadecimal color such as #2C8DFE."

addedInput schema / $defs / blockType / properties / id / description

Added value: +"Non-empty identifier, unique within this collection."

addedInput schema / $defs / blockType / properties / id / minLength
```
Added value: +1
```
addedInput schema / $defs / blockType / properties / name / description
```
Added value: +"Display name."
```

addedInput schema / $defs / item / allOf

Added value: +[
+  {
+    "if": {
+      "properties": {
+        "type": {
+          "const": "block"
+        }
+      }
+    },
+    "then": {
+      "not": {
+        "required": [
+          "children"
+        ]
+      }
+    }
+  },
+  {
+    "if": {
+      "properties": {
+        "type": {
+          "const": "group"
+        }
+      }
+    },
+    "then": {
+      "properties": {
+        "children": {
+          "items": {
+            "properties": {
+              "type": {
+                "enum": [
+                  "block",
+                  "breakout"
+                ]
+              }
+            }
+          }
+        }
+      },
+      "required": [
+        "children"
+      ]
+    }
+  },
+  {
+    "if": {
+      "properties": {
+        "type": {
+          "const": "breakout"
+        }
+      }
+    },
+    "then": {
+      "properties": {
+        "children": {
+          "items": {
+            "properties": {
+              "type": {
+                "const": "block"
+              }
+            }
+          }
+        }
+      },
+      "required": [
+        "children"
+      ]
+    }
+  }
+]

addedInput schema / $defs / item / properties / blockTypeId / description
```
Added value: +"ID of a declared block type, or null."
```

addedInput schema / $defs / item / properties / children / description

Added value: +"Groups contain blocks or breakouts; breakouts contain blocks. Blocks cannot have children."

addedInput schema / $defs / item / properties / duration / description

Added value: +"Explicit section duration in minutes. Groups normally use the sum of children; breakouts use the longest lane. The encoder does not recalculate durations."

addedInput schema / $defs / item / properties / durationLocked / description

Added value: +"Preserve the explicit container duration when the editor recalculates the plan."

addedInput schema / $defs / item / properties / fixedStartTime / description
```
Added value: +"Optional local fixed start time (HH:MM, 00:00–23:59)."
```
addedInput schema / $defs / item / properties / fixedStartTime / pattern
```
Added value: +"^([01][0-9]|2[0-3]):[0-5][0-9]$(?![\\s\\S])"
```

addedInput schema / $defs / item / properties / id / description

Added value: +"Non-empty stable identifier, unique across the complete item tree."

addedInput schema / $defs / item / properties / laneIndex / description

Added value: +"Zero-based lane index within the parent breakout; defaults to 0. Must be less than the parent lane count."

addedInput schema / $defs / item / properties / lanePersons / description

Added value: +"Map of zero-based lane indices to arrays of declared person IDs. Keep this as a JSON object, including when empty."

addedInput schema / $defs / item / properties / lanePersons / propertyNames
```
Added value: +{
+  "pattern": "^(0|[1-9][0-9]*)$(?![\\s\\S])"
+}
```

addedInput schema / $defs / item / properties / lanes / description

Added value: +"Number of breakout lanes, from 1 to 10 as supported by the editor. Defaults to 2 when omitted."

addedInput schema / $defs / item / properties / lanes / maximum
```
Added value: +10
```
addedInput schema / $defs / item / properties / material / description
```
Added value: +"Materials, links or resources."
```

addedInput schema / $defs / item / properties / notes / description

Added value: +"Facilitator notes; supports *bold*, _italic_ and [label](URL)."

addedInput schema / $defs / item / properties / parallel / description

Added value: +"Whether a breakout runs in parallel. Use true for breakouts."

addedInput schema / $defs / item / properties / personIds / description
```
Added value: +"IDs of declared persons assigned to this item."
```

addedInput schema / $defs / item / properties / sameInAllBreakouts / description

Added value: +"Show lane-zero content in every lane; child laneIndex must then be zero or omitted."

addedInput schema / $defs / item / properties / title / description
```
Added value: +"Agenda item title."
```

addedInput schema / $defs / item / properties / type / description

Added value: +"Item kind: block, sequential group, or parallel breakout."

addedInput schema / $defs / person / properties / color / description

Added value: +"CSS color, commonly a hexadecimal color such as #2C8DFE."

addedInput schema / $defs / person / properties / id / description

Added value: +"Non-empty identifier, unique within this collection."

addedInput schema / $defs / person / properties / id / minLength
```
Added value: +1
```
addedInput schema / $defs / person / properties / name / description
```
Added value: +"Display name."
```

addedInput schema / $defs / workshop / properties / date / description

Added value: +"Optional calendar date (YYYY-MM-DD). Use null when no date is planned."

addedInput schema / $defs / workshop / properties / date / format
```
Added value: +"date"
```

addedInput schema / $defs / workshop / properties / date / pattern

Added value: +"^(?!0000)[0-9]{4}-[0-9]{2}-[0-9]{2}$(?![\\s\\S])"

addedInput schema / $defs / workshop / properties / description / description
```
Added value: +"Session description or facilitator notes."
```
addedInput schema / $defs / workshop / properties / durationLocked / description
```
Added value: +"Whether the target duration is locked."
```

addedInput schema / $defs / workshop / properties / lastModified / description

Added value: +"Optional timestamp with T separator, seconds 00–59 and a time zone (Z or ±HH:MM), e.g. 2026-09-15T09:00:00.000Z."

addedInput schema / $defs / workshop / properties / lastModified / format
```
Added value: +"date-time"
```

addedInput schema / $defs / workshop / properties / lastModified / pattern

Added value: +"^(?!0000)[0-9]{4}-[0-9]{2}-[0-9]{2}[Tt]([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\\.[0-9]+)?([Zz]|[+-]([01][0-9]|2[0-3]):[0-5][0-9])$(?![\\s\\S])"

addedInput schema / $defs / workshop / properties / startTime / description

Added value: +"Optional local start time (HH:MM, 00:00–23:59). Use null when no start time is planned."

addedInput schema / $defs / workshop / properties / startTime / pattern
```
Added value: +"^([01][0-9]|2[0-3]):[0-5][0-9]$(?![\\s\\S])"
```

addedInput schema / $defs / workshop / properties / targetDuration / description

Added value: +"Optional target duration in minutes, greater than or equal to zero."

addedInput schema / $defs / workshop / properties / title / description
```
Added value: +"Session title."
```

changedInput schema / $defs / workshop / required

Previous value: -[
-  "title",
-  "description",
-  "date",
-  "startTime"
-]New value: +[
+  "title",
+  "description"
+]

addedInput schema / properties / session / description

Added value: +"Canonical format for newly generated Sessionplan documents. Include all required fields and only documented properties. Use declared category/person IDs and the supported item hierarchy."

addedInput schema / properties / session / properties / blockTypes / description
```
Added value: +"Declared block categories referenced by blockTypeId."
```

addedInput schema / properties / session / properties / items / description

Added value: +"Ordered top-level blocks, groups or breakouts. The complete tree may contain at most 500 items."

addedInput schema / properties / session / properties / persons / description

Added value: +"Declared facilitators or participants referenced by personIds and lanePersons."

addedInput schema / properties / session / properties / version / description

Added value: +"Document format version, currently 1.0; distinct from the v2 link codec and MCP protocol version."

addedInput schema / properties / session / properties / workshop / description
```
Added value: +"Workshop metadata."
```

changedOutput schema / properties / summary / properties / blockCount / description

Previous value: -"Number of agenda blocks."New value: +"Number of block items across the complete tree; containers are excluded."

changedOutput schema / properties / summary / properties / totalDuration / description

Previous value: -"Total session duration in minutes."New value: +"Sum of explicit top-level item durations in minutes; does not include fixed-start gaps or recalculate children."

Changed28 schema fields changedSep 2, 2026

removedInput schema / $defs / WorkshopItem

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "blockTypeId": {
-      "description": "ID of a declared block type, or null when none applies.",
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "children": {
-      "description": "Nested items belonging to a group or breakout.",
-      "items": {
-        "$ref": "#/$defs/WorkshopItem"
-      },
-      "type": "array"
-    },
-    "duration": {
-      "description": "Item duration in minutes.",
-      "minimum": 0,
-      "type": "number"
-    },
-    "durationLocked": {
-      "description": "Whether automatic adjustments must preserve this duration.",
-      "type": "boolean"
-    },
-    "fixedStartTime": {
-      "description": "Explicit start time for the item when one is required.",
-      "type": "string"
-    },
-    "id": {
-      "description": "Stable item identifier, unique within the session.",
-      "minLength": 1,
-      "type": "string"
-    },
-    "laneIndex": {
-      "description": "Zero-based breakout lane index for this item.",
-      "minimum": 0,
-      "type": "integer"
-    },
-    "lanePersons": {
-      "additionalProperties": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "description": "Mapping from lane identifiers to arrays of declared person IDs.",
-      "type": "object"
-    },
-    "lanes": {
-      "description": "Number of breakout lanes.",
-      "minimum": 1,
-      "type": "integer"
-    },
-    "material": {
-      "description": "Physical or digital materials required; use an empty string when none are needed.",
-      "type": "string"
-    },
-    "notes": {
-      "description": "Facilitation instructions, method details, or other notes.",
-      "type": "string"
-    },
-    "parallel": {
-      "description": "Whether child items or lanes run in parallel.",
-      "type": "boolean"
-    },
-    "personIds": {
-      "description": "IDs of declared persons assigned to this item.",
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "sameInAllBreakouts": {
-      "description": "Whether every breakout lane uses the same agenda.",
-      "type": "boolean"
-    },
-    "title": {
-      "description": "Concise title shown in the Sessionplan timeline.",
-      "type": "string"
-    },
-    "type": {
-      "description": "Item kind. Groups and breakouts may contain children.",
-      "enum": [
-        "block",
-        "group",
-        "breakout"
-      ],
-      "type": "string"
-    }
-  },
-  "required": [
-    "id",
-    "type",
-    "blockTypeId",
-    "title",
-    "duration",
-    "notes",
-    "material"
-  ],
-  "type": "object"
-}

addedInput schema / $defs / blockType

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "color": {
+      "type": "string"
+    },
+    "id": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "id",
+    "name",
+    "color"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / item

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "blockTypeId": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "children": {
+      "items": {
+        "$ref": "#/$defs/item"
+      },
+      "type": "array"
+    },
+    "duration": {
+      "minimum": 0,
+      "type": "number"
+    },
+    "durationLocked": {
+      "type": "boolean"
+    },
+    "fixedStartTime": {
+      "type": "string"
+    },
+    "id": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "laneIndex": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "lanePersons": {
+      "additionalProperties": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "type": "object"
+    },
+    "lanes": {
+      "minimum": 1,
+      "type": "integer"
+    },
+    "material": {
+      "type": "string"
+    },
+    "notes": {
+      "type": "string"
+    },
+    "parallel": {
+      "type": "boolean"
+    },
+    "personIds": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "sameInAllBreakouts": {
+      "type": "boolean"
+    },
+    "title": {
+      "type": "string"
+    },
+    "type": {
+      "enum": [
+        "block",
+        "group",
+        "breakout"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "id",
+    "type",
+    "blockTypeId",
+    "title",
+    "duration",
+    "notes",
+    "material"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / person

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "color": {
+      "type": "string"
+    },
+    "id": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "id",
+    "name",
+    "color"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / workshop

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "date": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "description": {
+      "type": "string"
+    },
+    "durationLocked": {
+      "type": "boolean"
+    },
+    "lastModified": {
+      "type": "string"
+    },
+    "startTime": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "targetDuration": {
+      "minimum": 0,
+      "type": "number"
+    },
+    "title": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "title",
+    "description",
+    "date",
+    "startTime"
+  ],
+  "type": "object"
+}

removedInput schema / properties / session / description

Removed value: -"Complete Sessionplan document. When creating or revising a plan, send the full document defined here; partial updates and patches are not accepted."

removedInput schema / properties / session / properties / blockTypes / description

Removed value: -"Small set of reusable visual categories referenced by item blockTypeId values."

addedInput schema / properties / session / properties / blockTypes / items / $ref
```
Added value: +"#/$defs/blockType"
```
removedInput schema / properties / session / properties / blockTypes / items / additionalProperties
```
Removed value: -false
```

removedInput schema / properties / session / properties / blockTypes / items / properties

Removed value: -{
-  "color": {
-    "description": "Color value used to display this block type.",
-    "type": "string"
-  },
-  "id": {
-    "description": "Stable block-type identifier, unique within the session.",
-    "type": "string"
-  },
-  "name": {
-    "description": "Human-readable block-type name.",
-    "type": "string"
-  }
-}

removedInput schema / properties / session / properties / blockTypes / items / required
```
Removed value: -[
-  "id",
-  "name",
-  "color"
-]
```
removedInput schema / properties / session / properties / blockTypes / items / type
```
Removed value: -"object"
```

removedInput schema / properties / session / properties / items / description

Removed value: -"Ordered top-level timeline items. Durations are expressed in minutes."

changedInput schema / properties / session / properties / items / items / $ref
```
Previous value: -"#/$defs/WorkshopItem"New value: +"#/$defs/item"
```
removedInput schema / properties / session / properties / persons / description
```
Removed value: -"People or roles explicitly supplied for this session."
```
addedInput schema / properties / session / properties / persons / items / $ref
```
Added value: +"#/$defs/person"
```
removedInput schema / properties / session / properties / persons / items / additionalProperties
```
Removed value: -false
```

removedInput schema / properties / session / properties / persons / items / properties

Removed value: -{
-  "color": {
-    "description": "Color value used to display this person or role.",
-    "type": "string"
-  },
-  "id": {
-    "description": "Stable person identifier, unique within the session.",
-    "type": "string"
-  },
-  "name": {
-    "description": "Person or role name.",
-    "type": "string"
-  }
-}

removedInput schema / properties / session / properties / persons / items / required
```
Removed value: -[
-  "id",
-  "name",
-  "color"
-]
```
removedInput schema / properties / session / properties / persons / items / type
```
Removed value: -"object"
```
removedInput schema / properties / session / properties / version / description
```
Removed value: -"Sessionplan document format version."
```
addedInput schema / properties / session / properties / workshop / $ref
```
Added value: +"#/$defs/workshop"
```
removedInput schema / properties / session / properties / workshop / additionalProperties
```
Removed value: -false
```
removedInput schema / properties / session / properties / workshop / description
```
Removed value: -"Top-level session metadata."
```

removedInput schema / properties / session / properties / workshop / properties

Removed value: -{
-  "date": {
-    "description": "Session date, or null when unknown.",
-    "type": [
-      "string",
-      "null"
-    ]
-  },
-  "description": {
-    "description": "Short description of the session goal or context.",
-    "type": "string"
-  },
-  "durationLocked": {
-    "description": "Whether the target duration must be preserved.",
-    "type": "boolean"
-  },
-  "lastModified": {
-    "description": "Last-modified value carried by the Sessionplan document.",
-    "type": "string"
-  },
-  "startTime": {
-    "description": "Session start time, or null when unknown.",
-    "type": [
-      "string",
-      "null"
-    ]
-  },
-  "targetDuration": {
-    "description": "Target duration of the complete session in minutes.",
-    "minimum": 0,
-    "type": "number"
-  },
-  "title": {
-    "description": "Session title.",
-    "type": "string"
-  }
-}

removedInput schema / properties / session / properties / workshop / required

Removed value: -[
-  "title",
-  "description",
-  "date",
-  "startTime"
-]

removedInput schema / properties / session / properties / workshop / type
```
Removed value: -"object"
```
addedInput schema / properties / session / title
```
Added value: +"Sessionplan document"
```

Changed38 schema fields changedAug 20, 2026
- addedInput schema / $defs / WorkshopItem / properties / blockTypeId / description
```
Added value: +"ID of a declared block type, or null when none applies."
```
- addedInput schema / $defs / WorkshopItem / properties / children / description
```
Added value: +"Nested items belonging to a group or breakout."
```
- addedInput schema / $defs / WorkshopItem / properties / duration / description
```
Added value: +"Item duration in minutes."
```
- addedInput schema / $defs / WorkshopItem / properties / durationLocked / description
```
Added value: +"Whether automatic adjustments must preserve this duration."
```
- addedInput schema / $defs / WorkshopItem / properties / fixedStartTime / description
```
Added value: +"Explicit start time for the item when one is required."
```
- addedInput schema / $defs / WorkshopItem / properties / id / description
```
Added value: +"Stable item identifier, unique within the session."
```
- addedInput schema / $defs / WorkshopItem / properties / laneIndex / description
```
Added value: +"Zero-based breakout lane index for this item."
```
- addedInput schema / $defs / WorkshopItem / properties / lanePersons / description
```
Added value: +"Mapping from lane identifiers to arrays of declared person IDs."
```
- addedInput schema / $defs / WorkshopItem / properties / lanes / description
```
Added value: +"Number of breakout lanes."
```
- addedInput schema / $defs / WorkshopItem / properties / material / description
```
Added value: +"Physical or digital materials required; use an empty string when none are needed."
```
- addedInput schema / $defs / WorkshopItem / properties / notes / description
```
Added value: +"Facilitation instructions, method details, or other notes."
```
- addedInput schema / $defs / WorkshopItem / properties / parallel / description
```
Added value: +"Whether child items or lanes run in parallel."
```
- addedInput schema / $defs / WorkshopItem / properties / personIds / description
```
Added value: +"IDs of declared persons assigned to this item."
```
- addedInput schema / $defs / WorkshopItem / properties / sameInAllBreakouts / description
```
Added value: +"Whether every breakout lane uses the same agenda."
```
- addedInput schema / $defs / WorkshopItem / properties / title / description
```
Added value: +"Concise title shown in the Sessionplan timeline."
```
- addedInput schema / $defs / WorkshopItem / properties / type / description
```
Added value: +"Item kind. Groups and breakouts may contain children."
```
- changedInput schema / properties / session / description
```
Previous value: -"Vollständiges Sessionplan-JSON gemäß der öffentlichen Sessionplan-Import-Spezifikation."New value: +"Complete Sessionplan document. When creating or revising a plan, send the full document defined here; partial updates and patches are not accepted."
```
- addedInput schema / properties / session / properties / blockTypes / description
```
Added value: +"Small set of reusable visual categories referenced by item blockTypeId values."
```
- addedInput schema / properties / session / properties / blockTypes / items / properties / color / description
```
Added value: +"Color value used to display this block type."
```
- addedInput schema / properties / session / properties / blockTypes / items / properties / id / description
```
Added value: +"Stable block-type identifier, unique within the session."
```
- addedInput schema / properties / session / properties / blockTypes / items / properties / name / description
```
Added value: +"Human-readable block-type name."
```
- addedInput schema / properties / session / properties / items / description
```
Added value: +"Ordered top-level timeline items. Durations are expressed in minutes."
```
- addedInput schema / properties / session / properties / persons / description
```
Added value: +"People or roles explicitly supplied for this session."
```
- addedInput schema / properties / session / properties / persons / items / properties / color / description
```
Added value: +"Color value used to display this person or role."
```
- addedInput schema / properties / session / properties / persons / items / properties / id / description
```
Added value: +"Stable person identifier, unique within the session."
```
- addedInput schema / properties / session / properties / persons / items / properties / name / description
```
Added value: +"Person or role name."
```
- addedInput schema / properties / session / properties / version / description
```
Added value: +"Sessionplan document format version."
```
- addedInput schema / properties / session / properties / workshop / description
```
Added value: +"Top-level session metadata."
```
- addedInput schema / properties / session / properties / workshop / properties / date / description
```
Added value: +"Session date, or null when unknown."
```
- addedInput schema / properties / session / properties / workshop / properties / description / description
```
Added value: +"Short description of the session goal or context."
```
- addedInput schema / properties / session / properties / workshop / properties / durationLocked / description
```
Added value: +"Whether the target duration must be preserved."
```
- addedInput schema / properties / session / properties / workshop / properties / lastModified / description
```
Added value: +"Last-modified value carried by the Sessionplan document."
```
- addedInput schema / properties / session / properties / workshop / properties / startTime / description
```
Added value: +"Session start time, or null when unknown."
```
- addedInput schema / properties / session / properties / workshop / properties / targetDuration / description
```
Added value: +"Target duration of the complete session in minutes."
```
- addedInput schema / properties / session / properties / workshop / properties / targetDuration / minimum
```
Added value: +0
```
- addedInput schema / properties / session / properties / workshop / properties / title / description
```
Added value: +"Session title."
```
- changedOutput schema / properties / link / description
```
Previous value: -"Direkt öffnbarer Sessionplan-Link."New value: +"Opaque, directly openable Sessionplan snapshot URL. Present this exact value verbatim; do not reconstruct, normalize, shorten, decode, or modify it."
```
- addedOutput schema / properties / summary
```
Added value: +{
+  "additionalProperties": true,
+  "description": "Optional compact summary of the encoded session.",
+  "properties": {
+    "blockCount": {
+      "description": "Number of agenda blocks.",
+      "minimum": 0,
+      "type": "integer"
+    },
+    "title": {
+      "description": "Session title.",
+      "type": "string"
+    },
+    "totalDuration": {
+      "description": "Total session duration in minutes.",
+      "minimum": 0,
+      "type": "number"
+    }
+  },
+  "type": "object"
+}
```

Changed2 schema fields changedAug 19, 2026

addedInput schema / $defs

Added value: +{
+  "WorkshopItem": {
+    "additionalProperties": false,
+    "properties": {
+      "blockTypeId": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "children": {
+        "items": {
+          "$ref": "#/$defs/WorkshopItem"
+        },
+        "type": "array"
+      },
+      "duration": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "durationLocked": {
+        "type": "boolean"
+      },
+      "fixedStartTime": {
+        "type": "string"
+      },
+      "id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "laneIndex": {
+        "minimum": 0,
+        "type": "integer"
+      },
+      "lanePersons": {
+        "additionalProperties": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "type": "object"
+      },
+      "lanes": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "material": {
+        "type": "string"
+      },
+      "notes": {
+        "type": "string"
+      },
+      "parallel": {
+        "type": "boolean"
+      },
+      "personIds": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "sameInAllBreakouts": {
+        "type": "boolean"
+      },
+      "title": {
+        "type": "string"
+      },
+      "type": {
+        "enum": [
+          "block",
+          "group",
+          "breakout"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "type",
+      "blockTypeId",
+      "title",
+      "duration",
+      "notes",
+      "material"
+    ],
+    "type": "object"
+  }
+}

removedInput schema / properties / session / $defs

Removed value: -{
-  "WorkshopItem": {
-    "$defs": {
-      "WorkshopItem": {
-        "properties": {
-          "blockTypeId": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "children": {
-            "items": {
-              "$ref": "#/$defs/WorkshopItem"
-            },
-            "type": "array"
-          },
-          "duration": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "durationLocked": {
-            "type": "boolean"
-          },
-          "fixedStartTime": {
-            "type": "string"
-          },
-          "id": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "laneIndex": {
-            "minimum": 0,
-            "type": "integer"
-          },
-          "lanePersons": {
-            "additionalProperties": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "type": "object"
-          },
-          "lanes": {
-            "minimum": 1,
-            "type": "integer"
-          },
-          "material": {
-            "type": "string"
-          },
-          "notes": {
-            "type": "string"
-          },
-          "parallel": {
-            "type": "boolean"
-          },
-          "personIds": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "sameInAllBreakouts": {
-            "type": "boolean"
-          },
-          "title": {
-            "type": "string"
-          },
-          "type": {
-            "enum": [
-              "block",
-              "group",
-              "breakout"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "id",
-          "type",
-          "blockTypeId",
-          "title",
-          "duration",
-          "notes",
-          "material"
-        ],
-        "type": "object"
-      }
-    },
-    "properties": {
-      "blockTypeId": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "children": {
-        "items": {
-          "$ref": "#/$defs/WorkshopItem"
-        },
-        "type": "array"
-      },
-      "duration": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "durationLocked": {
-        "type": "boolean"
-      },
-      "fixedStartTime": {
-        "type": "string"
-      },
-      "id": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "laneIndex": {
-        "minimum": 0,
-        "type": "integer"
-      },
-      "lanePersons": {
-        "additionalProperties": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "type": "object"
-      },
-      "lanes": {
-        "minimum": 1,
-        "type": "integer"
-      },
-      "material": {
-        "type": "string"
-      },
-      "notes": {
-        "type": "string"
-      },
-      "parallel": {
-        "type": "boolean"
-      },
-      "personIds": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "sameInAllBreakouts": {
-        "type": "boolean"
-      },
-      "title": {
-        "type": "string"
-      },
-      "type": {
-        "enum": [
-          "block",
-          "group",
-          "breakout"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "id",
-      "type",
-      "blockTypeId",
-      "title",
-      "duration",
-      "notes",
-      "material"
-    ],
-    "type": "object"
-  }
-}

First observedAug 19, 2026

TDQS

A4.1/5.0

Behavior4/5

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

Beyond the annotations, the description adds two important behavioral details: the call requires a complete session object rather than a patch, and the returned link is an opaque snapshot URL that must be presented verbatim. This complements the readOnlyHint and idempotentHint annotations by clarifying the expected input and output handling.

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

Conciseness5/5

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

The description is three efficient sentences with no wasted wording. It front-loads the usage condition, then the strict input requirement, then the output-handling rule.

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 complex nested schema with an output schema, the description covers the key call-level behavior: complete object required and link must be preserved verbatim. The detailed structural constraints are already in the schema, so the description does not need to repeat them. It could mention the snapshot nature more explicitly, but overall it is complete enough.

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?

The schema already documents the single session parameter in detail with 100% coverage, but the description adds meaningful semantics: it must be a complete session object, not a partial update. That constraint is not obvious from the schema alone and helps prevent malformed patch-style calls.

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

Purpose4/5

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

The description states a specific action: producing a new Sessionplan or a revised link after decoding an existing one, and it names the timed-session context. It distinguishes the tool from the decode sibling by framing this as the step after decoding, though it could be more explicit that the output is a shareable link.

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

Usage Guidelines4/5

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

It gives clear usage triggers: the user wants a new Sessionplan or a revised link after decoding. It also states a key constraint that partial updates and patches are not accepted, which helps an agent decide how to call it. It does not explicitly say to use decode_session_link for reading an existing plan, but the context implies the division.

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

All Sessionplan tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.