Skip to main content
Glama

SpeechWire MCP Server

License Python PyPI

A Model Context Protocol (MCP) server that provides AI assistants with secure, authenticated access to SpeechWire tournament data for speech-and-debate (forensics) competitions.

The server scrapes manage.speechwire.com behind an authenticated session and exposes structured tournament data through MCP tools, enabling AI assistants to help tournament directors manage judge assignments, rooms, teams, entries, and round pairings.

Features

  • Judge management — list judges, contact info, availability, school associations, judge types, and add new judges

  • Team & entry data — team rosters, entries by team, hybrid/cross-school entries

  • Room management — room lists, usage grids, room-vs-section counts

  • Schematics — event lists, round-by-round pairings with judges, rooms, and competitors

  • Tournament structure — timeslots, competition groupings

  • Results — tab sheets with round outcomes, speaker scores, and placements

  • Account discovery — list and select accounts and tournaments interactively

  • Session management — automatic re-authentication on session expiry

Related MCP server: MCP Server Demo

Installation

pip install speechwire-mcp

Set your SpeechWire credentials as environment variables:

export SPEECHWIRE_EMAIL="your-email@example.com"
export SPEECHWIRE_PASSWORD="your-password"

Available MCP Tools

Tool

Description

speechwire_list_user_accounts

List accounts available after login

speechwire_select_user_account

Select an account to work with

speechwire_list_user_tournaments

List tournaments for the selected account

speechwire_select_user_tournament

Select a tournament to activate

speechwire_list_judges

List all judges with roster details

speechwire_get_judge_contact

Get judge email and phone

speechwire_get_judge_availability

Get judge availability by timeslot

speechwire_get_judge_school

Get judge's school association

speechwire_add_judge

Add a new judge to the tournament

speechwire_update_judge_email

Update a judge's email address

speechwire_update_judge_availability

Update a judge's availability slots

speechwire_update_judge_school

Update a judge's school/team affiliation

speechwire_list_judge_types

List configured judge types

speechwire_list_rooms

List tournament rooms

speechwire_get_room_usage

Get room time-slot usage grid

speechwire_get_room_counts

Get rooms vs. sections per grouping/round

speechwire_list_teams

List registered teams

speechwire_get_team_entries

Get entries for a specific team

speechwire_list_hybrid_entries

List cross-school hybrid entries

speechwire_list_timeslots

List tournament schedule timeslots

speechwire_list_groupings

List competition groupings

speechwire_list_schematic_events

List schematic events with available rounds

speechwire_get_round_schematic

Get pairings for a specific event round

speechwire_get_tab_sheet

Get results tab sheet for a grouping

Contributing

Source contribution guidance, including MCP tool authoring conventions, lives in src/README.md.

License

MIT

Available Tools

24 tools
speechwire_add_judgeA

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}

Inputs: team_id (required), judge_name (required), is_clean, is_coach, +4 more.

speechwire_get_judge_availabilityA

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

Inputs: judge_id (required). Returns: result

speechwire_get_judge_contactA

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

Inputs: judge_id (required).

speechwire_get_judge_schoolA

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

Inputs: judge_id (required).

speechwire_get_room_countsA

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

Inputs: no named parameters. Returns: result

speechwire_get_room_usageA

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

Inputs: no named parameters. Returns: result

speechwire_get_round_schematicA

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

Inputs: grouping_id (required), round_number (required). Returns: result

speechwire_get_tab_sheetA

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

Inputs: grouping_id (required). Returns: result

speechwire_get_team_entriesA

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

Inputs: team_id (required). Returns: result

speechwire_list_groupingsA

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

Inputs: no named parameters. Returns: result

speechwire_list_hybrid_entriesA

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

Inputs: no named parameters. Returns: result

speechwire_list_judgesA

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")

Inputs: no named parameters. Returns: result

speechwire_list_judge_typesA

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

Inputs: no named parameters. Returns: result

speechwire_list_roomsA

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

Inputs: no named parameters. Returns: result

speechwire_list_schematic_eventsA

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

Inputs: no named parameters. Returns: result

speechwire_list_teamsA

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

Inputs: no named parameters. Returns: result

speechwire_list_timeslotsA

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

Inputs: no named parameters. Returns: result

speechwire_list_user_accountsA

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

Inputs: no named parameters. Returns: result

speechwire_list_user_tournamentsA

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").

Inputs: no named parameters. Returns: result

speechwire_select_user_accountA

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

Inputs: account_id (required).

speechwire_select_user_tournamentA

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

Inputs: circuit_id (required), tournament_id (required).

speechwire_update_judge_availabilityA

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}

Inputs: judge_id (required), available_slots (required).

speechwire_update_judge_emailA

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}

Inputs: email (required), judge_id (required).

speechwire_update_judge_schoolA

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}

Inputs: team_id (required), judge_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 24 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose. Judge tools are specific (list, add, get school/contact/availability, update email/availability/school), room tools (list, get usage, get counts) are separate, and team/entry/schedule/schematic tools are all unambiguous. No overlapping functionality.

    Naming Consistency5/5

    All tools follow the consistent pattern 'speechwire_verb_noun' with verbs like list, get, add, select, update. No mixing of conventions (e.g., camelCase) and no irregular naming.

    Tool Count5/5

    24 tools is well-scoped for a tournament management server covering account selection, tournament selection, judges (CRUD + queries), rooms, teams, entries, schedule, schematics, and results. Each tool serves a distinct function without bloat.

    Completeness4/5

    Core workflows for judge management, room allocation, scheduling, and results are covered. Minor gaps exist: no delete judge tool and no update tools for rooms, teams, or entries. However, the surface is robust for most common tasks.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that provides AI models with structured access to external data and services, acting as a bridge between AI assistants and applications, databases, and APIs in a standardized, secure way.
      2
      -
    • F
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server implementation that can be run directly or through Docker, enabling AI assistants to interact with external systems through the MCP standard.
      2
      -