Servers Playground How we check Add a server Log in

Fiveable for AP Students

Working · 1.0 s

io.github.thinkfiveable/fiveable-ap-studentsv1.0.0

AP study content, practice, FRQ feedback, progress, plans, and student tools for AI apps.

Education

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://fiveable.me/api/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

calculate_ap_score Read-only

Predicts a 1-5 AP score from raw section scores using Fiveable's per-subject score calculator, and explains the weighting. Call with no sectionScores to see which sections the subject has and their point maximums, then call again with the student's scores. Cheap.

subjectSlugstring, required

Fiveable subject slug, e.g. "ap-bio".

intentstring

Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.

sectionScoresarray

Raw scores per card. Omit to discover the subject's card structure first.

Fiveable for AP Students MCP server | mcptry

Tools (38)

calculate_ap_score

read-only

Argument	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".
sectionScores	array	Raw scores per card. Omit to discover the subject's card structure first.

Input schema (JSON)

{
  "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\"."
    },
    "sectionScores": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "card",
          "score"
        ],
        "properties": {
          "card": {
            "type": "string",
            "description": "Card/section title exactly as returned by this tool."
          },
          "score": {
            "type": "number",
            "minimum": 0,
            "description": "Raw points the student earned on that card."
          }
        },
        "additionalProperties": false
      },
      "description": "Raw scores per card. Omit to discover the subject's card structure first."
    }
  },
  "additionalProperties": false
}

check_practice_answer

Checks one multiple-choice practice answer and returns correctness plus the Fiveable explanation. Works during an anonymous preview but does not save progress. A signed-in answer submission is required for saved progress.

read-only

Argument	Type	Description
answer*	string	Displayed option label such as "B", or the full answer text.
intent	string	Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.
questionId*	string	Question id from get_practice_questions.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "questionId",
    "answer"
  ],
  "properties": {
    "answer": {
      "type": "string",
      "minLength": 1,
      "description": "Displayed option label such as \"B\", or the full answer text."
    },
    "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."
    },
    "questionId": {
      "type": "string",
      "minLength": 1,
      "description": "Question id from get_practice_questions."
    }
  },
  "additionalProperties": false
}

create_study_plan

Creates and saves a trackable Fiveable study plan from the student's topic and available time. Included for signed-in students; uses Fiveable's existing generator and verified resource catalog. Returns a plan id immediately while the plan builds, usually within two minutes — read it with get_study_plan, which reports whether it is still building. Reuse requestId with identical input to retry; never call this twice for the same plan.

Argument	Type	Description
scope*	string
timeUnit*	string
requestId*	string	Unique id for this intended action. Reuse it with identical input on retries.
timeAmount*	integer
subjectSlug*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "subjectSlug",
    "scope",
    "timeAmount",
    "timeUnit",
    "requestId"
  ],
  "properties": {
    "scope": {
      "type": "string",
      "maxLength": 300,
      "minLength": 1
    },
    "timeUnit": {
      "enum": [
        "hours",
        "days"
      ],
      "type": "string"
    },
    "requestId": {
      "type": "string",
      "pattern": "^[\\w-]{8,128}$",
      "description": "Unique id for this intended action. Reuse it with identical input on retries."
    },
    "timeAmount": {
      "type": "integer",
      "maximum": 90,
      "minimum": 1
    },
    "subjectSlug": {
      "type": "string",
      "maxLength": 100,
      "minLength": 2
    }
  },
  "additionalProperties": false
}

get_assignment_summary

Reads one student-accessible publication's instructions, section counts, timer/due-date settings and released feedback for the policy-selected owned attempt. Does not expose questions or answer keys, finalize timers, repair grading, start, autosave or submit work. Accepts a publicationId from the connected student's assignment listing.

read-only

Argument	Type	Description
publicationId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "publicationId"
  ],
  "properties": {
    "publicationId": {
      "type": "string",
      "pattern": "^[a-f0-9]{24}$"
    }
  },
  "additionalProperties": false
}

get_cheatsheet

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.

read-only

Argument	Type	Description
page*	integer
limit*	integer
cheatsheetId*	string

Input schema (JSON)

{
  "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
}

get_content_sections

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.

