Skip to main content

fiveable developer & agent resources

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

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.

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.

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.