studyloop-webmcp.web.app

{
  "type": "object",
  "properties": {
    "question_id": {
      "type": "string",
      "description": "Card id from get_session_state, e.g. \"q2\"."
    },
    "fields": {
      "type": "object",
      "properties": {
        "prompt": {
          "type": "string",
          "maxLength": 400,
          "description": "The question text shown on the card."
        },
        "options": {
          "type": "array",
          "minItems": 2,
          "maxItems": 6,
          "items": {
            "type": "string",
            "maxLength": 200
          },
          "description": "2–6 answer choices, shown as buttons A/B/C/…"
        },
        "correct_option": {
          "type": "integer",
          "minimum": 0,
          "description": "0-based index into options of the correct answer."
        },
        "explanation": {
          "type": "string",
          "maxLength": 600,
          "description": "Optional. Why the correct answer is correct. Revealed only after the student answers, so it cannot spoil."
        },
        "topic_tag": {
          "type": "string",
          "maxLength": 60,
          "description": "Short sub-topic label (e.g. 'alliances'). Drives the per-topic accuracy bars — reuse the same tag for related questions."
        },
        "difficulty": {
          "type": "string",
          "enum": [
            "easy",
            "medium",
            "hard"
          ],
          "description": "Optional. Defaults to the session difficulty."
        }
      },
      "description": "Only the fields you want to change."
    }
  },
  "required": [
    "question_id",
    "fields"
  ]
}