SAT Score Percentiles MCP

sat-score-percentiles-mcp

SAT score percentiles and class of 2026 SAT averages by state for AI assistants, from College Board's percentile tables and the 2026 SAT Suite Annual Report.

This is a Model Context Protocol (MCP) server. It answers from bundled College Board data, so it needs no API key and no network calls.

Tools

Tool	What it returns
get_sat_percentile	User group and nationally representative percentiles for any SAT total (400-1600) or section score (200-800), with the class of 2026 national mean and score band.
get_score_for_sat_percentile	The lowest total or section score that reaches a target percentile, for example the 90th.
get_sat_scores_by_state	Class of 2026 SAT results for any state, DC, Puerto Rico or the US Virgin Islands: test takers, participation rate, mean total, Reading and Writing and Math, percent meeting benchmarks, 25th/50th/75th percentile scores and rank.
rank_states_by_sat	States and DC ranked by mean score, participation rate, benchmark rate or test takers, with an optional minimum participation filter.

Every result has structured JSON, a one-paragraph summary, as_of, source (the College Board page or PDF) and more (a page on examscorecalc.com).

What it knows that your model does not

• Class of 2026 SAT results, published by College Board in fall 2026: 1,954,833 test takers nationally with a mean total of 1045 (528 Reading and Writing, 517 Math), and the same figures for every state.
• Each state's participation rate, which explains most of the gap between state averages. States that test every 11th grader have lower means than states where only college-bound students test.
• The 25th, 50th and 75th percentile SAT scores for each state's class of 2026.
• The exact College Board percentile for every 10-point score, in both reference groups, instead of a rounded guess.

Install

Hosted (Claude.ai custom connector, ChatGPT developer mode)

Paste this URL. No token, no sign-up.

https://sat-score-percentiles-mcp.lipmichal.workers.dev/mcp

Claude Code

claude mcp add --transport http sat-percentiles https://sat-score-percentiles-mcp.lipmichal.workers.dev/mcp

Or run it locally over stdio:

claude mcp add sat-percentiles -- npx -y github:theluckystrike/sat-score-percentiles-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "sat-percentiles": { "command": "npx", "args": ["-y", "github:theluckystrike/sat-score-percentiles-mcp"] }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "sat-percentiles": { "url": "https://sat-score-percentiles-mcp.lipmichal.workers.dev/mcp" }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "sat-percentiles": { "type": "http", "url": "https://sat-score-percentiles-mcp.lipmichal.workers.dev/mcp" }
  }
}

Node 20 or newer is needed for the local stdio version.

Example prompts

• "What percentile is a 1350 on the SAT?"
• "What SAT Math score do I need for the 90th percentile?"
• "What was the average SAT score in Texas for the class of 2026, and how many students took it?"
• "Which states had the highest SAT averages in 2026 among states where at least half of students took the test?"
• "Is a 1200 a good SAT score in Ohio?"

Data sources

Full list with fetch dates and file hashes in DATA_SOURCES.md.

• Percentiles: College Board, SAT Nationally Representative and User Percentiles.
• Class of 2026 results: College Board, 2026 SAT Suite of Assessments Annual Report, total group report and the state supplements.

Limitations

• The percentile page does not print a year. User group percentiles cover SAT takers from the past three graduating classes, as College Board states on that page.
• State means depend on who tests. Compare states with similar participation rates, or use min_participation_pct.
• Puerto Rico and the US Virgin Islands reports have no participation rate, so they are not ranked.
• The Ohio supplement was not linked from the report index on 2026-11-03; it was fetched from the same College Board path pattern and parsed like the others.
• Data are fixed at the 2026 reports. When College Board publishes the class of 2027 report, the data file is rebuilt with scripts/build_data.py.

More

Digital SAT score calculators and practice score conversions are on examscorecalc.com.

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

Development

npm install
npm test            # builds, then runs fixtures copied by hand from the College Board sources
node scripts/smoke-stdio.mjs   # stdio check, one call per tool
npx wrangler deploy            # Cloudflare Worker, Streamable HTTP at /mcp

License

MIT