io.github.chrischallPublished by GitHub account chrischallv1.2.0Updated Nov 7, 2026
MaxPreps MCP — high school schedules, scores, records, rosters and stat leaders
Read-only MCP server that lets an assistant look up US high school sports schedules, scores, records, rosters, rankings and stat leaders from MaxPreps.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Follow the launch instructions in the repository.
MCP server for MaxPreps — read any US high school's team schedules, scores, records, rosters, stat leaders and athlete careers.
Developed and maintained by AI (Claude Code). Use at your own discretion.
No account, no API key, no browser extension. MaxPreps serves its pages with Next.js, and every public page has a companion JSON route carrying the same data the page was rendered from. This server reads those routes directly over plain HTTPS, so it works anywhere Node runs.
Or add it to an MCP host:
All fifteen are read-only; this server has no write path.
Paths are not guessable, so resolve before you fetch:
maxpreps_search "myers park" → the school's canonicalUrlmaxpreps_list_teams on that path → real team pathsmaxpreps_get_schedule / _roster / _stat_leaders / _standings on a team pathTo go the other way — discovering teams and athletes rather than looking one up —
maxpreps_get_rankings and maxpreps_get_stat_leaderboard return ranked lists whose entries
each carry a teamPath you can feed straight back in. Stat leaderboard paths are not
guessable either, so list the categories first.
Prior seasons are a season argument ("25-26"); roughly 20 years are available.
Everything is optional — the server works with no configuration at all.
These are properties of MaxPreps' data, and each one has bitten a naive reading:
"L 20-13" even when the team scored 13. The teamScore / opponentScore
fields this server returns are always oriented team-vs-opponent."myers park" finds the school; "myers park high"
finds nothing. Drop qualifiers before concluding a school is absent./<st>/<sport>/scores/ renders its
game list client-side from a route that has no server-rendered payload. Per-team
schedules are the supported way to get scores; maxpreps_get_rankings is the way
to see a whole state's teams at once.The repo also ships a maxpreps skill (skills/maxpreps/) that reaches the same
data through curl + a small decoder, with no server to run. If you only ever use
Claude Code on one machine, the skill alone may be all you need; the MCP server is
what makes this reachable from claude.ai, a phone, or any other client.
docs/MAXPREPS-API.md pins the captured request/response shapes, the positional
key maps, and how to re-derive them if MaxPreps changes its bundle.
This reads an undocumented surface on someone else's site on behalf of one user. Requests are spaced and responses cached by default. Please keep it that way.
MIT
Source: README.md at commit 57c50ea
Search MaxPreps schools and athletes
Find a high school or an athlete by name. This is the entry point for every other tool: it returns each school's canonicalUrl (the site path the team tools need) and each athlete's careerCanonicalUrl. Search is exact-ish — prefer the plain school name ("myers park"), because appending qualifiers like "high" or "high school" usually returns nothing. Read-only.
limitqueryrequiredGet a MaxPreps school profile
School profile: identifiers, location, state athletic association, partner flags, plus nearby schools and recent articles/videos. Take the path from maxpreps_search. Read-only.
schoolrequiredincludeNearbyList a school’s teams
Every team path a school publishes, with sport, gender and level. Call this before any team tool — the sport path segments are not guessable (the default gender varies by sport, so girls golf is "golf/girls" while boys golf is "golf/spring", and field hockey has no gender segment at all). Passing a team path instead of a school path returns that team’s seasons. Read-only.
levelsportschoolrequiredGet a MaxPreps team season
Team overview for one season: sport/level/season identifiers, the win-loss record and points for/against, conference standing, rankings, and the full list of seasons this team has on MaxPreps (roughly 20 years). Use it to confirm a record without summing a schedule. Read-only.
teamrequiredseasonincludeSeasonsGet a MaxPreps team schedule and scores
Every game for a team season, with the result and both scores. Scores are oriented team-vs-opponent (`teamScore`/`opponentScore`); the raw `resultString` MaxPreps renders is winner-first, so a loss reads "L 20-13" even when the team scored 13. Soft-deleted contests are hidden by default, matching the site. Before opening day a current season legitimately has no results — check a prior season. Also returns any playoff or championship tournaments the season fed into. Read-only.
teamrequiredplayedseasonincludeDeletedincludeTournamentsGet a MaxPreps team roster
Players on a team for one season: jersey, name, class year, positions, height and weight. Soft-deleted entries (duplicates and departed players the site hides) are excluded by default — a roster payload often carries substantially more rows than the page shows. Height and weight are null when the school did not publish them. Read-only.
teamrequiredseasonpositionincludeDeletedGet MaxPreps team stat leaders
Statistical leaders for a team season — each entry names the athlete, the stat, its value and the athlete's career URL. Also returns the qualifying minimums and the stat refresh time. Coverage varies by sport and by how diligently the school reports; an empty result is normal, not an error. Read-only.
teamrequiredseasonGet a MaxPreps athlete career
One athlete’s career page: season history, sports played, and available data. Pass the `careerCanonicalUrl` from maxpreps_search verbatim — it carries the required `careerid` parameter, without which the page cannot be addressed. Read-only.
athleterequiredcareerIdGet MaxPreps team rankings
Ranked leaderboard of teams for a sport — nationally, or within one state. Each entry carries the rank, rating, overall record, movement, and a `teamPath` ready to pass to the other team tools, so this is the way to discover teams rather than look one up. Results are paginated 25 at a time. Omitting `season` uses the current one, which is empty before that sport is under way. Read-only.
sportrequiredstateseasonpageNumberGet one team’s rankings
Where a single team sits in each ranking MaxPreps publishes for it — typically national, state, state division/class, and metro area — along with the teams ranked immediately around it. Use this for "how good is this team"; use maxpreps_get_rankings to browse a whole leaderboard. Read-only.
teamrequiredseasonGet conference standings
The standings table a team sits in — every team in the conference with its conference and overall records and placement, not just this team's own line (maxpreps_get_team gives that). Also returns the ranked statistical leaders MaxPreps highlights for the season. Read-only.
teamrequiredseasonList MaxPreps stat leaderboard categories
Which statistical leaderboards exist for a sport, with the path to each one plus the national and in-scope averages and the games-played minimum. **Call this before maxpreps_get_stat_leaderboard** — the leaf path is not derivable from the stat name (Total TDs lives at `touchdowns/tot-tds`, Sacks at `sacks/tot-sacks`), so the path must come from here. Read-only.
sportrequiredstateseasonGet a MaxPreps stat leaderboard
The ranked athletes for one statistical category across a state or nationally — up to 200 per board, each with their full stat line, school, and a `teamPath` for the other team tools. Take `path` from maxpreps_list_stat_categories rather than constructing it. If MaxPreps changes the row shape the rows are returned undecoded with a warning rather than mislabelled. Read-only.
pathrequiredlimitCheck MaxPreps connectivity
Verify MaxPreps is reachable and that the site build id — which every data route embeds and which changes on each deploy — resolves. Also probes a real data route, so a pass means tools will work. Reports a failure rather than throwing. No credentials are required by this server. Read-only.
Takes no parameters.
Get raw MaxPreps page data
Escape hatch: return the raw server-rendered data for any public MaxPreps page, undecoded. Use when a dedicated tool does not cover what you need (playoff brackets, conference standings, article listings). Note that positional payloads — team rosters and schedules — arrive as bare arrays here with no field names; use maxpreps_get_roster / maxpreps_get_schedule for those. Roster rows (athleteData) are always projected to public roster fields (name, jersey, positions, class, height, weight). Read-only.
pathrequiredkeysOnly90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
npx maxpreps-mcp{ "mcpServers": { "maxpreps": { "command": "npx", "args": ["-y", "maxpreps-mcp"] } }}npm installnpm run buildnpm test