nfhs_events
Search NFHS Network games and events by activity, state, gender, level, school, publisher, date range, or free text; filter live, upcoming, on-demand, postseason, and download-to-own broadcasts.
Instructions
Search NFHS Network games and events. Returns one page of games and events from the live, upcoming or on-demand drill-down with schedule, sport, game type, gender, level, scores, status, postseason flag, participant teams and publisher identities. Filter by activity display name from nfhs-activities, state from nfhs-states, gender and level from nfhs-filters, school_key or publisher_key, a free-text search_term (at least 3 characters) and a YYYY-MM-DD from/to start-date range; sort by start_time or date. Page with start/size and use next_cursor for deep pages. Use nfhs-event for the full detail of one event key.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "nfhs_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Inclusive start-date upper bound as YYYY-MM-DD | |
| from | No | Inclusive start-date lower bound as YYYY-MM-DD | |
| size | No | Page size, 1 to 500; defaults to 20 | |
| sort | No | Sort order: start_time+asc, start_time+desc, date+asc, date+desc or updated_at+desc | |
| type | No | Event drill-down: live, upcoming (default) or ondemand | |
| level | No | Level filter: varsity, junior varsity, freshman, sophomore or middle school | |
| start | No | Zero-based result offset | |
| state | No | Two-letter state code from nfhs-states | |
| cursor | No | next_cursor from a previous page; the reliable way to page beyond 10000 results | |
| gender | No | Gender filter: boys, girls or coed | |
| activity | No | Activity name from nfhs-activities, matched case-insensitively, for example Football | |
| school_key | No | School key from nfhs-schools | |
| search_term | No | Free-text term matched against event titles and team names; at least 3 characters | |
| is_postseason | No | Optional postseason flag filter; true returns playoff and championship events only | |
| publisher_key | No | Publisher key from an event's publishers list | |
| download_to_own | No | Optional download-to-own filter; true returns events whose broadcast can be downloaded for ownership |