Fiveable for AP Teachers

Create assignment draft

create_assignment_draft

Builds an assignment draft from multiple-choice questions picked by question-bank mcq: id and/or drawn from units and topics (skipping already assigned questions), Fiveable FRQ or SAQ ids, readings with optional checks, or a diagnostic. Settings start from the first class's defaults. AP Calculus drafts require courseVariant or target classes sharing one course. Returns the draft id and review link. Drafts never use an included assignment slot.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "title": "<title>",
      "subjectSlug": "<subjectSlug>",
      "sections": "<sections>",
      "requestId": "<requestId>"
    },
    "name": "create_assignment_draft"
  }
}

Input Schema

Name	Required	Description
`dueAt`	No	Default due time for every class.
`title`	Yes
`classes`	No	Classes to target, each with an optional due date.
`sections`	Yes
`settings`	No
`requestId`	Yes	A unique id you generate for this action. Reuse it only when retrying the same action.
`availableAt`	No	When it opens, ISO with offset.
`subjectSlug`	Yes	Subject, e.g. apush or ap-bio.
`instructions`	No
`courseVariant`	No	AP Calculus only: ap-calc-ab or ap-calc-bc. Omit to use the course the target classes share.
`resultRelease`	No	When students see results.

Output Schema

Name	Required	Description	Default
`text`	No	Readable tool result text for clients that consume structured output.
`status`	Yes	Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedNov 2, 2026