read-only

Argument	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

Input schema (JSON)

{
  "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
}

get_diagnostic_results

Reads an owner-scoped Fiveable diagnostic. In-progress sessions return progress and the current question without answer keys; completed sessions return the adaptive diagnostic summary and recommendations.

read-only

Argument	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.
sessionToken*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "sessionToken"
  ],
  "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."
    },
    "sessionToken": {
      "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
}

get_exam_options

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. With progress:read consent, includes only genuine server-saved continuation links. Browser-only progress is not remotely recoverable.

read-only

Argument	Type	Description
unitNumber	integer
subjectSlug	string

Input schema (JSON)

{
  "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
}

get_exam_results

Read an owned completed exam using attemptId, or safely check a submitted exam using submissionId. Supply exactly one. Pending or partial grading returns status only, never unfinished scores or feedback. Honors practice resets and cannot dispatch scoring, finalize submissions or retrieve active exam content.

read-only

Argument	Type	Description
attemptId	string
submissionId	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "attemptId": {
      "type": "string",
      "pattern": "^[a-f0-9]{24}$"
    },
    "submissionId": {
      "type": "string",
      "pattern": "^[a-f0-9]{24}$"
    }
  },
  "additionalProperties": false
}

get_frq

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.

read-only

Argument	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.

Input schema (JSON)

{
  "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
}

get_frq_attempt_history

Returns the signed-in student's previous attempts at a single FRQ, so you can compare a new response against what they wrote before and comment on improvement.

read-only

Argument	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.

Input schema (JSON)

{
  "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
}

get_key_term

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.

read-only

Argument	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.

Input schema (JSON)

{
  "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
}

get_my_access

Explains which features this account can use for one subject and its remaining MCP previews. Does not return billing information or change access.

read-only

Argument	Type	Description
subjectSlug*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "subjectSlug"
  ],
  "properties": {
    "subjectSlug": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    }
  },
  "additionalProperties": false
}

get_my_frq_progress

Returns the signed-in student's saved free-response attempts for one subject, including scores where they were graded and recent scoring-point weak areas. Use it to see what a student has already practiced and where they are losing points before recommending what to work on next.

read-only

Argument	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	Subject slug, e.g. "ap-bio".

Input schema (JSON)

{
  "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": "Subject slug, e.g. \"ap-bio\"."
    }
  },
  "additionalProperties": false
}

get_my_practice_history

Reads a bounded page of your saved self-study MCQ answers with current question explanations. Honors practice resets. Does not save, score, or consume a content preview.

read-only

Argument	Type	Description
limit*	integer
cursor	string
subjectSlug*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "subjectSlug",
    "limit"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 25,
      "minimum": 1
    },
    "cursor": {
      "type": "string",
      "pattern": "^[a-f0-9]{24}$"
    },
    "subjectSlug": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    }
  },
  "additionalProperties": false
}

get_my_study_progress

Returns the signed-in student's durable Fiveable progress for one subject: multiple-choice accuracy, weak topics and units, FRQ performance, skill groups and recent activity, respecting the website progress reset. Also includes completed exams, plus assignment and study-plan summaries when their separate permissions are granted. Call this before choosing what to explain or practice so recommendations carry across conversations and AI clients.

read-only

Argument	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".

Input schema (JSON)

{
  "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\"."
    }
  },
  "additionalProperties": false
}

get_practice_questions

Returns original, course-specific multiple-choice practice questions. Free-text topics are matched against Fiveable's course map, so natural phrasing works. Omit topic to get balanced practice across the whole subject, with varied units, skills and stimulus formats. For history, science and language subjects this can return source-based sets — one stimulus with several questions off it — and stimulus images come back as viewable images. This is targeted or mixed practice, distinct from Fiveable's durable adaptive diagnostic. Every question carries a `Question id` that supports a saved answer submission for student progress. The recentCorrect and recentAnswered inputs allow the tool to drop to easier question types when a student is missing questions, helping find where understanding breaks down. A returned question set consumes one full-content preview unless existing access covers this practice feature. Moderate cost — roughly 300 tokens per question, more when images are attached.

read-only

