count_matches
ClaudeCount matches, optionally broken down by `group_by: "competition", "season", "division", "stage", "pool", "date", "venue", "live_stream" or "status". Takes the same filters as list_matches. Every group reports count plus how many of those are completed and live_streamed, so "how many Men's games versus Women's games are being live streamed at the Euros?" is a single call with season_id and group_by="division"`.
get_ladder
ClaudeStandings for a division (every stage that keeps a ladder, each split into its pools) or for a single stage. Entries are in ladder order with position, played, win/loss/draw, byes, forfeits, score for and against, difference, percentage, bonus points and points. Answers "who is top of Pool A?", "did we make the top four?" and "what is the points difference between ...".
get_match
ClaudeFull detail of one match by its identifier: teams, local kick-off time, venue and ground with coordinates and time zone, scores and result, live stream and video links.
get_season
ClaudeDescribe one season (event): its divisions with their stages and pools, the venues and grounds it is played at, the span of match dates, and how many matches are scheduled, completed, still to come and live streamed. Use the division, stage, pool and venue identifiers it returns to filter `list_matches, count_matches and get_ladder`.
get_team
ClaudeDescribe one team: its club, division, season and competition, its next match and last match (byes excluded), and its position on each ladder it appears on. This is the quickest way to answer "when do Australia play next?" or "where are we on the ladder?" once you have the team identifier.
list_matches
ClaudeList matches (fixtures and results) matching every filter given. Filters: `competition_id, season_id, division_id, stage_id and venue_id narrow the structure; team_id or club_id selects matches involving that team or any team of that club on either side; opponent_team_id or opponent_club_id requires the other side to match too, so "Australia v New Zealand" is club_id + opponent_club_id; date_from and date_to (YYYY-MM-DD) bound the match date; status is "upcoming" (not yet kicked off), "past" (kicked off), "completed" (result recorded) or "any"; live_stream_only keeps only live streamed matches. Results are ordered by kick-off (order "desc" for most recent first, useful with status "completed"), paged with limit and offset, and total reports how many matched overall. Each match carries its local kick-off time and time zone, venue and ground, both teams (undecided teams have a title but no id), scores, status, winner and live stream details. Use count_matches` when you only need numbers.
list_teams
ClaudeList teams, narrowed by season, division, club and/or a name `query` (every word must appear in the team, club or division title). At least one filter is required. Most recent season first. Use it to turn "Australia Women's" into a team identifier, or to see every team a club has entered in a season.
recent_events
ClaudeSeasons (events, tournaments) that had matches in the last `days` days, most recently active first. Events still in progress are included and flagged "in_progress". Use this for questions about results ("how did we go at the Nationals?", "who won last weekend?") to find the season identifier.
search
ClaudeFind competitions, seasons, divisions, teams, clubs and venues whose names contain every word of `query (case-insensitive), returning up to limit of each with the identifiers the other tools need. Team results include the club, division, season and competition so "Australia" resolves to one team per division it has entered, most recent season first. A season is matched on its own title, its hashtag and its competition's title, so "European Championships 2026" or "Euros2026" both work. Use upcoming_events` instead when the event is only referred to by a nickname.
upcoming_events
ClaudeSeasons (events, tournaments) that are in progress now or have their first match within the next `days` days, soonest first. Call this first when a question refers to an event by a nickname ("the Euros", "the World Cup", "this weekend") or gives no event at all, then use the returned season and competition identifiers with the other tools. Each entry reports whether the event is "upcoming" or "in_progress", its first and last match dates, hashtag, time zone and whether it is live streamed.
whoami
ClaudeIdentify the connected user so "my" questions can be answered, for example "when is my next game?" or "how did we go?": their name, the person record and club they are linked to, and the teams they are registered with (most recent season first), each with its next and last match. When `authenticated is false the caller is anonymous: ask which team or club they follow and use search` instead. Superusers can also see divisions still in draft.