AP Score Distributions MCP

AP Score Distributions MCP

Official College Board AP score distributions for AI assistants: the May 2026, 2025 and 2024 results for every AP exam, with percentiles, pass rate rankings and practice exam score estimates.

Hosted MCP URL (no sign-in, no token): https://ap-score-distributions-mcp.lipmichal.workers.dev/mcp

AP score calculators on the web: examscorecalc.com

Tools

Every result has structured JSON, a one-paragraph summary, an as_of date, a source URL on collegeboard.org and a more link to the matching examscorecalc.com page.

What it knows that your model does not

• The May 2026 results. College Board posted the 2026 AP Score Distributions after the 2026 exams, which is newer than most model training data. For example, 46% of AP Calculus BC students scored a 5 in 2026, and AP Biology's pass rate was 71%.
• Exact 2024 and 2025 counts. 287,232 students took AP Biology in May 2025 and 70.4% scored 3 or higher, with a mean of 3.24. All 49 rows per year (40 exams, 3 subscores, 6 Standard Group language rows) pass a check that counts add to the printed total and 5 + 4 + 3 equals the printed 3 or higher count.
• Which cut charts exist. College Board does not publish cut scores for live exams. The estimator uses only the 7 conversion charts College Board printed in its practice exams (Calculus AB 2012, Biology 2013, Statistics 2012, World History 2013, Psychology 2012, Macroeconomics 2012, Microeconomics 2012) and refuses every other exam rather than invent a cut.

Install

Claude.ai custom connector, ChatGPT developer mode

Paste this URL as a custom connector. No token or sign-in.

https://ap-score-distributions-mcp.lipmichal.workers.dev/mcp

Claude Code

claude mcp add --transport http ap-scores https://ap-score-distributions-mcp.lipmichal.workers.dev/mcp

Or run it locally over stdio:

claude mcp add ap-scores -- npx -y github:theluckystrike/ap-score-distributions-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "ap-scores": {
      "command": "npx",
      "args": ["-y", "github:theluckystrike/ap-score-distributions-mcp"]
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ap-scores": { "url": "https://ap-score-distributions-mcp.lipmichal.workers.dev/mcp" }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "ap-scores": { "type": "http", "url": "https://ap-score-distributions-mcp.lipmichal.workers.dev/mcp" }
  }
}

Test with curl

curl -s -X POST https://ap-score-distributions-mcp.lipmichal.workers.dev/mcp \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_ap_score_distribution","arguments":{"exam":"APUSH","year":2026}}}'

Example prompts

• "What percent of students got a 5 on AP Calculus BC in 2026?"
• "I got a 4 on AP Biology. What percentile is that?"
• "Which AP exams had the lowest pass rates in 2026?"
• "Compare the pass rates of Calc AB, Calc BC, Statistics and Precalculus."
• "On the 2012 Calculus AB practice exam I got 30 multiple choice right and 5 points on each free response. What score is that?"

How it works

• Exam names accept common short forms: APUSH, Lang, Lit, Calc AB, Calc BC, Stats, Psych, APES, HUG, Euro, Gov, CSA, CSP, Physics 1, Physics C E&M and others.
• Percentiles use exact counts for 2024 and 2025. For 2026 they use the whole-number percents College Board posted, so they can be off by about 1 point.
• The composite estimator multiplies each section by the worksheet weights, adds them without rounding the parts, rounds the composite to a whole number and reads the band from that practice exam's conversion chart, as the worksheet instructs.

15 test fixtures check values transcribed from the College Board files and arithmetic worked by hand. The expected values come from scripts/expected.py, not from the server code.

Data sources

See DATA_SOURCES.md for every URL, its HTTP status, sha256 and fetch date (2026-11-02).

• 2026: https://apstudents.collegeboard.org/about-ap-scores/score-distributions
• 2025: https://apcentral.collegeboard.org/media/pdf/ap-score-distributions-by-subject-2025.pdf
• 2024: https://apcentral.collegeboard.org/media/pdf/ap-score-distributions-by-subject-2024.pdf
• Scoring worksheets: College Board practice exams under https://secure-media.collegeboard.org/digitalServices/pdf/ap/

Limitations

• 2026 has percents only. College Board has not published 2026 student counts, means or standard deviations, so mean and test_takers ranking work for 2024 and 2025 only. The 2026 page says it is updated on a rolling basis.
• 2026 covers the 40 Total Group exams. Subscores and Standard Group rows are in 2024 and 2025 only.
• The composite charts belong to the 2012 and 2013 practice exam formats. Current exam formats may differ (not checked against the current Course and Exam Descriptions), and cut points move every year. Treat any estimate as a rough guide and check the current Course and Exam Description.
• A pass rate reflects who takes an exam, not only how hard it is.
• Not affiliated with College Board. AP is a registered trademark of College Board.

Development

npm install
npm run build
npm test
npx wrangler deploy

src/core.ts holds the pure logic and src/data.ts the generated table from data/ap.json. src/stdio.ts and src/worker.ts are thin entries over the same tool registry in src/tools.ts.

License

MIT

Part of the Zovo MCP collection: https://mcp.zovo.one

More data servers from the same author

Each one is free, needs no API key and has a hosted URL you can paste into Claude or ChatGPT.

The paid back-office collection (invoices, VAT, PDFs, spreadsheets) is at https://mcp.zovo.one