Sessionplan

Open Sessionplan

decode_session_link

Read-only

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.

Input Schema

TableJSON Schema

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

Output Schema

TableJSON Schema

Name	Required	Description	Default
`session`	Yes

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

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

Behavior4/5

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

Annotations already declare readOnlyHint=true and destructiveHint=false, and the description reinforces this by stating the existing snapshot is not modified in place. It adds useful context beyond annotations: the decoded output is validated and structuredContent.session is authoritative. This helps agents understand the tool's non-mutating behavior and its role in a change workflow.

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?

Two compact sentences carry all essential information: when to use, what the output represents, and how to handle changes. The description is front-loaded with the trigger condition and avoids redundant or tangential details.

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

Completeness5/5

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

For a single-parameter tool with an output schema and helpful annotations, the description covers usage context, the change workflow, and the sibling tool relationship. Nothing critical is missing for an agent to select and invoke this tool correctly.

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?

The schema already describes the link parameter thoroughly with its accepted forms and the requirement that it be unmodified. The description adds little new parameter-level meaning; it mainly restates the input forms in the usage context. With 100% schema coverage, a baseline of 3 is appropriate.

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 clearly identifies the tool's purpose: decoding Sessionplan URLs, URL hashes, or v2 snapshot codes for reading, summarizing, reviewing, validating, or changing. It explicitly names the validated structuredContent.session as the source of truth, which distinguishes it from the sibling create_session_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 states exactly when to use this tool ('whenever the user provides a Sessionplan URL, URL hash, or v2 snapshot code') and how it differs from the alternative: for changes, modify the decoded session and pass it to create_session_link. It also clarifies that the existing snapshot is not modified in place, preventing misuse.

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

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4.7/5.0

Disambiguation5/5

The two tools have clearly distinct roles: one creates a new Sessionplan link from a complete session object, the other decodes an existing link back into a session. Although revision is achieved by decode-then-create, each tool's purpose is unambiguous.

Naming Consistency5/5

Both tool names follow the same verb_noun snake_case pattern: create_session_link and decode_session_link. This is perfectly consistent and predictable.

Tool Count4/5

Only two tools exist, which is slightly below the typical 3-15 range, but the domain is narrowly scoped around encoding and decoding opaque Sessionplan links. Each tool earns its place and the count does not feel wasteful or incomplete.

Completeness5/5

The surface covers the full lifecycle implied by the domain: create a new session link, decode an existing link for reading or validation, and revise by decoding, modifying, and creating a new link. No obvious operations are missing given the opaque snapshot URL model.

Open Sessionplan

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

TDQS

Resources