get_correction
ChatGPTReturns the grading status of one student’s submission to an exam you own and, once the result is released, the full per-question breakdown with marks and feedback. A multi-part question yields one entry per part, each tagged with part. status is processing until the result is released, then success. A result is released once grading has finished and expectedGradingCompletionDate has passed; instant grading releases 10 minutes after submittedAt. If that date has passed and status is still processing, grading is running late; check again later. Grades, feedback and questions are null until status is success. annotatedPdf is the answer paper with the grading drawn onto it. It is generated after grading finishes, so annotatedPdf.status can still be processing when status is success. It is unavailable when annotation is not enabled for the account, failed, or no longer matches grades that were edited since. annotatedPdf.url does not expire. For a report of only the lost marks, use get_correction_mistakes_pdf once status is success.
get_correction_annotated_pdf
ChatGPTReturns the annotated PDF for one student’s graded submission to an exam you own: the answer paper with the grading drawn onto it, the same state as annotatedPdf in get_correction. status is processing while it is being generated, ready with a permanent url, or unavailable when annotation is not enabled for the account or the course, failed, or no longer matches grades that were edited since.
get_correction_mistakes_pdf
ChatGPTRenders the mistakes-only PDF report for one student’s graded submission to an exam you own and returns a temporary download link. The report shows only the questions and criteria where marks were lost, with fully correct sections collapsed. Use it once get_correction reports status = success. Each call renders a fresh copy, which takes a few seconds. The link stops working by expiresAt; call again for a new one.
get_course
ChatGPTReturns one course you own: its name, subject, language, year, education center, and any linked external integration. Courses you do not own return a not-found error.
get_course_student
ChatGPTReturns one student’s enrollment in a course you own, including the contact details omitted from list_course_students. The student must still be enrolled.
get_exam
ChatGPTReturns the metadata and preparation status of one exam you own. status is processing while the exam is being prepared, ready once it is available, or failed if it could not be prepared.
get_exam_analytics
ChatGPTReturns grade statistics for an exam you own: how many students are graded, awaiting release, or not yet graded; the average, median, range, and spread of released grades; a percentage distribution; and a per-course breakdown. Set includeLinked to true to cover every course the exam was also given in, counting each student once. Only released grades count toward the statistics; a grade is released once its expected grading-completion date has passed.
get_exam_question_analytics
ChatGPTReturns statistics for every question and part of an exam you own: average mark, how many students scored zero, below half, at least half, or full marks, and a needsReview flag for questions where strong students did no better than weak ones. Set includeStudents to true to list the student IDs behind the zero and below-half counts, and includeLinked to true to cover every course the exam was also given in. These statistics cover every graded paper, including grades not yet released. An exam that is still being prepared, or has no graded papers, returns an empty questions list.
get_student_performance
ChatGPTReturns one student’s results across a course you own, oldest exam first, with a summary (submitted, graded, missing, average percentage) and the overdue exams they have not handed in. Filter both lists by category. The student must still be enrolled.
list_course_exams
ChatGPTLists the exams in a course you own, with their examIds, preparation status (processing, ready or failed), and how many assigned students have submitted and been graded. Filter by name (exact) or q (substring), category, status, gradesPublished, and a due-date window. Pass limit (and optionally offset) to page the results; without limit, every matching exam is returned.
list_course_students
ChatGPTLists the students enrolled in a course you own, with their studentIds, a page at a time. Filter by q (case-insensitive substring of name or email), class, studentStatus (whether the student has signed up), and parentStatus (whether a parent account is linked). Separate multiple classes with commas, e.g. 4A,4B. Phone numbers are omitted here; use get_course_student for one student’s contact details. Results are ordered newest enrollment first, or by name when filtering by class.
list_courses
ChatGPTLists the courses you own, with their courseIds. Use it first to find the course another tool needs. Filter by name (case-insensitive exact match) or q (case-insensitive substring). Archived courses are excluded unless includeArchived is true. Pass limit (and optionally offset) to page the results; without limit, every matching course is returned.
list_exam_submissions
ChatGPTLists every student an exam you own is assigned to, with their submission, grading, visibility, and appeal state, a page at a time. Use it to answer questions like who has not submitted (submitted = false), who is still waiting on a result (submitted = true with graded = false), or who submitted late (late = true). Rows carry status only; use get_correction for a student’s full graded result. Grades are null until released. late = false matches on-time submissions only, not students who never submitted. Separate multiple classes with commas, e.g. 4A,4B. Results are ordered by student name.
list_exams
ChatGPTLists the exams across all your courses in one call, each with its examId, courseId, courseName, preparation status and how many assigned students have submitted and been graded. Use it for questions like “my last 3 created exams” or “exams due this week” instead of listing courses one by one. Sort with sort (createdAt, updatedAt, dueDateTime or name) and order; the default is newest created first, so limit = 3 returns the three latest. Filter by courseId (comma-separated), name (exact) or q (substring), category, status, gradesPublished, and due-date or creation-date windows (dueAfter, dueBefore, createdAfter, createdBefore). Exams in archived courses are excluded unless includeArchived is true. Without limit, every matching exam is returned, so pass limit for “latest N” questions.
list_subjects
ChatGPTLists the subject names a course can have, ordered by name. Use it to interpret or match a course’s subject.
query_grades
ChatGPTLooks up the grades of up to 100 students, by email address, for one exam you own. Results come back in the same order as studentEmails. Unknown emails are returned with grade: null. A grade is also null until that student’s expected grading-completion date has passed; that date is then returned in expectedGradingCompletionDate.
report_missing_capability
ChatGPTReport that the user's request needs a capability this server does not have. Records the report for the server's developers; it does not return or add tools.