Fiveable for AP Students

io.github.thinkfiveable由 GitHub 账号 thinkfiveable 发布v1.0.0更新于 Oct 25, 2026

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

已验证Streamable HTTP可网页运行效率与工作流知识与记忆数据与分析

概览

AI 生成的概览

一个托管的 Fiveable 连接器,让 AI 助手获取 AP 学习指南、练习题、FRQ 评分、分数计算器以及学生本人的学习进度。

可以做什么
浏览 AP 科目、单元大纲、学习指南、关键词和速查表 PDF,并按关键词或相关段落检索全部内容。生成多项选择练习题、运行自适应诊断、核对答案,并根据各部分得分预测 1-5 的 AP 分数。列出并评分自由回答题(FRQ),包括学生自己提供的题目,并读取已保存的评分结果。读取已登录学生的进度、练习记录、FRQ 作答、已完成考试结果和作业摘要。创建和更新学习计划、打开引导练习面板,并向 Fiveable 支持团队报告内容问题。
适用场景
适合希望助手讲解或复习课程内容、刷练习题、获得 FRQ 反馈,并集中查看薄弱单元和学习计划的 AP 学生。匿名预览可用于一般复习;需要保存进度和个人数据时应登录。
运行要求
在 MCP 客户端中添加远程 Streamable HTTP 端点;无需安装,也无需 API 密钥。公开发现和有限的内容预览无需账号。个人进度和保存类操作需要 Fiveable OAuth 登录。
安装前请注意
完整学习指南、段落和 FRQ 题目会消耗有限的预览额度,除非账号已有访问权限。登录后的工具会读取学生本人的进度、作答和作业数据,部分工具会写入:答案、诊断、学习计划、任务完成状态和内容问题报告。内容问题报告会发送给 Fiveable 支持团队,且需要明确确认。不会暴露教师名单和答案。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Fiveable for AP Students,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.thinkfiveable%2Ffiveable-ap-students/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "fiveable-for-ap-students": {
      "type": "http",
      "url": "https://fiveable.me/api/mcp"
    }
  }
}

README

Fiveable for AP Students

Use Fiveable's AP study content and student study tools inside MCP-compatible AI apps.

Teacher connector

Looking for grading and class prep? Fiveable for AP Teachers is a separate connector with its own endpoint and OAuth consent. The root extension and configuration in this repository remain student-only.

Connect

Add this remote Streamable HTTP endpoint to your MCP client:

text
https://fiveable.me/api/mcp

There is no package to install and no API key to copy. Public discovery and limited content previews work without a Fiveable account. Personal progress and saved actions use Fiveable OAuth.

Cursor

This repository includes a Cursor plugin manifest and an mcp.json configuration for the hosted Fiveable server. In Cursor, open Customize → MCPs, add a remote server, and use:

text
https://fiveable.me/api/mcp

Cursor will open Fiveable's OAuth flow when a personalized tool needs account access.

Gemini CLI

Install this repository as a Gemini CLI extension:

bash
gemini extensions install https://github.com/thinkfiveable/fiveable-mcp

Gemini CLI connects to the hosted Fiveable MCP through the extension. Run /mcp auth fiveable-ap-students to connect a Fiveable account for personalized tools.

What it supports

  • AP subjects, units, study guides, key terms, and relevant passages
  • Multiple-choice practice and adaptive diagnostics
  • Fiveable and student-supplied FRQ scoring
  • AP score calculators
  • Personal progress, study plans, and completed exam results
  • Official Fiveable cheatsheets
  • Student-accessible assignment summaries with released feedback

The connector is student-only. It does not expose teacher rosters, active answer keys, internal moderation tools, or another student's data.

Documentation and support

Security

Fiveable uses OAuth 2.1 with PKCE for connected tools. Please report security issues through Fiveable's published security contact rather than a public GitHub issue.

This repository contains public metadata and documentation for the hosted service. The production server implementation lives in Fiveable's private application repository.

来源:README.md,提交 d20e9bb

工具

38

list_subjects

List AP subjects

Lists every AP subject Fiveable covers, with its canonical subject slug and flags for which features exist for that subject (practice questions, key terms, score calculator). Suitable when a subject slug is not already known. Cheap — roughly 1-2k tokens.

输入参数intentsearch

get_subject_outline

Get subject outline

Returns the full unit and topic outline for one AP subject, including every study guide slug in each unit. Provides the course map for study planning and individual guide retrieval. Moderate cost — roughly 2-5k tokens depending on subject size.

输入参数intentsubjectSlug必填

get_study_guide

Get a study guide

Returns the full text of one Fiveable AP study guide as Markdown. Accepts the exact canonical guide reference or a close approximation of its title. Suitable when a student asks to learn or review a topic. It consumes one full-content preview for a caller unless existing access covers this subject and feature. Expensive — a full guide can be 3-8k tokens.

输入参数intentguideSlug必填subjectSlug必填

get_unit_overview

Get unit overview

