English Français العربية

io.github.chrischall/maxpreps-mcp

Official registry Other

MaxPreps MCP — high school schedules, scores, records, rosters and stat leaders

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package maxpreps-mcp
Claude Code 
claude mcp add maxpreps-mcp -e 'MAXPREPS_USER_AGENT=<MAXPREPS_USER_AGENT>' -e 'MAXPREPS_CACHE_TTL=<MAXPREPS_CACHE_TTL>' -e 'MAXPREPS_MIN_INTERVAL_MS=<MAXPREPS_MIN_INTERVAL_MS>' -- npx -y maxpreps-mcp@1.1.9
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "maxpreps-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "maxpreps-mcp@1.1.9"
            ],
            "env": {
                "MAXPREPS_USER_AGENT": "<MAXPREPS_USER_AGENT>",
                "MAXPREPS_CACHE_TTL": "<MAXPREPS_CACHE_TTL>",
                "MAXPREPS_MIN_INTERVAL_MS": "<MAXPREPS_MIN_INTERVAL_MS>"
            }
        }
    }
}

Environment variables

  • MAXPREPS_USER_AGENT Optional override for the User-Agent sent to MaxPreps.
  • MAXPREPS_CACHE_TTL Seconds to cache a page response. Default 300; 0 disables caching.
  • MAXPREPS_MIN_INTERVAL_MS Minimum spacing between requests, in ms. Default 250.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. maxpreps-mcp
  2. Install
  3. Tools
  4. Configuration
  5. Things worth knowing
  6. Shell-only alternative
  7. Development
  8. Etiquette
  9. License

maxpreps-mcp

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.

Install

npx maxpreps-mcp

Or add it to an MCP host:

{
  "mcpServers": {
    "maxpreps": {
      "command": "npx",
      "args": ["-y", "maxpreps-mcp"]
    }
  }
}

Tools

All fifteen are read-only; this server has no write path.

ToolWhat it does
maxpreps_searchFind a school or athlete by name — start here
maxpreps_list_teamsEvery team path a school publishes, with sport/gender/level
maxpreps_get_schoolSchool profile, identifiers, association, nearby schools
maxpreps_get_teamSeason record, standings, rankings, and available seasons
maxpreps_get_scheduleGames with results and scores, plus a computed record
maxpreps_get_rosterPlayers with jersey, class, positions, height, weight
maxpreps_get_stat_leadersStatistical leaders with qualifying minimums
maxpreps_get_rankingsRanked leaderboard for a sport, national or by state
maxpreps_get_team_rankingsWhere one team ranks nationally, by state, division, metro
maxpreps_get_standingsConference table with every team's record
maxpreps_list_stat_categoriesWhich stat leaderboards exist, and their paths
maxpreps_get_stat_leaderboardRanked athletes for one stat, statewide or national
maxpreps_get_athleteOne athlete's career page
maxpreps_healthcheckConnectivity plus site build-id resolution
maxpreps_get_pageRaw page data for anything the above doesn't cover (roster rows are projected to public fields)
Typical flow

Paths are not guessable, so resolve before you fetch:

  1. maxpreps_search "myers park" → the school's canonicalUrl
  2. maxpreps_list_teams on that path → real team paths
  3. maxpreps_get_schedule / _roster / _stat_leaders / _standings on a team path

To 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.

Configuration

Everything is optional — the server works with no configuration at all.

VariableDefaultPurpose
MAXPREPS_USER_AGENTbuilt-inOverride the User-Agent sent to MaxPreps
MAXPREPS_CACHE_TTL300Seconds to reuse a fetched page; 0 disables
MAXPREPS_MIN_INTERVAL_MS250Minimum spacing between requests
MAXPREPS_TIMEOUT_MS20000Per-request timeout

Things worth knowing

These are properties of MaxPreps' data, and each one has bitten a naive reading:

  • Scores are winner-first in the raw data. MaxPreps renders a loss as "L 20-13" even when the team scored 13. The teamScore / opponentScore fields this server returns are always oriented team-vs-opponent.
  • Rosters and schedules carry hidden rows. A meaningful minority are flagged deleted and the site does not render them — the 2025-26 Myers Park football roster has 87 entries behind 63 visible players. They are excluded by default.
  • An out-of-season team is not a broken one. Before opening day the current season legitimately has an empty roster and no results; ask for a prior season.
  • Search is literal. "myers park" finds the school; "myers park high" finds nothing. Drop qualifiers before concluding a school is absent.
  • Statewide scoreboards aren't available. /<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.

Shell-only alternative

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.

Development

npm install
npm run build
npm test

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.

Etiquette

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.

License

MIT

Frequently asked questions

What is io.github.chrischall/maxpreps-mcp?

MaxPreps MCP — high school schedules, scores, records, rosters and stat leaders

How do I install io.github.chrischall/maxpreps-mcp?

It runs on your machine. In Claude Code: claude mcp add maxpreps-mcp -e 'MAXPREPS_USER_AGENT=<MAXPREPS_USER_AGENT>' -e 'MAXPREPS_CACHE_TTL=<MAXPREPS_CACHE_TTL>' -e 'MAXPREPS_MIN_INTERVAL_MS=<MAXPREPS_MIN_INTERVAL_MS>' -- npx -y maxpreps-mcp@1.1.9. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.chrischall/maxpreps-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.chrischall/maxpreps-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.chrischall/maxpreps-mcp?

It is published by chrischall. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.