StudioMeyer Academy

academy_lesson

Read-onlyIdempotent

Read a public lesson using its unambiguous level and slug.

Input Schema

Name	Required	Description	Default
`slug`	Yes
`level`	Yes
`locale`	No	MCP transport locale; not a service input field.	de
`idempotencyKey`	No	Transport retry key, forwarded as Idempotency-Key.

Output Schema

Name	Required	Description	Default
`errors`	Yes
`result`	Yes
`success`	Yes
`messages`	Yes
`request_id`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed11 schema fields changedNov 2, 2026

addedInput schema / $schema

Added value: +"https://json-schema.org/draft/2020-12/schema"

addedInput schema / additionalProperties
```
Added value: +false
```

addedInput schema / properties / idempotencyKey

Added value: +{
+  "description": "Transport retry key, forwarded as Idempotency-Key.",
+  "maxLength": 200,
+  "minLength": 1,
+  "type": "string"
+}

changedInput schema / properties / level / type

Previous value: -"number"New value: +"integer"

addedInput schema / properties / locale / default
```
Added value: +"de"
```

changedInput schema / properties / locale / description

Previous value: -"Language. de=German, en=English, es=Spanish. Default en."New value: +"MCP transport locale; not a service input field."

removedInput schema / properties / slug / description

Removed value: -"Lesson slug, e.g. \"01-was-ist-ai\" (from academy_lessons)"

addedInput schema / properties / slug / maxLength
```
Added value: +180
```
addedInput schema / properties / slug / minLength
```
Added value: +1
```
addedInput schema / properties / slug / pattern
```
Added value: +"^[a-z0-9][a-z0-9_.-]*$"
```

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "oneOf": [
+    {
+      "properties": {
+        "errors": {
+          "maxItems": 0
+        },
+        "result": {
+          "additionalProperties": false,
+          "properties": {
+            "content": {
+              "additionalProperties": false,
+              "properties": {
+                "body": {
+                  "type": "string"
+                },
+                "bodyLocale": {
+                  "type": "string"
+                },
+                "bodyPending": {
+                  "type": "boolean"
+                },
+                "description": {
+                  "type": "string"
+                },
+                "duration": {
+                  "type": "string"
+                },
+                "level": {
+                  "maximum": 9007199254740991,
+                  "minimum": -9007199254740991,
+                  "type": "integer"
+                },
+                "locale": {
+                  "enum": [
+                    "de",
+                    "en",
+                    "es"
+                  ],
+                  "type": "string"
+                },
+                "order": {
+                  "type": "number"
+                },
+                "preview": {
+                  "type": "boolean"
+                },
+                "slug": {
+                  "type": "string"
+                },
+                "title": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "level",
+                "slug",
+                "locale",
+                "title",
+                "order",
+                "body"
+              ],
+              "type": "object"
+            },
+            "content_locale": {
+              "enum": [
+                "de",
+                "en",
+                "es"
+              ],
+              "type": "string"
+            },
+            "fallback": {
+              "type": "boolean"
+            },
+            "id": {
+              "type": "string"
+            },
+            "requestedLocale": {
+              "enum": [
+                "de",
+                "en",
+                "es"
+              ],
+              "type": "string"
+            },
+            "status": {
+              "anyOf": [
+                {
+                  "enum": [
+                    "draft",
+                    "candidate",
+                    "active",
+                    "deprecated"
+                  ],
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "updated": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "version": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "requestedLocale",
+            "content_locale",
+            "fallback",
+            "version",
+            "status",
+            "updated",
+            "content"
+          ],
+          "type": "object"
+        },
+        "success": {
+          "const": true
+        }
+      }
+    },
+    {
+      "properties": {
+        "errors": {
+          "minItems": 1
+        },
+        "result": {
+          "type": "null"
+        },
+        "success": {
+          "const": false
+        }
+      }
+    }
+  ],
+  "properties": {
+    "errors": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "code": {
+            "type": "number"
+          },
+          "documentation_url": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "hint": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "message": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "slug": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "slug",
+          "message",
+          "hint",
+          "documentation_url"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "messages": {
+      "type": "array"
+    },
+    "request_id": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "result": {},
+    "success": {
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "success",
+    "result",
+    "errors",
+    "messages",
+    "request_id"
+  ],
+  "type": "object"
+}

First observedJun 3, 2026

TDQS

B3.1/5.0

Behavior3/5

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

Annotations already declare readOnlyHint=true, idempotentHint=true, openWorldHint=false, and destructiveHint=false, so safety behavior is well covered. The description adds that the lesson is public and that level and slug together identify it unambiguously, but does not describe errors, access restrictions, or other behavioral details.

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 a single front-loaded sentence with no wasted wording. It immediately conveys the operation and the identifier method.

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

Completeness3/5

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

The tool has rich annotations and an output schema, so return values and safety do not need to be described. However, the description is still thin on sibling differentiation and level semantics, which an agent needs in order to select and call the tool confidently.

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

Parameters2/5

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

Schema description coverage is 50%, with slug and level lacking descriptive documentation in the schema. The description mentions both required parameters but adds little meaning beyond the schema constraints, and it does not explain what level values represent or how locale/idempotencyKey behave beyond their existing schema notes.

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

Purpose4/5

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

The description states a clear verb and resource: read a public lesson. It also identifies the key lookup method, level plus slug. It does not explicitly distinguish itself from sibling tools such as academy_lessons or academy_legacy_lessons, so it falls short of a 5.

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

Usage Guidelines2/5

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

The description implies retrieval by level and slug, but gives no explicit guidance on when to use this tool instead of academy_lessons, academy_legacy_lessons, academy_search, or premium-related siblings. The word 'public' hints at scope, but the alternatives and exclusions are left to inference.

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

All StudioMeyer Academy 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.