Maxpreps MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/chrischall-maxpreps-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

15 read · 0 write · 0 deleteRead-only

Secrets

None asked for

Install scripts

Not scanned yet

Runs as

Node.js package

Tools (15)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• maxpreps_get_athleteGet 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.

• maxpreps_get_pageGet 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.

• maxpreps_get_rankingsGet 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.

• maxpreps_get_rosterGet 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.

• maxpreps_get_scheduleGet 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.

• maxpreps_get_schoolGet 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.

• maxpreps_get_standingsGet 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.

• maxpreps_get_stat_leaderboardGet 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.

• maxpreps_get_stat_leadersGet 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.

• maxpreps_get_teamGet 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.

• maxpreps_get_team_rankingsGet 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.

• maxpreps_healthcheckCheck 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.

• maxpreps_list_stat_categoriesList 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.

• maxpreps_list_teamsList 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.

• maxpreps_searchSearch 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.

Signals

Stars

0

Forks

0

Open issues

0

Last commit

Oct 19, 2026 (11 days ago)

Last release

Oct 16, 2026 (14 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.chrischall/maxpreps-mcp

Version

1.1.9

Auth

No auth

Packages

npm maxpreps-mcp

License

MIT

Repository

github.com/chrischall/maxpreps-mcp

First seen

Oct 24, 2026

Last checked

Oct 25, 2026

Source

Official MCP Registrygithub-graphql