Skip to main content
Glama
EduBase

EduBase MCP Server

Official
by EduBase
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

edubase_get_quiz_grading_presets

Read-onlyIdempotent

List the grading presets available for a user, including global, custom, and organization presets. Filter by exam or Quiz set to view applicable presets and the one currently in use.

Instructions

List the grading presets available for the user. The global presets, the owned custom presets and the presets of the organizations of the user are returned. A Quiz set or an exam can be specified to list only the presets that can be used on it, together with the one it is currently using.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
examNoexam identification string, only the presets that can be used on this exam are listed, either the quiz or the exam can be specified, not both of them
quizNoQuiz identification string, only the presets that can be used on this Quiz set are listed
languageNooptional language to filter the results with, presets that are not bound to a language are always included (default: the language of the specified Quiz set or exam)

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
examNo
quizNo
presetsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed11 schema fields changedv2.0.0
    • removedOutput schema / properties / exam / description
      Removed value: -"exam identification string (only present if an exam is specified)"
    • removedOutput schema / properties / presets / items / properties / certificates / description
      Removed value: -"the preset decides whether the test was successful, so certificates can be issued with it (see edubase_post_exam_certificates)"
    • removedOutput schema / properties / presets / items / properties / configurable / description
      Removed value: -"the threshold of the preset can be configured on the Quiz set or the exam"
    • removedOutput schema / properties / presets / items / properties / current / description
      Removed value: -"the specified Quiz set or exam is currently graded with this preset (only present if a Quiz set or an exam is specified)"
    • removedOutput schema / properties / presets / items / properties / language / description
      Removed value: -"language of the grading preset, null if the preset is available in every language"
    • removedOutput schema / properties / presets / items / properties / organization / description
      Removed value: -"organization identification string of the preset, null if the preset is not bound to an organization"
    • removedOutput schema / properties / presets / items / properties / own / description
      Removed value: -"the preset is a custom preset owned by the user"
    • removedOutput schema / properties / presets / items / properties / preset / description
      Removed value: -"grading preset identification string"
    • removedOutput schema / properties / presets / items / properties / title / description
      Removed value: -"title of the grading preset"
    • removedOutput schema / properties / presets / items / properties / type / description
      Removed value: -"type of the grading preset"
    • removedOutput schema / properties / quiz / description
      Removed value: -"Quiz identification string (only present if a Quiz set is specified)"
  2. Changed9 schema fields changedv1.2.16
    • addedInput schema / properties / exam
      Added value: +{
+  "description": "exam identification string, only the presets that can be used on this exam are listed, either the quiz or the exam can be specified, not both of them",
+  "type": "string"
+}
    • changedInput schema / properties / language / description
      Previous value: -"optional language to filter the results with, presets that are not bound to a language are always included"New value: +"optional language to filter the results with, presets that are not bound to a language are always included (default: the language of the specified Quiz set or exam)"
    • addedInput schema / properties / quiz
      Added value: +{
+  "description": "Quiz identification string, only the presets that can be used on this Quiz set are listed",
+  "type": "string"
+}
    • addedOutput schema / properties / exam
      Added value: +{
+  "description": "exam identification string (only present if an exam is specified)",
+  "type": "string"
+}
    • addedOutput schema / properties / presets / items / properties / certificates
      Added value: +{
+  "description": "the preset decides whether the test was successful, so certificates can be issued with it (see edubase_post_exam_certificates)",
+  "type": "boolean"
+}
    • addedOutput schema / properties / presets / items / properties / current
      Added value: +{
+  "description": "the specified Quiz set or exam is currently graded with this preset (only present if a Quiz set or an exam is specified)",
+  "type": "boolean"
+}
    • addedOutput schema / properties / presets / items / properties / organization
      Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "organization identification string of the preset, null if the preset is not bound to an organization"
+}
    • changedOutput schema / properties / presets / items / required
      Previous value: -[
-  "preset",
-  "title",
-  "type",
-  "language",
-  "configurable",
-  "own"
-]New value: +[
+  "preset",
+  "title",
+  "type",
+  "language",
+  "configurable",
+  "certificates",
+  "own",
+  "organization"
+]
    • addedOutput schema / properties / quiz
      Added value: +{
+  "description": "Quiz identification string (only present if a Quiz set is specified)",
+  "type": "string"
+}
  3. Addedv1.2.15

TDQS

A4.2/5.0
Behavior4/5

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

Annotations already establish read-only, idempotent, and non-destructive behavior. The description adds meaningful behavioral detail: it specifies the preset sources returned (global, owned, organizational) and the 'currently using' inclusion behavior when an exam or quiz is specified. This goes beyond what the annotations alone convey, though it omits minor details like pagination.

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 sentences with no unnecessary content: the first states the primary action and scope, the second explains the optional filtering behavior. The main purpose is front-loaded and every clause contributes useful information.

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?

With annotations covering the safety profile and an output schema present, the description covers the decision-relevant behavior: what preset categories are returned and how quiz/exam filtering modifies the response. No critical information needed to call the tool correctly is missing.

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?

Input schema coverage is 100%, and each parameter already has a descriptive schema entry explaining exam, quiz, and language semantics. The tool description reinforces the filtering concept but adds no parameter syntax or default-value details beyond what the schema already documents, so the 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 opens with a specific verb and resource, 'List the grading presets available for the user', and then defines the exact scope: global presets, owned custom presets, and organizational presets. The optional quiz/exam filtering further clarifies the operation, and the plural 'presets' distinguishes it from the singular sibling get_quiz_grading_preset.

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

Usage Guidelines4/5

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

It clearly states when the optional quiz and exam parameters are useful and notes that the currently used preset is included. It does not explicitly name get_quiz_grading_preset as the single-preset alternative, but the list-versus-get context and sibling names make the routing reasonably clear.

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

Deploy Server

Other Tools