Fiveable for AP Teachers is an MCP server published by io.github.thinkfiveable, hosted at fiveable.me. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 77 tools, including get_my_teacher_workspace, list_classes, get_class, list_coursework, get_assignment.
AP rubric grading, assignment drafts, question-bank materials, and class insights for teachers.
913 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Orientation for the signed-in teacher's Fiveable workspace: classes, coursework awaiting review or due this week, included assignments remaining, and configured Google connections. Cheap.
No parameters.
{
"name": "get_my_teacher_workspace",
"title": "Get my teacher workspace",
"description": "Orientation for the signed-in teacher's Fiveable workspace: classes, coursework awaiting review or due this week, included assignments remaining, and configured Google connections. Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get my teacher workspace",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Lists the signed-in teacher's classes with subject, student count and class id. Class names such as 'period 3' can be resolved to their ids. Cheap.
| Parameter | Type | Description |
|---|---|---|
| includeArchived * | boolean | List archived classes instead of active ones. |
{
"name": "list_classes",
"title": "List my classes",
"description": "Lists the signed-in teacher's classes with subject, student count and class id. Class names such as 'period 3' can be resolved to their ids. Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"includeArchived"
],
"properties": {
"includeArchived": {
"type": "boolean",
"default": false,
"description": "List archived classes instead of active ones."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List my classes",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}One class in the teacher's workspace: subject, roster (students by handle and short name), the class's assignment defaults, and the student links of assignments currently open to it. Students join a class by opening one of those links; there are no class codes. Cheap.
| Parameter | Type | Description |
|---|---|---|
| classId * | string | Class id from list_classes. |
{
"name": "get_class",
"title": "Get class",
"description": "One class in the teacher's workspace: subject, roster (students by handle and short name), the class's assignment defaults, and the student links of assignments currently open to it. Students join a class by opening one of those links; there are no class codes. Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"classId"
],
"properties": {
"classId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Class id from list_classes."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get class",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Lists the teacher's assignments and grading sessions from their workspace ledger: status, class, due date, roster-based turn-in counts, review counts and class average. The active status filter selects work currently open to students. Optional filters cover class, subject and status. Cheap.
| Parameter | Type | Description |
|---|---|---|
| limit * | integer | |
| cursor | string | Cursor from a previous page. |
| status * | string | Ledger status filter. needs_review shows work waiting for the teacher. |
| classId | string | Class id from list_classes. |
| subjectSlug | string | Limit to one subject, e.g. ap-bio or apush. |
{
"name": "list_coursework",
"title": "List coursework",
"description": "Lists the teacher's assignments and grading sessions from their workspace ledger: status, class, due date, roster-based turn-in counts, review counts and class average. The active status filter selects work currently open to students. Optional filters cover class, subject and status. Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status",
"limit"
],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
},
"cursor": {
"type": "string",
"maxLength": 200,
"description": "Cursor from a previous page."
},
"status": {
"enum": [
"all",
"draft",
"scheduled",
"active",
"needs_review",
"closed",
"handed_back",
"archived"
],
"type": "string",
"default": "all",
"description": "Ledger status filter. needs_review shows work waiting for the teacher."
},
"classId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Class id from list_classes."
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"description": "Limit to one subject, e.g. ap-bio or apush."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List coursework",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns one assignment's sections, question counts, scoring and timing settings, published classes, due dates and student links. Cheap.
| Parameter | Type | Description |
|---|---|---|
| assignmentId * | string | Assignment id from list_coursework. |
{
"name": "get_assignment",
"title": "Get assignment",
"description": "Returns one assignment's sections, question counts, scoring and timing settings, published classes, due dates and student links. Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"assignmentId"
],
"properties": {
"assignmentId": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Assignment id from list_coursework."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get assignment",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Where each student is on one assignment: in progress, submitted, scored, or waiting for review, with their score when results are available. Students appear by handle and short name. Use it for 'who hasn't finished?' or 'how did period 5 do?'. Cheap.
| Parameter | Type | Description |
|---|---|---|
| assignmentId * | string | Assignment id from list_coursework. |
{
"name": "get_assignment_status",
"title": "Get assignment status",
"description": "Where each student is on one assignment: in progress, submitted, scored, or waiting for review, with their score when results are available. Students appear by handle and short name. Use it for 'who hasn't finished?' or 'how did period 5 do?'. Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"assignmentId"
],
"properties": {
"assignmentId": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Assignment id from list_coursework."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get assignment status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}How a class (or all the teacher's classes) is doing on Fiveable assignments: accuracy and FRQ points with change over time, each assignment's turn-in rate and average, and each student's average with flags (missing work, dropping, improving), weakest first. Scope by class, subject, assignment or time window. Moderate cost.
| Parameter | Type | Description |
|---|---|---|
| days * | integer | Look back this many days. 0 means this school year. |
| classId | string | Limit to one class (id from list_classes). |
| subjectSlug | string | Limit to one subject, e.g. apush or ap-bio. |
| assignmentId | string | Limit to one assignment (id from list_coursework). |
{
"name": "get_class_insights",
"title": "Get class insights",
"description": "How a class (or all the teacher's classes) is doing on Fiveable assignments: accuracy and FRQ points with change over time, each assignment's turn-in rate and average, and each student's average with flags (missing work, dropping, improving), weakest first. Scope by class, subject, assignment or time window. Moderate cost.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"days"
],
"properties": {
"days": {
"type": "integer",
"default": 0,
"maximum": 3650,
"minimum": 0,
"description": "Look back this many days. 0 means this school year."
},
"classId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Limit to one class (id from list_classes)."
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"description": "Limit to one subject, e.g. apush or ap-bio."
},
"assignmentId": {
"type": "string",
"maxLength": 100,
"description": "Limit to one assignment (id from list_coursework)."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get class insights",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns one student's Fiveable work: average, missing work, assignment scores, weakest units and topics, and skill progress. Accepts an anonymous student handle (S-…). Suitable for conference preparation, parent notes and individual reteaching. Moderate cost.
| Parameter | Type | Description |
|---|---|---|
| days * | integer | Look back this many days. 0 means this school year. |
| handle * | string | The student's handle, e.g. S-4f2a1c. |
| classId | string | Limit to one class (id from list_classes). |
| subjectSlug | string | Limit to one subject, e.g. apush or ap-bio. |
| assignmentId | string | Limit to one assignment (id from list_coursework). |
{
"name": "get_student_insights",
"title": "Get student insights",
"description": "Returns one student's Fiveable work: average, missing work, assignment scores, weakest units and topics, and skill progress. Accepts an anonymous student handle (S-…). Suitable for conference preparation, parent notes and individual reteaching. Moderate cost.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"handle",
"days"
],
"properties": {
"days": {
"type": "integer",
"default": 0,
"maximum": 3650,
"minimum": 0,
"description": "Look back this many days. 0 means this school year."
},
"handle": {
"type": "string",
"pattern": "^S-[a-f0-9]{6}$",
"description": "The student's handle, e.g. S-4f2a1c."
},
"classId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Limit to one class (id from list_classes)."
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"description": "Limit to one subject, e.g. apush or ap-bio."
},
"assignmentId": {
"type": "string",
"maxLength": 100,
"description": "Limit to one assignment (id from list_coursework)."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get student insights",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Ranks topics, units, CED skills and FRQ rubric rows where a class lost the most points on Fiveable assignments. Optional filters cover class, subject, assignment and time window. Moderate cost.
| Parameter | Type | Description |
|---|---|---|
| days * | integer | Look back this many days. 0 means this school year. |
| classId | string | Limit to one class (id from list_classes). |
| subjectSlug | string | Limit to one subject, e.g. apush or ap-bio. |
| assignmentId | string | Limit to one assignment (id from list_coursework). |
{
"name": "get_reteach_gaps",
"title": "Get reteach gaps",
"description": "Ranks topics, units, CED skills and FRQ rubric rows where a class lost the most points on Fiveable assignments. Optional filters cover class, subject, assignment and time window. Moderate cost.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"days"
],
"properties": {
"days": {
"type": "integer",
"default": 0,
"maximum": 3650,
"minimum": 0,
"description": "Look back this many days. 0 means this school year."
},
"classId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Limit to one class (id from list_classes)."
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"description": "Limit to one subject, e.g. apush or ap-bio."
},
"assignmentId": {
"type": "string",
"maxLength": 100,
"description": "Limit to one assignment (id from list_coursework)."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get reteach gaps",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Class progress on AP course skills (for example causation or contextualization): each skill's verdict (solid, improving, stuck, developing, building), average, trend, the students who need support most, and the units to revisit. Says so when evidence is limited instead of guessing. Works best scoped to one subject. Moderate cost.
| Parameter | Type | Description |
|---|---|---|
| days * | integer | Look back this many days. 0 means this school year. |
| classId | string | Limit to one class (id from list_classes). |
| subjectSlug | string | Limit to one subject, e.g. apush or ap-bio. |
| assignmentId | string | Limit to one assignment (id from list_coursework). |
{
"name": "get_skill_insights",
"title": "Get skill insights",
"description": "Class progress on AP course skills (for example causation or contextualization): each skill's verdict (solid, improving, stuck, developing, building), average, trend, the students who need support most, and the units to revisit. Says so when evidence is limited instead of guessing. Works best scoped to one subject. Moderate cost.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"days"
],
"properties": {
"days": {
"type": "integer",
"default": 0,
"maximum": 3650,
"minimum": 0,
"description": "Look back this many days. 0 means this school year."
},
"classId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Limit to one class (id from list_classes)."
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"description": "Limit to one subject, e.g. apush or ap-bio."
},
"assignmentId": {
"type": "string",
"maxLength": 100,
"description": "Limit to one assignment (id from list_coursework)."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get skill insights",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Per-question results for one assignment: percent correct and how many students picked each answer choice (identifying which distractors drew responses), plus FRQ part-by-part full-credit rates. Use it for 'which questions went worst?'. Moderate cost.
| Parameter | Type | Description |
|---|---|---|
| assignmentId * | string | Assignment id from list_coursework. |
{
"name": "get_assignment_question_breakdown",
"title": "Get assignment question breakdown",
"description": "Per-question results for one assignment: percent correct and how many students picked each answer choice (identifying which distractors drew responses), plus FRQ part-by-part full-credit rates. Use it for 'which questions went worst?'. Moderate cost.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"assignmentId"
],
"properties": {
"assignmentId": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Assignment id from list_coursework."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get assignment question breakdown",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Searches Fiveable's question bank for one subject (the same bank as the assignment builder): multiple choice, stimulus sets, SAQs and FRQs, filtered by unit, topic, skill, format and stimulus, optionally hiding questions this teacher already published. For AP Calculus, courseVariant scopes AB to exclude BC-only units, topics and FRQs. Returns ids, short stems and alignment, never answers. Filters accept exact unit/topic/skill labels from the filter lists in the result. Cheap.
| Parameter | Type | Description |
|---|---|---|
| type | string | mcq = single question, question-set = stimulus set, saq, or frq (LEQ, DBQ and other FRQs). |
| unit | string | Exact unit label from filters.units. |
| limit * | integer | |
| query | string | Words to match in the question. |
| skill | string | Exact skill label from filters.skills. |
| topic | string | Exact topic label from filters.topics. |
| format | string | one of ["multiple-choice","free-response"] |
| offset * | integer | |
| stimulus | string | one of ["includes-stimulus","no-stimulus"] |
| subjectSlug * | string | Subject, e.g. ap-bio or apush. |
| courseVariant | string | AP Calculus only: ap-calc-ab or ap-calc-bc, the course of the class or draft you are building for. |
| excludeAssigned * | boolean | Hide questions this teacher already published. |
{
"name": "search_question_bank",
"title": "Search question bank",
"description": "Searches Fiveable's question bank for one subject (the same bank as the assignment builder): multiple choice, stimulus sets, SAQs and FRQs, filtered by unit, topic, skill, format and stimulus, optionally hiding questions this teacher already published. For AP Calculus, courseVariant scopes AB to exclude BC-only units, topics and FRQs. Returns ids, short stems and alignment, never answers. Filters accept exact unit/topic/skill labels from the filter lists in the result. Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"excludeAssigned",
"offset",
"limit"
],
"properties": {
"type": {
"enum": [
"mcq",
"question-set",
"saq",
"frq"
],
"type": "string",
"description": "mcq = single question, question-set = stimulus set, saq, or frq (LEQ, DBQ and other FRQs)."
},
"unit": {
"type": "string",
"maxLength": 200,
"description": "Exact unit label from filters.units."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Words to match in the question."
},
"skill": {
"type": "string",
"maxLength": 200,
"description": "Exact skill label from filters.skills."
},
"topic": {
"type": "string",
"maxLength": 200,
"description": "Exact topic label from filters.topics."
},
"format": {
"enum": [
"multiple-choice",
"free-response"
],
"type": "string"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0
},
"stimulus": {
"enum": [
"includes-stimulus",
"no-stimulus"
],
"type": "string"
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Subject, e.g. ap-bio or apush."
},
"courseVariant": {
"enum": [
"ap-calc-ab",
"ap-calc-bc"
],
"type": "string",
"description": "AP Calculus only: ap-calc-ab or ap-calc-bc, the course of the class or draft you are building for."
},
"excludeAssigned": {
"type": "boolean",
"default": false,
"description": "Hide questions this teacher already published."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Search question bank",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns one bank question with its stimulus, choices, marked correct answer and explanation. Stimulus sets include all linked questions and keys. Answer keys are teacher-only material. Cheap.
| Parameter | Type | Description |
|---|---|---|
| questionId * | string | Question id from search_question_bank, e.g. mcq:64f… or stimulus-set:64f…. |
| subjectSlug * | string |
{
"name": "preview_question",
"title": "Preview question",
"description": "Returns one bank question with its stimulus, choices, marked correct answer and explanation. Stimulus sets include all linked questions and keys. Answer keys are teacher-only material. Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"questionId"
],
"properties": {
"questionId": {
"type": "string",
"pattern": "^(mcq|stimulus-set|frq):[\\w-]+$|^saq:[\\w-]+:[A-Za-z]$",
"description": "Question id from search_question_bank, e.g. mcq:64f… or stimulus-set:64f…."
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Preview question",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns up to 40 bank questions with answer keys, explanations, complete stimuli and Fiveable attribution for classroom materials. Stimuli are required context for their questions; answer keys are teacher-only material. Counts against the content budget.
| Parameter | Type | Description |
|---|---|---|
| purpose | string | What the teacher is making. Used only to improve Fiveable; changes nothing in the result. |
| questionIds * | array | |
| subjectSlug * | string |
{
"name": "get_questions_for_materials",
"title": "Get questions for materials",
"description": "Returns up to 40 bank questions with answer keys, explanations, complete stimuli and Fiveable attribution for classroom materials. Stimuli are required context for their questions; answer keys are teacher-only material. Counts against the content budget.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"questionIds"
],
"properties": {
"purpose": {
"enum": [
"slides",
"worksheet",
"game",
"notes",
"quiz",
"other"
],
"type": "string",
"description": "What the teacher is making. Used only to improve Fiveable; changes nothing in the result."
},
"questionIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(mcq|stimulus-set|frq):[\\w-]+$|^saq:[\\w-]+:[A-Za-z]$",
"description": "Question id from search_question_bank, e.g. mcq:64f… or stimulus-set:64f…."
},
"maxItems": 40,
"minItems": 1
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get questions for materials",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns reading-check questions and keys for one Fiveable guide: the curated set when available, otherwise generated questions (slower). Accepts a guide id. Suitable for exit tickets, reading quizzes and guided reading handouts.
| Parameter | Type | Description |
|---|---|---|
| guideId * | string | Study guide document id, or study-guide: resource id from list_teaching_resources. |
{
"name": "get_guide_reading_questions",
"title": "Get guide reading questions",
"description": "Returns reading-check questions and keys for one Fiveable guide: the curated set when available, otherwise generated questions (slower). Accepts a guide id. Suitable for exit tickets, reading quizzes and guided reading handouts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"guideId"
],
"properties": {
"guideId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Study guide document id, or study-guide: resource id from list_teaching_resources."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get guide reading questions",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}AMSCO textbook guided-notes prompts with answer keys for one chapter, for subjects that have AMSCO notes (for example AP US History). Without a chapter it lists the chapters. Use for guided notes handouts and reading checks. Cheap.
| Parameter | Type | Description |
|---|---|---|
| chapterSlug | string | Chapter slug from the chapter list, e.g. chapter-1-1. |
| subjectSlug * | string |
{
"name": "get_guided_notes",
"title": "Get guided notes",
"description": "AMSCO textbook guided-notes prompts with answer keys for one chapter, for subjects that have AMSCO notes (for example AP US History). Without a chapter it lists the chapters. Use for guided notes handouts and reading checks. Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug"
],
"properties": {
"chapterSlug": {
"type": "string",
"maxLength": 100,
"description": "Chapter slug from the chapter list, e.g. chapter-1-1."
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get guided notes",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Lists every AP subject Fiveable covers, with its canonical subject slug and flags for which features exist for that subject (practice questions, key terms, score calculator). Suitable when a subject slug is not already known. Cheap — roughly 1-2k tokens.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| search | string | Optional case-insensitive filter on subject name, e.g. "bio" or "history". |
{
"name": "list_subjects",
"title": "List AP subjects",
"description": "Lists every AP subject Fiveable covers, with its canonical subject slug and flags for which features exist for that subject (practice questions, key terms, score calculator). Suitable when a subject slug is not already known. Cheap — roughly 1-2k tokens.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"search": {
"type": "string",
"description": "Optional case-insensitive filter on subject name, e.g. \"bio\" or \"history\"."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List AP subjects",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns the full unit and topic outline for one AP subject, including every study guide slug in each unit. Provides the course map for study planning and individual guide retrieval. Moderate cost — roughly 2-5k tokens depending on subject size.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| subjectSlug * | string | Fiveable subject slug, e.g. "ap-bio" or "apush". The course name or a close approximation such as "ap-biology" also resolves. Use list_subjects to find it. |
{
"name": "get_subject_outline",
"title": "Get subject outline",
"description": "Returns the full unit and topic outline for one AP subject, including every study guide slug in each unit. Provides the course map for study planning and individual guide retrieval. Moderate cost — roughly 2-5k tokens depending on subject size.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug"
],
"properties": {
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"subjectSlug": {
"type": "string",
"minLength": 2,
"description": "Fiveable subject slug, e.g. \"ap-bio\" or \"apush\". The course name or a close approximation such as \"ap-biology\" also resolves. Use list_subjects to find it."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get subject outline",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns the full text of one Fiveable AP study guide as Markdown. Accepts the exact canonical guide reference or a close approximation of its title. Suitable when a student asks to learn or review a topic. It consumes one full-content preview for a caller unless existing access covers this subject and feature. Expensive — a full guide can be 3-8k tokens.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| guideSlug * | string | Canonical guide reference from get_subject_outline, content slug, document id, or title, e.g. "/ap-bio/unit-2/cell-structure/study-guide/abc123" or "cell-structure". |
| subjectSlug * | string | Fiveable subject slug, e.g. "ap-bio" or "apush". The course name or a close approximation such as "ap-biology" also resolves. Use list_subjects to find it. |
{
"name": "get_study_guide",
"title": "Get a study guide",
"description": "Returns the full text of one Fiveable AP study guide as Markdown. Accepts the exact canonical guide reference or a close approximation of its title. Suitable when a student asks to learn or review a topic. It consumes one full-content preview for a caller unless existing access covers this subject and feature. Expensive — a full guide can be 3-8k tokens.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"guideSlug"
],
"properties": {
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"guideSlug": {
"type": "string",
"minLength": 2,
"description": "Canonical guide reference from get_subject_outline, content slug, document id, or title, e.g. \"/ap-bio/unit-2/cell-structure/study-guide/abc123\" or \"cell-structure\"."
},
"subjectSlug": {
"type": "string",
"minLength": 2,
"description": "Fiveable subject slug, e.g. \"ap-bio\" or \"apush\". The course name or a close approximation such as \"ap-biology\" also resolves. Use list_subjects to find it."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get a study guide",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns the overview page for one unit of an AP course: what it covers, how it is weighted on the exam, its topics and study plan. Suitable when a student is reviewing a whole unit. Moderate cost — roughly 1-3k tokens.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| unitSlug * | string | Unit slug from get_subject_outline, e.g. "unit-1". |
| subjectSlug * | string | Fiveable subject slug, e.g. "ap-bio" or "apush". The course name or a close approximation such as "ap-biology" also resolves. Use list_subjects to find it. |
{
"name": "get_unit_overview",
"title": "Get unit overview",
"description": "Returns the overview page for one unit of an AP course: what it covers, how it is weighted on the exam, its topics and study plan. Suitable when a student is reviewing a whole unit. Moderate cost — roughly 1-3k tokens.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"unitSlug"
],
"properties": {
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"unitSlug": {
"type": "string",
"minLength": 1,
"description": "Unit slug from get_subject_outline, e.g. \"unit-1\"."
},
"subjectSlug": {
"type": "string",
"minLength": 2,
"description": "Fiveable subject slug, e.g. \"ap-bio\" or \"apush\". The course name or a close approximation such as \"ap-biology\" also resolves. Use list_subjects to find it."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get unit overview",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Lists the key vocabulary terms for an AP subject, paginated alphabetically. Suitable for building flashcards or checking what vocabulary a student should know; results include stable term slugs for full definitions. Cheap.
| Parameter | Type | Description |
|---|---|---|
| page * | integer | 1-indexed page number. |
| limit * | integer | Terms per page. |
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| letter * | string | Filter to terms starting with one letter, or "ALL" for every term. |
| subjectSlug * | string | Fiveable subject slug, e.g. "ap-bio" or "apush". The course name or a close approximation such as "ap-biology" also resolves. Use list_subjects to find it. |
{
"name": "list_key_terms",
"title": "List key terms",
"description": "Lists the key vocabulary terms for an AP subject, paginated alphabetically. Suitable for building flashcards or checking what vocabulary a student should know; results include stable term slugs for full definitions. Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"page",
"limit",
"letter"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-indexed page number."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 1,
"description": "Terms per page."
},
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"letter": {
"type": "string",
"default": "ALL",
"description": "Filter to terms starting with one letter, or \"ALL\" for every term."
},
"subjectSlug": {
"type": "string",
"minLength": 2,
"description": "Fiveable subject slug, e.g. \"ap-bio\" or \"apush\". The course name or a close approximation such as \"ap-biology\" also resolves. Use list_subjects to find it."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List key terms",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns the full definition, context and related terms for one AP key term. Use when a student asks "what does X mean" for AP vocabulary. Cheap — usually under 1k tokens.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| termSlug * | string | Key term slug or the term itself, e.g. "natural-selection". |
| subjectSlug * | string | Fiveable subject slug, e.g. "ap-bio" or "apush". The course name or a close approximation such as "ap-biology" also resolves. Use list_subjects to find it. |
{
"name": "get_key_term",
"title": "Get a key term",
"description": "Returns the full definition, context and related terms for one AP key term. Use when a student asks \"what does X mean\" for AP vocabulary. Cheap — usually under 1k tokens.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"termSlug"
],
"properties": {
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"termSlug": {
"type": "string",
"minLength": 1,
"description": "Key term slug or the term itself, e.g. \"natural-selection\"."
},
"subjectSlug": {
"type": "string",
"minLength": 2,
"description": "Fiveable subject slug, e.g. \"ap-bio\" or \"apush\". The course name or a close approximation such as \"ap-biology\" also resolves. Use list_subjects to find it."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get a key term",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Fiveable's site search across study guides, units, subject hubs, key terms, unit tests, unit vocab lists and practice pages. Handles typos, course names and requests like "apush unit 3 test". Suitable when the relevant subject or guide is not known. Returns titles and canonical references rather than full content, so it is cheap.
| Parameter | Type | Description |
|---|---|---|
| limit * | integer | Maximum results to return. |
| query * | string | What to search for, e.g. "photosynthesis light reactions". |
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| subjectSlug | string | Optional: restrict the search to one subject. |
{
"name": "search_content",
"title": "Search Fiveable content",
"description": "Fiveable's site search across study guides, units, subject hubs, key terms, unit tests, unit vocab lists and practice pages. Handles typos, course names and requests like \"apush unit 3 test\". Suitable when the relevant subject or guide is not known. Returns titles and canonical references rather than full content, so it is cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query",
"limit"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Maximum results to return."
},
"query": {
"type": "string",
"minLength": 2,
"description": "What to search for, e.g. \"photosynthesis light reactions\"."
},
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"subjectSlug": {
"type": "string",
"description": "Optional: restrict the search to one subject."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Search Fiveable content",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns a small set of Fiveable study-guide passages relevant to one question. Suitable for narrow explanations, research questions and checking student notes. One call consumes one full-content preview for a caller without existing access.
| Parameter | Type | Description |
|---|---|---|
| query * | string | The concept or question the student needs help with. |
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| guideSlug | string | Optional exact guide reference from get_subject_outline or search_content. |
| subjectSlug * | string | Fiveable subject slug, e.g. "ap-bio". A course name such as "AP Biology" also resolves. |
| maximumTokens * | integer | |
| maximumSections * | integer |
{
"name": "get_content_sections",
"title": "Get relevant study guide sections",
"description": "Returns a small set of Fiveable study-guide passages relevant to one question. Suitable for narrow explanations, research questions and checking student notes. One call consumes one full-content preview for a caller without existing access.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"query",
"maximumSections",
"maximumTokens"
],
"properties": {
"query": {
"type": "string",
"minLength": 2,
"description": "The concept or question the student needs help with."
},
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"guideSlug": {
"type": "string",
"description": "Optional exact guide reference from get_subject_outline or search_content."
},
"subjectSlug": {
"type": "string",
"minLength": 2,
"description": "Fiveable subject slug, e.g. \"ap-bio\". A course name such as \"AP Biology\" also resolves."
},
"maximumTokens": {
"type": "integer",
"default": 1800,
"maximum": 4000,
"minimum": 250
},
"maximumSections": {
"type": "integer",
"default": 3,
"maximum": 5,
"minimum": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get relevant study guide sections",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Lists Fiveable's free-response (FRQ) practice prompts for an AP subject, optionally filtered by FRQ type, unit, and excluded IDs. Results use stable ID order; unchanged filters continue pagination. Returns prompt ids and summaries rather than full prompts. Cheap.
| Parameter | Type | Description |
|---|---|---|
| limit * | integer | Maximum prompts to list. |
| cursor | string | |
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| unitId | string | Unit ID or public unit slug from get_subject_outline. |
| frqType | string | Optional FRQ type filter, e.g. "DBQ", "LEQ", "SAQ". Varies by subject. |
| excludeIds | array | |
| subjectSlug * | string | Fiveable subject slug, e.g. "ap-bio". A course name such as "AP Biology" also resolves. |
| courseVariant | string | AP Calculus only (subject ap-calc): 'ab' hides BC-only units, topics and FRQs; 'bc' includes them. Pass the course of the class or assignment draft you are building for ('ab' for ap-calc-ab, 'bc' for ap-calc-bc). |
{
"name": "list_frqs",
"title": "List free-response questions",
"description": "Lists Fiveable's free-response (FRQ) practice prompts for an AP subject, optionally filtered by FRQ type, unit, and excluded IDs. Results use stable ID order; unchanged filters continue pagination. Returns prompt ids and summaries rather than full prompts. Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"limit"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "Maximum prompts to list."
},
"cursor": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,512}$"
},
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"unitId": {
"type": "string",
"maxLength": 100,
"description": "Unit ID or public unit slug from get_subject_outline."
},
"frqType": {
"type": "string",
"description": "Optional FRQ type filter, e.g. \"DBQ\", \"LEQ\", \"SAQ\". Varies by subject."
},
"excludeIds": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 100
},
"subjectSlug": {
"type": "string",
"minLength": 2,
"description": "Fiveable subject slug, e.g. \"ap-bio\". A course name such as \"AP Biology\" also resolves."
},
"courseVariant": {
"enum": [
"ab",
"bc"
],
"type": "string",
"description": "AP Calculus only (subject ap-calc): 'ab' hides BC-only units, topics and FRQs; 'bc' includes them. Pass the course of the class or assignment draft you are building for ('ab' for ap-calc-ab, 'bc' for ap-calc-bc)."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List free-response questions",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns one full, original Fiveable FRQ prompt: stimulus, background and every lettered part with its point value. The returned prompt is eligible for Fiveable's saved scoring workflow after the student writes a response. It consumes one full-content preview unless existing access covers this FRQ. Moderate cost — 1-4k tokens.
| Parameter | Type | Description |
|---|---|---|
| frqId * | string | FRQ id from list_frqs. |
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
{
"name": "get_frq",
"title": "Get a free-response question",
"description": "Returns one full, original Fiveable FRQ prompt: stimulus, background and every lettered part with its point value. The returned prompt is eligible for Fiveable's saved scoring workflow after the student writes a response. It consumes one full-content preview unless existing access covers this FRQ. Moderate cost — 1-4k tokens.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"frqId"
],
"properties": {
"frqId": {
"type": "string",
"minLength": 1,
"description": "FRQ id from list_frqs."
},
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get a free-response question",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Find Fiveable exam formats, access requirements and website links without questions or answer keys. Choose a subject for version choices; add unitNumber to verify that unit's current bank and standard format.
| Parameter | Type | Description |
|---|---|---|
| unitNumber | integer | |
| subjectSlug | string |
{
"name": "get_exam_options",
"title": "Find practice exams and unit tests",
"description": "Find Fiveable exam formats, access requirements and website links without questions or answer keys. Choose a subject for version choices; add unitNumber to verify that unit's current bank and standard format.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"unitNumber": {
"type": "integer",
"maximum": 99,
"minimum": 1
},
"subjectSlug": {
"type": "string",
"pattern": "^[a-z0-9-]+$",
"maxLength": 100
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Find practice exams and unit tests",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Find approved Fiveable course and unit PDFs, including course variants, academic year when known, source links and readable-artifact readiness. Does not include user galleries or generated personal visuals.
| Parameter | Type | Description |
|---|---|---|
| limit * | integer | |
| cursor | string | |
| unitNumber | integer | |
| subjectSlug | string | |
| courseVariant | string |
{
"name": "list_cheatsheets",
"title": "List official Fiveable cheatsheets",
"description": "Find approved Fiveable course and unit PDFs, including course variants, academic year when known, source links and readable-artifact readiness. Does not include user galleries or generated personal visuals.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"limit"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1
},
"cursor": {
"type": "string",
"pattern": "^cs_[a-f0-9]{24}$"
},
"unitNumber": {
"type": "integer",
"maximum": 30,
"minimum": 0
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"courseVariant": {
"type": "string",
"maxLength": 100,
"minLength": 2
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List official Fiveable cheatsheets",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Reads bounded pages from a prepared official Fiveable PDF, returning page citations, extracted text and actual page images for formulas and diagrams. Image-only pages have no guessed transcription. Unavailable artifacts return the approved PDF link. This read never starts processing.
| Parameter | Type | Description |
|---|---|---|
| page * | integer | |
| limit * | integer | |
| cheatsheetId * | string |
{
"name": "get_cheatsheet",
"title": "Read an official Fiveable cheatsheet",
"description": "Reads bounded pages from a prepared official Fiveable PDF, returning page citations, extracted text and actual page images for formulas and diagrams. Image-only pages have no guessed transcription. Unavailable artifacts return the approved PDF link. This read never starts processing.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"cheatsheetId",
"page",
"limit"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 32,
"minimum": 1
},
"limit": {
"type": "integer",
"default": 1,
"maximum": 3,
"minimum": 1
},
"cheatsheetId": {
"type": "string",
"pattern": "^cs_[a-f0-9]{24}$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Read an official Fiveable cheatsheet",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Submits a caller-requested content issue to Fiveable support, which may lead to support follow-up. Requires explicit confirmReport approval. The description contains the reported issue only, excluding conversation history, unrelated notes and personal information. Fiveable resolves content and reporter identity. Matching requestId retries are idempotent.
| Parameter | Type | Description |
|---|---|---|
| contentId * | string | Exact guide/question/FRQ ID, or the exact canonical key-term path from Fiveable. |
| requestId * | string | |
| contentType * | string | one of ["studyGuide","keyTerm","practiceQuestion","frq"] |
| description * | string | Only the issue the student wants reported; no conversation transcript or unrelated personal notes. |
| confirmReport * | boolean | True only after the student explicitly requests sending this issue to Fiveable. |
{
"name": "report_content_issue",
"title": "Report a content issue to Fiveable",
"description": "Submits a caller-requested content issue to Fiveable support, which may lead to support follow-up. Requires explicit confirmReport approval. The description contains the reported issue only, excluding conversation history, unrelated notes and personal information. Fiveable resolves content and reporter identity. Matching requestId retries are idempotent.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contentType",
"contentId",
"description",
"requestId",
"confirmReport"
],
"properties": {
"contentId": {
"type": "string",
"maxLength": 250,
"minLength": 2,
"description": "Exact guide/question/FRQ ID, or the exact canonical key-term path from Fiveable."
},
"requestId": {
"type": "string",
"pattern": "^[\\w-]{8,128}$"
},
"contentType": {
"enum": [
"studyGuide",
"keyTerm",
"practiceQuestion",
"frq"
],
"type": "string"
},
"description": {
"type": "string",
"maxLength": 2000,
"minLength": 10,
"description": "Only the issue the student wants reported; no conversation transcript or unrelated personal notes."
},
"confirmReport": {
"type": "boolean",
"const": true,
"description": "True only after the student explicitly requests sending this issue to Fiveable."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Report a content issue to Fiveable",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Creates one or more classes in the teacher's workspace. Students join through an assignment's class link or a teacher-managed roster; there are no class codes. Created classes can be archived.
| Parameter | Type | Description |
|---|---|---|
| classes * | array | |
| requestId * | string | A unique id you generate for this action. Reuse it only when retrying the same action. |
{
"name": "create_classes",
"title": "Create classes",
"description": "Creates one or more classes in the teacher's workspace. Students join through an assignment's class link or a teacher-managed roster; there are no class codes. Created classes can be archived.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"classes",
"requestId"
],
"properties": {
"classes": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"subjectSlug"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "e.g. \"Period 3 APUSH\"."
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Subject, e.g. apush or ap-bio."
},
"courseVariant": {
"enum": [
"ap-calc-ab",
"ap-calc-bc"
],
"type": "string",
"description": "AP Calculus only: ap-calc-ab or ap-calc-bc."
}
},
"additionalProperties": false
},
"maxItems": 8,
"minItems": 1
},
"requestId": {
"type": "string",
"pattern": "^[\\w-]{8,128}$",
"description": "A unique id you generate for this action. Reuse it only when retrying the same action."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Create classes",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Renames a class, changes its subject, or sets an AP Calculus class's course (AB or BC). Returns the previous values for reversal through a subsequent class update.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| classId * | string | Class id from list_classes. |
| subjectSlug | string | |
| courseVariant | string | AP Calculus only: ap-calc-ab or ap-calc-bc. |
{
"name": "update_class",
"title": "Update class",
"description": "Renames a class, changes its subject, or sets an AP Calculus class's course (AB or BC). Returns the previous values for reversal through a subsequent class update.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"classId"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"classId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Class id from list_classes."
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"courseVariant": {
"enum": [
"ap-calc-ab",
"ap-calc-bc"
],
"type": "string",
"description": "AP Calculus only: ap-calc-ab or ap-calc-bc."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Update class",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Archives a class the teacher created (it leaves the class list; nothing is deleted), or restores an archived one with archived: false. Co-taught classes can only be archived by their owner.
| Parameter | Type | Description |
|---|---|---|
| classId * | string | Class id from list_classes. |
| archived * | boolean | false restores an archived class. |
{
"name": "archive_class",
"title": "Archive or restore class",
"description": "Archives a class the teacher created (it leaves the class list; nothing is deleted), or restores an archived one with archived: false. Co-taught classes can only be archived by their owner.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"classId",
"archived"
],
"properties": {
"classId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Class id from list_classes."
},
"archived": {
"type": "boolean",
"default": true,
"description": "false restores an archived class."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Archive or restore class",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Sets a class's assignment defaults (scoring mode, timer, attempts, result release, notifications) so new assignments for that class start with them. Replaces the previous defaults and returns them for undo.
| Parameter | Type | Description |
|---|---|---|
| classId * | string | Class id from list_classes. |
| defaults * | object | The class's new defaults; unset fields fall back to Fiveable's. |
{
"name": "set_class_assignment_defaults",
"title": "Set class assignment defaults",
"description": "Sets a class's assignment defaults (scoring mode, timer, attempts, result release, notifications) so new assignments for that class start with them. Replaces the previous defaults and returns them for undo.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"classId",
"defaults"
],
"properties": {
"classId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Class id from list_classes."
},
"defaults": {
"type": "object",
"properties": {
"timerMode": {
"enum": [
"strict",
"flexible",
"none"
],
"type": "string"
},
"maxAttempts": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"scoringMode": {
"enum": [
"ai",
"self",
"teacher"
],
"type": "string",
"description": "Who scores free responses."
},
"notifications": {
"type": "object",
"properties": {
"onPublish": {
"type": "boolean"
},
"dueReminder": {
"type": "boolean"
},
"onResultsRelease": {
"type": "boolean"
}
},
"additionalProperties": false
},
"resultRelease": {
"enum": [
"immediate",
"manual",
"scheduled"
],
"type": "string",
"description": "When students see results."
},
"durationMinutes": {
"anyOf": [
{
"type": "integer",
"maximum": 300,
"minimum": 1
},
{
"type": "null"
}
]
}
},
"description": "The class's new defaults; unset fields fall back to Fiveable's.",
"additionalProperties": false
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Set class assignment defaults",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Adds students to a class roster from individual entries with names in First Last order and optional emails. Existing roster students are matched rather than duplicated. Emails support assignment notifications and are never returned. Roster additions can be removed.
| Parameter | Type | Description |
|---|---|---|
| classId * | string | Class id from list_classes. |
| students * | array |
{
"name": "add_students",
"title": "Add students",
"description": "Adds students to a class roster from individual entries with names in First Last order and optional emails. Existing roster students are matched rather than duplicated. Emails support assignment notifications and are never returned. Roster additions can be removed.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"classId",
"students"
],
"properties": {
"classId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Class id from list_classes."
},
"students": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "First Last."
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254
}
},
"additionalProperties": false
},
"maxItems": 200,
"minItems": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Add students",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Fixes a student's name on a class roster (the old name is kept as an alias so past work still matches), or sets the email used for assignment notifications. Students with Fiveable accounts can be renamed but their email comes from their account.
| Parameter | Type | Description |
|---|---|---|
| name | string | Full name as the teacher wants it shown. |
| string | ||
| handle * | string | Student handle from get_class, e.g. S-4f2a1c. |
| classId * | string | Class id from list_classes. |
{
"name": "update_student",
"title": "Update student",
"description": "Fixes a student's name on a class roster (the old name is kept as an alias so past work still matches), or sets the email used for assignment notifications. Students with Fiveable accounts can be renamed but their email comes from their account.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"classId",
"handle"
],
"properties": {
"name": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Full name as the teacher wants it shown."
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254
},
"handle": {
"type": "string",
"pattern": "^S-[a-f0-9]{6}$",
"description": "Student handle from get_class, e.g. S-4f2a1c."
},
"classId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Class id from list_classes."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Update student",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Removes students by handle from a class roster while preserving their past work in the teacher's results. Returns an undoId valid for exact restoration within seven days.
| Parameter | Type | Description |
|---|---|---|
| classId * | string | Class id from list_classes. |
| handles * | array |
{
"name": "remove_students",
"title": "Remove students",
"description": "Removes students by handle from a class roster while preserving their past work in the teacher's results. Returns an undoId valid for exact restoration within seven days.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"classId",
"handles"
],
"properties": {
"classId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Class id from list_classes."
},
"handles": {
"type": "array",
"items": {
"type": "string",
"pattern": "^S-[a-f0-9]{6}$",
"description": "Student handle from get_class, e.g. S-4f2a1c."
},
"maxItems": 200,
"minItems": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Remove students",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Restores removed roster students using a valid undoId, preserving their original roster entries.
| Parameter | Type | Description |
|---|---|---|
| undoId * | string | undoId from remove_students. |
{
"name": "restore_students",
"title": "Restore removed students",
"description": "Restores removed roster students using a valid undoId, preserving their original roster entries.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"undoId"
],
"properties": {
"undoId": {
"type": "string",
"pattern": "^undo_[\\w-]{8,40}$",
"description": "undoId from remove_students."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Restore removed students",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| dueAt | string | Default due time for every class. |
| title * | string | |
| classes | array | Classes to target, each with an optional due date. |
| sections * | array | |
| settings | object | |
| requestId * | string | A unique id you generate for this action. Reuse it only when retrying the same action. |
| availableAt | string | When it opens, ISO with offset. |
| subjectSlug * | string | Subject, e.g. apush or ap-bio. |
| instructions | string | |
| courseVariant | string | AP Calculus only: ap-calc-ab or ap-calc-bc. Omit to use the course the target classes share. |
| resultRelease | string | When students see results. |
{
"name": "create_assignment_draft",
"title": "Create assignment draft",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"title",
"subjectSlug",
"sections",
"requestId"
],
"properties": {
"dueAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\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)))$",
"description": "Default due time for every class."
},
"title": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"classes": {
"type": "array",
"items": {
"type": "object",
"required": [
"classId"
],
"properties": {
"dueAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\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)))$",
"description": "ISO date-time with timezone offset."
},
"classId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Class id from list_classes."
}
},
"additionalProperties": false
},
"maxItems": 12,
"description": "Classes to target, each with an optional due date."
},
"sections": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"style",
"avoidRepeats"
],
"properties": {
"type": {
"type": "string",
"const": "multiple_choice"
},
"style": {
"enum": [
"exam",
"comprehension",
"vocabulary"
],
"type": "string",
"default": "exam",
"description": "exam = AP-style (with stimulus sets where the exam has them); comprehension or vocabulary checks."
},
"units": {
"type": "array",
"items": {
"type": "object",
"required": [
"unitId"
],
"properties": {
"unitId": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "null"
}
],
"description": "Unit id from get_subject_outline; null = whole course."
},
"topicIds": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 60,
"description": "Topic ids to narrow to."
},
"questionCount": {
"type": "integer",
"maximum": 100,
"minimum": 0,
"description": "Omit to split the total evenly."
}
},
"additionalProperties": false
},
"maxItems": 20,
"description": "Units to draw questions from. Omit when only using questionIds."
},
"skillId": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
],
"description": "Optional CED skill id to narrow to."
},
"questionIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(mcq:)?[\\w-]+$"
},
"maxItems": 100,
"minItems": 1,
"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."
},
"avoidRepeats": {
"type": "boolean",
"default": true,
"description": "When drawing from units, skip questions this teacher already published."
},
"questionCount": {
"type": "integer",
"maximum": 100,
"minimum": 0,
"description": "Questions to draw from units, on top of any questionIds. Omit when only using questionIds."
},
"timeLimitMinutes": {
"anyOf": [
{
"type": "integer",
"maximum": 300,
"minimum": 1
},
{
"type": "null"
}
],
"description": "Omit for untimed."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"questionId"
],
"properties": {
"type": {
"type": "string",
"const": "free_response"
},
"focus": {
"type": "string",
"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."
},
"parts": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z]$"
},
"maxItems": 12,
"minItems": 1,
"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."
},
"questionId": {
"type": "string",
"pattern": "^frq:[\\w-]+$|^saq:[\\w-]+(:[A-Za-z])?$",
"description": "An frq: or saq: id from search_question_bank."
},
"rubricPoints": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Da-d][1-3]?$"
},
"maxItems": 7,
"minItems": 1,
"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."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"resourceId",
"readingQuestions"
],
"properties": {
"type": {
"type": "string",
"const": "reading"
},
"resourceId": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "A resource id from list_teaching_resources."
},
"readingQuestions": {
"type": "boolean",
"default": false,
"description": "Add reading-check questions (study guides and AMSCO guided notes)."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"unitIds"
],
"properties": {
"type": {
"type": "string",
"const": "diagnostic"
},
"unitIds": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 15,
"minItems": 1,
"description": "Unit ids from get_subject_outline."
},
"unitLabels": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 15
}
},
"additionalProperties": false
}
]
},
"maxItems": 20,
"minItems": 1
},
"settings": {
"type": "object",
"properties": {
"timerMode": {
"enum": [
"strict",
"flexible",
"none"
],
"type": "string"
},
"maxAttempts": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"scoringMode": {
"enum": [
"ai",
"self",
"teacher"
],
"type": "string",
"description": "Who scores free responses."
},
"notifications": {
"type": "object",
"properties": {
"onPublish": {
"type": "boolean"
},
"dueReminder": {
"type": "boolean"
},
"onResultsRelease": {
"type": "boolean"
}
},
"additionalProperties": false
},
"resultRelease": {
"enum": [
"immediate",
"manual",
"scheduled"
],
"type": "string",
"description": "When students see results."
},
"durationMinutes": {
"anyOf": [
{
"type": "integer",
"maximum": 300,
"minimum": 1
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"requestId": {
"type": "string",
"pattern": "^[\\w-]{8,128}$",
"description": "A unique id you generate for this action. Reuse it only when retrying the same action."
},
"availableAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\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)))$",
"description": "When it opens, ISO with offset."
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Subject, e.g. apush or ap-bio."
},
"instructions": {
"type": "string",
"maxLength": 5000
},
"courseVariant": {
"enum": [
"ap-calc-ab",
"ap-calc-bc"
],
"type": "string",
"description": "AP Calculus only: ap-calc-ab or ap-calc-bc. Omit to use the course the target classes share."
},
"resultRelease": {
"enum": [
"immediate",
"manual",
"scheduled"
],
"type": "string",
"description": "When students see results."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Create assignment draft",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Changes a draft's title, instructions, AP Calculus course, classes, dates, settings or sections. Existing section ids identify sections to remove. Published assignments cannot be changed here. Returns an undoId for restoring the previous draft.
| Parameter | Type | Description |
|---|---|---|
| dueAt | string | Default due time for every class. |
| title | string | |
| classes | array | Replaces the class targets. |
| settings | object | Merged into the current settings. |
| addSections | array | |
| availableAt | string | When it opens, ISO with offset. |
| assignmentId * | string | |
| instructions | string | |
| courseVariant | string | AP Calculus only: switch the draft to ap-calc-ab or ap-calc-bc. Its multiple choice, free-response and diagnostic sections must be removed in the same call (add new ones there too); readings stay. |
| resultRelease | string | When students see results. |
| removeSectionIds | array |
{
"name": "update_assignment_draft",
"title": "Update assignment draft",
"description": "Changes a draft's title, instructions, AP Calculus course, classes, dates, settings or sections. Existing section ids identify sections to remove. Published assignments cannot be changed here. Returns an undoId for restoring the previous draft.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"assignmentId"
],
"properties": {
"dueAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\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)))$",
"description": "Default due time for every class."
},
"title": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"classes": {
"type": "array",
"items": {
"type": "object",
"required": [
"classId"
],
"properties": {
"dueAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\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)))$",
"description": "ISO date-time with timezone offset."
},
"classId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Class id from list_classes."
}
},
"additionalProperties": false
},
"maxItems": 12,
"minItems": 1,
"description": "Replaces the class targets."
},
"settings": {
"type": "object",
"properties": {
"timerMode": {
"enum": [
"strict",
"flexible",
"none"
],
"type": "string"
},
"maxAttempts": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"scoringMode": {
"enum": [
"ai",
"self",
"teacher"
],
"type": "string",
"description": "Who scores free responses."
},
"notifications": {
"type": "object",
"properties": {
"onPublish": {
"type": "boolean"
},
"dueReminder": {
"type": "boolean"
},
"onResultsRelease": {
"type": "boolean"
}
},
"additionalProperties": false
},
"resultRelease": {
"enum": [
"immediate",
"manual",
"scheduled"
],
"type": "string",
"description": "When students see results."
},
"durationMinutes": {
"anyOf": [
{
"type": "integer",
"maximum": 300,
"minimum": 1
},
{
"type": "null"
}
]
}
},
"description": "Merged into the current settings.",
"additionalProperties": false
},
"addSections": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"style",
"avoidRepeats"
],
"properties": {
"type": {
"type": "string",
"const": "multiple_choice"
},
"style": {
"enum": [
"exam",
"comprehension",
"vocabulary"
],
"type": "string",
"default": "exam",
"description": "exam = AP-style (with stimulus sets where the exam has them); comprehension or vocabulary checks."
},
"units": {
"type": "array",
"items": {
"type": "object",
"required": [
"unitId"
],
"properties": {
"unitId": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "null"
}
],
"description": "Unit id from get_subject_outline; null = whole course."
},
"topicIds": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 60,
"description": "Topic ids to narrow to."
},
"questionCount": {
"type": "integer",
"maximum": 100,
"minimum": 0,
"description": "Omit to split the total evenly."
}
},
"additionalProperties": false
},
"maxItems": 20,
"description": "Units to draw questions from. Omit when only using questionIds."
},
"skillId": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
],
"description": "Optional CED skill id to narrow to."
},
"questionIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(mcq:)?[\\w-]+$"
},
"maxItems": 100,
"minItems": 1,
"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."
},
"avoidRepeats": {
"type": "boolean",
"default": true,
"description": "When drawing from units, skip questions this teacher already published."
},
"questionCount": {
"type": "integer",
"maximum": 100,
"minimum": 0,
"description": "Questions to draw from units, on top of any questionIds. Omit when only using questionIds."
},
"timeLimitMinutes": {
"anyOf": [
{
"type": "integer",
"maximum": 300,
"minimum": 1
},
{
"type": "null"
}
],
"description": "Omit for untimed."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"questionId"
],
"properties": {
"type": {
"type": "string",
"const": "free_response"
},
"focus": {
"type": "string",
"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."
},
"parts": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z]$"
},
"maxItems": 12,
"minItems": 1,
"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."
},
"questionId": {
"type": "string",
"pattern": "^frq:[\\w-]+$|^saq:[\\w-]+(:[A-Za-z])?$",
"description": "An frq: or saq: id from search_question_bank."
},
"rubricPoints": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Da-d][1-3]?$"
},
"maxItems": 7,
"minItems": 1,
"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."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"resourceId",
"readingQuestions"
],
"properties": {
"type": {
"type": "string",
"const": "reading"
},
"resourceId": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "A resource id from list_teaching_resources."
},
"readingQuestions": {
"type": "boolean",
"default": false,
"description": "Add reading-check questions (study guides and AMSCO guided notes)."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"unitIds"
],
"properties": {
"type": {
"type": "string",
"const": "diagnostic"
},
"unitIds": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 15,
"minItems": 1,
"description": "Unit ids from get_subject_outline."
},
"unitLabels": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 15
}
},
"additionalProperties": false
}
]
},
"maxItems": 20
},
"availableAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\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)))$",
"description": "When it opens, ISO with offset."
},
"assignmentId": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"instructions": {
"type": "string",
"maxLength": 5000
},
"courseVariant": {
"enum": [
"ap-calc-ab",
"ap-calc-bc"
],
"type": "string",
"description": "AP Calculus only: switch the draft to ap-calc-ab or ap-calc-bc. Its multiple choice, free-response and diagnostic sections must be removed in the same call (add new ones there too); readings stay."
},
"resultRelease": {
"enum": [
"immediate",
"manual",
"scheduled"
],
"type": "string",
"description": "When students see results."
},
"removeSectionIds": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 20
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Update assignment draft",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Restores an assignment draft to its previous state using an undoId from a draft update.
| Parameter | Type | Description |
|---|---|---|
| undoId * | string | undoId from update_assignment_draft. |
{
"name": "restore_assignment_draft",
"title": "Restore assignment draft",
"description": "Restores an assignment draft to its previous state using an undoId from a draft update.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"undoId"
],
"properties": {
"undoId": {
"type": "string",
"pattern": "^undo_[\\w-]{8,40}$",
"description": "undoId from update_assignment_draft."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Restore assignment draft",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Lists assignment reading resources for one subject: study guides, unit reviews, AMSCO guided notes, key terms and cheatsheets, with resource ids suitable for reading sections. Optional filters cover kind, unit and words. Cheap.
| Parameter | Type | Description |
|---|---|---|
| kind | string | one of ["study-guide","unit-review","guided-notes","key-terms","cheatsheet","visual-cheatsheet"] |
| unit | string | Exact unit label from the result's unit list. |
| limit * | integer | |
| query | string | |
| offset * | integer | |
| subjectSlug * | string |
{
"name": "list_teaching_resources",
"title": "List teaching resources",
"description": "Lists assignment reading resources for one subject: study guides, unit reviews, AMSCO guided notes, key terms and cheatsheets, with resource ids suitable for reading sections. Optional filters cover kind, unit and words. Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"offset",
"limit"
],
"properties": {
"kind": {
"enum": [
"study-guide",
"unit-review",
"guided-notes",
"key-terms",
"cheatsheet",
"visual-cheatsheet"
],
"type": "string"
},
"unit": {
"type": "string",
"maxLength": 200,
"description": "Exact unit label from the result's unit list."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 200
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List teaching resources",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Copies a teacher-owned assignment, including archived or prior-year work, into a new draft with the same questions and settings. The resulting draft can be retargeted or archived.
| Parameter | Type | Description |
|---|---|---|
| requestId * | string | A unique id you generate for this action. Reuse it only when retrying the same action. |
| assignmentId * | string | Assignment id from list_coursework. |
{
"name": "duplicate_assignment",
"title": "Duplicate assignment",
"description": "Copies a teacher-owned assignment, including archived or prior-year work, into a new draft with the same questions and settings. The resulting draft can be retargeted or archived.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"assignmentId",
"requestId"
],
"properties": {
"requestId": {
"type": "string",
"pattern": "^[\\w-]{8,128}$",
"description": "A unique id you generate for this action. Reuse it only when retrying the same action."
},
"assignmentId": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Assignment id from list_coursework."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Duplicate assignment",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Archives an unpublished draft (it leaves the coursework list; nothing is deleted) or restores an archived draft with archived: false. Published assignments are archived on the website.
| Parameter | Type | Description |
|---|---|---|
| archived * | boolean | false restores an archived draft. |
| assignmentId * | string | Assignment id from list_coursework. |
{
"name": "archive_assignment",
"title": "Archive or restore draft",
"description": "Archives an unpublished draft (it leaves the coursework list; nothing is deleted) or restores an archived draft with archived: false. Published assignments are archived on the website.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"assignmentId",
"archived"
],
"properties": {
"archived": {
"type": "boolean",
"default": true,
"description": "false restores an archived draft."
},
"assignmentId": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Assignment id from list_coursework."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Archive or restore draft",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}What a student will see when they open the assignment: instructions and each section in order. Answers are hidden, as they are for students. Diagnostics can't be previewed. Cheap.
| Parameter | Type | Description |
|---|---|---|
| assignmentId * | string | Assignment id from list_coursework. |
{
"name": "preview_assignment_as_student",
"title": "Preview assignment as a student",
"description": "What a student will see when they open the assignment: instructions and each section in order. Answers are hidden, as they are for students. Diagnostics can't be previewed. Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"assignmentId"
],
"properties": {
"assignmentId": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Assignment id from list_coursework."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Preview assignment as a student",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}The teacher's grading sessions for work done outside Fiveable (stacks of essays graded in the workspace), newest first, with essay, scored and approved counts. Use to resume a stack. Cheap.
| Parameter | Type | Description |
|---|---|---|
| limit * | integer |
{
"name": "list_grading_sessions",
"title": "List grading sessions",
"description": "The teacher's grading sessions for work done outside Fiveable (stacks of essays graded in the workspace), newest first, with essay, scored and approved counts. Use to resume a stack. Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"limit"
],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List grading sessions",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Creates a workspace grading session for finished student work, including paper, Google Docs or an AP Classroom export. Accepts a Fiveable FRQ or SAQ id, or the teacher's own question in prompt. A session uses an included assignment when grading starts unless the account has unlimited assignments. Returns the new session id.
| Parameter | Type | Description |
|---|---|---|
| title | string | |
| prompt | object | The teacher's own question, when not a Fiveable one. |
| requestId * | string | A unique id you generate for this action. Reuse it only when retrying the same action. |
| subjectSlug * | string | e.g. apush or ap-bio. |
| fiveableQuestionId | string | frq:… or saq:… from search_question_bank, or frq: plus the FRQ id from get_frq. |
{
"name": "create_grading_session",
"title": "Create grading session",
"description": "Creates a workspace grading session for finished student work, including paper, Google Docs or an AP Classroom export. Accepts a Fiveable FRQ or SAQ id, or the teacher's own question in prompt. A session uses an included assignment when grading starts unless the account has unlimited assignments. Returns the new session id.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"requestId"
],
"properties": {
"title": {
"type": "string",
"maxLength": 200
},
"prompt": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 20000,
"minLength": 20,
"description": "The question exactly as the teacher assigned it."
},
"images": {
"type": "array",
"items": {
"type": "object",
"required": [
"data",
"mediaType"
],
"properties": {
"data": {
"type": "string",
"maxLength": 6000000,
"minLength": 1,
"description": "Base64 image, no data: prefix."
},
"mediaType": {
"enum": [
"image/jpeg",
"image/png",
"image/webp"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 4,
"description": "Visuals the question depends on."
},
"frqType": {
"type": "string",
"maxLength": 120,
"description": "Question type as Fiveable names it, e.g. \"Long Essay Question (LEQ)\". Omit to get the list."
}
},
"description": "The teacher's own question, when not a Fiveable one.",
"additionalProperties": false
},
"requestId": {
"type": "string",
"pattern": "^[\\w-]{8,128}$",
"description": "A unique id you generate for this action. Reuse it only when retrying the same action."
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "e.g. apush or ap-bio."
},
"fiveableQuestionId": {
"type": "string",
"maxLength": 120,
"description": "frq:… or saq:… from search_question_bank, or frq: plus the FRQ id from get_frq."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Create grading session",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Returns the session's Fiveable scoring guidelines point by point on the AP rubric for its question type. If absent, starts rubric generation and returns pending status; generation takes about a minute. Rubrics use the website's grading pipeline. Cheap once written.
| Parameter | Type | Description |
|---|---|---|
| sessionId * | string | Grading session id from list_grading_sessions or create_grading_session. |
{
"name": "get_grading_rubric",
"title": "Get grading rubric",
"description": "Returns the session's Fiveable scoring guidelines point by point on the AP rubric for its question type. If absent, starts rubric generation and returns pending status; generation takes about a minute. Rubrics use the website's grading pipeline. Cheap once written.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sessionId"
],
"properties": {
"sessionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Grading session id from list_grading_sessions or create_grading_session."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get grading rubric",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Changes a session's Fiveable question or teacher-provided prompt and AP question type before any essay is scored. Regenerates the rubric using that type's AP rubric and point total. Returns the previous prompt for restoration.
| Parameter | Type | Description |
|---|---|---|
| prompt | object | |
| sessionId * | string | Grading session id from list_grading_sessions or create_grading_session. |
| fiveableQuestionId | string |
{
"name": "update_grading_rubric",
"title": "Change grading prompt",
"description": "Changes a session's Fiveable question or teacher-provided prompt and AP question type before any essay is scored. Regenerates the rubric using that type's AP rubric and point total. Returns the previous prompt for restoration.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sessionId"
],
"properties": {
"prompt": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 20000,
"minLength": 20,
"description": "The question exactly as the teacher assigned it."
},
"images": {
"type": "array",
"items": {
"type": "object",
"required": [
"data",
"mediaType"
],
"properties": {
"data": {
"type": "string",
"maxLength": 6000000,
"minLength": 1,
"description": "Base64 image, no data: prefix."
},
"mediaType": {
"enum": [
"image/jpeg",
"image/png",
"image/webp"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 4,
"description": "Visuals the question depends on."
},
"frqType": {
"type": "string",
"maxLength": 120,
"description": "Question type as Fiveable names it, e.g. \"Long Essay Question (LEQ)\". Omit to get the list."
}
},
"additionalProperties": false
},
"sessionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Grading session id from list_grading_sessions or create_grading_session."
},
"fiveableQuestionId": {
"type": "string",
"maxLength": 120
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Change grading prompt",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Adds individual student responses supplied as pasted, downloaded or transcribed text, with each student's name as written. Photo transcriptions require transcribedFromPhotos and explicit teacherConfirmedTranscription approval of the transcription. Returns counts only.
| Parameter | Type | Description |
|---|---|---|
| essays * | array | |
| sessionId * | string | Grading session id from list_grading_sessions or create_grading_session. |
| transcribedFromPhotos * | boolean | |
| teacherConfirmedTranscription * | boolean |
{
"name": "import_essays_from_text",
"title": "Import essays from text",
"description": "Adds individual student responses supplied as pasted, downloaded or transcribed text, with each student's name as written. Photo transcriptions require transcribedFromPhotos and explicit teacherConfirmedTranscription approval of the transcription. Returns counts only.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sessionId",
"essays",
"transcribedFromPhotos",
"teacherConfirmedTranscription"
],
"properties": {
"essays": {
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 60000,
"minLength": 1
},
"studentName": {
"type": "string",
"maxLength": 120,
"description": "As written on the work. Omit if unknown."
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"sessionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Grading session id from list_grading_sessions or create_grading_session."
},
"transcribedFromPhotos": {
"type": "boolean",
"default": false
},
"teacherConfirmedTranscription": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Import essays from text",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Splits teacher-supplied PDFs or Word stacks into one essay per student, including AP Classroom 'FRQ Response PDFs, By Student Page Break' exports. Photos support one essay per image and are read by Fiveable. Accepts up to three ChatGPT attached uploads of 25 MB each, or up to three base64 files totaling about 3 MB. Returns counts and warnings only. Long PDFs can take up to a minute.
| Parameter | Type | Description |
|---|---|---|
| files * | array | |
| uploads * | array | Files the teacher attached in ChatGPT, passed by reference. |
| sessionId * | string | Grading session id from list_grading_sessions or create_grading_session. |
{
"name": "import_essays_from_files",
"title": "Import essays from files",
"description": "Splits teacher-supplied PDFs or Word stacks into one essay per student, including AP Classroom 'FRQ Response PDFs, By Student Page Break' exports. Photos support one essay per image and are read by Fiveable. Accepts up to three ChatGPT attached uploads of 25 MB each, or up to three base64 files totaling about 3 MB. Returns counts and warnings only. Long PDFs can take up to a minute.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sessionId",
"files",
"uploads"
],
"properties": {
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"fileName",
"mediaType",
"dataBase64"
],
"properties": {
"fileName": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "e.g. application/pdf, image/jpeg."
},
"dataBase64": {
"type": "string",
"maxLength": 4200000,
"minLength": 1
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 3
},
"uploads": {
"type": "array",
"items": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"file_name": {
"type": "string",
"maxLength": 200
},
"mime_type": {
"type": "string",
"maxLength": 120
},
"download_url": {
"type": "string",
"maxLength": 4000,
"minLength": 1
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 3,
"description": "Files the teacher attached in ChatGPT, passed by reference."
},
"sessionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Grading session id from list_grading_sessions or create_grading_session."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Import essays from files",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Walks the teacher's Google Classroom: with no ids, their courses; with a course id, its assignments; with a course and assignment id, who turned it in, each with a handle (T-…) and a link to the turned-in file. Use it to grade typed work collected in Classroom. Needs the teacher's Google Classroom connection.
| Parameter | Type | Description |
|---|---|---|
| courseId | string | Id from list_google_classroom_work. |
| courseWorkId | string | Id from list_google_classroom_work. |
{
"name": "list_google_classroom_work",
"title": "List Google Classroom work",
"description": "Walks the teacher's Google Classroom: with no ids, their courses; with a course id, its assignments; with a course and assignment id, who turned it in, each with a handle (T-…) and a link to the turned-in file. Use it to grade typed work collected in Classroom. Needs the teacher's Google Classroom connection.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"courseId": {
"type": "string",
"pattern": "^[\\w-]{1,64}$",
"description": "Id from list_google_classroom_work."
},
"courseWorkId": {
"type": "string",
"pattern": "^[\\w-]{1,64}$",
"description": "Id from list_google_classroom_work."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List Google Classroom work",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Adds selected Google Classroom turn-in handles to a grading session. Reads authorized Google Docs directly; optional teacher-provided text supports other files or missing Google access. Names come from the Classroom roster. Existing session submissions are skipped. Records the source Classroom assignment for subsequent approved-grade export. Returns counts only.
| Parameter | Type | Description |
|---|---|---|
| turnIns * | array | |
| courseId * | string | Id from list_google_classroom_work. |
| sessionId * | string | Grading session id from list_grading_sessions or create_grading_session. |
| courseWorkId * | string | Id from list_google_classroom_work. |
{
"name": "import_essays_from_google_classroom",
"title": "Import essays from Google Classroom",
"description": "Adds selected Google Classroom turn-in handles to a grading session. Reads authorized Google Docs directly; optional teacher-provided text supports other files or missing Google access. Names come from the Classroom roster. Existing session submissions are skipped. Records the source Classroom assignment for subsequent approved-grade export. Returns counts only.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sessionId",
"courseId",
"courseWorkId",
"turnIns"
],
"properties": {
"turnIns": {
"type": "array",
"items": {
"type": "object",
"required": [
"handle"
],
"properties": {
"text": {
"type": "string",
"maxLength": 50000,
"minLength": 1,
"description": "Optional teacher-provided work. Omit to read the authorized Classroom file through Fiveable."
},
"handle": {
"type": "string",
"pattern": "^T-[a-f\\d]{6}$",
"description": "Turn-in handle from list_google_classroom_work."
}
},
"additionalProperties": false
},
"maxItems": 150,
"minItems": 1
},
"courseId": {
"type": "string",
"pattern": "^[\\w-]{1,64}$",
"description": "Id from list_google_classroom_work."
},
"sessionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Grading session id from list_grading_sessions or create_grading_session."
},
"courseWorkId": {
"type": "string",
"pattern": "^[\\w-]{1,64}$",
"description": "Id from list_google_classroom_work."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Import essays from Google Classroom",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Starts background AI grading for unscored essays on the session's Fiveable rubric, generating that rubric first if needed. Returns immediately with job status. retryFailed includes previously failed essays. Scores remain drafts until teacher approval.
| Parameter | Type | Description |
|---|---|---|
| requestId * | string | A unique id you generate for this action. Reuse it only when retrying the same action. |
| sessionId * | string | Grading session id from list_grading_sessions or create_grading_session. |
| retryFailed * | boolean |
{
"name": "start_grading",
"title": "Start grading",
"description": "Starts background AI grading for unscored essays on the session's Fiveable rubric, generating that rubric first if needed. Returns immediately with job status. retryFailed includes previously failed essays. Scores remain drafts until teacher approval.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sessionId",
"retryFailed",
"requestId"
],
"properties": {
"requestId": {
"type": "string",
"pattern": "^[\\w-]{8,128}$",
"description": "A unique id you generate for this action. Reuse it only when retrying the same action."
},
"sessionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Grading session id from list_grading_sessions or create_grading_session."
},
"retryFailed": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Start grading",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns grading counts (scored, remaining, failed and approved) and background-job status (running, done or stopped). Cheap.
| Parameter | Type | Description |
|---|---|---|
| sessionId * | string | Grading session id from list_grading_sessions or create_grading_session. |
{
"name": "get_grading_progress",
"title": "Get grading progress",
"description": "Returns grading counts (scored, remaining, failed and approved) and background-job status (running, done or stopped). Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sessionId"
],
"properties": {
"sessionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Grading session id from list_grading_sessions or create_grading_session."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get grading progress",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Class results for a grading session: average, score distribution, how the class did on each rubric part, common gaps, and a table of essays (handle, short name, score, status, what to check). Filter to the ones that need review, drafts, approved or failed. Scores marked AI draft aren't approved yet.
| Parameter | Type | Description |
|---|---|---|
| limit * | integer | |
| filter * | string | one of ["all","needs_review","draft","approved","failed"] |
| offset * | integer | |
| sessionId * | string | Grading session id from list_grading_sessions or create_grading_session. |
{
"name": "get_grading_results",
"title": "Get grading results",
"description": "Class results for a grading session: average, score distribution, how the class did on each rubric part, common gaps, and a table of essays (handle, short name, score, status, what to check). Filter to the ones that need review, drafts, approved or failed. Scores marked AI draft aren't approved yet.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sessionId",
"filter",
"offset",
"limit"
],
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"filter": {
"enum": [
"all",
"needs_review",
"draft",
"approved",
"failed"
],
"type": "string",
"default": "all"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0
},
"sessionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Grading session id from list_grading_sessions or create_grading_session."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get grading results",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Retries background AI grading for one essay whose scoring failed. Existing successful scores cannot be changed by this operation.
| Parameter | Type | Description |
|---|---|---|
| requestId * | string | A unique id you generate for this action. Reuse it only when retrying the same action. |
| sessionId * | string | Grading session id from list_grading_sessions or create_grading_session. |
| essayHandle * | string | Essay handle from get_grading_results, e.g. E-3b91c0. |
{
"name": "rescore_essay",
"title": "Retry a failed essay",
"description": "Retries background AI grading for one essay whose scoring failed. Existing successful scores cannot be changed by this operation.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sessionId",
"essayHandle",
"requestId"
],
"properties": {
"requestId": {
"type": "string",
"pattern": "^[\\w-]{8,128}$",
"description": "A unique id you generate for this action. Reuse it only when retrying the same action."
},
"sessionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Grading session id from list_grading_sessions or create_grading_session."
},
"essayHandle": {
"type": "string",
"pattern": "^E-[a-f0-9]{6}$",
"description": "Essay handle from get_grading_results, e.g. E-3b91c0."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Retry a failed essay",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}One essay's score and feedback part by part, what the teacher changed, and whether it's approved. Set includeText only when the teacher wants to read the response itself.
| Parameter | Type | Description |
|---|---|---|
| sessionId * | string | Grading session id from list_grading_sessions or create_grading_session. |
| essayHandle * | string | Essay handle from get_grading_results, e.g. E-3b91c0. |
| includeText * | boolean |
{
"name": "get_essay_feedback",
"title": "Get essay feedback",
"description": "One essay's score and feedback part by part, what the teacher changed, and whether it's approved. Set includeText only when the teacher wants to read the response itself.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sessionId",
"essayHandle",
"includeText"
],
"properties": {
"sessionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Grading session id from list_grading_sessions or create_grading_session."
},
"essayHandle": {
"type": "string",
"pattern": "^E-[a-f0-9]{6}$",
"description": "Essay handle from get_grading_results, e.g. E-3b91c0."
},
"includeText": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get essay feedback",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Changes the points on one rubric part of a scored essay, with the teacher's reason. The change is logged and the total recalculated, as on the website. Reversal restores the previous part points.
| Parameter | Type | Description |
|---|---|---|
| part * | string | Rubric part as shown in get_essay_feedback, e.g. "A" or "Thesis". |
| points * | number | |
| reason * | string | |
| sessionId * | string | Grading session id from list_grading_sessions or create_grading_session. |
| essayHandle * | string | Essay handle from get_grading_results, e.g. E-3b91c0. |
| reasonCategory * | string | one of ["evidence","reasoning","accuracy","rubric","teacher-judgment","other"] |
{
"name": "override_essay_score",
"title": "Adjust an essay score",
"description": "Changes the points on one rubric part of a scored essay, with the teacher's reason. The change is logged and the total recalculated, as on the website. Reversal restores the previous part points.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sessionId",
"essayHandle",
"part",
"points",
"reasonCategory",
"reason"
],
"properties": {
"part": {
"type": "string",
"maxLength": 20,
"minLength": 1,
"description": "Rubric part as shown in get_essay_feedback, e.g. \"A\" or \"Thesis\"."
},
"points": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"reason": {
"type": "string",
"default": "",
"maxLength": 2000
},
"sessionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Grading session id from list_grading_sessions or create_grading_session."
},
"essayHandle": {
"type": "string",
"pattern": "^E-[a-f0-9]{6}$",
"description": "Essay handle from get_grading_results, e.g. E-3b91c0."
},
"reasonCategory": {
"enum": [
"evidence",
"reasoning",
"accuracy",
"rubric",
"teacher-judgment",
"other"
],
"type": "string",
"default": "teacher-judgment"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Adjust an essay score",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Marks scored essays approved (the teacher stands behind the score), or unapproves them with approve: false. Accepts essay handles, or all: true for every scored essay not yet approved. Only approved essays go to Google Classroom. The same handles with approve: false reverse approval.
| Parameter | Type | Description |
|---|---|---|
| all * | boolean | |
| approve * | boolean | |
| sessionId * | string | Grading session id from list_grading_sessions or create_grading_session. |
| essayHandles | array |
{
"name": "approve_essays",
"title": "Approve essays",
"description": "Marks scored essays approved (the teacher stands behind the score), or unapproves them with approve: false. Accepts essay handles, or all: true for every scored essay not yet approved. Only approved essays go to Google Classroom. The same handles with approve: false reverse approval.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sessionId",
"all",
"approve"
],
"properties": {
"all": {
"type": "boolean",
"default": false
},
"approve": {
"type": "boolean",
"default": true
},
"sessionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Grading session id from list_grading_sessions or create_grading_session."
},
"essayHandles": {
"type": "array",
"items": {
"type": "string",
"pattern": "^E-[a-f0-9]{6}$",
"description": "Essay handle from get_grading_results, e.g. E-3b91c0."
},
"maxItems": 200
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Approve essays",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Links a grading session to a workspace class so results feed class insights. Exact roster-name matches link automatically; explicit essay-handle to student-handle matches resolve remaining essays. Returns unmatched essays. A null classId removes the class link.
| Parameter | Type | Description |
|---|---|---|
| classId * | any | Class id from list_classes, or null to unlink. |
| matches * | array | |
| sessionId * | string | Grading session id from list_grading_sessions or create_grading_session. |
{
"name": "link_grading_to_class",
"title": "Link grading to a class",
"description": "Links a grading session to a workspace class so results feed class insights. Exact roster-name matches link automatically; explicit essay-handle to student-handle matches resolve remaining essays. Returns unmatched essays. A null classId removes the class link.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sessionId",
"classId",
"matches"
],
"properties": {
"classId": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f\\d]{24}$"
},
{
"type": "null"
}
],
"description": "Class id from list_classes, or null to unlink."
},
"matches": {
"type": "array",
"items": {
"type": "object",
"required": [
"essayHandle",
"studentHandle"
],
"properties": {
"essayHandle": {
"type": "string",
"pattern": "^E-[a-f0-9]{6}$",
"description": "Essay handle from get_grading_results, e.g. E-3b91c0."
},
"studentHandle": {
"type": "string",
"pattern": "^S-[a-f0-9]{6}$"
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 200
},
"sessionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Grading session id from list_grading_sessions or create_grading_session."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Link grading to a class",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Creates a Google Sheet of the session's results in the teacher's own Drive (one row per student, scores by part, feedback links) and returns its link. The rows never pass through chat. Needs Google connected with Sheets access; otherwise returns the link to connect it.
| Parameter | Type | Description |
|---|---|---|
| sessionId * | string | Grading session id from list_grading_sessions or create_grading_session. |
{
"name": "export_grading_results",
"title": "Export grading results",
"description": "Creates a Google Sheet of the session's results in the teacher's own Drive (one row per student, scores by part, feedback links) and returns its link. The rows never pass through chat. Needs Google connected with Sheets access; otherwise returns the link to connect it.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sessionId"
],
"properties": {
"sessionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Grading session id from list_grading_sessions or create_grading_session."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Export grading results",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}The teacher's review queue, as on the website inbox: submissions whose free responses need a teacher score or a look at the AI score, imported essays awaiting approval, and assignments ready to hand back. Each row includes the identifiers and review operation for its item. Filter by subject or assignment. Cheap.
| Parameter | Type | Description |
|---|---|---|
| limit * | integer | |
| cursor | string | |
| filter * | string | one of ["all","review","handback"] |
| subjectSlug | string | |
| assignmentId | string | Assignment id from list_coursework or list_submissions_to_review. |
{
"name": "list_submissions_to_review",
"title": "List work to review",
"description": "The teacher's review queue, as on the website inbox: submissions whose free responses need a teacher score or a look at the AI score, imported essays awaiting approval, and assignments ready to hand back. Each row includes the identifiers and review operation for its item. Filter by subject or assignment. Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"filter",
"limit"
],
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 50,
"minimum": 1
},
"cursor": {
"type": "string",
"maxLength": 500
},
"filter": {
"enum": [
"all",
"review",
"handback"
],
"type": "string",
"default": "all"
},
"subjectSlug": {
"type": "string",
"maxLength": 100
},
"assignmentId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Assignment id from list_coursework or list_submissions_to_review."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List work to review",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}One student's submission on a Fiveable assignment: each section's AI and teacher scores, the FRQ rubric breakdown, overrides and feedback, and whether the student can see results yet. includeText requires that the teacher wants to read the student's responses; it also returns student drawings and handwritten pages as images.
| Parameter | Type | Description |
|---|---|---|
| includeText * | boolean | |
| assignmentId * | string | Assignment id from list_coursework or list_submissions_to_review. |
| submissionId * | string | Submission id from list_submissions_to_review. |
{
"name": "get_submission",
"title": "Get submission",
"description": "One student's submission on a Fiveable assignment: each section's AI and teacher scores, the FRQ rubric breakdown, overrides and feedback, and whether the student can see results yet. includeText requires that the teacher wants to read the student's responses; it also returns student drawings and handwritten pages as images.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"assignmentId",
"submissionId",
"includeText"
],
"properties": {
"includeText": {
"type": "boolean",
"default": false
},
"assignmentId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Assignment id from list_coursework or list_submissions_to_review."
},
"submissionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Submission id from list_submissions_to_review."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get submission",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Sets the teacher's score on sections of one submission (submission item ids), optionally with written feedback. Works in any scoring mode. Says whether the student sees it yet; to undo, set the sections back to the previous scores this returns.
| Parameter | Type | Description |
|---|---|---|
| itemScores * | array | |
| assignmentId * | string | Assignment id from list_coursework or list_submissions_to_review. |
| itemFeedback | array | |
| submissionId * | string | Submission id from list_submissions_to_review. |
| overallFeedback | string |
{
"name": "score_submission",
"title": "Score submission",
"description": "Sets the teacher's score on sections of one submission (submission item ids), optionally with written feedback. Works in any scoring mode. Says whether the student sees it yet; to undo, set the sections back to the previous scores this returns.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"assignmentId",
"submissionId",
"itemScores"
],
"properties": {
"itemScores": {
"type": "array",
"items": {
"type": "object",
"required": [
"itemId",
"points"
],
"properties": {
"itemId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"points": {
"type": "number",
"maximum": 500,
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 20,
"minItems": 1
},
"assignmentId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Assignment id from list_coursework or list_submissions_to_review."
},
"itemFeedback": {
"type": "array",
"items": {
"type": "object",
"required": [
"itemId",
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 10000
},
"itemId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"maxItems": 20
},
"submissionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Submission id from list_submissions_to_review."
},
"overallFeedback": {
"type": "string",
"maxLength": 10000
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Score submission",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Saves teacher-reviewed written feedback on one submission, overall or per section, without changing scores. Students see it once results are released, including immediately if already released. Returns previous text for restoration.
| Parameter | Type | Description |
|---|---|---|
| assignmentId * | string | Assignment id from list_coursework or list_submissions_to_review. |
| itemFeedback | array | |
| submissionId * | string | Submission id from list_submissions_to_review. |
| overallFeedback | string |
{
"name": "save_submission_feedback",
"title": "Save submission feedback",
"description": "Saves teacher-reviewed written feedback on one submission, overall or per section, without changing scores. Students see it once results are released, including immediately if already released. Returns previous text for restoration.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"assignmentId",
"submissionId"
],
"properties": {
"assignmentId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Assignment id from list_coursework or list_submissions_to_review."
},
"itemFeedback": {
"type": "array",
"items": {
"type": "object",
"required": [
"itemId",
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 10000
},
"itemId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"maxItems": 20
},
"submissionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Submission id from list_submissions_to_review."
},
"overallFeedback": {
"type": "string",
"maxLength": 10000
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Save submission feedback",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Changes the points on one rubric part of an AI-scored FRQ in a submission, with the teacher's reason, as on the website. The section's score is recalculated. Reversal restores the previous part points.
| Parameter | Type | Description |
|---|---|---|
| part * | string | |
| itemId * | string | |
| points * | number | |
| reason * | string | |
| assignmentId * | string | Assignment id from list_coursework or list_submissions_to_review. |
| submissionId * | string | Submission id from list_submissions_to_review. |
| reasonCategory * | string | one of ["evidence","reasoning","accuracy","rubric","teacher-judgment","other"] |
{
"name": "override_submission_part",
"title": "Adjust an FRQ part score",
"description": "Changes the points on one rubric part of an AI-scored FRQ in a submission, with the teacher's reason, as on the website. The section's score is recalculated. Reversal restores the previous part points.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"assignmentId",
"submissionId",
"itemId",
"part",
"points",
"reasonCategory",
"reason"
],
"properties": {
"part": {
"type": "string",
"maxLength": 20,
"minLength": 1
},
"itemId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"points": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"reason": {
"type": "string",
"default": "",
"maxLength": 2000
},
"assignmentId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Assignment id from list_coursework or list_submissions_to_review."
},
"submissionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Submission id from list_submissions_to_review."
},
"reasonCategory": {
"enum": [
"evidence",
"reasoning",
"accuracy",
"rubric",
"teacher-judgment",
"other"
],
"type": "string",
"default": "teacher-judgment"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Adjust an FRQ part score",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Creates an owner-bound confirmation preview for publishing a draft or republishing with new dates: classes, openings, due dates in the teacher's time zone, result visibility and student-facing changes. Publication remains unchanged. Execution requires approval of this specific preview. With no classes, anyoneWithLink must be true for a public link.
| Parameter | Type | Description |
|---|---|---|
| dueAt | string | Due time for the anyone-with-link publish. |
| classes * | array | |
| timeZone * | string | The teacher's IANA time zone, e.g. America/Chicago, so the preview shows their local times. |
| assignmentId * | string | Assignment id from list_coursework. |
| resultRelease | string | Defaults to the draft's setting. |
| anyoneWithLink * | boolean |
{
"name": "prepare_publish_assignment",
"title": "Preview publishing an assignment",
"description": "Creates an owner-bound confirmation preview for publishing a draft or republishing with new dates: classes, openings, due dates in the teacher's time zone, result visibility and student-facing changes. Publication remains unchanged. Execution requires approval of this specific preview. With no classes, anyoneWithLink must be true for a public link.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"assignmentId",
"classes",
"anyoneWithLink",
"timeZone"
],
"properties": {
"dueAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\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)))$",
"description": "Due time for the anyone-with-link publish."
},
"classes": {
"type": "array",
"items": {
"type": "object",
"required": [
"classId"
],
"properties": {
"dueAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\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)))$"
},
"classId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Class id from list_classes."
},
"opensAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\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)))$",
"description": "When students can start; omit for now."
},
"resultsReleaseAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\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)))$",
"description": "Only for scheduled release."
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 12
},
"timeZone": {
"type": "string",
"default": "America/New_York",
"maxLength": 64,
"description": "The teacher's IANA time zone, e.g. America/Chicago, so the preview shows their local times."
},
"assignmentId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Assignment id from list_coursework."
},
"resultRelease": {
"enum": [
"immediate",
"manual",
"scheduled"
],
"type": "string",
"description": "Defaults to the draft's setting."
},
"anyoneWithLink": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Preview publishing an assignment",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Publishes exactly the owner-bound preview identified by previewId, subject to explicit teacher approval of that specific preview. Returns each class's student link and a message to post.
| Parameter | Type | Description |
|---|---|---|
| previewId * | string | The previewId from the matching prepare_ tool, after the teacher said yes to that preview. |
{
"name": "confirm_publish_assignment",
"title": "Publish assignment",
"description": "Publishes exactly the owner-bound preview identified by previewId, subject to explicit teacher approval of that specific preview. Returns each class's student link and a message to post.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"previewId"
],
"properties": {
"previewId": {
"type": "string",
"maxLength": 200,
"minLength": 20,
"description": "The previewId from the matching prepare_ tool, after the teacher said yes to that preview."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Publish assignment",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Creates an owner-bound confirmation preview for closing or reopening a published assignment, or changing class open/due dates. Links and submissions remain intact. Publication remains unchanged until approved preview execution.
| Parameter | Type | Description |
|---|---|---|
| action * | string | one of ["close","reopen","change_dates"] |
| changes * | array | For change_dates only. |
| timeZone * | string | The teacher's IANA time zone, e.g. America/Chicago, so the preview shows their local times. |
| assignmentId * | string |
{
"name": "prepare_update_publication",
"title": "Preview changing a published assignment",
"description": "Creates an owner-bound confirmation preview for closing or reopening a published assignment, or changing class open/due dates. Links and submissions remain intact. Publication remains unchanged until approved preview execution.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"assignmentId",
"action",
"changes",
"timeZone"
],
"properties": {
"action": {
"enum": [
"close",
"reopen",
"change_dates"
],
"type": "string"
},
"changes": {
"type": "array",
"items": {
"type": "object",
"required": [
"classId"
],
"properties": {
"dueAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\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)))$"
},
"classId": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f\\d]{24}$"
},
{
"type": "null"
}
],
"description": "Class id, or null for the anyone-with-the-link publication."
},
"opensAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\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)))$"
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 12,
"description": "For change_dates only."
},
"timeZone": {
"type": "string",
"default": "America/New_York",
"maxLength": 64,
"description": "The teacher's IANA time zone, e.g. America/Chicago, so the preview shows their local times."
},
"assignmentId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Preview changing a published assignment",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Applies the owner-bound publication preview identified by previewId, subject to explicit teacher approval of that specific preview.
| Parameter | Type | Description |
|---|---|---|
| previewId * | string | The previewId from the matching prepare_ tool, after the teacher said yes to that preview. |
{
"name": "confirm_update_publication",
"title": "Change a published assignment",
"description": "Applies the owner-bound publication preview identified by previewId, subject to explicit teacher approval of that specific preview.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"previewId"
],
"properties": {
"previewId": {
"type": "string",
"maxLength": 200,
"minLength": 20,
"description": "The previewId from the matching prepare_ tool, after the teacher said yes to that preview."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Change a published assignment",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Creates an owner-bound confirmation preview for releasing assignment scores and feedback to every class, including counts of unscored responses. Release status remains unchanged until approved preview execution. A release cannot be taken back.
| Parameter | Type | Description |
|---|---|---|
| assignmentId * | string | Assignment id from list_coursework. |
{
"name": "prepare_release_results",
"title": "Preview handing results back",
"description": "Creates an owner-bound confirmation preview for releasing assignment scores and feedback to every class, including counts of unscored responses. Release status remains unchanged until approved preview execution. A release cannot be taken back.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"assignmentId"
],
"properties": {
"assignmentId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Assignment id from list_coursework."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Preview handing results back",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Releases results exactly as specified by the owner-bound previewId, subject to explicit teacher approval of that specific preview. Release cannot be reversed.
| Parameter | Type | Description |
|---|---|---|
| previewId * | string | The previewId from the matching prepare_ tool, after the teacher said yes to that preview. |
{
"name": "confirm_release_results",
"title": "Hand results back",
"description": "Releases results exactly as specified by the owner-bound previewId, subject to explicit teacher approval of that specific preview. Release cannot be reversed.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"previewId"
],
"properties": {
"previewId": {
"type": "string",
"maxLength": 200,
"minLength": 20,
"description": "The previewId from the matching prepare_ tool, after the teacher said yes to that preview."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Hand results back",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Creates an owner-bound confirmation preview for correcting a published multiple-choice key, including how many students gain or lose points. Accepts assignment section and question numbers. Keys and scores remain unchanged until approved preview execution.
| Parameter | Type | Description |
|---|---|---|
| note | string | A note for Fiveable with the shared fix. |
| explanation | string | Why this answer is right, in the teacher's words; defaults to the current explanation. |
| assignmentId * | string | Assignment id from list_coursework. |
| sectionNumber * | integer | 1 for the assignment's first section. |
| correctAnswers * | array | The right answer letters, e.g. ["C"]. |
| questionNumber * | integer | Question number within that section. |
| shareCorrection * | boolean | Also send the fix to Fiveable so the question is corrected for everyone. |
{
"name": "prepare_correct_answer_key",
"title": "Preview correcting an answer key",
"description": "Creates an owner-bound confirmation preview for correcting a published multiple-choice key, including how many students gain or lose points. Accepts assignment section and question numbers. Keys and scores remain unchanged until approved preview execution.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"assignmentId",
"sectionNumber",
"questionNumber",
"correctAnswers",
"shareCorrection"
],
"properties": {
"note": {
"type": "string",
"maxLength": 2000,
"description": "A note for Fiveable with the shared fix."
},
"explanation": {
"type": "string",
"maxLength": 5000,
"description": "Why this answer is right, in the teacher's words; defaults to the current explanation."
},
"assignmentId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Assignment id from list_coursework."
},
"sectionNumber": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "1 for the assignment's first section."
},
"correctAnswers": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Ha-h]$"
},
"maxItems": 8,
"minItems": 1,
"description": "The right answer letters, e.g. [\"C\"]."
},
"questionNumber": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Question number within that section."
},
"shareCorrection": {
"type": "boolean",
"default": false,
"description": "Also send the fix to Fiveable so the question is corrected for everyone."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Preview correcting an answer key",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Applies the owner-bound answer-key correction preview identified by previewId and rescores affected attempts in the background, subject to explicit teacher approval. Rejects scores changed since the preview.
| Parameter | Type | Description |
|---|---|---|
| previewId * | string | The previewId from the matching prepare_ tool, after the teacher said yes to that preview. |
{
"name": "confirm_correct_answer_key",
"title": "Correct an answer key",
"description": "Applies the owner-bound answer-key correction preview identified by previewId and rescores affected attempts in the background, subject to explicit teacher approval. Rejects scores changed since the preview.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"previewId"
],
"properties": {
"previewId": {
"type": "string",
"maxLength": 200,
"minLength": 20,
"description": "The previewId from the matching prepare_ tool, after the teacher said yes to that preview."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Correct an answer key",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Creates an owner-bound confirmation preview for exporting approved grading-session scores to the source Google Classroom assignment. Includes included/excluded counts and the point scale. No grades are sent until approved preview execution.
| Parameter | Type | Description |
|---|---|---|
| sessionId * | string | Grading session id from list_grading_sessions or create_grading_session. |
{
"name": "prepare_push_grades_to_google_classroom",
"title": "Preview sending grades to Google Classroom",
"description": "Creates an owner-bound confirmation preview for exporting approved grading-session scores to the source Google Classroom assignment. Includes included/excluded counts and the point scale. No grades are sent until approved preview execution.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sessionId"
],
"properties": {
"sessionId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$",
"description": "Grading session id from list_grading_sessions or create_grading_session."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Preview sending grades to Google Classroom",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Exports exactly the grades in the owner-bound previewId, subject to explicit teacher approval of that preview. Rejects session scores changed since the preview.
| Parameter | Type | Description |
|---|---|---|
| previewId * | string | The previewId from the matching prepare_ tool, after the teacher said yes to that preview. |
{
"name": "confirm_push_grades_to_google_classroom",
"title": "Send grades to Google Classroom",
"description": "Exports exactly the grades in the owner-bound previewId, subject to explicit teacher approval of that preview. Rejects session scores changed since the preview.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"previewId"
],
"properties": {
"previewId": {
"type": "string",
"maxLength": 200,
"minLength": 20,
"description": "The previewId from the matching prepare_ tool, after the teacher said yes to that preview."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Send grades to Google Classroom",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Fiveable for AP Teachers connects an AP teacher's Fiveable teacher workspace. You are working for a teacher. Their classes are the ones in their Fiveable teacher workspace. There are no class codes: students join a class by opening an assignment's class link, or through the teacher's roster. Never ask for, mention, or invent a class code, join code, or invite code. Students are referred to by an opaque handle and a first name plus last initial. Never ask for or guess full names, emails, or account ids. Never publish, release, notify students, correct answer keys on submitted work, or push grades unless the teacher said yes to that specific preview. AI scores are drafts until the teacher approves them; always say which is which. Do not estimate scores or AP results yourself, and never grade student work or write a rubric of your own: scores and rubrics come only from Fiveable's grading tools. If a rubric or scores aren't ready yet, say so and check back. Every essay is scored on the AP rubric for its question type, out of that type's AP point total; the teacher doesn't set the points or the scale. Never give your own read of a score or of how a student's work will score (not even "they never used the term"), suggest a different scale, or offer to regrade on other terms. If the teacher disagrees with a score, they can change it with override_essay_score. Use only Fiveable content. Do not look up or quote College Board released questions, rubrics, or sample essays, including with your own web search; if the teacher asks for one, explain Fiveable grades their question on its AP rubric. A teacher's own AP Classroom export is fine to import; for its prompt, ask the teacher to paste or screenshot the question they assigned. When a teacher assigned a released College Board question, ask them to paste or screenshot it too; never offer to find it from its name or year. Never call Fiveable or any part of it "free", including what doesn't use an included assignment. Accounts without a plan include three assignments with student work: an assignment uses one only when its first student submits, so building, drafting and publishing never use one. When a tool reports the included assignments are used, pass on its message and link without quoting prices. Changes you make in the teacher's workspace (classes, rosters, drafts, scores) can be undone: every write says how. After every change, tell the teacher what you changed and how to undo it, in one short line. Drafts stay invisible to students until the teacher publishes them. Actions students see (publishing, changing dates, handing results back, correcting an answer key, sending grades to Google Classroom) are two steps: call the prepare_ tool, show the teacher its preview in your own words, and call the confirm_ tool only after they say yes to that preview. Never confirm on your own or reuse an old previewId. When you make materials (slides, worksheets, review games, notes), keep every stimulus with its questions, put answer keys on a separate page, keep the Fiveable attribution line, and offer to turn gradable material into a Fiveable assignment. When evidence about a class or skill is thin, say so instead of guessing. Write about students growth-first and never compare them with each other. Before importing transcribed photos, show the transcription to the teacher and get their approval. Split pasted responses into one entry per student. For rosters, normalize names to First Last order and include each student once. Draft submission feedback on the rubric and let the teacher review it before saving. Only report a content issue when the teacher explicitly asks; never include conversation history, unrelated notes or personal information. Suggested flows: - Orientation: get_my_teacher_workspace, then list_classes to turn "period 3" into a class id. - Reteach: get_class_insights, get_reteach_gaps, get_content_sections, then search_question_bank and get_questions_for_materials for an
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.