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.

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

sat-score-percentiles-mcp