io.github.chrischall/maxpreps-mcp
NPM · MAXPREPS-MCP · SCANNED SEP 20
MaxPreps MCP — high school schedules, scores, records, rosters and stat leaders
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 0 of 5 dependencies flagged as unhealthy. View diagnostics → Pass
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to chrischall/maxpreps-mcp). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 0 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability75
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 2127 tokens (~141/item across 15 items; 15 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management80
- Stability observed for 24 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 15 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 15 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
How do I install the io.github.chrischall/maxpreps-mcp server?
io.github.chrischall/maxpreps-mcp runs locally as an npm package, launched with npx -y maxpreps-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · maxpreps-mcp
claude mcp add chrischall-maxpreps-mcp -- npx -y maxpreps-mcp
{
"mcpServers": {
"chrischall-maxpreps-mcp": {
"command": "npx",
"args": [
"-y",
"maxpreps-mcp"
]
}
}
} {
"servers": {
"chrischall-maxpreps-mcp": {
"command": "npx",
"args": [
"-y",
"maxpreps-mcp"
]
}
}
} codex mcp add chrischall-maxpreps-mcp -- npx -y maxpreps-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"chrischall-maxpreps-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"maxpreps-mcp"
],
"enabled": true
}
}
} openclaw mcp add chrischall-maxpreps-mcp --command npx --arg -y --arg maxpreps-mcp
mcp_servers:
chrischall-maxpreps-mcp:
command: "npx"
args: ["-y", "maxpreps-mcp"] {
"McpServers": {
"chrischall-maxpreps-mcp": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"maxpreps-mcp"
]
}
}
} assistant mcp add chrischall-maxpreps-mcp -t stdio -c npx -a -y maxpreps-mcp
{
"mcpServers": {
"chrischall-maxpreps-mcp": {
"command": "npx",
"args": [
"-y",
"maxpreps-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 20 Sept 26 0
- MCP protocol: Implements a current MCP spec version (2026-07-28). functional
- Package version: 1.0.0 → 1.1.0 functional
- 19 Sept 26 −2
- Stability: pass → unverified ▼ security
- Tool safety: pass → unverified ▼ security
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Dependency health: 0.86 → 1.00 ▲ functional
- Schema quality: Schema quality not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. functional
- Stability: pass → 0.77 functional
- Package version: 0.2.0 → 1.0.0 functional
- Package version: 0.3.1 → 1.0.0 functional
- 18 Sept 26 0
- Stability: 0.97 → pass security
- 17 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
- 15 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.
- 14 Sept 26 0
- Package version: 0.2.0 → 0.3.1 functional
- 13 Sept 26 −2
- Stability: pass → 0.83 functional
- Package version: 0.2.0 → 0.3.1 functional
- 12 Sept 26 +15
- Malware scan: unverified → pass ▲ security
- Stability: 0.97 → pass security
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed npm/maxpreps-mcp@1.1.0
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | npm |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | chrischall/maxpreps-mcp |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/chrischall/maxpreps-mcp/.github/workflows/release-please.yml@refs/heads/main |
| Rekor log index | 2893923300 |
| Predicate type | https://slsa.dev/provenance/v1 |
| Subject digest | sha512:210544e33502b948661c1c648c937ca223979dddf3869c749322b7d33d4cb62db09237649c90c59244ed926e93b1c05b06d0932eb95129603a318ec5f |
Background: How many MCP packages publish verified provenance →
Dependencies 5 packages
| Packages resolved | 5 |
|---|---|
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
maxpreps_get_athlete Get a MaxPreps athlete career ~109
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.
| Name | Type | Req | Description |
|---|---|---|---|
| athlete | string | yes | Athlete career path or URL, including ?careerid=… (use search’s careerCanonicalUrl) |
| careerId | string | – | careerid, if not already present in the path |
No output schema declared.
No examples provided.
maxpreps_get_page Get raw MaxPreps page data ~135
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. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| keysOnly | boolean | – | Return only the top-level prop names and their types — cheap way to explore a page |
| path | string | yes | Site path or maxpreps.com URL |
No output schema declared.
No examples provided.
maxpreps_get_rankings Get MaxPreps team rankings ~189
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.
| Name | Type | Req | Description |
|---|---|---|---|
| pageNumber | integer | – | 1-based page; 25 teams per page |
| season | string | – | Season label, e.g. 25-26. Omit for the current season. |
| sport | string | yes | Sport slug as used in MaxPreps URLs, e.g. football, basketball |
| state | string | – | Two-letter state code, e.g. NC. Omit for national rankings. |
No output schema declared.
No examples provided.
maxpreps_get_roster Get a MaxPreps team roster ~169
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.
| Name | Type | Req | Description |
|---|---|---|---|
| includeDeleted | boolean | – | Include soft-deleted roster entries the site hides |
| position | string | – | Case-insensitive filter on position, e.g. "QB" |
| season | string | – | Season label, e.g. 25-26. Omit for the current season. |
| team | string | yes | Team site path or URL, e.g. nc/charlotte/myers-park-mustangs/football |
No output schema declared.
No examples provided.
maxpreps_get_schedule Get a MaxPreps team schedule and scores ~229
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.
| Name | Type | Req | Description |
|---|---|---|---|
| includeDeleted | boolean | – | Include soft-deleted contests the site hides |
| includeTournaments | boolean | – | Include playoff/championship tournament entries the schedule references |
| played | string | – | Filter to games with a result, games without one, or both |
| season | string | – | Season label, e.g. 25-26. Omit for the current season. |
| team | string | yes | Team site path or URL, e.g. nc/charlotte/myers-park-mustangs/football |
No output schema declared.
No examples provided.
maxpreps_get_school Get a MaxPreps school profile ~90
School profile: identifiers, location, state athletic association, partner flags, plus nearby schools and recent articles/videos. Take the path from maxpreps_search. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| includeNearby | boolean | – | Include the nearby-schools list |
| school | string | yes | School site path or maxpreps.com URL, e.g. nc/charlotte/myers-park-mustangs |
No output schema declared.
No examples provided.
maxpreps_get_standings Get conference standings ~120
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.
| Name | Type | Req | Description |
|---|---|---|---|
| season | string | – | Season label, e.g. 25-26. Omit for the current season. |
| team | string | yes | Team site path or URL, e.g. nc/charlotte/myers-park-mustangs/football |
No output schema declared.
No examples provided.
maxpreps_get_stat_leaderboard Get a MaxPreps stat leaderboard ~146
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max athletes to return |
| path | string | yes | Leaderboard path from maxpreps_list_stat_categories, e.g. nc/football/25-26/stat-leaders/offense/passing/yds |
No output schema declared.
No examples provided.
maxpreps_get_stat_leaders Get MaxPreps team stat leaders ~128
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.
| Name | Type | Req | Description |
|---|---|---|---|
| season | string | – | Season label, e.g. 25-26. Omit for the current season. |
| team | string | yes | Team site path or URL, e.g. nc/charlotte/myers-park-mustangs/football |
No output schema declared.
No examples provided.
maxpreps_get_team Get a MaxPreps team season ~142
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.
| Name | Type | Req | Description |
|---|---|---|---|
| includeSeasons | boolean | – | Include the list of available seasons |
| season | string | – | Season label, e.g. 25-26. Omit for the current season. |
| team | string | yes | Team site path or URL, e.g. nc/charlotte/myers-park-mustangs/football |
No output schema declared.
No examples provided.
maxpreps_get_team_rankings Get one team’s rankings ~129
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.
| Name | Type | Req | Description |
|---|---|---|---|
| season | string | – | Season label, e.g. 25-26. Omit for the current season. |
| team | string | yes | Team site path or URL, e.g. nc/charlotte/myers-park-mustangs/football |
No output schema declared.
No examples provided.
maxpreps_healthcheck Check MaxPreps connectivity ~71
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
maxpreps_list_stat_categories List MaxPreps stat leaderboard categories ~172
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.
| Name | Type | Req | Description |
|---|---|---|---|
| season | string | – | Season label, e.g. 25-26. Omit for the current season. |
| sport | string | yes | Sport slug as used in MaxPreps URLs, e.g. football |
| state | string | – | Two-letter state code, e.g. NC. Omit for national leaders. |
No output schema declared.
No examples provided.
maxpreps_list_teams List a school’s teams ~173
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.
| Name | Type | Req | Description |
|---|---|---|---|
| level | string | – | Filter on level, e.g. "Varsity", "JV", "Freshman" |
| school | string | yes | School site path or maxpreps.com URL, e.g. nc/charlotte/myers-park-mustangs |
| sport | string | – | Case-insensitive filter on the sport name, e.g. "football" |
No output schema declared.
No examples provided.
maxpreps_search Search MaxPreps schools and athletes ~125
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max results per category |
| query | string | yes | School or athlete name, e.g. "myers park" or "brody keefe" |
No output schema declared.
No examples provided.
What is the io.github.chrischall/maxpreps-mcp server?
io.github.chrischall/maxpreps-mcp is listed in the public MCP registry as io.github.chrischall/maxpreps-mcp. MaxPreps MCP, high school schedules, scores, records, rosters and stat leaders. This page covers its npm package (maxpreps-mcp).
Is the io.github.chrischall/maxpreps-mcp server safe to use?
io.github.chrischall/maxpreps-mcp scores 92 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.chrischall/maxpreps-mcp server expose?
io.github.chrischall/maxpreps-mcp exposes 15 tools: maxpreps_search, maxpreps_get_school, maxpreps_list_teams, maxpreps_get_team, maxpreps_get_schedule, and 10 more. Their descriptions and schemas cost roughly 2,127 tokens of context every time the server is loaded.
Is the io.github.chrischall/maxpreps-mcp server still maintained?
io.github.chrischall/maxpreps-mcp is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.chrischall/maxpreps-mcp server under?
io.github.chrischall/maxpreps-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.