FIT

Count 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"``.

count_matches

Standings 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_ladder

Full 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_match

Describe 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_season

Describe 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.

get_team

List 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_matches

List 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.

list_teams

Seasons (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.

recent_events

Find 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.

search

Seasons (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.

upcoming_events