Argument	Type	Description
mode*	string	"exam" requests Fiveable's balanced whole-course practice mix of units, skills and stimulus formats. "topic" drills one scope. "auto" picks exam when no topic is given.
tier	string	The tier the student was just working at — pass back the tier from the previous result, along with recentCorrect / recentAnswered, so a student who is still missing comprehension questions drops to vocabulary rather than being handed comprehension again. On its own it pins the level: stimulus = source-based application, comprehension = does the student know the content, vocabulary = does the student know the terms.
limit*	integer	Exact maximum number of questions to return, including questions in a stimulus set.

get_scoring_result

Read the status or saved result of your FRQ scoring request. This never starts or retries scoring.

read-only

Argument	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.
scoringJobId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "scoringJobId"
  ],
  "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."
    },
    "scoringJobId": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    }
  },
  "additionalProperties": false
}

get_study_guide

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.

read-only

Argument	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.

Input schema (JSON)

{
  "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
}

get_study_plan

Reads one owned study plan, stable task ids, completion state and revision. A plan that is still being built reports pending with a retry delay, so poll this after create_study_plan rather than creating again. Use its revision for task changes. Reading older plans never changes them.

read-only

Argument	Type	Description
planId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "planId"
  ],
  "properties": {
    "planId": {
      "type": "string",
      "pattern": "^[a-f0-9]{24}$"
    }
  },
  "additionalProperties": false
}

get_subject_outline

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.

read-only

Argument	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.

Input schema (JSON)

{
  "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
}

get_unit_overview

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.

read-only

Argument	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.

Input schema (JSON)

{
  "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
}

list_cheatsheets

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.

read-only

Argument	Type	Description
limit*	integer
cursor	string
unitNumber	integer
subjectSlug	string
courseVariant	string

Input schema (JSON)

{
  "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
}

list_frqs

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.

read-only

Argument	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 and topics; 'bc' includes them. Defaults to the student's saved Fiveable course when they are connected.

list_key_terms

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.

read-only

Argument	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.

Input schema (JSON)

{
  "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
}

list_my_assignments

Lists assignments delivered to the connected student's enrolled classes, signed-in submissions, and safely claimed guest work. Includes due dates, completion status and only released scores. No teacher roster or answer keys. Complete work on the website.

read-only

Argument	Type	Description
limit*	integer
cursor	string
subjectSlug	string

Input schema (JSON)

{
  "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": "^[a-f0-9]{24}$"
    },
    "subjectSlug": {
      "type": "string",
      "pattern": "^[a-z0-9-]+$",
      "maxLength": 100
    }
  },
  "additionalProperties": false
}

list_my_exam_attempts

Lists only the connected student's completed full-length and unit-exam results. Honors the website progress reset, deduplicates retried submissions and paginates. Unit tests show points/percent, never an AP projection. Does not read browser-only or active exam state.

read-only

Argument	Type	Description
limit*	integer
cursor	string
subjectSlug	string

Input schema (JSON)

{
  "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": "^[a-f0-9]{24}$"
    },
    "subjectSlug": {
      "type": "string",
      "pattern": "^[a-z0-9-]+$",
      "maxLength": 100
    }
  },
  "additionalProperties": false
}

list_my_study_plans

Lists the connected student's saved Fiveable study plans, including website plans. Included for signed-in students. Cheap; paginated.

read-only

Argument	Type	Description
limit*	integer
cursor	string
subjectSlug	string

Input schema (JSON)

{
  "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": "^[a-f0-9]{24}$"
    },
    "subjectSlug": {
      "type": "string",
      "maxLength": 100,
      "minLength": 2
    }
  },
  "additionalProperties": false
}

list_subjects

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.

read-only

Argument	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".

Input schema (JSON)

{
  "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
}

open_guided_practice

Opens Fiveable's interactive multiple-choice practice panel with existing question, answer and explanation components. Students select answers directly in the panel. Connected accounts can save answers to Fiveable progress; anonymous practice is an unsaved preview.

read-only

Argument	Type	Description
tier	string
limit*	integer
topic	string	Free-text topic or a CED topic number like "3.3", matched against Fiveable course topics.
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
topicId	string
subjectSlug*	string
courseVariant	string	AP Calculus only (subject ap-calc): 'ab' hides BC-only units and topics; 'bc' includes them. Defaults to the student's saved Fiveable course when they are connected.