changedInput schema / properties / sections / items / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "avoidRepeats": {
-        "default": true,
-        "description": "When drawing from units, skip questions this teacher already published.",
-        "type": "boolean"
-      },
-      "questionCount": {
-        "description": "Questions to draw from units, on top of any questionIds. Omit when only using questionIds.",
-        "maximum": 100,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "questionIds": {
-        "description": "Specific questions to include, as mcq: ids from search_question_bank. They come first, exactly as picked; questions drawn from units never repeat them. Omit units to use only these.",
-        "items": {
-          "pattern": "^(mcq:)?[\\w-]+$",
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array"
-      },
-      "skillId": {
-        "anyOf": [
-          {
-            "maxLength": 200,
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional CED skill id to narrow to."
-      },
-      "style": {
-        "default": "exam",
-        "description": "exam = AP-style (with stimulus sets where the exam has them); comprehension or vocabulary checks.",
-        "enum": [
-          "exam",
-          "comprehension",
-          "vocabulary"
-        ],
-        "type": "string"
-      },
-      "timeLimitMinutes": {
-        "anyOf": [
-          {
-            "maximum": 300,
-            "minimum": 1,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Omit for untimed."
-      },
-      "type": {
-        "const": "multiple_choice",
-        "type": "string"
-      },
-      "units": {
-        "description": "Units to draw questions from. Omit when only using questionIds.",
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "questionCount": {
-              "description": "Omit to split the total evenly.",
-              "maximum": 100,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "topicIds": {
-              "description": "Topic ids to narrow to.",
-              "items": {
-                "maxLength": 200,
-                "minLength": 1,
-                "type": "string"
-              },
-              "maxItems": 60,
-              "type": "array"
-            },
-            "unitId": {
-              "anyOf": [
-                {
-                  "maxLength": 200,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Unit id from get_subject_outline; null = whole course."
-            }
-          },
-          "required": [
-            "unitId"
-          ],
-          "type": "object"
-        },
-        "maxItems": 20,
-        "type": "array"
-      }
-    },
-    "required": [
-      "type",
-      "style",
-      "avoidRepeats"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "focus": {
-        "const": "introduction",
-        "description": "AP World, APUSH or AP Euro DBQ or LEQ only: students write just the introduction (contextualization and a thesis), scored on the AP rubric's Thesis/Claim and Contextualization points (2 points). Omit for the whole essay. Can't be combined with parts.",
-        "type": "string"
-      },
-      "parts": {
-        "description": "Part letters students answer (e.g. [\"A\", \"B\"]), scored on those parts' AP rubric points. Omit for the whole question. Questions scored as a whole (essays, AP Stats, world languages) can't be split.",
-        "items": {
-          "pattern": "^[A-Za-z]$",
-          "type": "string"
-        },
-        "maxItems": 12,
-        "minItems": 1,
-        "type": "array"
-      },
-      "questionId": {
-        "description": "An frq: or saq: id from search_question_bank.",
-        "pattern": "^frq:[\\w-]+$|^saq:[\\w-]+(:[A-Za-z])?$",
-        "type": "string"
-      },
-      "type": {
-        "const": "free_response",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "questionId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "readingQuestions": {
-        "default": false,
-        "description": "Add reading-check questions (study guides and AMSCO guided notes).",
-        "type": "boolean"
-      },
-      "resourceId": {
-        "description": "A resource id from list_teaching_resources.",
-        "maxLength": 300,
-        "minLength": 1,
-        "type": "string"
-      },
-      "type": {
-        "const": "reading",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "resourceId",
-      "readingQuestions"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "type": {
-        "const": "diagnostic",
-        "type": "string"
-      },
-      "unitIds": {
-        "description": "Unit ids from get_subject_outline.",
-        "items": {
-          "maxLength": 200,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 15,
-        "minItems": 1,
-        "type": "array"
-      },
-      "unitLabels": {
-        "items": {
-          "maxLength": 200,
-          "type": "string"
-        },
-        "maxItems": 15,
-        "type": "array"
-      }
-    },
-    "required": [
-      "type",
-      "unitIds"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "avoidRepeats": {
+        "default": true,
+        "description": "When drawing from units, skip questions this teacher already published.",
+        "type": "boolean"
+      },
+      "questionCount": {
+        "description": "Questions to draw from units, on top of any questionIds. Omit when only using questionIds.",
+        "maximum": 100,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "questionIds": {
+        "description": "Specific questions to include, as mcq: ids from search_question_bank. They come first, exactly as picked; questions drawn from units never repeat them. Omit units to use only these.",
+        "items": {
+          "pattern": "^(mcq:)?[\\w-]+$",
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array"
+      },
+      "skillId": {
+        "anyOf": [
+          {
+            "maxLength": 200,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional CED skill id to narrow to."
+      },
+      "style": {
+        "default": "exam",
+        "description": "exam = AP-style (with stimulus sets where the exam has them); comprehension or vocabulary checks.",
+        "enum": [
+          "exam",
+          "comprehension",
+          "vocabulary"
+        ],
+        "type": "string"
+      },
+      "timeLimitMinutes": {
+        "anyOf": [
+          {
+            "maximum": 300,
+            "minimum": 1,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Omit for untimed."
+      },
+      "type": {
+        "const": "multiple_choice",
+        "type": "string"
+      },
+      "units": {
+        "description": "Units to draw questions from. Omit when only using questionIds.",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "questionCount": {
+              "description": "Omit to split the total evenly.",
+              "maximum": 100,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "topicIds": {
+              "description": "Topic ids to narrow to.",
+              "items": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              },
+              "maxItems": 60,
+              "type": "array"
+            },
+            "unitId": {
+              "anyOf": [
+                {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Unit id from get_subject_outline; null = whole course."
+            }
+          },
+          "required": [
+            "unitId"
+          ],
+          "type": "object"
+        },
+        "maxItems": 20,
+        "type": "array"
+      }
+    },
+    "required": [
+      "type",
+      "style",
+      "avoidRepeats"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "focus": {
+        "const": "introduction",
+        "description": "AP World, APUSH or AP Euro DBQ or LEQ only: students write just the introduction (contextualization and a thesis), scored on the AP rubric's Thesis/Claim and Contextualization points (2 points). Omit for the whole essay. Can't be combined with parts or rubricPoints.",
+        "type": "string"
+      },
+      "parts": {
+        "description": "Part letters students answer (e.g. [\"A\", \"B\"]), scored on those parts' AP rubric points. Omit for the whole question. Questions scored as a whole (essays, AP Stats, world languages) can't be split.",
+        "items": {
+          "pattern": "^[A-Za-z]$",
+          "type": "string"
+        },
+        "maxItems": 12,
+        "minItems": 1,
+        "type": "array"
+      },
+      "questionId": {
+        "description": "An frq: or saq: id from search_question_bank.",
+        "pattern": "^frq:[\\w-]+$|^saq:[\\w-]+(:[A-Za-z])?$",
+        "type": "string"
+      },
+      "rubricPoints": {
+        "description": "AP World, APUSH or AP Euro DBQ or LEQ only: the one-point AP rubric rows students write for, scored on only those points. DBQ rows: A Thesis/Claim, B Contextualization, C1 Evidence from the Documents (2 documents), C2 Evidence Supports Argument (4 documents), C3 Evidence Beyond the Documents, D1 Sourcing (2 documents), D2 Complexity. LEQ rows: A, B, C1 Evidence, C2 Evidence Supports Argument, D1 Historical Reasoning, D2 Complexity. E.g. a two-paragraph DBQ: [\"A\", \"B\", \"C1\", \"C3\"]. The total is the number of points chosen. Can't be combined with parts or focus.",
+        "items": {
+          "pattern": "^[A-Da-d][1-3]?$",
+          "type": "string"
+        },
+        "maxItems": 7,
+        "minItems": 1,
+        "type": "array"
+      },
+      "type": {
+        "const": "free_response",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "questionId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "readingQuestions": {
+        "default": false,
+        "description": "Add reading-check questions (study guides and AMSCO guided notes).",
+        "type": "boolean"
+      },
+      "resourceId": {
+        "description": "A resource id from list_teaching_resources.",
+        "maxLength": 300,
+        "minLength": 1,
+        "type": "string"
+      },
+      "type": {
+        "const": "reading",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "resourceId",
+      "readingQuestions"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "type": {
+        "const": "diagnostic",
+        "type": "string"
+      },
+      "unitIds": {
+        "description": "Unit ids from get_subject_outline.",
+        "items": {
+          "maxLength": 200,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 15,
+        "minItems": 1,
+        "type": "array"
+      },
+      "unitLabels": {
+        "items": {
+          "maxLength": 200,
+          "type": "string"
+        },
+        "maxItems": 15,
+        "type": "array"
+      }
+    },
+    "required": [
+      "type",
+      "unitIds"
+    ],
+    "type": "object"
+  }
+]

Changed3 schema fields changedOct 27, 2026

changedInput schema / properties / availableAt / pattern

Previous value: -"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"New value: +"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"

changedInput schema / properties / classes / items / properties / dueAt / pattern

Previous value: -"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"New value: +"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"

changedInput schema / properties / dueAt / pattern

Previous value: -"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"New value: +"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"

Changed1 schema field changedOct 19, 2026

changedInput schema / properties / sections / items / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "avoidRepeats": {
-        "default": true,
-        "description": "When drawing from units, skip questions this teacher already published.",
-        "type": "boolean"
-      },
-      "questionCount": {
-        "description": "Questions to draw from units, on top of any questionIds. Omit when only using questionIds.",
-        "maximum": 100,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "questionIds": {
-        "description": "Specific questions to include, as mcq: ids from search_question_bank. They come first, exactly as picked; questions drawn from units never repeat them. Omit units to use only these.",
-        "items": {
-          "pattern": "^(mcq:)?[\\w-]+$",
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array"
-      },
-      "skillId": {
-        "anyOf": [
-          {
-            "maxLength": 200,
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional CED skill id to narrow to."
-      },
-      "style": {
-        "default": "exam",
-        "description": "exam = AP-style (with stimulus sets where the exam has them); comprehension or vocabulary checks.",
-        "enum": [
-          "exam",
-          "comprehension",
-          "vocabulary"
-        ],
-        "type": "string"
-      },
-      "timeLimitMinutes": {
-        "anyOf": [
-          {
-            "maximum": 300,
-            "minimum": 1,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Omit for untimed."
-      },
-      "type": {
-        "const": "multiple_choice",
-        "type": "string"
-      },
-      "units": {
-        "description": "Units to draw questions from. Omit when only using questionIds.",
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "questionCount": {
-              "description": "Omit to split the total evenly.",
-              "maximum": 100,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "topicIds": {
-              "description": "Topic ids to narrow to.",
-              "items": {
-                "maxLength": 200,
-                "minLength": 1,
-                "type": "string"
-              },
-              "maxItems": 60,
-              "type": "array"
-            },
-            "unitId": {
-              "anyOf": [
-                {
-                  "maxLength": 200,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Unit id from get_subject_outline; null = whole course."
-            }
-          },
-          "required": [
-            "unitId"
-          ],
-          "type": "object"
-        },
-        "maxItems": 20,
-        "type": "array"
-      }
-    },
-    "required": [
-      "type",
-      "style",
-      "avoidRepeats"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "parts": {
-        "description": "Part letters students answer (e.g. [\"A\", \"B\"]), scored on those parts' AP rubric points. Omit for the whole question. Questions scored as a whole (essays, AP Stats, world languages) can't be split.",
-        "items": {
-          "pattern": "^[A-Za-z]$",
-          "type": "string"
-        },
-        "maxItems": 12,
-        "minItems": 1,
-        "type": "array"
-      },
-      "questionId": {
-        "description": "An frq: or saq: id from search_question_bank.",
-        "pattern": "^frq:[\\w-]+$|^saq:[\\w-]+(:[A-Za-z])?$",
-        "type": "string"
-      },
-      "type": {
-        "const": "free_response",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "questionId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "readingQuestions": {
-        "default": false,
-        "description": "Add reading-check questions (study guides and AMSCO guided notes).",
-        "type": "boolean"
-      },
-      "resourceId": {
-        "description": "A resource id from list_teaching_resources.",
-        "maxLength": 300,
-        "minLength": 1,
-        "type": "string"
-      },
-      "type": {
-        "const": "reading",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "resourceId",
-      "readingQuestions"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "type": {
-        "const": "diagnostic",
-        "type": "string"
-      },
-      "unitIds": {
-        "description": "Unit ids from get_subject_outline.",
-        "items": {
-          "maxLength": 200,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 15,
-        "minItems": 1,
-        "type": "array"
-      },
-      "unitLabels": {
-        "items": {
-          "maxLength": 200,
-          "type": "string"
-        },
-        "maxItems": 15,
-        "type": "array"
-      }
-    },
-    "required": [
-      "type",
-      "unitIds"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "avoidRepeats": {
+        "default": true,
+        "description": "When drawing from units, skip questions this teacher already published.",
+        "type": "boolean"
+      },
+      "questionCount": {
+        "description": "Questions to draw from units, on top of any questionIds. Omit when only using questionIds.",
+        "maximum": 100,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "questionIds": {
+        "description": "Specific questions to include, as mcq: ids from search_question_bank. They come first, exactly as picked; questions drawn from units never repeat them. Omit units to use only these.",
+        "items": {
+          "pattern": "^(mcq:)?[\\w-]+$",
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array"
+      },
+      "skillId": {
+        "anyOf": [
+          {
+            "maxLength": 200,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional CED skill id to narrow to."
+      },
+      "style": {
+        "default": "exam",
+        "description": "exam = AP-style (with stimulus sets where the exam has them); comprehension or vocabulary checks.",
+        "enum": [
+          "exam",
+          "comprehension",
+          "vocabulary"
+        ],
+        "type": "string"
+      },
+      "timeLimitMinutes": {
+        "anyOf": [
+          {
+            "maximum": 300,
+            "minimum": 1,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Omit for untimed."
+      },
+      "type": {
+        "const": "multiple_choice",
+        "type": "string"
+      },
+      "units": {
+        "description": "Units to draw questions from. Omit when only using questionIds.",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "questionCount": {
+              "description": "Omit to split the total evenly.",
+              "maximum": 100,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "topicIds": {
+              "description": "Topic ids to narrow to.",
+              "items": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              },
+              "maxItems": 60,
+              "type": "array"
+            },
+            "unitId": {
+              "anyOf": [
+                {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Unit id from get_subject_outline; null = whole course."
+            }
+          },
+          "required": [
+            "unitId"
+          ],
+          "type": "object"
+        },
+        "maxItems": 20,
+        "type": "array"
+      }
+    },
+    "required": [
+      "type",
+      "style",
+      "avoidRepeats"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "focus": {
+        "const": "introduction",
+        "description": "AP World, APUSH or AP Euro DBQ or LEQ only: students write just the introduction (contextualization and a thesis), scored on the AP rubric's Thesis/Claim and Contextualization points (2 points). Omit for the whole essay. Can't be combined with parts.",
+        "type": "string"
+      },
+      "parts": {
+        "description": "Part letters students answer (e.g. [\"A\", \"B\"]), scored on those parts' AP rubric points. Omit for the whole question. Questions scored as a whole (essays, AP Stats, world languages) can't be split.",
+        "items": {
+          "pattern": "^[A-Za-z]$",
+          "type": "string"
+        },
+        "maxItems": 12,
+        "minItems": 1,
+        "type": "array"
+      },
+      "questionId": {
+        "description": "An frq: or saq: id from search_question_bank.",
+        "pattern": "^frq:[\\w-]+$|^saq:[\\w-]+(:[A-Za-z])?$",
+        "type": "string"
+      },
+      "type": {
+        "const": "free_response",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "questionId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "readingQuestions": {
+        "default": false,
+        "description": "Add reading-check questions (study guides and AMSCO guided notes).",
+        "type": "boolean"
+      },
+      "resourceId": {
+        "description": "A resource id from list_teaching_resources.",
+        "maxLength": 300,
+        "minLength": 1,
+        "type": "string"
+      },
+      "type": {
+        "const": "reading",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "resourceId",
+      "readingQuestions"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "type": {
+        "const": "diagnostic",
+        "type": "string"
+      },
+      "unitIds": {
+        "description": "Unit ids from get_subject_outline.",
+        "items": {
+          "maxLength": 200,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 15,
+        "minItems": 1,
+        "type": "array"
+      },
+      "unitLabels": {
+        "items": {
+          "maxLength": 200,
+          "type": "string"
+        },
+        "maxItems": 15,
+        "type": "array"
+      }
+    },
+    "required": [
+      "type",
+      "unitIds"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedOct 15, 2026

changedInput schema / properties / sections / items / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "avoidRepeats": {
-        "default": true,
-        "description": "Skip questions this teacher already published.",
-        "type": "boolean"
-      },
-      "questionCount": {
-        "description": "Total questions in this section.",
-        "maximum": 100,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "skillId": {
-        "anyOf": [
-          {
-            "maxLength": 200,
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional CED skill id to narrow to."
-      },
-      "style": {
-        "default": "exam",
-        "description": "exam = AP-style (with stimulus sets where the exam has them); comprehension or vocabulary checks.",
-        "enum": [
-          "exam",
-          "comprehension",
-          "vocabulary"
-        ],
-        "type": "string"
-      },
-      "timeLimitMinutes": {
-        "anyOf": [
-          {
-            "maximum": 300,
-            "minimum": 1,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Omit for untimed."
-      },
-      "type": {
-        "const": "multiple_choice",
-        "type": "string"
-      },
-      "units": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "questionCount": {
-              "description": "Omit to split the total evenly.",
-              "maximum": 100,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "topicIds": {
-              "description": "Topic ids to narrow to.",
-              "items": {
-                "maxLength": 200,
-                "minLength": 1,
-                "type": "string"
-              },
-              "maxItems": 60,
-              "type": "array"
-            },
-            "unitId": {
-              "anyOf": [
-                {
-                  "maxLength": 200,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Unit id from get_subject_outline; null = whole course."
-            }
-          },
-          "required": [
-            "unitId"
-          ],
-          "type": "object"
-        },
-        "maxItems": 20,
-        "minItems": 1,
-        "type": "array"
-      }
-    },
-    "required": [
-      "type",
-      "questionCount",
-      "style",
-      "units",
-      "avoidRepeats"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "parts": {
-        "description": "Part letters students answer (e.g. [\"A\", \"B\"]), scored on those parts' AP rubric points. Omit for the whole question. Questions scored as a whole (essays, AP Stats, world languages) can't be split.",
-        "items": {
-          "pattern": "^[A-Za-z]$",
-          "type": "string"
-        },
-        "maxItems": 12,
-        "minItems": 1,
-        "type": "array"
-      },
-      "questionId": {
-        "description": "An frq: or saq: id from search_question_bank.",
-        "pattern": "^frq:[\\w-]+$|^saq:[\\w-]+(:[A-Za-z])?$",
-        "type": "string"
-      },
-      "type": {
-        "const": "free_response",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "questionId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "readingQuestions": {
-        "default": false,
-        "description": "Add reading-check questions (study guides and AMSCO guided notes).",
-        "type": "boolean"
-      },
-      "resourceId": {
-        "description": "A resource id from list_teaching_resources.",
-        "maxLength": 300,
-        "minLength": 1,
-        "type": "string"
-      },
-      "type": {
-        "const": "reading",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "resourceId",
-      "readingQuestions"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "type": {
-        "const": "diagnostic",
-        "type": "string"
-      },
-      "unitIds": {
-        "description": "Unit ids from get_subject_outline.",
-        "items": {
-          "maxLength": 200,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 15,
-        "minItems": 1,
-        "type": "array"
-      },
-      "unitLabels": {
-        "items": {
-          "maxLength": 200,
-          "type": "string"
-        },
-        "maxItems": 15,
-        "type": "array"
-      }
-    },
-    "required": [
-      "type",
-      "unitIds"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "avoidRepeats": {
+        "default": true,
+        "description": "When drawing from units, skip questions this teacher already published.",
+        "type": "boolean"
+      },
+      "questionCount": {
+        "description": "Questions to draw from units, on top of any questionIds. Omit when only using questionIds.",
+        "maximum": 100,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "questionIds": {
+        "description": "Specific questions to include, as mcq: ids from search_question_bank. They come first, exactly as picked; questions drawn from units never repeat them. Omit units to use only these.",
+        "items": {
+          "pattern": "^(mcq:)?[\\w-]+$",
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array"
+      },
+      "skillId": {
+        "anyOf": [
+          {
+            "maxLength": 200,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional CED skill id to narrow to."
+      },
+      "style": {
+        "default": "exam",
+        "description": "exam = AP-style (with stimulus sets where the exam has them); comprehension or vocabulary checks.",
+        "enum": [
+          "exam",
+          "comprehension",
+          "vocabulary"
+        ],
+        "type": "string"
+      },
+      "timeLimitMinutes": {
+        "anyOf": [
+          {
+            "maximum": 300,
+            "minimum": 1,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Omit for untimed."
+      },
+      "type": {
+        "const": "multiple_choice",
+        "type": "string"
+      },
+      "units": {
+        "description": "Units to draw questions from. Omit when only using questionIds.",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "questionCount": {
+              "description": "Omit to split the total evenly.",
+              "maximum": 100,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "topicIds": {
+              "description": "Topic ids to narrow to.",
+              "items": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              },
+              "maxItems": 60,
+              "type": "array"
+            },
+            "unitId": {
+              "anyOf": [
+                {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Unit id from get_subject_outline; null = whole course."
+            }
+          },
+          "required": [
+            "unitId"
+          ],
+          "type": "object"
+        },
+        "maxItems": 20,
+        "type": "array"
+      }
+    },
+    "required": [
+      "type",
+      "style",
+      "avoidRepeats"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "parts": {
+        "description": "Part letters students answer (e.g. [\"A\", \"B\"]), scored on those parts' AP rubric points. Omit for the whole question. Questions scored as a whole (essays, AP Stats, world languages) can't be split.",
+        "items": {
+          "pattern": "^[A-Za-z]$",
+          "type": "string"
+        },
+        "maxItems": 12,
+        "minItems": 1,
+        "type": "array"
+      },
+      "questionId": {
+        "description": "An frq: or saq: id from search_question_bank.",
+        "pattern": "^frq:[\\w-]+$|^saq:[\\w-]+(:[A-Za-z])?$",
+        "type": "string"
+      },
+      "type": {
+        "const": "free_response",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "questionId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "readingQuestions": {
+        "default": false,
+        "description": "Add reading-check questions (study guides and AMSCO guided notes).",
+        "type": "boolean"
+      },
+      "resourceId": {
+        "description": "A resource id from list_teaching_resources.",
+        "maxLength": 300,
+        "minLength": 1,
+        "type": "string"
+      },
+      "type": {
+        "const": "reading",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "resourceId",
+      "readingQuestions"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "type": {
+        "const": "diagnostic",
+        "type": "string"
+      },
+      "unitIds": {
+        "description": "Unit ids from get_subject_outline.",
+        "items": {
+          "maxLength": 200,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 15,
+        "minItems": 1,
+        "type": "array"
+      },
+      "unitLabels": {
+        "items": {
+          "maxLength": 200,
+          "type": "string"
+        },
+        "maxItems": 15,
+        "type": "array"
+      }
+    },
+    "required": [
+      "type",
+      "unitIds"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedOct 14, 2026

changedInput schema / properties / sections / items / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "avoidRepeats": {
-        "default": true,
-        "description": "Skip questions this teacher already published.",
-        "type": "boolean"
-      },
-      "questionCount": {
-        "description": "Total questions in this section.",
-        "maximum": 100,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "skillId": {
-        "anyOf": [
-          {
-            "maxLength": 200,
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Optional CED skill id to narrow to."
-      },
-      "style": {
-        "default": "exam",
-        "description": "exam = AP-style (with stimulus sets where the exam has them); comprehension or vocabulary checks.",
-        "enum": [
-          "exam",
-          "comprehension",
-          "vocabulary"
-        ],
-        "type": "string"
-      },
-      "timeLimitMinutes": {
-        "anyOf": [
-          {
-            "maximum": 300,
-            "minimum": 1,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Omit for untimed."
-      },
-      "type": {
-        "const": "multiple_choice",
-        "type": "string"
-      },
-      "units": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "questionCount": {
-              "description": "Omit to split the total evenly.",
-              "maximum": 100,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "topicIds": {
-              "description": "Topic ids to narrow to.",
-              "items": {
-                "maxLength": 200,
-                "minLength": 1,
-                "type": "string"
-              },
-              "maxItems": 60,
-              "type": "array"
-            },
-            "unitId": {
-              "anyOf": [
-                {
-                  "maxLength": 200,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Unit id from get_subject_outline; null = whole course."
-            }
-          },
-          "required": [
-            "unitId"
-          ],
-          "type": "object"
-        },
-        "maxItems": 20,
-        "minItems": 1,
-        "type": "array"
-      }
-    },
-    "required": [
-      "type",
-      "questionCount",
-      "style",
-      "units",
-      "avoidRepeats"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "questionId": {
-        "description": "An frq: or saq: id from search_question_bank.",
-        "pattern": "^frq:[\\w-]+$|^saq:[\\w-]+(:[A-Za-z])?$",
-        "type": "string"
-      },
-      "type": {
-        "const": "free_response",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "questionId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "readingQuestions": {
-        "default": false,
-        "description": "Add reading-check questions (study guides and AMSCO guided notes).",
-        "type": "boolean"
-      },
-      "resourceId": {
-        "description": "A resource id from list_teaching_resources.",
-        "maxLength": 300,
-        "minLength": 1,
-        "type": "string"
-      },
-      "type": {
-        "const": "reading",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "resourceId",
-      "readingQuestions"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "type": {
-        "const": "diagnostic",
-        "type": "string"
-      },
-      "unitIds": {
-        "description": "Unit ids from get_subject_outline.",
-        "items": {
-          "maxLength": 200,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 15,
-        "minItems": 1,
-        "type": "array"
-      },
-      "unitLabels": {
-        "items": {
-          "maxLength": 200,
-          "type": "string"
-        },
-        "maxItems": 15,
-        "type": "array"
-      }
-    },
-    "required": [
-      "type",
-      "unitIds"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "avoidRepeats": {
+        "default": true,
+        "description": "Skip questions this teacher already published.",
+        "type": "boolean"
+      },
+      "questionCount": {
+        "description": "Total questions in this section.",
+        "maximum": 100,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "skillId": {
+        "anyOf": [
+          {
+            "maxLength": 200,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional CED skill id to narrow to."
+      },
+      "style": {
+        "default": "exam",
+        "description": "exam = AP-style (with stimulus sets where the exam has them); comprehension or vocabulary checks.",
+        "enum": [
+          "exam",
+          "comprehension",
+          "vocabulary"
+        ],
+        "type": "string"
+      },
+      "timeLimitMinutes": {
+        "anyOf": [
+          {
+            "maximum": 300,
+            "minimum": 1,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Omit for untimed."
+      },
+      "type": {
+        "const": "multiple_choice",
+        "type": "string"
+      },
+      "units": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "questionCount": {
+              "description": "Omit to split the total evenly.",
+              "maximum": 100,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "topicIds": {
+              "description": "Topic ids to narrow to.",
+              "items": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              },
+              "maxItems": 60,
+              "type": "array"
+            },
+            "unitId": {
+              "anyOf": [
+                {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Unit id from get_subject_outline; null = whole course."
+            }
+          },
+          "required": [
+            "unitId"
+          ],
+          "type": "object"
+        },
+        "maxItems": 20,
+        "minItems": 1,
+        "type": "array"
+      }
+    },
+    "required": [
+      "type",
+      "questionCount",
+      "style",
+      "units",
+      "avoidRepeats"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "parts": {
+        "description": "Part letters students answer (e.g. [\"A\", \"B\"]), scored on those parts' AP rubric points. Omit for the whole question. Questions scored as a whole (essays, AP Stats, world languages) can't be split.",
+        "items": {
+          "pattern": "^[A-Za-z]$",
+          "type": "string"
+        },
+        "maxItems": 12,
+        "minItems": 1,
+        "type": "array"
+      },
+      "questionId": {
+        "description": "An frq: or saq: id from search_question_bank.",
+        "pattern": "^frq:[\\w-]+$|^saq:[\\w-]+(:[A-Za-z])?$",
+        "type": "string"
+      },
+      "type": {
+        "const": "free_response",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "questionId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "readingQuestions": {
+        "default": false,
+        "description": "Add reading-check questions (study guides and AMSCO guided notes).",
+        "type": "boolean"
+      },
+      "resourceId": {
+        "description": "A resource id from list_teaching_resources.",
+        "maxLength": 300,
+        "minLength": 1,
+        "type": "string"
+      },
+      "type": {
+        "const": "reading",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "resourceId",
+      "readingQuestions"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "type": {
+        "const": "diagnostic",
+        "type": "string"
+      },
+      "unitIds": {
+        "description": "Unit ids from get_subject_outline.",
+        "items": {
+          "maxLength": 200,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 15,
+        "minItems": 1,
+        "type": "array"
+      },
+      "unitLabels": {
+        "items": {
+          "maxLength": 200,
+          "type": "string"
+        },
+        "maxItems": 15,
+        "type": "array"
+      }
+    },
+    "required": [
+      "type",
+      "unitIds"
+    ],
+    "type": "object"
+  }
+]

First observedOct 1, 2026

TDQS

A3.9/5.0

Behavior4/5

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

Annotations already declare a non-read-only, non-destructive, non-idempotent write with no open-world access; the description adds genuinely new behavior: settings inherit from the first class's defaults, AP Calculus requires courseVariant or a shared course among target classes, drafts never consume an included assignment slot, and it returns a draft id plus review link. That is meaningful disclosure of side effects and preconditions beyond the annotations. It doesn't cover failure modes or the requestId retry semantics beyond the schema's own note.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded, followed by source types, then conditional rules, then return value — a sensible order. The first sentence is long and comma-heavy, which slows parsing slightly, but no sentence is filler.

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

Completeness5/5

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

For an 11-parameter nested creation tool with an output schema, the description covers what can be built from, defaulting behavior, the AP Calculus constraint, the slot rule, and the return value. Since an output schema exists, it need not describe return structure further. Nothing an agent needs to call this correctly appears to be missing.

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

Parameters4/5

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

With 64% schema coverage, the description still adds meaning: it ties the mcq/frq/saq id patterns to their source tools, clarifies that unit draws skip already-assigned questions, and explains the courseVariant fallback for AP Calculus. The 'settings start from the first class's defaults' line gives semantics the schema does not. The remaining undescribed parameters are largely covered by nested schema descriptions.

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 opens with a concrete verb and resource ('Builds an assignment draft') and enumerates the exact content sources: mcq ids from the question bank, unit/topic draws, FRQ/SAQ ids, readings with optional checks, and diagnostics. That is far more specific than the name alone. It doesn't explicitly distinguish itself from siblings like update_assignment_draft or duplicate_assignment, which keeps it at 4 rather than 5.

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

Usage Guidelines3/5

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

It implies this is the creation path and gives conditional rules ('AP Calculus drafts require courseVariant or target classes sharing one course', 'Drafts never use an included assignment slot'), but it never states when to choose this tool over update_assignment_draft, duplicate_assignment, or restore_assignment_draft. The agent must infer the routing from tool names.

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

All Fiveable for AP Teachers 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.

Create assignment draft

Tool call template

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources