get_active_streaks
ChatGPTUse this when the user asks which football players are on the longest current runs of recording at least one shot, shot on target, tackle or foul in every game. Returns up to 8 players with the number of consecutive games (in that competition this season) in which they have done it, still active. Runs end the first game a player records none.
get_match_leaders
ChatGPTUse this when the user asks about the key players in a specific football match: each team's top five this season for goals, assists, shots, shots on target, tackles or fouls, side by side. Pass fixture_id from get_upcoming_fixtures or search. Without fixture_id it uses Statz's featured match of the day. Season totals across all of each team's matches.
get_player_stat_leaders
ChatGPTUse this when the user asks who leads a football competition this season for a player stat: goals, assists, shots, shots on target, fouls or tackles. Returns the top 7 players with season totals, for one competition. Season to date only; for upcoming-match projections use get_top_projections.
get_team_stat_leaders
ChatGPTUse this when the user asks which teams lead a football competition this season for goals, shots, shots on target or corners. Returns the top 7 teams with season totals and games played, for one competition. Season to date only.
get_top_projections
ChatGPTUse this when the user asks which teams or players the Statz projection model expects to do best in upcoming football matches over the next 7 days, for example the likeliest winners, which games should have both teams scoring, who will have the most shots or corners, or who is projected to score. board='fixtures' ranks matches (win probability, both teams to score, clean sheet, team goals, 2+ and 3+ match goals). board='teams' ranks teams by projected goals, shots, shots on target, corners, offsides, fouls, tackles, yellow cards, passes and fouls drawn. board='players' ranks players by projected goals, assists, goal involvements, shots, shots on target, fouls, tackles, yellow cards, key passes, passes and fouls drawn; by default it leaves out players projected not to start. Each team or player appears once, for their next match. Values are model projections (probabilities in percent, or expected counts), not results or guarantees. Covers the next 7 days only; for season-to-date numbers use the stat leader tools.
get_upcoming_fixtures
ChatGPTUse this to list upcoming football matches in the next 7 days, optionally for one competition or team, with each fixture_id, kick-off time (UTC) and the Statz model's home win / draw / away win probabilities and projected goals. Use it to find a fixture_id for get_match_leaders. Only matches Statz projects are listed. Probabilities are model estimates.
mention_search
ChatGPTComposer @-mention search: finds Statz football teams, players and competitions matching the typed text, returned as resource links.
open_statz
ChatGPTOpens the Statz football stats app: top-10 projections for the next 7 days, season stat leaders and active player streaks, browsable by competition. Use this only when the user asks to open or browse Statz; for a specific question call the specific tool instead.
search
ChatGPTUse this to find the Statz slug or id of a football competition, team or player before calling another Statz tool, for example the competition slug for "Spanish league" or the player id for "Saka". Returns up to five matches of each kind. Data lookup only.
