Skip to content
Docs menu

Tool reference · Team onboarding

New in 14.6.0

onboarding_quiz_draft

Generates draft quiz questions from a module's lessons with the server LLM, keeping only questions that quote a lesson verbatim.

team server /mcp
Caution. Needs an LLM configured on the server; otherwise it fails with "unavailable". The lesson material is sent to that provider. Nothing is saved.

When to use

  • Writing a first quiz for a module and the server has an LLM configured.

Parameters

NameTypeDefaultDescription
module_idrequired string — (pattern ^[a-zA-Z0-9_-]{1,64}$)

Example

Arguments

{
  "module_id": "mod_deploy"
}

Result shape

{
  "module_id": "mod_deploy",
  "current_revision": 0,
  "questions": [
    {
      "type": "single",
      "prompt": "When do production deploys run?",
      "options": [
        "Tuesdays and Thursdays after 14:00",
        "Any weekday morning"
      ],
      "correct": [
        0
      ],
      "points": 1,
      "lesson_id": "les_pipeline"
    }
  ],
  "evidence": [
    {
      "lesson_id": "les_pipeline",
      "quote": "run on Tuesdays and Thursdays"
    }
  ],
  "rejected": [],
  "message": "Draft only. Review, then save with onboarding_quiz_set (questions=questions, expected_revision=current_revision)."
}

Questions without a verbatim quote of at least three words from a lesson are listed under rejected.

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: generate draft quiz questions from the module's lessons with the server LLM; each is checked against a lesson quote. Not saved. Without an LLM, author questions via onboarding_quiz_set.

Found a mistake? Open an issue on GitHub.

Search