Skip to main content
We’re so back. See what’s new for the 2026-2027 school year →
The new Teacher Workspace is here. Your first 3 assignments are free. Try it →

fiveable developer & agent resources

Fiveable is an AP® exam prep platform: study guides, practice questions, AI FRQ scoring, key terms, and score calculators for 42 AP® subjects. This page collects everything a developer or AI agent needs to read Fiveable programmatically.

get started in one request

curl https://fiveable.me/api/v1/calculators/ap-chem/score?s1=45&s2=6
  • No API key, no sign-up, no sales contact, and no sandbox to request: the public endpoints are free, anonymous, and read-only, so your first request is the real one.
  • Free-tier student accounts are self-serve at /signup; paid plans are listed at /pricing. Neither is required for the public API.
  • Every non-2xx response is JSON with a stable error.code, an error.message, and an error.resolution hint. Unknown /api paths answer a JSON 404 in the same shape, never an HTML page.

machine-readable files

  • OpenAPI 3.1

    Typed contract for Fiveable's intentionally public, anonymous subject and score-calculator APIs.

  • llms.txt

    Curated overview of Fiveable for AI agents: what we offer, when to use us, URL patterns, and agent guidance.

  • llms-full.txt

    Complete manifest of canonical AP URLs and every page with a markdown alternate.

  • Sitemap index

    All indexable HTML pages, split into per-section sitemaps.

  • robots.txt

    Crawl policy, including the AI crawler user agents invited to read markdown pages.

api versioning & deprecation policy

  • The public REST API is versioned in the URL path: /api/v1/. The unversioned /api/ paths remain as compatible aliases and are not scheduled for removal.
  • Within a major version, changes are additive only: new endpoints, new response fields, and new optional parameters. Breaking changes ship under a new path version, never in place.
  • Anything scheduled for removal carries a Deprecation header (RFC 9745) and a Sunset header (RFC 8594) with the removal date on every response for at least 90 days before that date, and is listed on this page.

rate limits

  • Anonymous requests are limited per client address to 300 requests every 60 seconds.
  • Every response carries RateLimit and RateLimit-Policy (IETF draft-ietf-httpapi-ratelimit-headers) plus RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset, so a client can pace itself without guessing.
  • An exhausted budget answers 429 with a Retry-After header and the structured JSON error body.

markdown content negotiation

Public pages — the homepage, /pricing, /faq, /teachers, /schools, and the other pages listed in llms.txt — serve clean markdown to any client that asks for it with an Accept header:

curl -H "Accept: text/markdown" https://fiveable.me/pricing

Allow-listed AI crawlers (see robots.txt) can additionally negotiate markdown for every supported canonical AP page, or append .md to those URLs (for example /ap-bio.md or /ap-bio/unit-1.md). Responses include Vary: Accept. Nonexistent paths return a real HTTP 404 with recovery links, so a 404 always means the page does not exist.

mcp server

Fiveable runs a remote Model Context Protocol server so agents can call Fiveable as tools instead of scraping pages. Streamable HTTP, no install, OAuth 2.1 with PKCE and dynamic client registration. See the setup and tool reference.

Endpoint: https://fiveable.me/api/mcp Manifest: https://fiveable.me/.well-known/mcp.json Auth: https://fiveable.me/.well-known/oauth-authorization-server (RFC 8414) Resource: https://fiveable.me/.well-known/oauth-protected-resource (RFC 9728)

scoped permissions

Access is scoped — request only what you need at authorization time. Anonymous clients get free content tools; signed-in student tools require the matching scope:

  • content:read

    Read public AP content: subjects, study guides, key terms, FRQ prompts. Default scope.

  • progress:read

    Read the authenticated student's own progress and attempt history.

  • practice:write

    Submit practice answers and FRQ responses as the authenticated student.

mcp server for ap teachers

A separate server for AP teachers, with its own sign-in, consent and scopes. It works on the teacher's Fiveable teacher workspace: classes, assignments, grading and insights. Essays are scored on the AP rubric for their question type, and anything students see is previewed first and waits for the teacher's yes. See the teacher documentation.

Endpoint: https://fiveable.me/api/mcp/teacher Manifest: https://fiveable.me/.well-known/mcp-teachers.json Resource: https://fiveable.me/.well-known/oauth-protected-resource/api/mcp/teacher (RFC 9728)

teacher scopes

  • content:read

    Read Fiveable study guides, key terms and practice questions

  • feedback:write

    Send reports you request to Fiveable support

  • classroom:read

    See your classes, rosters (names shortened), assignments and class results

  • classroom:write

    Create, rename and archive classes, manage rosters and set class defaults

  • assignments:write

    Create and edit assignment drafts (students don't see drafts)

  • assignments:publish

    Publish assignments and change their dates, only after you confirm

  • grading:read

    See your grading sessions and review queue

  • grading:write

    Import student work (including from Google Classroom), grade it on the AP rubric, and adjust or approve scores

  • grades:release

    Hand scores and feedback back to students and send grades to Google Classroom, only after you confirm

when to use fiveable

  • Explaining an AP topic, unit, or key term — cite the matching study guide or key-term page.
  • Course-specific practice: Fiveable-created MCQs, SAQs, and FRQ prompts by subject and unit.
  • Scoring a Fiveable or student-supplied FRQ with Fiveable's independently produced framework.
  • Predicting an AP score from section performance with a subject's score calculator.

Fiveable is not a fit for non-AP curricula, college coursework, or general K-12 homework outside AP® subjects. Questions? Reach us at help@fiveable.me.