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.

Input Schema

TableJSON 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

TableJSON 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.

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.6/5.0

Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint, so the safety profile is covered. The description adds valuable behavioral context: the output link is 'an opaque snapshot URL and must be presented verbatim,' and partial updates are rejected. These are meaningful operational details beyond what annotations provide, though it could also mention error behavior or idempotency, which are already annotated.

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 two sentences with zero filler. The first sentence front-loads the use case, and the second packs two essential operational constraints (complete object required, opaque link verbatim). Every word earns its place.

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?

Given the tool's complex nested schema and the presence of an output schema, the description adequately covers the key contextual points: when to use, the completeness requirement, and how to handle the output link. It does not explain the full session format, but that is extensively documented in the input schema. No critical piece for correctly invoking the tool is missing.

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 single 'session' parameter is fully documented in the schema with detailed descriptions for all nested fields (100% coverage). The description adds a crucial semantic: the session object must be complete, not a patch or partial update. This prevents the agent from sending incomplete objects, which is not fully conveyed by the schema's required fields alone. The description's reference to 'matching inputSchema' also reinforces correctness.

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?

The description states exactly when to use the tool: 'when the user wants a new Sessionplan... or a revised link after decoding an existing Sessionplan.' It clearly identifies the resource (Sessionplan/link) and the action (create). The distinction from the sibling decode_session_link is implied: decoding is the inverse operation, while this tool creates a link.

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?

The description explicitly specifies the trigger conditions ('when the user wants a new Sessionplan...' and 'or a revised link after decoding...'), and provides a critical usage constraint: 'Pass a complete session object matching inputSchema; partial updates and patches are not accepted.' This tells the agent exactly when and how to invoke the tool, leaving no ambiguity.

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

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.