Fiveable for AP Students is an MCP server published by io.github.thinkfiveable, hosted at fiveable.me. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 38 tools, including list_subjects, get_subject_outline, get_study_guide, get_unit_overview, list_key_terms.
AP study content, practice, FRQ feedback, progress, plans, and student tools for AI apps.
919 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Lists every AP subject Fiveable covers, with its canonical subject slug and flags for which features exist for that subject (practice questions, key terms, score calculator). Suitable when a subject slug is not already known. Cheap — roughly 1-2k tokens.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| search | string | Optional case-insensitive filter on subject name, e.g. "bio" or "history". |
{
"name": "list_subjects",
"title": "List AP subjects",
"description": "Lists every AP subject Fiveable covers, with its canonical subject slug and flags for which features exist for that subject (practice questions, key terms, score calculator). Suitable when a subject slug is not already known. Cheap — roughly 1-2k tokens.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"search": {
"type": "string",
"description": "Optional case-insensitive filter on subject name, e.g. \"bio\" or \"history\"."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List AP subjects",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Returns the full unit and topic outline for one AP subject, including every study guide slug in each unit. Provides the course map for study planning and individual guide retrieval. Moderate cost — roughly 2-5k tokens depending on subject size.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| subjectSlug * | string | Fiveable subject slug, e.g. "ap-bio" or "apush". The course name or a close approximation such as "ap-biology" also resolves. Use list_subjects to find it. |
{
"name": "get_subject_outline",
"title": "Get subject outline",
"description": "Returns the full unit and topic outline for one AP subject, including every study guide slug in each unit. Provides the course map for study planning and individual guide retrieval. Moderate cost — roughly 2-5k tokens depending on subject size.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug"
],
"properties": {
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"subjectSlug": {
"type": "string",
"minLength": 2,
"description": "Fiveable subject slug, e.g. \"ap-bio\" or \"apush\". The course name or a close approximation such as \"ap-biology\" also resolves. Use list_subjects to find it."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get subject outline",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns the full text of one Fiveable AP study guide as Markdown. Accepts the exact canonical guide reference or a close approximation of its title. Suitable when a student asks to learn or review a topic. It consumes one full-content preview for a caller unless existing access covers this subject and feature. Expensive — a full guide can be 3-8k tokens.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| guideSlug * | string | Canonical guide reference from get_subject_outline, content slug, document id, or title, e.g. "/ap-bio/unit-2/cell-structure/study-guide/abc123" or "cell-structure". |
| subjectSlug * | string | Fiveable subject slug, e.g. "ap-bio" or "apush". The course name or a close approximation such as "ap-biology" also resolves. Use list_subjects to find it. |
{
"name": "get_study_guide",
"title": "Get a study guide",
"description": "Returns the full text of one Fiveable AP study guide as Markdown. Accepts the exact canonical guide reference or a close approximation of its title. Suitable when a student asks to learn or review a topic. It consumes one full-content preview for a caller unless existing access covers this subject and feature. Expensive — a full guide can be 3-8k tokens.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"guideSlug"
],
"properties": {
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"guideSlug": {
"type": "string",
"minLength": 2,
"description": "Canonical guide reference from get_subject_outline, content slug, document id, or title, e.g. \"/ap-bio/unit-2/cell-structure/study-guide/abc123\" or \"cell-structure\"."
},
"subjectSlug": {
"type": "string",
"minLength": 2,
"description": "Fiveable subject slug, e.g. \"ap-bio\" or \"apush\". The course name or a close approximation such as \"ap-biology\" also resolves. Use list_subjects to find it."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get a study guide",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns the overview page for one unit of an AP course: what it covers, how it is weighted on the exam, its topics and study plan. Suitable when a student is reviewing a whole unit. Moderate cost — roughly 1-3k tokens.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| unitSlug * | string | Unit slug from get_subject_outline, e.g. "unit-1". |
| subjectSlug * | string | Fiveable subject slug, e.g. "ap-bio" or "apush". The course name or a close approximation such as "ap-biology" also resolves. Use list_subjects to find it. |
{
"name": "get_unit_overview",
"title": "Get unit overview",
"description": "Returns the overview page for one unit of an AP course: what it covers, how it is weighted on the exam, its topics and study plan. Suitable when a student is reviewing a whole unit. Moderate cost — roughly 1-3k tokens.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"unitSlug"
],
"properties": {
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"unitSlug": {
"type": "string",
"minLength": 1,
"description": "Unit slug from get_subject_outline, e.g. \"unit-1\"."
},
"subjectSlug": {
"type": "string",
"minLength": 2,
"description": "Fiveable subject slug, e.g. \"ap-bio\" or \"apush\". The course name or a close approximation such as \"ap-biology\" also resolves. Use list_subjects to find it."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get unit overview",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Lists the key vocabulary terms for an AP subject, paginated alphabetically. Suitable for building flashcards or checking what vocabulary a student should know; results include stable term slugs for full definitions. Cheap.
| Parameter | Type | Description |
|---|---|---|
| page * | integer | 1-indexed page number. |
| limit * | integer | Terms per page. |
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| letter * | string | Filter to terms starting with one letter, or "ALL" for every term. |
| subjectSlug * | string | Fiveable subject slug, e.g. "ap-bio" or "apush". The course name or a close approximation such as "ap-biology" also resolves. Use list_subjects to find it. |
{
"name": "list_key_terms",
"title": "List key terms",
"description": "Lists the key vocabulary terms for an AP subject, paginated alphabetically. Suitable for building flashcards or checking what vocabulary a student should know; results include stable term slugs for full definitions. Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"page",
"limit",
"letter"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-indexed page number."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 1,
"description": "Terms per page."
},
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"letter": {
"type": "string",
"default": "ALL",
"description": "Filter to terms starting with one letter, or \"ALL\" for every term."
},
"subjectSlug": {
"type": "string",
"minLength": 2,
"description": "Fiveable subject slug, e.g. \"ap-bio\" or \"apush\". The course name or a close approximation such as \"ap-biology\" also resolves. Use list_subjects to find it."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List key terms",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns the full definition, context and related terms for one AP key term. Use when a student asks "what does X mean" for AP vocabulary. Cheap — usually under 1k tokens.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| termSlug * | string | Key term slug or the term itself, e.g. "natural-selection". |
| subjectSlug * | string | Fiveable subject slug, e.g. "ap-bio" or "apush". The course name or a close approximation such as "ap-biology" also resolves. Use list_subjects to find it. |
{
"name": "get_key_term",
"title": "Get a key term",
"description": "Returns the full definition, context and related terms for one AP key term. Use when a student asks \"what does X mean\" for AP vocabulary. Cheap — usually under 1k tokens.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"termSlug"
],
"properties": {
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"termSlug": {
"type": "string",
"minLength": 1,
"description": "Key term slug or the term itself, e.g. \"natural-selection\"."
},
"subjectSlug": {
"type": "string",
"minLength": 2,
"description": "Fiveable subject slug, e.g. \"ap-bio\" or \"apush\". The course name or a close approximation such as \"ap-biology\" also resolves. Use list_subjects to find it."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get a key term",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Fiveable's site search across study guides, units, subject hubs, key terms, unit tests, unit vocab lists and practice pages. Handles typos, course names and requests like "apush unit 3 test". Suitable when the relevant subject or guide is not known. Returns titles and canonical references rather than full content, so it is cheap.
| Parameter | Type | Description |
|---|---|---|
| limit * | integer | Maximum results to return. |
| query * | string | What to search for, e.g. "photosynthesis light reactions". |
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| subjectSlug | string | Optional: restrict the search to one subject. |
{
"name": "search_content",
"title": "Search Fiveable content",
"description": "Fiveable's site search across study guides, units, subject hubs, key terms, unit tests, unit vocab lists and practice pages. Handles typos, course names and requests like \"apush unit 3 test\". Suitable when the relevant subject or guide is not known. Returns titles and canonical references rather than full content, so it is cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query",
"limit"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Maximum results to return."
},
"query": {
"type": "string",
"minLength": 2,
"description": "What to search for, e.g. \"photosynthesis light reactions\"."
},
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"subjectSlug": {
"type": "string",
"description": "Optional: restrict the search to one subject."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Search Fiveable content",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns a small set of Fiveable study-guide passages relevant to one question. Suitable for narrow explanations, research questions and checking student notes. One call consumes one full-content preview for a caller without existing access.
| Parameter | Type | Description |
|---|---|---|
| query * | string | The concept or question the student needs help with. |
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| guideSlug | string | Optional exact guide reference from get_subject_outline or search_content. |
| subjectSlug * | string | Fiveable subject slug, e.g. "ap-bio". A course name such as "AP Biology" also resolves. |
| maximumTokens * | integer | |
| maximumSections * | integer |
{
"name": "get_content_sections",
"title": "Get relevant study guide sections",
"description": "Returns a small set of Fiveable study-guide passages relevant to one question. Suitable for narrow explanations, research questions and checking student notes. One call consumes one full-content preview for a caller without existing access.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"query",
"maximumSections",
"maximumTokens"
],
"properties": {
"query": {
"type": "string",
"minLength": 2,
"description": "The concept or question the student needs help with."
},
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"guideSlug": {
"type": "string",
"description": "Optional exact guide reference from get_subject_outline or search_content."
},
"subjectSlug": {
"type": "string",
"minLength": 2,
"description": "Fiveable subject slug, e.g. \"ap-bio\". A course name such as \"AP Biology\" also resolves."
},
"maximumTokens": {
"type": "integer",
"default": 1800,
"maximum": 4000,
"minimum": 250
},
"maximumSections": {
"type": "integer",
"default": 3,
"maximum": 5,
"minimum": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get relevant study guide sections",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Lists Fiveable's free-response (FRQ) practice prompts for an AP subject, optionally filtered by FRQ type, unit, and excluded IDs. Results use stable ID order; unchanged filters continue pagination. Returns prompt ids and summaries rather than full prompts. Cheap.
| Parameter | Type | Description |
|---|---|---|
| limit * | integer | Maximum prompts to list. |
| cursor | string | |
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| unitId | string | Unit ID or public unit slug from get_subject_outline. |
| frqType | string | Optional FRQ type filter, e.g. "DBQ", "LEQ", "SAQ". Varies by subject. |
| excludeIds | array | |
| subjectSlug * | string | Fiveable subject slug, e.g. "ap-bio". A course name such as "AP Biology" also resolves. |
| courseVariant | string | AP Calculus only (subject ap-calc): 'ab' hides BC-only units and topics; 'bc' includes them. Defaults to the student's saved Fiveable course when they are connected. |
{
"name": "list_frqs",
"title": "List free-response questions",
"description": "Lists Fiveable's free-response (FRQ) practice prompts for an AP subject, optionally filtered by FRQ type, unit, and excluded IDs. Results use stable ID order; unchanged filters continue pagination. Returns prompt ids and summaries rather than full prompts. Cheap.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"limit"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "Maximum prompts to list."
},
"cursor": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,512}$"
},
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"unitId": {
"type": "string",
"maxLength": 100,
"description": "Unit ID or public unit slug from get_subject_outline."
},
"frqType": {
"type": "string",
"description": "Optional FRQ type filter, e.g. \"DBQ\", \"LEQ\", \"SAQ\". Varies by subject."
},
"excludeIds": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 100
},
"subjectSlug": {
"type": "string",
"minLength": 2,
"description": "Fiveable subject slug, e.g. \"ap-bio\". A course name such as \"AP Biology\" also resolves."
},
"courseVariant": {
"enum": [
"ab",
"bc"
],
"type": "string",
"description": "AP Calculus only (subject ap-calc): 'ab' hides BC-only units and topics; 'bc' includes them. Defaults to the student's saved Fiveable course when they are connected."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List free-response questions",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns one full, original Fiveable FRQ prompt: stimulus, background and every lettered part with its point value. The returned prompt is eligible for Fiveable's saved scoring workflow after the student writes a response. It consumes one full-content preview unless existing access covers this FRQ. Moderate cost — 1-4k tokens.
| Parameter | Type | Description |
|---|---|---|
| frqId * | string | FRQ id from list_frqs. |
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
{
"name": "get_frq",
"title": "Get a free-response question",
"description": "Returns one full, original Fiveable FRQ prompt: stimulus, background and every lettered part with its point value. The returned prompt is eligible for Fiveable's saved scoring workflow after the student writes a response. It consumes one full-content preview unless existing access covers this FRQ. Moderate cost — 1-4k tokens.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"frqId"
],
"properties": {
"frqId": {
"type": "string",
"minLength": 1,
"description": "FRQ id from list_frqs."
},
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get a free-response question",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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 = sour… |
| limit * | integer | Exact maximum number of questions to return, including questions in a stimulus set. |
| topic | string | 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 | 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 | 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 | string | Exact topic id from get_subject_outline, if known. |
| 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. |
| recentCorrect | integer | How many of the student's recent answers were correct, for automatic tier adjustment. |
| includeAnswers * | boolean | 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 * | string | "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 | integer | How many questions the student recently answered. Needs 3+ before the tier moves. |
{
"name": "get_practice_questions",
"title": "Get multiple-choice practice questions",
"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": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get multiple-choice practice questions",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| subjectSlug * | string | Fiveable subject slug, e.g. "ap-bio". |
| sectionScores | array | Raw scores per card. Omit to discover the subject's card structure first. |
{
"name": "calculate_ap_score",
"title": "Predict an AP score",
"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": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Predict an AP score",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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. |
{
"name": "check_practice_answer",
"title": "Check a practice answer",
"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": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Check a practice answer",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| subjectSlug * | string | Fiveable subject slug, e.g. "ap-bio". |
{
"name": "get_my_study_progress",
"title": "Get my study progress",
"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": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get my study progress",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| 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 | Fiveable subject slug, e.g. "ap-bio". |
| promptImages | array | Optional original prompt images for diagrams, graphs, maps, or artwork. |
| partResponses * | array | |
| responseImages | array | Optional response images that must be evaluated visually, such as a student-drawn graph. |
| transcriptionConfirmed * | boolean | Must be true only after the student confirms the transcribed prompt and response text. |
{
"name": "score_external_frq_response",
"title": "Score an uploaded or pasted FRQ",
"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": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Score an uploaded or pasted FRQ",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| 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. |
{
"name": "start_diagnostic",
"title": "Start an adaptive AP diagnostic",
"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": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Start an adaptive AP diagnostic",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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 |
{
"name": "submit_diagnostic_answer",
"title": "Answer the current diagnostic question",
"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": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Answer the current diagnostic question",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| sessionToken * | string |
{
"name": "get_diagnostic_results",
"title": "Read my diagnostic status or results",
"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": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Read my diagnostic status or results",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| subjectSlug * | string | Subject slug, e.g. "ap-bio". |
{
"name": "get_my_frq_progress",
"title": "Get my FRQ progress",
"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": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get my FRQ progress",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| frqId * | string | FRQ id from list_frqs. |
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
{
"name": "get_frq_attempt_history",
"title": "Get attempt history for one FRQ",
"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": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"frqId"
],
"properties": {
"frqId": {
"type": "string",
"minLength": 1,
"description": "FRQ id from list_frqs."
},
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get attempt history for one FRQ",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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 | string | one of ["use_my_project","use_a_sample_project"] |
{
"name": "score_frq_response",
"title": "Score a free-response answer",
"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 included score is available to signed-in students.",
"inputSchema": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Score a free-response answer",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Read the status or saved result of your FRQ scoring request. This never starts or retries scoring.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics. |
| scoringJobId * | string |
{
"name": "get_scoring_result",
"title": "Get a saved FRQ scoring result",
"description": "Read the status or saved result of your FRQ scoring request. This never starts or retries scoring.",
"inputSchema": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get a saved FRQ scoring result",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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. |
{
"name": "submit_practice_answer",
"title": "Record a practice question answer",
"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": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Record a practice question answer",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Explains which features this account can use for one subject and its remaining MCP previews. Does not return billing information or change access.
| Parameter | Type | Description |
|---|---|---|
| subjectSlug * | string |
{
"name": "get_my_access",
"title": "Check my Fiveable access",
"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": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug"
],
"properties": {
"subjectSlug": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Check my Fiveable access",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit * | integer | |
| cursor | string | |
| subjectSlug * | string |
{
"name": "get_my_practice_history",
"title": "Review my practice answers",
"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": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Review my practice answers",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Find approved Fiveable course and unit PDFs, including course variants, academic year when known, source links and readable-artifact readiness. Does not include user galleries or generated personal visuals.
| Parameter | Type | Description |
|---|---|---|
| limit * | integer | |
| cursor | string | |
| unitNumber | integer | |
| subjectSlug | string | |
| courseVariant | string |
{
"name": "list_cheatsheets",
"title": "List official Fiveable cheatsheets",
"description": "Find approved Fiveable course and unit PDFs, including course variants, academic year when known, source links and readable-artifact readiness. Does not include user galleries or generated personal visuals.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"limit"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1
},
"cursor": {
"type": "string",
"pattern": "^cs_[a-f0-9]{24}$"
},
"unitNumber": {
"type": "integer",
"maximum": 30,
"minimum": 0
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"courseVariant": {
"type": "string",
"maxLength": 100,
"minLength": 2
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List official Fiveable cheatsheets",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Reads bounded pages from a prepared official Fiveable PDF, returning page citations, extracted text and actual page images for formulas and diagrams. Image-only pages have no guessed transcription. Unavailable artifacts return the approved PDF link. This read never starts processing.
| Parameter | Type | Description |
|---|---|---|
| page * | integer | |
| limit * | integer | |
| cheatsheetId * | string |
{
"name": "get_cheatsheet",
"title": "Read an official Fiveable cheatsheet",
"description": "Reads bounded pages from a prepared official Fiveable PDF, returning page citations, extracted text and actual page images for formulas and diagrams. Image-only pages have no guessed transcription. Unavailable artifacts return the approved PDF link. This read never starts processing.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"cheatsheetId",
"page",
"limit"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 32,
"minimum": 1
},
"limit": {
"type": "integer",
"default": 1,
"maximum": 3,
"minimum": 1
},
"cheatsheetId": {
"type": "string",
"pattern": "^cs_[a-f0-9]{24}$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Read an official Fiveable cheatsheet",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Submits a caller-requested content issue to Fiveable support, which may lead to support follow-up. Requires explicit confirmReport approval. The description contains the reported issue only, excluding conversation history, unrelated notes and personal information. Fiveable resolves content and reporter identity. Matching requestId retries are idempotent.
| Parameter | Type | Description |
|---|---|---|
| contentId * | string | Exact guide/question/FRQ ID, or the exact canonical key-term path from Fiveable. |
| requestId * | string | |
| contentType * | string | one of ["studyGuide","keyTerm","practiceQuestion","frq"] |
| description * | string | Only the issue the student wants reported; no conversation transcript or unrelated personal notes. |
| confirmReport * | boolean | True only after the student explicitly requests sending this issue to Fiveable. |
{
"name": "report_content_issue",
"title": "Report a content issue to Fiveable",
"description": "Submits a caller-requested content issue to Fiveable support, which may lead to support follow-up. Requires explicit confirmReport approval. The description contains the reported issue only, excluding conversation history, unrelated notes and personal information. Fiveable resolves content and reporter identity. Matching requestId retries are idempotent.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contentType",
"contentId",
"description",
"requestId",
"confirmReport"
],
"properties": {
"contentId": {
"type": "string",
"maxLength": 250,
"minLength": 2,
"description": "Exact guide/question/FRQ ID, or the exact canonical key-term path from Fiveable."
},
"requestId": {
"type": "string",
"pattern": "^[\\w-]{8,128}$"
},
"contentType": {
"enum": [
"studyGuide",
"keyTerm",
"practiceQuestion",
"frq"
],
"type": "string"
},
"description": {
"type": "string",
"maxLength": 2000,
"minLength": 10,
"description": "Only the issue the student wants reported; no conversation transcript or unrelated personal notes."
},
"confirmReport": {
"type": "boolean",
"const": true,
"description": "True only after the student explicitly requests sending this issue to Fiveable."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Report a content issue to Fiveable",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Lists the connected student's saved Fiveable study plans, including website plans. Included for signed-in students. Cheap; paginated.
| Parameter | Type | Description |
|---|---|---|
| limit * | integer | |
| cursor | string | |
| subjectSlug | string |
{
"name": "list_my_study_plans",
"title": "List my study plans",
"description": "Lists the connected student's saved Fiveable study plans, including website plans. Included for signed-in students. Cheap; paginated.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"limit"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1
},
"cursor": {
"type": "string",
"pattern": "^[a-f0-9]{24}$"
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"minLength": 2
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List my study plans",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| planId * | string |
{
"name": "get_study_plan",
"title": "Get a study plan",
"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": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"planId"
],
"properties": {
"planId": {
"type": "string",
"pattern": "^[a-f0-9]{24}$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get a study plan",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| scope * | string | |
| timeUnit * | string | one of ["hours","days"] |
| requestId * | string | Unique id for this intended action. Reuse it with identical input on retries. |
| timeAmount * | integer | |
| subjectSlug * | string |
{
"name": "create_study_plan",
"title": "Create a study plan",
"description": "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.",
"inputSchema": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Create a study plan",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| tasks * | array | |
| planId * | string | |
| requestId * | string | Unique id for this intended action. Reuse it with identical input on retries. |
| expectedRevision * | integer |
{
"name": "update_study_plan_tasks",
"title": "Update study plan tasks",
"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": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Update study plan tasks",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Find Fiveable exam formats, access requirements and website links without questions or answer keys. Choose a subject for version choices; add unitNumber to verify that unit's current bank and standard format. With progress:read consent, includes only genuine server-saved continuation links. Browser-only progress is not remotely recoverable.
| Parameter | Type | Description |
|---|---|---|
| unitNumber | integer | |
| subjectSlug | string |
{
"name": "get_exam_options",
"title": "Find practice exams and unit tests",
"description": "Find Fiveable exam formats, access requirements and website links without questions or answer keys. Choose a subject for version choices; add unitNumber to verify that unit's current bank and standard format. With progress:read consent, includes only genuine server-saved continuation links. Browser-only progress is not remotely recoverable.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"unitNumber": {
"type": "integer",
"maximum": 99,
"minimum": 1
},
"subjectSlug": {
"type": "string",
"pattern": "^[a-z0-9-]+$",
"maxLength": 100
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Find practice exams and unit tests",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit * | integer | |
| cursor | string | |
| subjectSlug | string |
{
"name": "list_my_exam_attempts",
"title": "List my completed exams",
"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": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List my completed exams",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| attemptId | string | |
| submissionId | string |
{
"name": "get_exam_results",
"title": "Review my completed exam results",
"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": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Review my completed exam results",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit * | integer | |
| cursor | string | |
| subjectSlug | string |
{
"name": "list_my_assignments",
"title": "List my student assignments",
"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": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List my student assignments",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| publicationId * | string |
{
"name": "get_assignment_summary",
"title": "Read my assignment summary",
"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": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"publicationId"
],
"properties": {
"publicationId": {
"type": "string",
"pattern": "^[a-f0-9]{24}$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Read my assignment summary",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| tier | string | one of ["stimulus","comprehension","vocabulary"] |
| 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. |
| questionFormat * | string | one of ["auto","stimulus-set","standalone"] |
{
"name": "open_guided_practice",
"title": "Open Fiveable Guided Practice",
"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": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subjectSlug",
"limit",
"questionFormat"
],
"properties": {
"tier": {
"enum": [
"stimulus",
"comprehension",
"vocabulary"
],
"type": "string"
},
"limit": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 1
},
"topic": {
"type": "string",
"maxLength": 200,
"description": "Free-text topic or a CED topic number like \"3.3\", matched against Fiveable course topics."
},
"intent": {
"enum": [
"explain",
"quiz",
"notes",
"frq",
"research"
],
"type": "string",
"description": "Privacy-safe reason for the request. Use explain, quiz, notes, frq, or research; never send the student's raw prompt for analytics."
},
"unitId": {
"type": "string",
"maxLength": 100
},
"topicId": {
"type": "string",
"maxLength": 100
},
"subjectSlug": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"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."
},
"questionFormat": {
"enum": [
"auto",
"stimulus-set",
"standalone"
],
"type": "string",
"default": "auto"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status"
],
"properties": {
"text": {
"type": "string",
"description": "Readable tool result text for clients that consume structured output."
},
"status": {
"type": "string",
"description": "Operation status: completed, pending, partial, failed, unavailable, or a domain-specific outcome."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Open Fiveable Guided Practice",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Fiveable is an AP study platform for high school students. Use these tools when a student asks to study with Fiveable content, practice, or saved work. Exams and assignments must be completed on the website, not through MCP. Do not submit reports or generate saved work without the student's request. Never invent scores, completion, or unavailable content. For FRQ grading, ask for missing prompt or rubric context. Until a scoring tool or saved result provides a score, do not estimate points or suggest full credit, even conditionally. You may explain the underlying concept without presenting that explanation as a grade. When a student asks for a diagnostic, readiness check, or broad survey, use start_diagnostic and submit_diagnostic_answer. A get_practice_questions batch is targeted practice, not a diagnostic, and must never be described as broadly surveying a unit or course. Never omit a required stimulus when presenting Fiveable questions. Show each returned stimulus image or Markdown image link before its dependent questions; if the student cannot see it, provide the returned website continuation instead of asking them to answer without the source. When a student sounds stressed, overwhelmed, or down on themselves, pause the task and respond in Fiveable's voice: warm, calm, and quiet, like "you're more prepared than you think" or "this is hard and you're still here." Keep it to three or four plain sentences. Acknowledge the feeling, point to the effort they are already making, and keep growth ahead of outcomes: an AP score is feedback on practice, never a measure of who they are. It is okay to find things hard, okay to be imperfect, and okay to rest; if they sound worn out, tell them a real break counts as studying too. Comfort them without performing: no lecture, no analyzing their word choice or reframing their fear back at them, and full gentle sentences rather than punchy fragments. Never pile on urgency and never frame studying as combat; students practice, build, and grow. Close with one small, doable next step and let them choose it. Suggested flow for a student: 1. list_subjects to resolve the subject slug. 2. get_subject_outline for the map of units and guides. 3. get_content_sections for a narrow question, or get_study_guide for a full review. 4. 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. 5. score_frq_response for a Fiveable prompt, or score_external_frq_response after verifying a transcription. 6. get_my_study_progress when signed in so recommendations reflect durable Fiveable progress. Budget notes: list and search tools are cheap; full study guides run several thousand tokens; score_frq_response is slow and rate limited because it runs a scoring model — call it once per student response, never in a loop.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.