maxpreps_school_proximal
Find MaxPreps schools near a specified school using it as the proximity origin, then filter by name, distance, ZIP, season, or state and paginate results.
Instructions
MaxPreps schools near a school. Returns the MaxPreps schools near one school, using that school as the proximity origin, with the same school record shape as maxpreps-school-search: identity, location, colours, mascot, enrollment and each school's sport-season ids. Offset pagination with maxResults and startFrom; optional name, distance, ZIP, season and state-scope filters.
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": {
"schoolId": "<schoolId>"
},
"name": "maxpreps_school_proximal"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| byState | No | Search by state instead of radius | |
| zipCode | No | Optional five-digit US ZIP code example(90210) | |
| schoolId | Yes | School id used as the proximity origin example(7bdc339f-7cbf-4728-b0c8-ed898929cf68) | |
| sortOrder | No | Optional sort order: Distance or Name | |
| startFrom | No | Zero-based offset; defaults to 0 example(0) | |
| maxResults | No | Page size from 1 to 200; defaults to 50 example(25) | |
| searchText | No | Optional school-name filter inside the radius example(lincoln) | |
| allSeasonId | No | Optional all-season id from maxpreps-sports example(22e2b335-334e-4d4d-9f67-a0f716bb1ccd) | |
| maxDistance | No | Optional maximum distance in metres example(40000) | |
| publishedOnly | No | Only published schools | |
| sportSeasonId | No | Optional sport-season id to scope returned teams example(2286cd80-c46d-4739-8dd1-92a67ca8daa7) | |
| historicalOnly | No | Only historically published schools | |
| includeDeleted | No | Include deleted schools |