maxpreps_scoreboard
Retrieve MaxPreps scoreboard contest IDs by date for a selected context, sport, and level, including canonical URLs and date-grouped IDs to discover scheduled games.
Instructions
MaxPreps scoreboard contest ids by date. Returns the scoreboard for one context (National, State, Section, StateDivision, Association, League or DMA) and one genderSport and level: the yesterday/today/tomorrow scoreboard canonical URLs and the contest ids grouped by date. Use the ids to discover which games exist on a date; this route returns the id index, not the contest detail.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"context": "<context>",
"genderSport": "<genderSport>",
"level": "<level>"
},
"name": "maxpreps_scoreboard"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Context identifier: state code for National (use NN) and State, otherwise a section/state-division/association/league/DMA id example(FL) | |
| level | Yes | Team level: Varsity, JV or Freshman | |
| context | Yes | Scoreboard context: National, State, Section, StateDivision, Association, League or DMA; see maxpreps-request-enums for the id kind each context needs | |
| genderSport | Yes | Gender+sport value from maxpreps-sports in lowercase, for example boys,football. Case-insensitive; see maxpreps-sports for all 64 values example(boys,football) | |
| excludeTbaDate | No | Exclude contests whose date is still TBA | |
| nationalTeamCount | No | Number of nationally ranked teams to include for a National context scoreboard example(10) |