Returns the overview page for one unit of an AP course: what it covers, how it is weighted on the exam, its topics and study plan. Suitable when a student is reviewing a whole unit. Moderate cost — roughly 1-3k tokens.

输入参数intentunitSlug必填subjectSlug必填

list_key_terms

List key terms

Lists the key vocabulary terms for an AP subject, paginated alphabetically. Suitable for building flashcards or checking what vocabulary a student should know; results include stable term slugs for full definitions. Cheap.

输入参数page必填limit必填intentletter必填subjectSlug必填

get_key_term

Get a key term

Returns the full definition, context and related terms for one AP key term. Use when a student asks "what does X mean" for AP vocabulary. Cheap — usually under 1k tokens.

输入参数intenttermSlug必填subjectSlug必填

search_content

Search Fiveable content

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

输入参数limit必填query必填intentsubjectSlug

get_content_sections

Get relevant study guide sections

Returns a small set of Fiveable study-guide passages relevant to one question. Suitable for narrow explanations, research questions and checking student notes. One call consumes one full-content preview for a caller without existing access.

输入参数query必填intentguideSlugsubjectSlug必填maximumTokens必填maximumSections必填

list_frqs

List free-response questions

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.

输入参数limit必填cursorintentunitIdfrqTypeexcludeIdssubjectSlug必填courseVariant

get_frq

Get a free-response question

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.

输入参数frqId必填intent

get_practice_questions

Get multiple-choice practice questions

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

输入参数mode必填tierlimit必填topicintentunitIdtopicIdsubjectSlug必填courseVariantrecentCorrectincludeAnswers必填questionFormat必填另有 1 个

calculate_ap_score

Predict an AP score

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.

输入参数intentsubjectSlug必填sectionScores

check_practice_answer

Check a practice answer

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

输入参数answer必填intentquestionId必填

get_my_study_progress

Get my study progress

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

输入参数intentsubjectSlug必填

score_external_frq_response

Score an uploaded or pasted FRQ

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.

输入参数intentfrqType必填requestIdpromptText必填promptLabelsubjectSlug必填promptImagespartResponses必填responseImagestranscriptionConfirmed必填

start_diagnostic

Start an adaptive AP diagnostic

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

输入参数intentunitIdrequestIdsubjectSlug必填courseVariant

submit_diagnostic_answer

Answer the current diagnostic question

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.

输入参数answer必填intentrequestIdquestionId必填sessionToken必填

get_diagnostic_results

Read my diagnostic status or results

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

输入参数intentsessionToken必填

get_my_frq_progress

Get my FRQ progress

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

输入参数intentsubjectSlug必填

get_frq_attempt_history

Get attempt history for one FRQ

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.

输入参数frqId必填intent

score_frq_response

Score a free-response answer

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.

输入参数frqId必填intentrequestIdprogramCodepartResponses必填promptVariantIdselectedLeqQuestionbusinessProjectReferencebusinessProjectPracticeMode

get_scoring_result

Get a saved FRQ scoring result

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

输入参数intentscoringJobId必填

submit_practice_answer

Record a practice question answer

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

输入参数answer必填intentrequestIdquestionId必填

get_my_access

Check my Fiveable access

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

输入参数subjectSlug必填

get_my_practice_history

Review my practice answers

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.

输入参数limit必填cursorsubjectSlug必填

list_cheatsheets

List official Fiveable cheatsheets

Find approved Fiveable course and unit PDFs, including course variants, academic year when known, source links and readable-artifact readiness. Does not include user galleries or generated personal visuals.

输入参数limit必填cursorunitNumbersubjectSlugcourseVariant

get_cheatsheet

Read an official Fiveable cheatsheet

Reads bounded pages from a prepared official Fiveable PDF, returning page citations, extracted text and actual page images for formulas and diagrams. Image-only pages have no guessed transcription. Unavailable artifacts return the approved PDF link. This read never starts processing.

输入参数page必填limit必填cheatsheetId必填

report_content_issue

Report a content issue to Fiveable

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.

输入参数contentId必填requestId必填contentType必填description必填confirmReport必填

list_my_study_plans

List my study plans

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

输入参数limit必填cursorsubjectSlug

get_study_plan

Get a study plan

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

输入参数planId必填

create_study_plan

Create a study plan

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

输入参数scope必填timeUnit必填requestId必填timeAmount必填subjectSlug必填

update_study_plan_tasks

Update study plan tasks

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

输入参数tasks必填planId必填requestId必填expectedRevision必填

get_exam_options

Find practice exams and unit tests

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.

输入参数unitNumbersubjectSlug

list_my_exam_attempts

List my completed exams

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.

输入参数limit必填cursorsubjectSlug

get_exam_results

Review my completed exam results

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

输入参数attemptIdsubmissionId

list_my_assignments

List my student assignments

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

输入参数limit必填cursorsubjectSlug

get_assignment_summary

Read my assignment summary

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

输入参数publicationId必填

open_guided_practice

Open Fiveable Guided Practice

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

输入参数tierlimit必填topicintentunitIdtopicIdsubjectSlug必填courseVariantquestionFormat必填

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。