Sessionplan

Open Sessionplan

decode_session_link

Read-onlyIdempotent

Use this whenever the user provides a Sessionplan URL, URL hash, or v2 snapshot code and wants it read, summarized, reviewed, validated, or changed. The validated structuredContent.session is the source of truth. For changes, modify the complete decoded session and pass it to create_session_link; the existing snapshot is not modified in place.

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": {
      "link": "<link>"
    },
    "name": "decode_session_link"
  }
}

Input Schema

Name	Required	Description	Default
`link`	Yes	Unmodified Sessionplan URL, URL hash, or v2 snapshot code supplied by the user.

Output Schema

Name	Required	Description	Default
`session`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedNov 4, 2026

addedOutput schema / $defs / day

Added value: +{
+  "additionalProperties": true,
+  "properties": {
+    "date": {
+      "if": {
+        "not": {
+          "const": ""
+        }
+      },
+      "then": {
+        "format": "date",
+        "pattern": "^(?!0000)[0-9]{4}-[0-9]{2}-[0-9]{2}$(?![\\s\\S])"
+      },
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "description": {
+      "type": "string"
+    },
+    "durationLocked": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "id": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "items": {
+      "items": {
+        "$ref": "#/$defs/item"
+      },
+      "maxItems": 500,
+      "type": "array"
+    },
+    "startTime": {
+      "pattern": "^(([01][0-9]|2[0-3]):[0-5][0-9])?$(?![\\s\\S])",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "targetDuration": {
+      "minimum": 0,
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "title": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "id"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / session / properties / days

Added value: +{
+  "items": {
+    "$ref": "#/$defs/day"
+  },
+  "maxItems": 14,
+  "type": "array"
+}

Changed24 schema fields changedSep 15, 2026

changedOutput schema / $defs / blockType / additionalProperties
```
Previous value: -falseNew value: +true
```
addedOutput schema / $defs / blockType / properties / id / minLength
```
Added value: +1
```

changedOutput schema / $defs / blockType / required

Previous value: -[
-  "id",
-  "name",
-  "color"
-]New value: +[
+  "id",
+  "name"
+]

changedOutput schema / $defs / item / additionalProperties
```
Previous value: -falseNew value: +true
```

addedOutput schema / $defs / item / allOf

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

addedOutput schema / $defs / item / properties / fixedStartTime / pattern
```
Added value: +"^(([01][0-9]|2[0-3]):[0-5][0-9])?$(?![\\s\\S])"
```
changedOutput schema / $defs / item / properties / fixedStartTime / type
```
Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
```
addedOutput schema / $defs / item / properties / lanePersons / propertyNames
```
Added value: +{
+  "pattern": "^(0|[1-9][0-9]*)$(?![\\s\\S])"
+}
```
addedOutput schema / $defs / item / properties / lanes / maximum
```
Added value: +10
```

changedOutput schema / $defs / item / required

Previous value: -[
-  "id",
-  "type",
-  "blockTypeId",
-  "title",
-  "duration",
-  "notes",
-  "material"
-]New value: +[
+  "id",
+  "type",
+  "title",
+  "duration"
+]

changedOutput schema / $defs / person / additionalProperties
```
Previous value: -falseNew value: +true
```
addedOutput schema / $defs / person / properties / id / minLength
```
Added value: +1
```

changedOutput schema / $defs / person / required

Previous value: -[
-  "id",
-  "name",
-  "color"
-]New value: +[
+  "id",
+  "name"
+]

changedOutput schema / $defs / workshop / additionalProperties
```
Previous value: -falseNew value: +true
```
addedOutput schema / $defs / workshop / properties / date / if
```
Added value: +{
+  "not": {
+    "const": ""
+  }
+}
```

addedOutput schema / $defs / workshop / properties / date / then

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

changedOutput schema / $defs / workshop / properties / durationLocked / type
```
Previous value: -"boolean"New value: +[
+  "boolean",
+  "null"
+]
```
addedOutput schema / $defs / workshop / properties / lastModified / format
```
Added value: +"date-time"
```

addedOutput 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])"

addedOutput schema / $defs / workshop / properties / startTime / pattern
```
Added value: +"^(([01][0-9]|2[0-3]):[0-5][0-9])?$(?![\\s\\S])"
```
changedOutput schema / $defs / workshop / properties / targetDuration / type
```
Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
```

changedOutput schema / $defs / workshop / required

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

changedOutput schema / properties / session / additionalProperties
```
Previous value: -falseNew value: +true
```

changedOutput schema / properties / session / required

Previous value: -[
-  "version",
-  "workshop",
-  "blockTypes",
-  "persons",
-  "items"
-]New value: +[
+  "workshop",
+  "items"
+]

Changed28 schema fields changedSep 2, 2026

removedOutput 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"
-}

addedOutput schema / $defs / blockType

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

addedOutput 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"
+}

addedOutput schema / $defs / person

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

addedOutput 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"
+}

