Discord Bot

Run Tournaments From Discord

Seamless tournament management for Magic: The Gathering and other TCGs. Standings, pairings, match reporting, LFG lobbies, and event notifications — all without leaving Discord.

/ show_standings
Weekly Modern
Round 4
1. PlayerOne 12 pts
2. CardShark 10 pts
3. MtgPro 9 pts

Everything You Need

Powerful tournament tools, zero friction

Live Standings

Automatic standings updates posted to your channel after each round. Players always know where they stand.

Round Posting

Pairings posted automatically with optional voice channels, forum threads, and SpellTable links for each table.

Self-Reporting

Players report their own match results with /report_match. Supports 1v1 and multiplayer pod formats.

LFG Lobbies

Looking-for-game system for leagues. Auto-join existing lobbies or create new ones. Private lobbies with invite codes supported.

Event Hub

Get notified about upcoming events at your favorite stores, filtered by location, game, and format.

Fully Configurable

Custom channels, categories, access roles, and more. The bot adapts to your server's structure.

Quick Start

Get running in under 5 minutes

1

Install the Bot

Click the "Add to Discord" button and select your server. The bot needs permissions to manage channels and send messages.

Install Now →
2

Link Your Tournament

Create your tournament on topdeck.gg, then link it with:

/link_tournament tid:your-tournament-url
3

Configure Channels

Set where updates should be posted:

/set_channel_settings updates_channel:#tournament
4

Check Your Config

Verify everything is set up correctly:

/status

You must be staffed on the tournament at topdeck.gg to link it. Rounds and standings will post automatically when you advance the tournament.

Commands

Complete reference for all bot commands

Tournament Management

/link_tournament Link a tournament to this Discord server
/unlink_tournament Disconnect a tournament from this server
/show_standings Display current tournament standings
/post_round Post the latest round pairings
/clear_channel Clear tournament channels and categories

Settings & Configuration

/status View current bot configuration for this server
/set_channel_settings Set update channels, categories, and forums
/set_round_settings Configure voice channels, forum posts, SpellTable links
/set_tournament_access_role Set role required for player commands

Event Hub

/set_location Set location for event notifications
/set_game_formats Set game and format filters
/add_store Follow a store for event notifications
/remove_store Unfollow a store
/show_filters Show current event notification filters
/clear_filters Clear all event filters

LFG / Leagues

/set_active_league Set the active league for LFG matchmaking
/set_lfg_ping_role Set a role to ping when someone creates a public LFG lobby

Tournament Actions

/register Register for a tournament on this server
/checkin Check into a tournament (when check-in is open)
/drop Drop from a tournament
/report_match Report your match result
/faq View frequently asked questions
/stats View your tournament statistics

Looking for Game (LFG)

/lfg Join an existing lobby or create a new one automatically
/lfg code:XXXX Join a specific lobby by code
/lfg private:True Create a private lobby (share code with friends)
/lfg create:True Force create a new lobby (skip auto-join)
/lobbies View all active public lobbies