Run tournaments by talking to your AI
The MCP server connects Grassroots to any AI assistant that supports the Model Context Protocol. Describe what you want in plain English — create brackets, record scores, check standings — and the AI handles the rest.
Who is this for?
MCP is designed for people who want to run tournaments without writing code or learning an API. If you can describe what you want, the AI can do it.
Community organizers
Run weekly game nights, club tournaments, or office competitions with zero setup overhead.
Casual gamers
Track your group's matches, ratings, and rivalries without spreadsheets or manual data entry.
Educators & students
Teach tournament theory, ELO ratings, or competitive structures hands-on through conversation.
How it works
Three steps from zero to a running tournament.
Connect the MCP server
Add the Grassroots MCP server to your AI client (Claude Desktop, VS Code, etc). Point it at your database and set your username.
Describe your tournament
Tell the AI what you want: "Create a Swiss chess tournament for Alice, Bob, Charlie, and Diana." It handles brackets, seeding, and round generation.
Play and advance
Record results as they happen — "Alice beat Bob 3-1" — and ask the AI to advance to the next round when you're ready.
Example conversations
Here's what working with the MCP server looks like in practice.
Creating a tournament
"Set up a 4-player single elimination pool tournament for me, Alice, Bob, and Charlie."
The AI creates a series, tournament, and seeds Round 1 matches automatically.
Recording results
"I beat Alice 3-2 and Bob beat Charlie 3-0."
Both match results are recorded and ELO ratings update in the background.
Checking standings
"Who's winning? Show me the current bracket."
The AI shows completed and upcoming matches, scores, and tournament progress.
Available tools
The MCP server exposes 9 tools that your AI assistant can call.
create_tournamentCreate a new tournament with participants and format selection.
record_match_resultRecord or update the result of a single match.
batch_record_resultsRecord results for an entire round at once.
update_tournamentChange a tournament's name, description, or status.
replace_participantsSwap the participant list before matches begin.
advance_tournamentGenerate next round pairings or complete the tournament.
get_tournament_progressView matches, standings, and bracket status.
get_top_ratingsSee top-rated players for any discipline.
get_player_ratingLook up a specific player's rating and history.
Included with Free and Basic plans
The MCP server is available to all Grassroots users at no extra cost. Free-tier users can create up to 3 active tournaments. Basic-tier users get unlimited tournaments and priority support.
View pricing plans