removedOutput 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."

removedOutput schema / properties / session / properties / blockTypes / description

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

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

removedOutput 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"
-  }
-}

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

removedOutput schema / properties / session / properties / items / description

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

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

removedOutput 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"
-  }
-}

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

removedOutput 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"
-  }
-}

removedOutput schema / properties / session / properties / workshop / required

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

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

Changed38 schema fields changedAug 20, 2026
- changedInput schema / properties / link / description
```
Previous value: -"Vollständige Sessionplan-URL, Hash oder v2-Snapshot-Code."New value: +"Unmodified Sessionplan URL, URL hash, or v2 snapshot code supplied by the user."
```
- addedInput schema / properties / link / minLength
```
Added value: +1
```
- addedOutput schema / $defs / WorkshopItem / properties / blockTypeId / description
```
Added value: +"ID of a declared block type, or null when none applies."
```
- addedOutput schema / $defs / WorkshopItem / properties / children / description
```
Added value: +"Nested items belonging to a group or breakout."
```
- addedOutput schema / $defs / WorkshopItem / properties / duration / description
```
Added value: +"Item duration in minutes."
```
- addedOutput schema / $defs / WorkshopItem / properties / durationLocked / description
```
Added value: +"Whether automatic adjustments must preserve this duration."
```
- addedOutput schema / $defs / WorkshopItem / properties / fixedStartTime / description
```
Added value: +"Explicit start time for the item when one is required."
```
- addedOutput schema / $defs / WorkshopItem / properties / id / description
```
Added value: +"Stable item identifier, unique within the session."
```
- addedOutput schema / $defs / WorkshopItem / properties / laneIndex / description
```
Added value: +"Zero-based breakout lane index for this item."
```
- addedOutput schema / $defs / WorkshopItem / properties / lanePersons / description
```
Added value: +"Mapping from lane identifiers to arrays of declared person IDs."
```
- addedOutput schema / $defs / WorkshopItem / properties / lanes / description
```
Added value: +"Number of breakout lanes."
```
- addedOutput schema / $defs / WorkshopItem / properties / material / description
```
Added value: +"Physical or digital materials required; use an empty string when none are needed."
```
- addedOutput schema / $defs / WorkshopItem / properties / notes / description
```
Added value: +"Facilitation instructions, method details, or other notes."
```
- addedOutput schema / $defs / WorkshopItem / properties / parallel / description
```
Added value: +"Whether child items or lanes run in parallel."
```
- addedOutput schema / $defs / WorkshopItem / properties / personIds / description
```
Added value: +"IDs of declared persons assigned to this item."
```
- addedOutput schema / $defs / WorkshopItem / properties / sameInAllBreakouts / description
```
Added value: +"Whether every breakout lane uses the same agenda."
```
- addedOutput schema / $defs / WorkshopItem / properties / title / description
```
Added value: +"Concise title shown in the Sessionplan timeline."
```
- addedOutput schema / $defs / WorkshopItem / properties / type / description
```
Added value: +"Item kind. Groups and breakouts may contain children."
```
- changedOutput 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."
```
- addedOutput schema / properties / session / properties / blockTypes / description
```
Added value: +"Small set of reusable visual categories referenced by item blockTypeId values."
```
- addedOutput schema / properties / session / properties / blockTypes / items / properties / color / description
```
Added value: +"Color value used to display this block type."
```
- addedOutput schema / properties / session / properties / blockTypes / items / properties / id / description
```
Added value: +"Stable block-type identifier, unique within the session."
```
- addedOutput schema / properties / session / properties / blockTypes / items / properties / name / description
```
Added value: +"Human-readable block-type name."
```
- addedOutput schema / properties / session / properties / items / description
```
Added value: +"Ordered top-level timeline items. Durations are expressed in minutes."
```
- addedOutput schema / properties / session / properties / persons / description
```
Added value: +"People or roles explicitly supplied for this session."
```
- addedOutput schema / properties / session / properties / persons / items / properties / color / description
```
Added value: +"Color value used to display this person or role."
```
- addedOutput schema / properties / session / properties / persons / items / properties / id / description
```
Added value: +"Stable person identifier, unique within the session."
```
- addedOutput schema / properties / session / properties / persons / items / properties / name / description
```
Added value: +"Person or role name."
```
- addedOutput schema / properties / session / properties / version / description
```
Added value: +"Sessionplan document format version."
```
- addedOutput schema / properties / session / properties / workshop / description
```
Added value: +"Top-level session metadata."
```
- addedOutput schema / properties / session / properties / workshop / properties / date / description
```
Added value: +"Session date, or null when unknown."
```
- addedOutput schema / properties / session / properties / workshop / properties / description / description
```
Added value: +"Short description of the session goal or context."
```
- addedOutput schema / properties / session / properties / workshop / properties / durationLocked / description
```
Added value: +"Whether the target duration must be preserved."
```
- addedOutput schema / properties / session / properties / workshop / properties / lastModified / description
```
Added value: +"Last-modified value carried by the Sessionplan document."
```
- addedOutput schema / properties / session / properties / workshop / properties / startTime / description
```
Added value: +"Session start time, or null when unknown."
```
- addedOutput schema / properties / session / properties / workshop / properties / targetDuration / description
```
Added value: +"Target duration of the complete session in minutes."
```
- addedOutput schema / properties / session / properties / workshop / properties / targetDuration / minimum
```
Added value: +0
```
- addedOutput schema / properties / session / properties / workshop / properties / title / description
```
Added value: +"Session title."
```

Changed2 schema fields changedAug 19, 2026

addedOutput 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"
+  }
+}

removedOutput 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?

Annotations already cover readOnly, idempotent, non-destructive, and closed-world behavior, so the bar is lower; the description still adds real value by designating structuredContent.session as the authoritative result and explaining that edits are round-tripped through create_session_link rather than applied in place. It does not describe invalid-link/validation-failure behavior, which is the one remaining behavioral gap.

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?

Three sentences, front-loaded with the invocation trigger, then the result-of-record, then the mutation routing. The five-verb list ('read, summarized, reviewed, validated, or changed') is slightly padded, and 'changed' sits awkwardly in a read-only tool until the next sentence resolves it.

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 single-parameter decode tool with a full-coverage schema, an output schema, and rich annotations, the description covers invocation, result interpretation, and the mutation hand-off. What is missing is failure handling for malformed links and any hint about the shape or size of the decoded session beyond naming it.

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

Parameters3/5

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

Schema description coverage is 100% and the single parameter is already documented as an unmodified URL, URL hash, or v2 snapshot code. The description restates the same accepted input forms without adding format details, examples, or constraints, so the baseline 3 applies.

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 implies the core action through 'decoded session' and 'the validated structuredContent.session is the source of truth', and it clearly separates this tool from create_session_link. However, it never states the decode/parse operation outright as a verb+resource sentence; the opening sentence describes user intents ('read, summarized, reviewed, validated, or changed') rather than what the tool does, leaving the purpose to be inferred.

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?

It gives an explicit trigger ('whenever the user provides a Sessionplan URL, URL hash, or v2 snapshot code'), names the alternative for mutation work (create_session_link), and states the condition that selects it ('For changes, modify the complete decoded session and pass it to create_session_link'). The 'existing snapshot is not modified in place' clause heads off the main wrong-turn an agent could take.

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.