List SpeechWire accounts available to the authenticated user.

Call speechwire_select_user_account to choose one.

Returns

list[dict] Account records containing account_id (int) and name (str).

Select a SpeechWire account to work with.

Parameters

account_id : int Account ID from speechwire_list_user_accounts.

Returns

dict Status record containing status (str) and account_id (int).

List all tournaments (current and past seasons) for the selected account.

Call speechwire_select_user_tournament to choose one.

Returns

list[dict] Tournament records containing tournament_id (int), circuit_id (int | None), name (str), date (str | None), and season (str: "current" or "past").

Select a tournament to work with.

After calling this, tournament-specific tools become available.

Parameters

tournament_id : int Tournament ID from speechwire_list_user_tournaments. circuit_id : int Circuit ID from speechwire_list_user_tournaments.

Returns

dict Status record containing status (str), tournament_id (int), and circuit_id (int).

List all judges registered for the tournament with roster details.

Returns

list[dict] Judge records containing: - judge_id: int — numeric judge identifier - name: str — judge's full name - team: str | None — school or team name - team_id: int | None — numeric team identifier - is_coach: bool — whether the judge is marked as a coach - is_active: bool — whether the judge is active - is_clean: bool — whether the judge is marked clean - is_priority: bool — whether the judge is marked priority - email: str | None — judge's email address (if present on the roster page) - unavailability: str | None — unavailability summary text - blocks: list[str] — event/team blocks (e.g. "GROUPING: Varsity Policy Debate")

Get a judge's email and phone contact information.

Parameters

judge_id : int Numeric judge identifier from speechwire_list_judges.

Returns

dict Contact record containing judge_id (int), email (str | None), and phone (str | None).

Get a judge's availability by timeslot.

Parameters

judge_id : int Numeric judge identifier from speechwire_list_judges.

Returns

list[dict] Timeslot records containing: - slot_index: int — internal slot identifier - label: str — human-readable time slot description - available: bool — whether the judge is available

Get the school (team) a judge is associated with.

Parameters

judge_id : int Numeric judge identifier from speechwire_list_judges.

Returns

dict School record containing judge_id (int), school (str | None), and team_id (int | None).

Add a new judge to the tournament.

Parameters

judge_name : str Judge's full name (required). team_id : int Team/school ID (required). Get valid IDs from speechwire_list_teams. judge_email : str Email address (optional). judge_type_id : int Tournament-specific judge type ID from speechwire_list_judge_types. Use 0 when no configured judge type is selected. is_clean : bool Whether the judge is a clean/neutral judge. is_coach : bool Whether the judge is a coach. is_priority : bool Whether the judge is a priority judge. available_slots : list[int] | None Provider slot_id values from speechwire_list_timeslots for which the judge is available. If omitted, the judge is blocked for all slots.

Returns

dict {"success": bool, "judge_id": int | None, "error": str | None}

Update a judge's email address.

Replaces the email while preserving the judge's other values.

Parameters

judge_id : int ID of the judge to update. email : str New email address for the judge.

Returns

dict {"success": bool, "judge_id": int | None, "error": str | None}

Replace a judge's availability slots while preserving other values.

Parameters

judge_id : int ID of the judge to update. available_slots : list[int] Provider slot_id values from speechwire_list_timeslots for which the judge should be available. Replaces all current availability.

Returns

dict {"success": bool, "judge_id": int | None, "error": str | None}

Update a judge's school (team) affiliation.

Replaces the team affiliation while preserving the judge's other values.

Parameters

judge_id : int ID of the judge to update. team_id : int New team/school ID. Get valid IDs from speechwire_list_teams.

Returns

dict {"success": bool, "judge_id": int | None, "error": str | None}

List judge types configured for the tournament.

If no judge types are configured for the tournament, returns an empty list.

Returns

list[dict] Judge type records containing: - judge_type_id: int — identifier to use with speechwire_add_judge - judge_type: str — name (e.g., "A", "B", "Speech judge") - groupings: list[str] — grouping codes this type can judge

List all rooms configured for the tournament.

Returns

list[dict] Room records containing: - room_id: int — numeric room identifier - name: str — room display name - has_constraints: bool — whether the room has availability constraints

Get room time-slot usage showing assignments for every room.

Returns

list[dict] Room usage records containing: - room_id: int — numeric room identifier - room_name: str — room display name - time_slots: list[dict] — per-slot records with slot_index, time_label, status, event_code, and round_number

Get room vs. section counts per grouping and round.

Shows how many rooms are assigned versus how many sections are needed for each competition grouping in each round. Useful for identifying rounds that are short on rooms.

Returns

list[dict] Grouping records containing: - grouping_name: str — competition grouping (e.g., "JV Policy Debate") - rounds: list[dict] — per-round room and section counts with a sufficient boolean

List all teams registered for the tournament.

Returns

list[dict] Team records containing: - team_id: int — numeric team identifier - name: str — team/school name - code: str | None — team code abbreviation - is_invited: bool — whether the team is invited - is_attending: bool — whether the team is attending - is_checked_in: bool — whether the team is checked in - is_udl_member: bool — whether the team is a UDL member

Get entries for a specific team.

Parameters

team_id : int Numeric team identifier from speechwire_list_teams.

Returns

list[dict] Entry records containing: - event_id: int — numeric event identifier - event_name: str | None — event name - entry_number: int — entry number within the event - entry_code: str | None — entry code - competitors: list[dict] — student_id, name, and competitor_number - division: str | None — division name - division_id: int | None — numeric division identifier - is_dropped: bool — whether the entry is dropped

List all hybrid entries (cross-school team entries) for the tournament.

Returns

list[dict] Hybrid entry records containing: - comp_id: int — numeric competition entry identifier - event: str — event name - division: str | None — division name - students: list[dict] — student name and school records - code: str | None — entry code - team_blocks: list[str] — school names for team blocking

List the tournament schedule timeslots.

Returns

list[dict] Timeslot records containing: - slot_id: int — numeric timeslot identifier - time: str — human-readable time (e.g., "9:00 AM") - description: str | None — slot description - date: str | None — date for this slot - round_assignments: list[dict] — event_name and round_label records

List competition groupings configured for the tournament.

Returns

list[dict] Grouping records containing: - grouping_id: int — numeric grouping identifier - name: str — full grouping name - abbreviation: str — short code - event: str — event name - divisions: str — division text

List all schematic events (debate/speech groupings) with available rounds.

Returns

list[dict] Event records containing: - grouping_id: int — numeric event identifier - name: str — event name - rounds: list[int] — available round numbers

Get the full schematic (pairings/sections) for a specific event round.

Parameters

grouping_id : int Event grouping identifier from speechwire_list_schematic_events. round_number : int Round number for this event.

Returns

dict | list Schematic containing: - event_name: str — event name - round: int — round number - time: str | None — scheduled time - unused_judges: list[dict] — unassigned judges - sections: list[dict] — sections with judges, rooms, and competitors

Get the results tab sheet for a competition grouping.

Includes round-by-round outcomes (W/L/BYE/FORFEIT), per-speaker scores, win-loss records, total points, and final placements.

Parameters

grouping_id : int Grouping identifier from speechwire_list_groupings.

Returns

dict | list Tab sheet containing: - grouping_name: str — grouping name - round_names: list[str] — round column headers - competitors: list[dict] — team results, records, points, placements, and speaker results