Skip to content
Docs menu

Tool reference · Team onboarding

New in 14.6.0

onboarding_quiz_set

Creates or replaces a module's quiz with single-choice, multiple-choice and open questions, answer keys and rubrics.

team server /mcp
Caution. A stale expected_revision is rejected. Attempts already submitted keep the snapshot of the questions they answered.

When to use

  • Saving a quiz written by the department head.
  • Saving a reviewed draft from onboarding_quiz_draft.

Parameters

NameTypeDefaultDescription
module_idrequired string — (pattern ^[a-zA-Z0-9_-]{1,64}$)
expected_revisionrequired integer — Quiz revision from onboarding_curriculum_get; 0 when creating. (min 0)
questionsrequired { id, type, prompt, options, correct, points, rubric, lesson_id }[] — —

Example

Arguments

{
  "module_id": "mod_deploy",
  "expected_revision": 0,
  "questions": [
    {
      "type": "single",
      "prompt": "On which days do production deploys run?",
      "options": [
        "Monday and Friday",
        "Tuesday and Thursday",
        "Every day"
      ],
      "correct": [
        1
      ],
      "points": 1,
      "lesson_id": "les_pipeline"
    },
    {
      "type": "open",
      "prompt": "Why do billing changes need two approvals?",
      "rubric": "Billing is high-risk; a second reviewer catches mistakes before customers see them.",
      "points": 2
    }
  ]
}

Result shape

{
  "module_id": "mod_deploy",
  "revision": 1,
  "questions": [
    {
      "id": "q_3f9a1c02de",
      "type": "single",
      "prompt": "On which days do production deploys run?",
      "correct": [
        1
      ],
      "points": 1
    }
  ]
}

Questions without an id get a new one. Open questions need a rubric.

Values are illustrative; the keys follow the server's handler. MCP clients receive the result as JSON text content.

Server description

The description the server sends to your agent in tools/list, captured from the v14.7.0 source:

Department head: create or replace a module quiz (single, multiple or open questions with answer keys/rubrics). Existing attempts keep their snapshot.

Found a mistake? Open an issue on GitHub.

Search