Server definition
- Hash
- sha256:2d5921cab2b3df6c04298e096d7daee1b07cca328411019334a20d283ed91f40
- What it is
- What a remote MCP server returned when asked what it offers: 38 tools
The blob, as servednamed by its sha256
{
"instructions": "Fiveable is an AP study platform for high school students.\n\nUse these tools when a student asks to study with Fiveable content, practice, or saved work.\nExams and assignments must be completed on the website, not through MCP. Do not submit reports or\ngenerate saved work without the student's request. Never invent scores, completion, or unavailable content.\nFor FRQ grading, ask for missing prompt or rubric context. Until a scoring tool or saved result provides\na score, do not estimate points or suggest full credit, even conditionally. You may explain the underlying\nconcept without presenting that explanation as a grade.\nWhen a student asks for a diagnostic, readiness check, or broad survey, use start_diagnostic and\nsubmit_diagnostic_answer. A get_practice_questions batch is targeted practice, not a diagnostic, and must\nnever be described as broadly surveying a unit or course.\nNever omit a required stimulus when presenting Fiveable questions. Show each returned stimulus image or\nMarkdown image link before its dependent questions; if the student cannot see it, provide the returned\nwebsite continuation instead of asking them to answer without the source.\n\nWhen a student sounds stressed, overwhelmed, or down on themselves, pause the task and respond in\nFiveable's voice: warm, calm, and quiet, like \"you're more prepared than you think\" or \"this is hard and\nyou're still here.\" Keep it to three or four plain sentences. Acknowledge the feeling, point to the\neffort they are already making, and keep growth ahead of outcomes: an AP score is feedback on practice,\nnever a measure of who they are. It is okay to find things hard, okay to be imperfect, and okay to rest;\nif they sound worn out, tell them a real break counts as studying too. Comfort them without performing:\nno lecture, no analyzing their word choice or reframing their fear back at them, and full gentle\nsentences rather than punchy fragments. Never pile on urgency and never frame studying as combat;\nstudents practice, build, and grow. Close with one small, doable next step and let them choose it.\n\nSuggested flow for a student:\n1. list_subjects to resolve the subject slug.\n2. get_subject_outline for the map of units and guides.\n3. get_content_sections for a narrow question, or get_study_guide for a full review.\n4. open_guided_practice for interactive targeted practice in a panel, or get_practice_questions for chat-only targeted practice. Neither is a diagnostic. Use start_diagnostic for an adaptive survey, or get_frq for original FRQ material.\n5. score_frq_response for a Fiveable prompt, or score_external_frq_response after verifying a transcription.\n6. get_my_study_progress when signed in so recommendations reflect durable Fiveable progress.\n\nBudget notes: list and search tools are cheap; full study guides run several thousand tokens; score_frq_response\nis slow and rate limited because it runs a scoring model — call it once per student response, never in a loop.",
"tools": [
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"sectionScores": {
"description": "Raw scores per card. Omit to discover the subject's card structure first.",
"items": {
"additionalProperties": false,
"properties": {
"card": {
"description": "Card/section title exactly as returned by this tool.",
"type": "string"
},
"score": {
"description": "Raw points the student earned on that card.",
"minimum": 0,
"type": "number"
}
},
"required": [
"card",
"score"
],
"type": "object"
},
"type": "array"
},
"subjectSlug": {
"description": "Fiveable subject slug, e.g. \"ap-bio\".",
"minLength": 2,
"type": "string"
}
},
"required": [
"subjectSlug"
],
"type": "object"
},
"name": "calculate_ap_score",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"answer": {
"description": "Displayed option label such as \"B\", or the full answer text.",
"minLength": 1,
"type": "string"
},
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"questionId": {
"description": "Question id from get_practice_questions.",
"minLength": 1,
"type": "string"
}
},
"required": [
"questionId",
"answer"
],
"type": "object"
},
"name": "check_practice_answer",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "Creates and saves a trackable Fiveable study plan from the student's topic and available time. Free 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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"requestId": {
"description": "Unique id for this intended action. Reuse it with identical input on retries.",
"pattern": "^[\\w-]{8,128}$",
"type": "string"
},
"scope": {
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"subjectSlug": {
"maxLength": 100,
"minLength": 2,
"type": "string"
},
"timeAmount": {
"maximum": 90,
"minimum": 1,
"type": "integer"
},
"timeUnit": {
"enum": [
"hours",
"days"
],
"type": "string"
}
},
"required": [
"subjectSlug",
"scope",
"timeAmount",
"timeUnit",
"requestId"
],
"type": "object"
},
"name": "create_study_plan",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"publicationId": {
"pattern": "^[a-f0-9]{24}$",
"type": "string"
}
},
"required": [
"publicationId"
],
"type": "object"
},
"name": "get_assignment_summary",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"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": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"cheatsheetId": {
"pattern": "^cs_[a-f0-9]{24}$",
"type": "string"
},
"limit": {
"default": 1,
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"page": {
"default": 1,
"maximum": 32,
"minimum": 1,
"type": "integer"
}
},
"required": [
"cheatsheetId",
"page",
"limit"
],
"type": "object"
},
"name": "get_cheatsheet",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"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": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"guideSlug": {
"description": "Optional exact guide reference from get_subject_outline or search_content.",
"type": "string"
},
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"maximumSections": {
"default": 3,
"maximum": 5,
"minimum": 1,
"type": "integer"
},
"maximumTokens": {
"default": 1800,
"maximum": 4000,
"minimum": 250,
"type": "integer"
},
"query": {
"description": "The concept or question the student needs help with.",
"minLength": 2,
"type": "string"
},
"subjectSlug": {
"description": "Fiveable subject slug, e.g. \"ap-bio\". A course name such as \"AP Biology\" also resolves.",
"minLength": 2,
"type": "string"
}
},
"required": [
"subjectSlug",
"query",
"maximumSections",
"maximumTokens"
],
"type": "object"
},
"name": "get_content_sections",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"sessionToken": {
"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)$",
"type": "string"
}
},
"required": [
"sessionToken"
],
"type": "object"
},
"name": "get_diagnostic_results",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"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. With progress:read consent, includes only genuine server-saved continuation links. Browser-only progress is not remotely recoverable.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"subjectSlug": {
"maxLength": 100,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"unitNumber": {
"maximum": 99,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "get_exam_options",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"attemptId": {
"pattern": "^[a-f0-9]{24}$",
"type": "string"
},
"submissionId": {
"pattern": "^[a-f0-9]{24}$",
"type": "string"
}
},
"type": "object"
},
"name": "get_exam_results",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"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": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"frqId": {
"description": "FRQ id from list_frqs.",
"minLength": 1,
"type": "string"
},
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
}
},
"required": [
"frqId"
],
"type": "object"
},
"name": "get_frq",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"frqId": {
"description": "FRQ id from list_frqs.",
"minLength": 1,
"type": "string"
},
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
}
},
"required": [
"frqId"
],
"type": "object"
},
"name": "get_frq_attempt_history",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"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": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"subjectSlug": {
"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.",
"minLength": 2,
"type": "string"
},
"termSlug": {
"description": "Key term slug or the term itself, e.g. \"natural-selection\".",
"minLength": 1,
"type": "string"
}
},
"required": [
"subjectSlug",
"termSlug"
],
"type": "object"
},
"name": "get_key_term",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "Explains which features this account can use for one subject and its remaining MCP previews. Does not return billing information or change access.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"subjectSlug": {
"maxLength": 100,
"minLength": 1,
"type": "string"
}
},
"required": [
"subjectSlug"
],
"type": "object"
},
"name": "get_my_access",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"subjectSlug": {
"description": "Subject slug, e.g. \"ap-bio\".",
"minLength": 2,
"type": "string"
}
},
"required": [
"subjectSlug"
],
"type": "object"
},
"name": "get_my_frq_progress",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"cursor": {
"pattern": "^[a-f0-9]{24}$",
"type": "string"
},
"limit": {
"default": 10,
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"subjectSlug": {
"maxLength": 100,
"minLength": 1,
"type": "string"
}
},
"required": [
"subjectSlug",
"limit"
],
"type": "object"
},
"name": "get_my_practice_history",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"subjectSlug": {
"description": "Fiveable subject slug, e.g. \"ap-bio\".",
"minLength": 2,
"type": "string"
}
},
"required": [
"subjectSlug"
],
"type": "object"
},
"name": "get_my_study_progress",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.\n\nEvery 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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"courseVariant": {
"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.",
"enum": [
"ab",
"bc"
],
"type": "string"
},
"includeAnswers": {
"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.",
"type": "boolean"
},
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"limit": {
"default": 5,
"description": "Exact maximum number of questions to return, including questions in a stimulus set.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"mode": {
"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.",
"enum": [
"auto",
"exam",
"topic"
],
"type": "string"
},
"questionFormat": {
"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.",
"enum": [
"auto",
"stimulus-set",
"standalone"
],
"type": "string"
},
"recentAnswered": {
"description": "How many questions the student recently answered. Needs 3+ before the tier moves.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"recentCorrect": {
"description": "How many of the student's recent answers were correct, for automatic tier adjustment.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"subjectSlug": {
"description": "Fiveable subject slug, e.g. \"ap-bio\". A course name such as \"AP Biology\" also resolves.",
"minLength": 2,
"type": "string"
},
"tier": {
"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.",
"enum": [
"stimulus",
"comprehension",
"vocabulary"
],
"type": "string"
},
"topic": {
"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.",
"type": "string"
},
"topicId": {
"description": "Exact topic id from get_subject_outline, if known.",
"type": "string"
},
"unitId": {
"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.",
"type": "string"
}
},
"required": [
"subjectSlug",
"limit",
"includeAnswers",
"questionFormat",
"mode"
],
"type": "object"
},
"name": "get_practice_questions",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "Read the status or saved result of your FRQ scoring request. This never starts or retries scoring.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"scoringJobId": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
}
},
"required": [
"scoringJobId"
],
"type": "object"
},
"name": "get_scoring_result",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"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 free caller unless existing access covers this subject and feature. Expensive — a full guide can be 3-8k tokens.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"guideSlug": {
"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\".",
"minLength": 2,
"type": "string"
},
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"subjectSlug": {
"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.",
"minLength": 2,
"type": "string"
}
},
"required": [
"subjectSlug",
"guideSlug"
],
"type": "object"
},
"name": "get_study_guide",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"planId": {
"pattern": "^[a-f0-9]{24}$",
"type": "string"
}
},
"required": [
"planId"
],
"type": "object"
},
"name": "get_study_plan",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"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": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"subjectSlug": {
"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.",
"minLength": 2,
"type": "string"
}
},
"required": [
"subjectSlug"
],
"type": "object"
},
"name": "get_subject_outline",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"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": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"subjectSlug": {
"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.",
"minLength": 2,
"type": "string"
},
"unitSlug": {
"description": "Unit slug from get_subject_outline, e.g. \"unit-1\".",
"minLength": 1,
"type": "string"
}
},
"required": [
"subjectSlug",
"unitSlug"
],
"type": "object"
},
"name": "get_unit_overview",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"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": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"courseVariant": {
"maxLength": 100,
"minLength": 2,
"type": "string"
},
"cursor": {
"pattern": "^cs_[a-f0-9]{24}$",
"type": "string"
},
"limit": {
"default": 10,
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"subjectSlug": {
"maxLength": 100,
"minLength": 2,
"type": "string"
},
"unitNumber": {
"maximum": 30,
"minimum": 0,
"type": "integer"
}
},
"required": [
"limit"
],
"type": "object"
},
"name": "list_cheatsheets",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"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": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"courseVariant": {
"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.",
"enum": [
"ab",
"bc"
],
"type": "string"
},
"cursor": {
"pattern": "^[A-Za-z0-9_-]{1,512}$",
"type": "string"
},
"excludeIds": {
"items": {
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"frqType": {
"description": "Optional FRQ type filter, e.g. \"DBQ\", \"LEQ\", \"SAQ\". Varies by subject.",
"type": "string"
},
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"limit": {
"default": 10,
"description": "Maximum prompts to list.",
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"subjectSlug": {
"description": "Fiveable subject slug, e.g. \"ap-bio\". A course name such as \"AP Biology\" also resolves.",
"minLength": 2,
"type": "string"
},
"unitId": {
"description": "Unit ID or public unit slug from get_subject_outline.",
"maxLength": 100,
"type": "string"
}
},
"required": [
"subjectSlug",
"limit"
],
"type": "object"
},
"name": "list_frqs",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"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": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"letter": {
"default": "ALL",
"description": "Filter to terms starting with one letter, or \"ALL\" for every term.",
"type": "string"
},
"limit": {
"default": 25,
"description": "Terms per page.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"page": {
"default": 1,
"description": "1-indexed page number.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"subjectSlug": {
"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.",
"minLength": 2,
"type": "string"
}
},
"required": [
"subjectSlug",
"page",
"limit",
"letter"
],
"type": "object"
},
"name": "list_key_terms",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"cursor": {
"pattern": "^[a-f0-9]{24}$",
"type": "string"
},
"limit": {
"default": 10,
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"subjectSlug": {
"maxLength": 100,
"pattern": "^[a-z0-9-]+$",
"type": "string"
}
},
"required": [
"limit"
],
"type": "object"
},
"name": "list_my_assignments",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"cursor": {
"pattern": "^[a-f0-9]{24}$",
"type": "string"
},
"limit": {
"default": 10,
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"subjectSlug": {
"maxLength": 100,
"pattern": "^[a-z0-9-]+$",
"type": "string"
}
},
"required": [
"limit"
],
"type": "object"
},
"name": "list_my_exam_attempts",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "Lists the connected student's saved Fiveable study plans, including website plans. Free for signed-in students. Cheap; paginated.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"cursor": {
"pattern": "^[a-f0-9]{24}$",
"type": "string"
},
"limit": {
"default": 10,
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"subjectSlug": {
"maxLength": 100,
"minLength": 2,
"type": "string"
}
},
"required": [
"limit"
],
"type": "object"
},
"name": "list_my_study_plans",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"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": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"search": {
"description": "Optional case-insensitive filter on subject name, e.g. \"bio\" or \"history\".",
"type": "string"
}
},
"type": "object"
},
"name": "list_subjects",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"courseVariant": {
"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.",
"enum": [
"ab",
"bc"
],
"type": "string"
},
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"limit": {
"default": 5,
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"questionFormat": {
"default": "auto",
"enum": [
"auto",
"stimulus-set",
"standalone"
],
"type": "string"
},
"subjectSlug": {
"maxLength": 100,
"minLength": 2,
"type": "string"
},
"tier": {
"enum": [
"stimulus",
"comprehension",
"vocabulary"
],
"type": "string"
},
"topic": {
"description": "Free-text topic or a CED topic number like \"3.3\", matched against Fiveable course topics.",
"maxLength": 200,
"type": "string"
},
"topicId": {
"maxLength": 100,
"type": "string"
},
"unitId": {
"maxLength": 100,
"type": "string"
}
},
"required": [
"subjectSlug",
"limit",
"questionFormat"
],
"type": "object"
},
"name": "open_guided_practice",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"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": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"confirmReport": {
"const": true,
"description": "True only after the student explicitly requests sending this issue to Fiveable.",
"type": "boolean"
},
"contentId": {
"description": "Exact guide/question/FRQ ID, or the exact canonical key-term path from Fiveable.",
"maxLength": 250,
"minLength": 2,
"type": "string"
},
"contentType": {
"enum": [
"studyGuide",
"keyTerm",
"practiceQuestion",
"frq"
],
"type": "string"
},
"description": {
"description": "Only the issue the student wants reported; no conversation transcript or unrelated personal notes.",
"maxLength": 2000,
"minLength": 10,
"type": "string"
},
"requestId": {
"pattern": "^[\\w-]{8,128}$",
"type": "string"
}
},
"required": [
"contentType",
"contentId",
"description",
"requestId",
"confirmReport"
],
"type": "object"
},
"name": "report_content_issue",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"frqType": {
"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.",
"maxLength": 120,
"minLength": 2,
"type": "string"
},
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"partResponses": {
"items": {
"additionalProperties": false,
"properties": {
"partLetter": {
"description": "Part label, e.g. \"a\" or \"UNIFIED\".",
"maxLength": 20,
"minLength": 1,
"type": "string"
},
"response": {
"description": "Verified transcription or pasted response.",
"maxLength": 50000,
"minLength": 1,
"type": "string"
}
},
"required": [
"partLetter",
"response"
],
"type": "object"
},
"maxItems": 30,
"minItems": 1,
"type": "array"
},
"promptImages": {
"description": "Optional original prompt images for diagrams, graphs, maps, or artwork.",
"items": {
"additionalProperties": false,
"properties": {
"data": {
"description": "Base64 image payload without a data-URI prefix.",
"maxLength": 3000000,
"minLength": 100,
"type": "string"
},
"mediaType": {
"enum": [
"image/jpeg",
"image/png",
"image/webp"
],
"type": "string"
}
},
"required": [
"data",
"mediaType"
],
"type": "object"
},
"maxItems": 4,
"type": "array"
},
"promptLabel": {
"description": "Short label shown in attempt history.",
"maxLength": 160,
"type": "string"
},
"promptText": {
"description": "Verified transcription or pasted text of the complete prompt.",
"maxLength": 30000,
"minLength": 20,
"type": "string"
},
"requestId": {
"description": "Stable unique request ID. Reuse it only for retries of the same submission; a new response needs a new ID.",
"pattern": "^[\\w-]{8,128}$",
"type": "string"
},
"responseImages": {
"description": "Optional response images that must be evaluated visually, such as a student-drawn graph.",
"items": {
"additionalProperties": false,
"properties": {
"data": {
"description": "Base64 image payload without a data-URI prefix.",
"maxLength": 3000000,
"minLength": 100,
"type": "string"
},
"label": {
"maxLength": 120,
"type": "string"
},
"mediaType": {
"enum": [
"image/jpeg",
"image/png",
"image/webp"
],
"type": "string"
},
"partLetter": {
"maxLength": 20,
"minLength": 1,
"type": "string"
}
},
"required": [
"data",
"mediaType",
"partLetter"
],
"type": "object"
},
"maxItems": 8,
"type": "array"
},
"subjectSlug": {
"description": "Fiveable subject slug, e.g. \"ap-bio\".",
"minLength": 2,
"type": "string"
},
"transcriptionConfirmed": {
"const": true,
"description": "Must be true only after the student confirms the transcribed prompt and response text.",
"type": "boolean"
}
},
"required": [
"subjectSlug",
"frqType",
"promptText",
"transcriptionConfirmed",
"partResponses"
],
"type": "object"
},
"name": "score_external_frq_response",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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 free score is available to signed-in students.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"businessProjectPracticeMode": {
"enum": [
"use_my_project",
"use_a_sample_project"
],
"type": "string"
},
"businessProjectReference": {
"additionalProperties": false,
"properties": {
"customer_problem_or_need": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"financing_assumptions": {
"additionalProperties": false,
"properties": {
"access_constraints": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"external_financial_capital_needed": {
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"internal_financial_capital": {
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"operating_costs_until_break_even": {
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"startup_costs": {
"maxLength": 300,
"minLength": 1,
"type": "string"
}
},
"required": [
"startup_costs",
"operating_costs_until_break_even",
"internal_financial_capital",
"external_financial_capital_needed",
"access_constraints"
],
"type": "object"
},
"pricing_decision": {
"additionalProperties": false,
"properties": {
"decision": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"selected_price": {
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"strategy": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
}
},
"required": [
"strategy",
"selected_price",
"decision"
],
"type": "object"
},
"product": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"research_method_and_evidence": {
"additionalProperties": false,
"properties": {
"evidence": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"method": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"sample": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
}
},
"required": [
"method",
"sample",
"evidence"
],
"type": "object"
},
"target_customer": {
"additionalProperties": false,
"properties": {
"profile": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
}
},
"required": [
"profile"
],
"type": "object"
},
"tested_hypothesis": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"value_proposition": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
}
},
"required": [
"product",
"target_customer",
"customer_problem_or_need",
"value_proposition",
"pricing_decision",
"tested_hypothesis",
"research_method_and_evidence",
"financing_assumptions"
],
"type": "object"
},
"frqId": {
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"partResponses": {
"items": {
"additionalProperties": false,
"properties": {
"drawingData": {
"additionalProperties": false,
"properties": {
"data": {
"maxLength": 3000100,
"minLength": 16,
"type": "string"
},
"drawingLabel": {
"maxLength": 200,
"type": "string"
},
"height": {
"maximum": 10000,
"minimum": 1,
"type": "integer"
},
"mimeType": {
"enum": [
"image/png",
"image/jpeg",
"image/webp"
],
"type": "string"
},
"source": {
"enum": [
"drawing",
"uploaded_photo"
],
"type": "string"
},
"type": {
"const": "canvas",
"type": "string"
},
"width": {
"maximum": 10000,
"minimum": 1,
"type": "integer"
}
},
"required": [
"type",
"data",
"width",
"height"
],
"type": "object"
},
"partLetter": {
"maxLength": 20,
"minLength": 1,
"type": "string"
},
"response": {
"default": "",
"description": "Student's own response, verbatim. May be empty for a drawing/photo-only response.",
"maxLength": 50000,
"type": "string"
},
"subpartNumeral": {
"maxLength": 20,
"type": "string"
}
},
"required": [
"partLetter",
"response"
],
"type": "object"
},
"maxItems": 30,
"minItems": 1,
"type": "array"
},
"programCode": {
"maxLength": 100000,
"type": "string"
},
"promptVariantId": {
"const": "official_2026_v1",
"type": "string"
},
"requestId": {
"description": "Stable unique request ID. Reuse it only for retries of the same submission; a new response needs a new ID.",
"pattern": "^[\\w-]{8,128}$",
"type": "string"
},
"selectedLeqQuestion": {
"maximum": 4,
"minimum": 2,
"type": "integer"
}
},
"required": [
"frqId",
"partResponses"
],
"type": "object"
},
"name": "score_frq_response",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"limit": {
"default": 10,
"description": "Maximum results to return.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "What to search for, e.g. \"photosynthesis light reactions\".",
"minLength": 2,
"type": "string"
},
"subjectSlug": {
"description": "Optional: restrict the search to one subject.",
"type": "string"
}
},
"required": [
"query",
"limit"
],
"type": "object"
},
"name": "search_content",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"courseVariant": {
"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.",
"enum": [
"ab",
"bc"
],
"type": "string"
},
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"requestId": {
"description": "Reuse this ID for retries of the same operation; changed input returns a conflict.",
"pattern": "^[\\w-]{8,128}$",
"type": "string"
},
"subjectSlug": {
"maxLength": 100,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"unitId": {
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"subjectSlug"
],
"type": "object"
},
"name": "start_diagnostic",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"answer": {
"maxLength": 1000,
"minLength": 1,
"type": "string"
},
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"questionId": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"requestId": {
"description": "Reuse this ID for retries of the same operation; changed input returns a conflict.",
"pattern": "^[\\w-]{8,128}$",
"type": "string"
},
"sessionToken": {
"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)$",
"type": "string"
}
},
"required": [
"sessionToken",
"questionId",
"answer"
],
"type": "object"
},
"name": "submit_diagnostic_answer",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"answer": {
"description": "The displayed option label (for example \"B\" or \"B.\") or the full answer text.",
"maxLength": 1000,
"minLength": 1,
"type": "string"
},
"intent": {
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics.",
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string"
},
"questionId": {
"description": "The practice question id from get_practice_questions.",
"minLength": 1,
"type": "string"
},
"requestId": {
"description": "Reuse this ID for retries of the same answer; changed input returns a conflict.",
"pattern": "^[\\w-]{8,128}$",
"type": "string"
}
},
"required": [
"questionId",
"answer"
],
"type": "object"
},
"name": "submit_practice_answer",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"expectedRevision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"planId": {
"pattern": "^[a-f0-9]{24}$",
"type": "string"
},
"requestId": {
"description": "Unique id for this intended action. Reuse it with identical input on retries.",
"pattern": "^[\\w-]{8,128}$",
"type": "string"
},
"tasks": {
"items": {
"additionalProperties": false,
"properties": {
"completed": {
"type": "boolean"
},
"taskId": {
"pattern": "^session-\\d+-task-\\d+$",
"type": "string"
}
},
"required": [
"taskId",
"completed"
],
"type": "object"
},
"maxItems": 240,
"minItems": 1,
"type": "array"
}
},
"required": [
"planId",
"expectedRevision",
"requestId",
"tasks"
],
"type": "object"
},
"name": "update_study_plan_tasks",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"status": {
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome.",
"type": "string"
},
"text": {
"description": "Readable tool result text for clients that consume structured output.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:2d5921cab2b3df6c04298e096d7daee1b07cca328411019334a20d283ed91f40 | sha256sum