report_content_issue

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.

Argument	Type	Description
contentId*	string	Exact guide/question/FRQ ID, or the exact canonical key-term path from Fiveable.
requestId*	string
contentType*	string
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.

Input schema (JSON)

{
  "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
}

score_external_frq_response

Scores a student's existing FRQ even when it did not come from Fiveable. If the student attached photos, the host AI must first transcribe the prompt and response, show the transcription for confirmation, then call this tool. Optional prompt images preserve graphs or artwork that text alone cannot represent. Fiveable scores it on the AP rubric for its exact question type, out of that type's AP point total. Requires sign-in; one scoring preview is included without a plan, with further scoring available to eligible accounts. The attempt is saved to the student's Fiveable progress. Returns a pending scoring job; poll get_scoring_result. Reuse requestId for retries.

Argument	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.
frqType*	string	The exact AP question type as Fiveable names it, e.g. "Document-Based Question (DBQ)". If it doesn't match, the tool lists this subject's types.
requestId	string	Stable unique request ID. Reuse it only for retries of the same submission; a new response needs a new ID.
promptText*	string	Verified transcription or pasted text of the complete prompt.
promptLabel	string	Short label shown in attempt history.
subjectSlug*	string

score_frq_response

Submits the student's own response to a Fiveable practice FRQ for saved, asynchronous scoring. Supports text, subparts, drawings/photos, LEQ selection, CSP program code and Business project references. Excludes teacher assignments and exams. Returns a scoring job id for status retrieval, and requestId provides idempotent retries. One included score is available to signed-in students.

Argument	Type	Description
frqId*	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.
requestId	string	Stable unique request ID. Reuse it only for retries of the same submission; a new response needs a new ID.
programCode	string
partResponses*	array
promptVariantId	string
selectedLeqQuestion	integer
businessProjectReference	object
businessProjectPracticeMode

search_content

Keyword search across every Fiveable study guide, unit, subject hub and key term. Suitable when the relevant subject or guide is not known. Returns titles and canonical references rather than full content, so it is cheap.

read-only

Argument	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.

Input schema (JSON)

{
  "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
}

start_diagnostic

Starts Fiveable's canonical adaptive diagnostic for the connected student. Without a unitId it covers the whole course; an exact unitId scopes the survey across that unit's available topics. Returns one adaptive question at a time and creates durable diagnostic progress.

Argument	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.
unitId	string
requestId	string	Reuse this ID for retries of the same operation; changed input returns a conflict.
subjectSlug*	string
courseVariant	string	AP Calculus only (subject ap-calc): 'ab' hides BC-only units and topics; 'bc' includes them. Defaults to the student's saved Fiveable course when they are connected.

Input schema (JSON)

{
  "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."
    },
    "unitId": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "requestId": {
      "type": "string",
      "pattern": "^[\\w-]{8,128}$",
      "description": "Reuse this ID for retries of the same operation; changed input returns a conflict."
    },
    "subjectSlug": {
      "type": "string",
      "pattern": "^[a-z0-9-]+$",
      "maxLength": 100
    },
    "courseVariant": {
      "enum": [
        "ab",
        "bc"
      ],
      "type": "string",
      "description": "AP Calculus only (subject ap-calc): 'ab' hides BC-only units and topics; 'bc' includes them. Defaults to the student's saved Fiveable course when they are connected."
    }
  },
  "additionalProperties": false
}

submit_diagnostic_answer

Saves one answer in the connected student's active Fiveable diagnostic and returns feedback plus exactly one next adaptive question. Accepts the option letter, full text, or answer id from the current diagnostic question. Handles one question per call.

Argument	Type	Description
answer*	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.
requestId	string	Reuse this ID for retries of the same operation; changed input returns a conflict.
questionId*	string
sessionToken*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "sessionToken",
    "questionId",
    "answer"
  ],
  "properties": {
    "answer": {
      "type": "string",
      "maxLength": 1000,
      "minLength": 1
    },
    "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."
    },
    "requestId": {
      "type": "string",
      "pattern": "^[\\w-]{8,128}$",
      "description": "Reuse this ID for retries of the same operation; changed input returns a conflict."
    },
    "questionId": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "sessionToken": {
      "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
}

