Skip to main content

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_term

practice 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_score

save 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_history

score an frq

sign-in required

Score a Fiveable FRQ or a prompt and response supplied by the student.

score_frq_responsescore_external_frq_response

Get 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_result

Check 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_access

Review 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_history

Generate 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_cheatsheet

Get 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_result

List 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_cheatsheets

Read 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_cheatsheet

Report 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_issue

List 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_plans

Get 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_plan

Create 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_plan

Update 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_tasks

Find 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_options

List 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_attempts

Review 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_results

List 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_assignments

Read 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_summary

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