technical reference
Use the endpoint, discovery metadata, OAuth details, and current student tool catalog.
server
Name: fiveable
Version: 1.0.0
Transport: Streamable HTTP
Endpoint: https://fiveable.me/api/mcp
authorization
OAuth 2.1 with PKCE and dynamic client registration.
Anonymous tools work without authorization. Signed-in tools request only their required scope.
discovery metadata
/.well-known/mcp.json/.well-known/oauth-protected-resource/.well-known/oauth-authorization-server
tool catalog
Tool names are stable identifiers used by MCP clients. A full-content preview can be shared across more than one reading tool, so an app should reuse a result instead of pulling the same page again.
find and read content
no account needed
Resolve a subject, browse its course map, search Fiveable, and read focused or full content.
list_subjectsget_subject_outlineget_unit_overviewsearch_contentget_content_sectionsget_study_guidelist_key_termsget_key_termpractice and estimate
no account needed
Practice across a subject, an exact unit, or one topic; view required sources; check an answer; retrieve an FRQ; or estimate an AP score.
get_practice_questionscheck_practice_answerlist_frqsget_frqcalculate_ap_scoresave and review progress
sign-in required
Run an adaptive diagnostic, save practice work, and use the signed-in student's own study history.
start_diagnosticsubmit_diagnostic_answerget_diagnostic_resultssubmit_practice_answerget_my_study_progressget_my_frq_progressget_frq_attempt_historyscore an frq
sign-in required
Score a Fiveable FRQ or a prompt and response supplied by the student.
score_frq_responsescore_external_frq_responseGet a saved FRQ scoring result
sign-in and specified permission required
Read the status or saved result of your FRQ scoring request. This never starts or retries scoring.
get_scoring_resultCheck my Fiveable access
sign-in and specified permission required
Explains which features this account can use for one subject and its remaining MCP previews. Does not return billing information or change access.
get_my_accessReview my practice answers
sign-in and specified permission required
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.
get_my_practice_historyGenerate a visual cheatsheet
sign-in and specified permission required
Create an AI-generated visual summary only when the student asks. Uses a published Fiveable guide and the website's generation pipeline. Requires existing visual-generation access. Like website-generated visuals, the finished image may appear in Fiveable's public gallery. Returns pending or completed; generated images are distinct from official cheatsheets. Reuse the same requestId when retrying.
generate_visual_cheatsheetGet a generated visual cheatsheet
sign-in and specified permission required
Read your own pending or completed visual cheatsheet generation. Does not generate, retry, or change an image. Finished images follow the website's public-gallery behavior. Never retrieves another student's generation job or generator prompts.
get_visual_cheatsheet_resultList official Fiveable cheatsheets
no account needed
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.
list_cheatsheetsRead an official Fiveable cheatsheet
no account needed
Read bounded pages from a prepared official Fiveable PDF, with page citations, extracted text and actual page images for formulas and diagrams. Image-only pages are not transcribed by guessing. If artifacts are unavailable, use the approved PDF link; this read never starts processing.
get_cheatsheetReport a content issue to Fiveable
sign-in and specified permission required
Submit a content issue to Fiveable support only when the student explicitly asks to report it. This may lead to normal support follow-up. Do not automatically report disagreements or send conversation history, unrelated notes, or personal information. Fiveable resolves the content and reporter identity. Reuse requestId on retries.
report_content_issueList my study plans
sign-in and specified permission required
Lists the connected student's saved Fiveable study plans, including website plans. Free for signed-in students. Cheap; paginated.
list_my_study_plansGet a study plan
sign-in and specified permission required
Reads one owned study plan, stable task ids, completion state and revision. Use its revision for task changes. Reading older plans never changes them.
get_study_planCreate a study plan
sign-in and specified permission required
Creates and saves a trackable Fiveable study plan from the student's topic and available time. Free for signed-in students; uses Fiveable's existing generator and verified resource catalog. Takes up to a few minutes. Reuse requestId and identical input after a timeout.
create_study_planUpdate study plan tasks
sign-in and specified permission required
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.
update_study_plan_tasksFind practice exams and unit tests
no account needed
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.
get_exam_optionsList my completed exams
sign-in and specified permission required
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.
list_my_exam_attemptsReview my completed exam results
sign-in and specified permission required
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.
get_exam_resultsList my student assignments
sign-in and specified permission required
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.
list_my_assignmentsRead my assignment summary
sign-in and specified permission required
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. Use publicationId from list_my_assignments.
get_assignment_summaryMCP Inspector endpoint
https://fiveable.me/api/mcp
Building an MCP client? The broader developer and agent resources page covers OpenAPI, Markdown content negotiation, llms.txt, robots.txt, and sitemaps.