submit_practice_answer

Records the signed-in student's answer to a multiple-choice practice question so it counts toward their Fiveable progress. Accepts a question id previously served by Fiveable MCP and returns whether the answer was correct plus the explanation.

Argument	Type	Description
answer*	string	The displayed option label (for example "B" or "B.") or the full answer text.
intent	string	Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.
requestId	string	Reuse this ID for retries of the same answer; changed input returns a conflict.
questionId*	string	The practice question id from get_practice_questions.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "questionId",
    "answer"
  ],
  "properties": {
    "answer": {
      "type": "string",
      "maxLength": 1000,
      "minLength": 1,
      "description": "The displayed option label (for example \"B\" or \"B.\") or the full answer text."
    },
    "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."
    },
    "requestId": {
      "type": "string",
      "pattern": "^[\\w-]{8,128}$",
      "description": "Reuse this ID for retries of the same answer; changed input returns a conflict."
    },
    "questionId": {
      "type": "string",
      "minLength": 1,
      "description": "The practice question id from get_practice_questions."
    }
  },
  "additionalProperties": false
}

update_study_plan_tasks

Marks specified owned plan tasks complete or incomplete at the student's request. This is self-reported planning, never a quiz score or practice submission. Supply the latest revision and a unique requestId; retry identical input safely.

