SpeechWire MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SpeechWire MCP Server list judges for the current tournament"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SpeechWire MCP Server
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-mcpSet your SpeechWire credentials as environment variables:
export SPEECHWIRE_EMAIL="your-email@example.com"
export SPEECHWIRE_PASSWORD="your-password"Available MCP Tools
Tool | Description |
| List accounts available after login |
| Select an account to work with |
| List tournaments for the selected account |
| Select a tournament to activate |
| List all judges with roster details |
| Get judge email and phone |
| Get judge availability by timeslot |
| Get judge's school association |
| Add a new judge to the tournament |
| Update a judge's email address |
| Update a judge's availability slots |
| Update a judge's school/team affiliation |
| List configured judge types |
| List tournament rooms |
| Get room time-slot usage grid |
| Get rooms vs. sections per grouping/round |
| List registered teams |
| Get entries for a specific team |
| List cross-school hybrid entries |
| List tournament schedule timeslots |
| List competition groupings |
| List schematic events with available rounds |
| Get pairings for a specific event round |
| Get results tab sheet for a grouping |
Contributing
Source contribution guidance, including MCP tool authoring conventions, lives
in src/README.md.
License
Available Tools
24 toolsspeechwire_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
Scored across 24 tools
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.
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.
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.
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
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
MCP server for Argo RPG Platform — connects AI assistants to campaign data via OAuth2
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA 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-
- FlicenseBqualityDmaintenanceA 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-

OpenStride MCP Serverofficial
AlicenseNot gradedqualityDmaintenanceModel Context Protocol (MCP) server that allows AI assistants to access and analyze your OpenStride training data.MIT- FlicenseNot gradedqualityFmaintenanceA Model Context Protocol (MCP) server that provides AI assistants full access to the Motion task and project management API, enabling task, project, and schedule management.-