Fiveable for AP Teachers

Creates one or more classes in the teacher's workspace, e.g. three AP Bio periods. Students join a class by opening an assignment's class link (there are no class codes), or the teacher adds them with add_students. Undo with archive_class.

create_classes

Starts a workspace grading session for a stack of finished student work (paper, Google Docs, an AP Classroom export). The prompt is a Fiveable FRQ or SAQ id from search_question_bank, or the teacher's own question pasted in `prompt`; never look one up elsewhere. A grading session uses one of the teacher's included assignments when grading starts (plans are unlimited). Next: import_essays_from_text or import_essays_from_files, then get_grading_rubric.

create_grading_session

Copies any of the teacher's assignments (including last year's or archived ones) into a new draft with the same questions and settings, ready to retarget with update_assignment_draft. Undo with archive_assignment.

duplicate_assignment

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.

export_grading_results

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.

get_exam_options

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.

get_frq

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.

get_key_term

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 free caller unless existing access covers this subject and feature. Expensive — a full guide can be 3-8k tokens.

get_study_guide

One assignment's setup: its sections and question counts, scoring and timing settings, and each class it is published to with due dates and the student link. Use preview_question to read a question with its key. Cheap.

get_assignment

Per-question results for one assignment: percent correct and how many students picked each answer choice (so you can see which wrong answer pulled them), plus FRQ part-by-part full-credit rates. Use it for 'which questions went worst?'. Moderate cost.

get_assignment_question_breakdown

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.

get_assignment_status

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.

get_class

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.

get_class_insights

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.

get_essay_feedback

How far grading has got: scored, still to score, failed and approved counts, and whether the background job is running, done or stopped. Cheap; call it when the teacher asks, not in a tight loop.

get_grading_progress

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.

get_grading_results

Shows the scoring guidelines Fiveable will grade this session against, point by point, so the teacher can check them before scoring. If they aren't written yet this starts writing them (about a minute) and says to call again. Rubrics are written exactly as on the Fiveable website, on the AP rubric for the question type. Cheap once written.

get_grading_rubric

Reading-check questions with keys for one Fiveable study guide: Fiveable's curated set when one exists, otherwise questions generated from the guide (slower). Use for exit tickets, reading quizzes or guided reading handouts. Takes a guide id from get_subject_outline or get_unit_overview.

get_guide_reading_questions

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.

get_guided_notes

Orientation for the signed-in teacher's Fiveable teacher workspace: their classes, how much coursework is waiting for review or due this week, how many of their included assignments are left, and which Google connections are set up. Call this first in a new conversation. Cheap.

get_my_teacher_workspace

Pulls up to 40 bank questions with answer keys, explanations and their stimuli, ready to turn into slides, worksheets, exit tickets, review games or study packets in your own tools. Keep every stimulus with its questions, put keys on a separate page, and keep the Fiveable attribution line. Offer to turn gradable material into a Fiveable assignment later. Counts against the content budget.

get_questions_for_materials

Returns a small set of passages from Fiveable study guides that are most relevant to one question. Use this for narrow explanations, research questions, and checking student notes instead of fetching a full guide. One call consumes one full-content preview for a free caller.

get_content_sections

What to reteach: the topics, units, CED skills and FRQ rubric rows where the class lost the most points on Fiveable assignments, ranked. Scope by class, subject, assignment or time window. Follow up with get_content_sections for the teaching material and search_question_bank for practice. Moderate cost.

get_reteach_gaps

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.

get_skill_insights

One student's Fiveable work: average, missing work, each assignment's score, weakest units and topics, and skill progress. Takes the student's handle (S-…) from get_class_insights or get_assignment_status. Use it for conference prep, parent notes, or a personal reteach plan. Moderate cost.

get_student_insights

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.

get_subject_outline

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. Set includeText only when the teacher wants to read the student's responses.

get_submission

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.

get_unit_overview

Releases results exactly as prepare_release_results previewed, after the teacher said yes to it.

confirm_release_results

Adds Google Classroom turn-ins to a grading session. Send each turn-in handle from list_google_classroom_work with the text you read from its file. Student names come from the Classroom roster, submissions already in the session are skipped, and the session remembers the Classroom assignment so approved grades can be sent back later. Returns counts only.

import_essays_from_google_classroom

Splits files the teacher dropped into chat into one essay per student and adds them: a PDF or Word stack (including an AP Classroom 'FRQ Response PDFs, By Student Page Break' export) or photos of handwritten work (one essay per photo, read by Fiveable). In ChatGPT, pass files the teacher attached as uploads (up to 3, 25 MB each); otherwise send up to 3 files as base64, about 3 MB in total. Returns counts and warnings only. Can take up to a minute for a long PDF.

import_essays_from_files

Adds student responses the AI client already has as text: pasted by the teacher, read through the client's own Google Drive connector, or transcribed from photos. Split them one per student yourself and send each with the student's name as written. For transcriptions, show the teacher your transcription and get their ok first, then set transcribedFromPhotos. Returns counts only.

import_essays_from_text

Attaches a grading session to a workspace class so its results feed class insights. Essays whose name exactly matches a roster student are linked automatically; pass matches (essay handle to student handle from get_class) for the rest. Returns what's still unmatched. Undo with classId: null.

link_grading_to_class

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.

list_subjects

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.

list_google_classroom_work

Lists the teacher's assignments and grading sessions from their /assignments ledger: status, class, due date, how many students turned it in (of the roster, once the class has one), how many need review, and the class average. status: active shows what is open to students right now. Filter by class, subject or status. Use it to find an assignment id. Cheap.

list_coursework

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.

list_frqs

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.

list_grading_sessions

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.

list_key_terms

Lists the classes in the signed-in teacher's Fiveable teacher workspace with subject, student count and class id. Use it to turn names like 'period 3' or 'my APUSH classes' into class ids for other tools. Cheap.

list_classes