Argument	Type	Description
tasks*	array
planId*	string
requestId*	string	Unique id for this intended action. Reuse it with identical input on retries.
expectedRevision*	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "planId",
    "expectedRevision",
    "requestId",
    "tasks"
  ],
  "properties": {
    "tasks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "taskId",
          "completed"
        ],
        "properties": {
          "taskId": {
            "type": "string",
            "pattern": "^session-\\d+-task-\\d+$"
          },
          "completed": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 240,
      "minItems": 1
    },
    "planId": {
      "type": "string",
      "pattern": "^[a-f0-9]{24}$"
    },
    "requestId": {
      "type": "string",
      "pattern": "^[\\w-]{8,128}$",
      "description": "Unique id for this intended action. Reuse it with identical input on retries."
    },
    "expectedRevision": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "subjectSlug",
    "limit",
    "includeAnswers",
    "questionFormat",
    "mode"
  ],
  "properties": {
    "mode": {
      "enum": [
        "auto",
        "exam",
        "topic"
      ],
      "type": "string",
      "default": "auto",
      "description": "\"exam\" requests Fiveable's balanced whole-course practice mix of units, skills and stimulus formats. \"topic\" drills one scope. \"auto\" picks exam when no topic is given."
    },
    "tier": {
      "enum": [
        "stimulus",
        "comprehension",
        "vocabulary"
      ],
      "type": "string",
      "description": "The tier the student was just working at — pass back the tier from the previous result, along with recentCorrect / recentAnswered, so a student who is still missing comprehension questions drops to vocabulary rather than being handed comprehension again. On its own it pins the level: stimulus = source-based application, comprehension = does the student know the content, vocabulary = does the student know the terms."
    },
    "limit": {
      "type": "integer",
      "default": 5,
      "maximum": 20,
      "minimum": 1,
      "description": "Exact maximum number of questions to return, including questions in a stimulus set."
    },
    "topic": {
      "type": "string",
      "description": "Free-text topic, e.g. \"photosynthesis\", \"the American Revolution\" or a CED topic number like \"3.3\". Matched against Fiveable course topics, then key terms. Omit for whole-subject mixed practice."
    },
    "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",
      "description": "Exact unit id, public id, or slug from get_subject_outline. Use this for broad practice across a unit; do not substitute one topic id as a proxy for the entire unit."
    },
    "topicId": {
      "type": "string",
      "description": "Exact topic id from get_subject_outline, if known."
    },
    "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 and topics; 'bc' includes them. Defaults to the student's saved Fiveable course when they are connected."
    },
    "recentCorrect": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "How many of the student's recent answers were correct, for automatic tier adjustment."
    },
    "includeAnswers": {
      "type": "boolean",
      "default": false,
      "description": "Defaults false so students can attempt questions before seeing the key. Set true only when the student explicitly asks for answers. Use check_practice_answer anonymously or submit_practice_answer when signed in."
    },
    "questionFormat": {
      "enum": [
        "auto",
        "stimulus-set",
        "standalone"
      ],
      "type": "string",
      "default": "auto",
      "description": "\"auto\" matches what the subject's own practice UI leads with. \"stimulus-set\" requests source-based questions; \"standalone\" requests single questions with no shared source."
    },
    "recentAnswered": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "How many questions the student recently answered. Needs 3+ before the tier moves."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "subjectSlug",
    "frqType",
    "promptText",
    "transcriptionConfirmed",
    "partResponses"
  ],
  "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."
    },
    "frqType": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "The exact AP question type as Fiveable names it, e.g. \"Document-Based Question (DBQ)\". If it doesn't match, the tool lists this subject's types."
    },
    "requestId": {
      "type": "string",
      "pattern": "^[\\w-]{8,128}$",
      "description": "Stable unique request ID. Reuse it only for retries of the same submission; a new response needs a new ID."
    },
    "promptText": {
      "type": "string",
      "maxLength": 30000,
      "minLength": 20,
      "description": "Verified transcription or pasted text of the complete prompt."
    },
    "promptLabel": {
      "type": "string",
      "maxLength": 160,
      "description": "Short label shown in attempt history."
    },
    "subjectSlug": {
      "type": "string",
      "minLength": 2,
      "description": "Fiveable subject slug, e.g. \"ap-bio\"."
    },
    "promptImages": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "data",
          "mediaType"
        ],
        "properties": {
          "data": {
            "type": "string",
            "maxLength": 3000000,
            "minLength": 100,
            "description": "Base64 image payload without a data-URI prefix."
          },
          "mediaType": {
            "enum": [
              "image/jpeg",
              "image/png",
              "image/webp"
            ],
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 4,
      "description": "Optional original prompt images for diagrams, graphs, maps, or artwork."
    },
    "partResponses": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "partLetter",
          "response"
        ],
        "properties": {
          "response": {
            "type": "string",
            "maxLength": 50000,
            "minLength": 1,
            "description": "Verified transcription or pasted response."
          },
          "partLetter": {
            "type": "string",
            "maxLength": 20,
            "minLength": 1,
            "description": "Part label, e.g. \"a\" or \"UNIFIED\"."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 30,
      "minItems": 1
    },
    "responseImages": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "data",
          "mediaType",
          "partLetter"
        ],
        "properties": {
          "data": {
            "type": "string",
            "maxLength": 3000000,
            "minLength": 100,
            "description": "Base64 image payload without a data-URI prefix."
          },
          "label": {
            "type": "string",
            "maxLength": 120
          },
          "mediaType": {
            "enum": [
              "image/jpeg",
              "image/png",
              "image/webp"
            ],
            "type": "string"
          },
          "partLetter": {
            "type": "string",
            "maxLength": 20,
            "minLength": 1
          }
        },
        "additionalProperties": false
      },
      "maxItems": 8,
      "description": "Optional response images that must be evaluated visually, such as a student-drawn graph."
    },
    "transcriptionConfirmed": {
      "type": "boolean",
      "const": true,
      "description": "Must be true only after the student confirms the transcribed prompt and response text."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "frqId",
    "partResponses"
  ],
  "properties": {
    "frqId": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    },
    "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."
    },
    "requestId": {
      "type": "string",
      "pattern": "^[\\w-]{8,128}$",
      "description": "Stable unique request ID. Reuse it only for retries of the same submission; a new response needs a new ID."
    },
    "programCode": {
      "type": "string",
      "maxLength": 100000
    },
    "partResponses": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "partLetter",
          "response"
        ],
        "properties": {
          "response": {
            "type": "string",
            "default": "",
            "maxLength": 50000,
            "description": "Student's own response, verbatim. May be empty for a drawing/photo-only response."
          },
          "partLetter": {
            "type": "string",
            "maxLength": 20,
            "minLength": 1
          },
          "drawingData": {
            "type": "object",
            "required": [
              "type",
              "data",
              "width",
              "height"
            ],
            "properties": {
              "data": {
                "type": "string",
                "maxLength": 3000100,
                "minLength": 16
              },
              "type": {
                "type": "string",
                "const": "canvas"
              },
              "width": {
                "type": "integer",
                "maximum": 10000,
                "minimum": 1
              },
              "height": {
                "type": "integer",
                "maximum": 10000,
                "minimum": 1
              },
              "source": {
                "enum": [
                  "drawing",
                  "uploaded_photo"
                ],
                "type": "string"
              },
              "mimeType": {
                "enum": [
                  "image/png",
                  "image/jpeg",
                  "image/webp"
                ],
                "type": "string"
              },
              "drawingLabel": {
                "type": "string",
                "maxLength": 200
              }
            },
            "additionalProperties": false
          },
          "subpartNumeral": {
            "type": "string",
            "maxLength": 20
          }
        },
        "additionalProperties": false
      },
      "maxItems": 30,
      "minItems": 1
    },
    "promptVariantId": {
      "type": "string",
      "const": "official_2026_v1"
    },
    "selectedLeqQuestion": {
      "type": "integer",
      "maximum": 4,
      "minimum": 2
    },
    "businessProjectReference": {
      "type": "object",
      "required": [
        "product",
        "target_customer",
        "customer_problem_or_need",
        "value_proposition",
        "pricing_decision",
        "tested_hypothesis",
        "research_method_and_evidence",
        "financing_assumptions"
      ],
      "properties": {
        "product": {
          "type": "string",
          "maxLength": 2000,
          "minLength": 1
        },
        "target_customer": {
          "type": "object",
          "required": [
            "profile"
          ],
          "properties": {
            "profile": {
              "type": "string",
              "maxLength": 2000,
              "minLength": 1
            }
          },
          "additionalProperties": false
        },
        "pricing_decision": {
          "type": "object",
          "required": [
            "strategy",
            "selected_price",
            "decision"
          ],
          "properties": {
            "decision": {
              "type": "string",
              "maxLength": 2000,
              "minLength": 1
            },
            "strategy": {
              "type": "string",
              "maxLength": 2000,
              "minLength": 1
            },
            "selected_price": {
              "type": "string",
              "maxLength": 300,
              "minLength": 1
            }
          },
          "additionalProperties": false
        },
        "tested_hypothesis": {
          "type": "string",
          "maxLength": 2000,
          "minLength": 1
        },
        "value_proposition": {
          "type": "string",
          "maxLength": 2000,
          "minLength": 1
        },
        "financing_assumptions": {
          "type": "object",
          "required": [
            "startup_costs",
            "operating_costs_until_break_even",
            "internal_financial_capital",
            "external_financial_capital_needed",
            "access_constraints"
          ],
          "properties": {
            "startup_costs": {
              "type": "string",
              "maxLength": 300,
              "minLength": 1
            },
            "access_constraints": {
              "type": "string",
              "maxLength": 2000,
              "minLength": 1
            },
            "internal_financial_capital": {
              "type": "string",
              "maxLength": 300,
              "minLength": 1
            },
            "operating_costs_until_break_even": {
              "type": "string",
              "maxLength": 300,
              "minLength": 1
            },
            "external_financial_capital_needed": {
              "type": "string",
              "maxLength": 300,
              "minLength": 1
            }
          },
          "additionalProperties": false
        },
        "customer_problem_or_need": {
          "type": "string",
          "maxLength": 2000,
          "minLength": 1
        },
        "research_method_and_evidence": {
          "type": "object",
          "required": [
            "method",
            "sample",
            "evidence"
          ],
          "properties": {
            "method": {
              "type": "string",
              "maxLength": 2000,
              "minLength": 1
            },
            "sample": {
              "type": "string",
              "maxLength": 2000,
              "minLength": 1
            },
            "evidence": {
              "type": "string",
              "maxLength": 2000,
              "minLength": 1
            }
          },
          "additionalProperties": false
        }
      },
      "additionalProperties": false
    },
    "businessProjectPracticeMode": {
      "enum": [
        "use_my_project",
        "use_a_sample_project"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}