Start Here

New servers can start with /setup, which shows a guided checklist for staff roles, daily posts, alerts, scheduled game trackers, Stubs channels, and recommended server settings.

Recommended Category

Create a Discord category dedicated to MLB Bot channels, such as Daily, News, Birthdays, Predictions, Botspam, and game channels.

Daily Posts

Use /daily bets:True for the daily MLB scoreboard. Daily posts refresh around 5:00 AM ET.

Game Channels

Use /schedulegame add to create pre-game previews, live trackers, and final box scores.

Staff Role

Use /staffrole so only trusted staff can press tracker controls like Stop and manage key server settings.

Popular Setup Commands

/daily bets:True posts the daily scheduled games.
/news fetches recent MLB articles and supports polling.
/birthdays displays current-day MLB birthdays.
/stubschannel sets the Stubs betting feed channel.
/schedulegame add team:All Teams count:162 creates daily matchup channels.
/alerts add event:Home Run team:All Teams tracks home run alerts.

Most team, player, date, division, game, and stat inputs support Discord autocomplete. Game options usually accept autocomplete or a pasted gamePk.

Stubs are virtual entertainment currency only. Stubs, predictions, cards, rewards, and leaderboard progress have no real-world cash value.

📺 Live / Scoreboard Commands

Commands for live games, daily scoreboards, game trackers, scheduled posts, box scores, lineups, calendars, and standings.

Live Scoreboard

/scores [date]Scores

Shows MLB scores for a selected date.

date Optional date: MM-DD-YYYY, MM/DD/YYYY, or YYYY-MM-DD.

Example: /scores date:06-09-2026

/live [team] [interval]Live Tracker

Starts an auto-refreshing live MLB tracker.

team Optional team name or abbreviation.
interval Optional refresh interval in seconds. Default 10. Min 10, max 120.

Example: /live team:Yankees interval:10

/boxscore game:<gamePk>Box Score

Shows a detailed MLB box score for a game.

Example: /boxscore game:123456

/lineup game:<gamePk>Lineups

Shows current lineups, bench, bullpen, and player season stats for a game.

Example: /lineup game:123456

/calendar team:<team> [month]Calendar

Renders a team monthly calendar image with scores and gamePk codes.

team Team name or abbreviation.
month Optional month, such as June 2026, 2026-06, or 06-2026.

Example: /calendar team:Yankees month:June 2026

/standings division:<division>Standings

Shows MLB standings for a division.

Example: /standings division:AL East

Scheduled Game Trackers

/schedulegame add team:<team> [date] [count] [channel] [category] [bets]Schedule

Schedules MLB game trackers to post before first pitch. Pre-game previews are sent around 5 AM ET, trackers start before game time, and final box scores post when games end.

team Team name, abbreviation, or All Teams.
date Pick one game/date, or start date when count is used.
count Schedule the next number of games from the date or today. Max 162.
channel Existing channel where the scheduled tracker will post.
category Category where the bot creates matchup channels. Required for All Teams.
bets Shows live Stubs betting buttons for the scheduled game.

Example: /schedulegame add team:Yankees count:7 bets:true

All Teams: /schedulegame add team:All Teams count:162 category:#MLB Bot Feed bets:true

/schedulegame listList

Lists scheduled MLB games for the server.

Example: /schedulegame list

/schedulegame remove id:<id>Remove

Removes a scheduled MLB game or active scheduled batch.

Example: /schedulegame remove id:abc123

/stopStop Tracker

Stops MLB auto-refresh messages in the current channel.

Example: /stop

💰 Stubs Economy Commands

Commands for the virtual Stubs economy, predictions, live betting buttons, missions, profiles, shop items, and leaderboards.

Balances, Profiles & Channels

/claimDaily Claim

Claims daily Stubs with a consecutive-day streak bonus.

Example: /claim

/balance [user]Balance

Shows your Stubs balance or another user’s balance.

user Optional user to check.

Examples: /balance /balance user:@Pavy

/stubschannel [channel] [clear]Bet Feed

Sets the public channel for Stubs betting announcements.

channel Channel where Stubs bet announcements will post.
clear Clears the saved Stubs betting announcement channel.

Examples: /stubschannel channel:#stubs /stubschannel clear:true

/betsActive Bets

Shows your active MLB Stubs bets.

Example: /bets

/profile [user] [season]Profile

Shows a Stubs betting profile.

user Optional user profile to view.
season Optional season year, such as 2026.

Examples: /profile /profile user:@Pavy season:2026

/leaderboard [season]Leaderboard

Shows the server’s Stubs leaderboard.

season Optional season year.

Example: /leaderboard season:2026

/missionsMissions

Shows daily and weekly Stubs missions.

Example: /missions

Predictions & Live Bets

/predict game game:<gamePk> team:<team> [amount] [exact_score] [run_diff]Game Bet

Places a Stubs bet on a game winner before the scheduled start time.

game MLB game from autocomplete, or pasted gamePk.
team Team you predict will win.
amount Stubs to bet. Default 100. Max 2500.
exact_score Optional exact final score as away-home, such as 4-2.
run_diff Optional winner run differential.

Example: /predict game game:123456 team:Yankees amount:100

/predict live game:<gamePk> event:<event> [amount]Live Bet

Places a live bet on the next completed play in a live game.

game MLB game from autocomplete, or pasted gamePk.
event Next-play event: Home Run, Strikeout, Walk, Run Scores, Groundout, Double Play, Lineout, Fly Out, Single, Double, Triple.
amount Stubs to bet. Default 25. Max 100.

Example: /predict live game:123456 event:Home Run amount:25

/attachbets [game]Buttons

Attaches live Stubs betting buttons to an existing game tracker channel.

game Optional MLB game from autocomplete, or pasted gamePk.

Example: /attachbets

Shop Commands

/shop listShop

Shows Stubs shop items.

Example: /shop list

/shop buy profile-title title:<title>Title

Buys a custom betting profile title.

Example: /shop buy profile-title title:Bronx Bombardier

/shop buy team-flair team:<team>Flair

Buys a team flair for your profile.

Example: /shop buy team-flair team:Yankees

/shop buy highlight-video url:<url>Video

Buys a highlight video for your profile. The URL should be an MP4 link.

Example: /shop buy highlight-video url:https://example.com/video.mp4

/shop buy odds-boostBoost

Buys an odds boost token for eligible predictions.

Example: /shop buy odds-boost

/shop buy bet-insuranceInsurance

Buys bet insurance for an eligible future loss.

Example: /shop buy bet-insurance

Stubs predictions and live bets are not real-money gambling and cannot be exchanged for money, prizes, or cash-equivalent rewards.

🎫 Season Pass Commands

Season Pass gives members 100 levels of progression with XP, rewards, inventory, Diamond Dynasty packs, profile upgrades, and leaderboards.

XP Sources

XP can come from claims, Top.gg votes, predictions, Bingo, Guess the Player, Trivia, missions, and supported commands.

Rewards

Rewards include Stubs, odds boost tokens, bet insurance, Bingo bonus tokens, Diamond Dynasty packs, and profile upgrades.

Level 50

Unlocks the Profile Team Frame, changing /profile into a custom team-colored canvas.

Level 100

Unlocks the Champion Profile Card with favorite player selection and holographic baseball card styling.

Season Pass Commands

/seasonpassProgress

Shows your Season Pass level, XP, claimable rewards, inventory, leaderboard, and recent XP history.

Example: /seasonpass

/seasonpass activate-profile-team-frame:<team>Level 50

Activates the Level 50 Profile Team Frame using the selected MLB team.

Example: /seasonpass activate-profile-team-frame:Yankees

/seasonpass activate-champion-player:<player>Level 100

Activates the Level 100 Champion Profile Card using a favorite player from autocomplete search.

Example: /seasonpass activate-champion-player:Mark Teixeira

Related XP Commands

/claim daily claim XP.
/vote Top.gg vote XP.
/predict game and /predict live prediction XP.
/bingo game and /bingo check Bingo XP.
/guess Guess the Player XP.
/trivia start Trivia XP.
/missions mission progress and rewards.
/profile profile canvas rewards after unlocks.

💎 Diamond Dynasty Commands

Diamond Dynasty is the card-collection mode with packs, collections, legal teams, loadouts, challenges, simulations, market listings, and leaderboards.

Card Pool

Collect MLB cards across teams, eras, positions, series, handedness, and rarities.

No Duplicate Pulls

Users cannot pull duplicate cards.

Legal Teams

Build teams using C, 1B, 2B, 3B, SS, LF, CF, RF, and SP.

Market

List, buy, and sell cards with virtual Stubs through the server market.

Packs & Collections

/shop buy pack tier:<pack>Buy Pack

Buys and opens a Diamond Dynasty pack from the shop.

tier Pack tier such as Bronze, Silver, Gold, Diamond, Elite, or Legend.

Example: /shop buy pack tier:gold

/dd packsInventory

Shows your Diamond Dynasty pack inventory.

Example: /dd packs

/dd open tier:<pack>Open

Opens a saved Diamond Dynasty pack.

Example: /dd open tier:gold

/dd quicksellQuick Sell

Shows quick sell options for eligible cards.

Example: /dd quicksell

/dd quicksell card id:<id>Sell Card

Quick sells a specific card for immediate discounted Stubs.

Example: /dd quicksell card id:12345

/dd collections [user]Collection

Shows Diamond Dynasty collection progress for yourself or another user.

Example: /dd collections user:@Pavy

/dd card player:<search>Card Lookup

Searches for a Diamond Dynasty card by player name or card search text.

Example: /dd card player:Aaron Judge

Teams & Loadouts

/dd team [user]View Team

Shows your active Diamond Dynasty team or another user’s team.

Example: /dd team

/dd team position:<position> card_id:<id>Set Player

Adds a card to your active Diamond Dynasty team at a legal position.

Example: /dd team position:CF card_id:12345

/dd team position:<position> clear:trueClear Spot

Clears a position from your active Diamond Dynasty team.

Example: /dd team position:CF clear:true

/dd team canvas:trueCanvas

Shows a canvas image of your active Diamond Dynasty team.

Example: /dd team canvas:true

/dd team collection:trueBuild View

Shows collection/team-building view for cards you own.

Example: /dd team collection:true

/dd loadout action:<action> slot:<1-5> [name] [canvas]Loadouts

Saves, loads, shows, or deletes Diamond Dynasty team loadouts.

action:save Save your current team to a slot.
action:load Load a saved team from a slot.
action:show View a saved loadout.
action:delete Delete a saved loadout.
slot Loadout slot from 1 to 5.
canvas Optional canvas view for showing a loadout.

Examples: /dd loadout action:save slot:1 name:Main Squad /dd loadout action:show slot:1 canvas:true

Challenges, Leaderboards & Market

/dd challenge user:<member> [stubs_bet]Challenge

Challenges another user to a Diamond Dynasty simulation. Teams must be legal before simulations.

Example: /dd challenge user:@Pavy stubs_bet:100

/dd leaderboards [season]Rankings

Shows Diamond Dynasty wins, losses, and best overall team leaderboard data.

Example: /dd leaderboards season:2026

/dd market [search]Market

Browses the server Diamond Dynasty card market.

Example: /dd market search:Yankees

/dd sell card_id:<id> price:<stubs>Sell

Lists a card on the server market for Stubs.

Example: /dd sell card_id:12345 price:500

/dd buy listing_id:<id>Buy

Buys a listed card from the server market.

Example: /dd buy listing_id:abc123

/dd marketchannel channel:<channel>Market Feed

Sets the market announcement channel for listings and completed sales.

Example: /dd marketchannel channel:#dd-market

/dd marketchannel clear:trueClear Feed

Clears the Diamond Dynasty market announcement channel.

Example: /dd marketchannel clear:true

/dd stockSupply

Shows Diamond Dynasty stock or pack/card availability information.

Example: /dd stock

🔠 Bingo & 📚 Trivia Commands

Server games tied to MLB data, virtual Stubs, Season Pass XP, and leaderboards.

MLB Stubs Bingo

/bingo game game:<gamePk> difficulty:<difficulty>Create Board

Creates or shows a game-specific Bingo board using virtual Stubs. Boards fill from live or final MLB game data.

game MLB game from autocomplete, or pasted gamePk.
difficulty Easy, Medium, or Hard.
easy 4x4 board with lower cost and lower reward potential.
medium 5x5 board with higher reward potential.
hard 5x5 board with higher cost and higher reward potential.

Example: /bingo game game:123456 difficulty:medium

/bingo checkCheck

Checks active finalized Bingo boards, fills completed tiles, and pays eligible line rewards.

Example: /bingo check

/bingo leaderboard [season]Leaderboard

Shows the server Bingo leaderboard. Users need at least 5 board attempts to appear.

Example: /bingo leaderboard season:2026

Guess the Player

/guessPuzzle

Starts a timed MLB Guess the Player puzzle. Users reveal clues, make guesses, and earn Stubs plus Season Pass XP for correct solves.

Example: /guess

MLB Trivia

/trivia start [questions] [time] [difficulty] [category] [team]Start

Starts timed MLB trivia with buttons, Stubs rewards, Season Pass XP, and leaderboards.

questions 5, 10, 15, or 20. Default 10.
time 15, 30, 45, or 60 seconds. Default 30.
difficulty Easy, Medium, Hard, or Mixed.
category Mixed, Leaders, Awards, Teams, Players, Standings, Birthdays, Game, Venues, Staff, Draft, Home Run Derby, Advanced Stats, Payroll, Contracts.
team Optional team filter for supported trivia types.

Example: /trivia start questions:10 time:30 difficulty:Mixed category:Mixed

/trivia stopStop

Stops the active trivia round.

Example: /trivia stop

/trivia leaderboard [period]Leaderboard

Shows trivia leaderboards by period.

period Today, Week, Season, or All. Default Season.

Example: /trivia leaderboard period:Season

/trivia stats [user]Stats

Shows trivia stats for yourself or another user.

Example: /trivia stats user:@Pavy

📊 Stats / Teams / Players & 🎲 Game Details

Commands for highlights, scoring plays, Statcast-style tools, pitcher arsenals, umpires, league leaders, player lookups, teams, rosters, transactions, injuries, payroll, and ABS stats.

Game Details

/highlights [game] [team] [date] [limit]Highlights

Shows MLB highlight clips for a game, team, or date.

game Optional game from autocomplete or gamePk.
team Optional team filter.
date Optional date.
limit Default 5. Max 40.

Example: /highlights team:Yankees date:06-09-2026 limit:10

/scoringplays game:<gamePk>Scoring

Shows scoring plays for a selected MLB game.

Example: /scoringplays game:123456

/statcast [game] [team] [date] [limit]Statcast

Shows Statcast-style game info, including hardest-hit balls, longest drives, fastest pitches, barrels, expected contact, and batted-ball details.

game Optional game from autocomplete or gamePk.
team Optional team filter.
date Optional date.
limit Default 5. Max 40.

Example: /statcast team:Yankees date:06-09-2026 limit:10

/pitcherarsenal pitcher:<pitcher> [season] [limit]Pitching

Shows pitcher arsenal and pitch mix information.

pitcher Pitcher name or MLBAM ID.
season Optional season. Defaults to current season.
limit Default 8. Max 10.

Example: /pitcherarsenal pitcher:Gerrit Cole season:2026

/umpires [game] [team] [date]Officials

Shows umpires and officials for a game.

Example: /umpires team:Yankees date:06-09-2026

Stats, Teams & Players

/leaders stat:<stat> group:<group> [league] [limit] [season]Leaders

Shows league leaders for hitting, pitching, or fielding stats.

stat Stat such as homeRuns, ops, or earnedRunAverage.
group Hitting, Pitching, or Fielding.
league Optional league filter.
limit Default 10. Max 25.
season Optional season year.

Example: /leaders stat:homeRuns group:Hitting league:All MLB limit:10 season:2026

/player name:<player> [season]Player

Looks up a player with season stats, advanced stats, game logs, and awards where available.

Example: /player name:Aaron Judge season:2026

/compare player1:<player> player2:<player>Compare

Compares two players using supported standard and advanced stats.

Example: /compare player1:Aaron Judge player2:Shohei Ohtani

/roster team:<team> [type] [season]Roster

Shows an MLB team roster.

type Active, 40 Man, Full Season, Depth Chart, or Non-Roster Invitees.
season Optional season year.

Example: /roster team:Yankees type:Active season:2026

/team team:<team>Team

Shows a team dashboard with useful team information.

Example: /team team:Yankees

/teamleaders team:<team> stat:<stat> [limit] [season]Team Leaders

Shows statistical leaders for a selected team.

Example: /teamleaders team:Yankees stat:homeRuns limit:10 season:2026

/transactions [team] [date] [start] [end] [days] [limit]Transactions

Shows recent MLB transactions.

team Optional team filter.
date, start, end Optional date filters.
days Default 7. Max 30.
limit Default 15. Max 25.

Example: /transactions team:Yankees days:7 limit:15

/injuries [team] [status] [limit]Injuries

Shows MLB injury reports.

team Optional team filter.
status All, Active, Day-to-Day, Injured List, or Out.
limit Default 15. Max 25.

Example: /injuries team:Yankees status:All limit:15

/payroll team [team] [season] [limit]Team Payroll

Shows payroll information for a team.

Example: /payroll team team:Yankees season:2025 limit:25

/payroll leaders [season] [limit]Payroll Leaders

Shows league payroll leaders.

Example: /payroll leaders season:2025 limit:10

/abs team:<team> season:<season>ABS

Shows ABS challenge stats for a team or All Teams.

Examples: /abs team:NYY season:2026 /abs team:All Teams season:2026

📢 Alerts / Updates Commands

Commands for team alerts, play-by-play alerts, watchlist DMs, news polling, daily posts, and birthdays.

Team Alerts

/alerts add event:<event> team:<team>Add Alert

Adds a persistent team alert for supported game events.

event Score Change, Final Score, Delayed, Postponed, Home Run, Lead Change, Pitcher Change, ABS Challenge, or Play-by-Play.
team Team name, abbreviation, or All Teams where supported.

Example: /alerts add event:Home Run team:All Teams

/alerts basic team:<team>Basic PBP

Enables compact basic play-by-play alerts for a team.

Example: /alerts basic team:Yankees

/alerts listList

Lists saved alerts for the server.

Example: /alerts list

/alerts remove id:<id>Remove

Removes an alert by ID.

Example: /alerts remove id:abc123

News & Daily Updates

/newsNews

Shows recent MLB news.

Example: /news

/news league [limit]League News

Shows league-wide MLB news with an optional result limit.

Example: /news league limit:10

/news pollPolling

Enables or manages news polling for new MLB articles.

Example: /news poll

/news clearClear

Clears saved news polling settings.

Example: /news clear

/dailyDaily Board

Posts the daily scheduled MLB games and can include Stubs prediction buttons.

Example: /daily bets:True

/birthdaysBirthdays

Displays MLB player birthdays for the current day.

Example: /birthdays

Player Watchlist

/watchlist add player:<player>Add Player

Adds a player to your watchlist for postgame player summary DMs.

Example: /watchlist add player:Aaron Judge

/watchlist listList

Lists your current watchlisted players.

Example: /watchlist list

/watchlist remove player:<player>Remove

Removes a player from your watchlist.

Example: /watchlist remove player:Aaron Judge

/watchlist recentRecent

Shows recent watchlist-related player updates where available.

Example: /watchlist recent

All Teams is mainly intended for Home Run alerts. Most other alert types require one specific team.

🛠️ Admin / Support Commands

Setup, permissions, staff controls, final GIF settings, Stubs configuration, help, voting, and support commands.

Server Setup & Permissions

/setupSetup

Shows the guided server setup checklist for MLB Bot.

Example: /setup

/stubsconfig enabled:<true|false>Stubs Toggle

Enables or disables Stubs-related betting features for the server.

Example: /stubsconfig enabled:false

/helpHelp

Displays the bot help panel and command categories.

Example: /help

/staffrole id:<role|clear>Staff Role

Sets or clears the staff role for tracker controls, stop, attachbets, finalgif, stubschannel, and DD market channel management.

Examples: /staffrole id:@Staff /staffrole id:clear

Support & Extras

/finalgif mode:<mode> [team]Final GIF

Configures final winning-team GIF behavior.

mode winner, followed, neutral, or disabled.
team Optional team for followed-team behavior.

Examples: /finalgif mode:winner /finalgif mode:followed team:Yankees /finalgif mode:disabled

/donateSupport

Shows donation and support information for the bot.

Example: /donate

/voteTop.gg

Shows Top.gg voting information and vote rewards.

Example: /vote

ℹ️ Notes / Legal

Important usage notes, data notes, and disclaimers for MLB Bot.

Command Notes

Most team, player, date, division, game, and stat inputs support autocomplete.
Game options usually accept a game selected from autocomplete or a pasted gamePk.
Some setup commands require server staff permissions, Manage Server, or a configured staff role.
Live game trackers depend on Discord, hosting, and MLB data availability.
Scheduled posts and daily scoreboard features use Eastern Time unless stated otherwise.
MLB data, scores, schedules, stats, highlights, news, injuries, and transactions may be delayed, incomplete, or corrected later.
Bot settings are server-specific. Settings changed in one Discord server do not automatically apply to another server.
Make sure the bot can view channels, send messages, embed links, attach files, and use slash commands.

Virtual Economy Disclaimer

Stubs are a virtual server currency for entertainment only.
Stubs have no real-world cash value.
Predictions and live bets are not real-money gambling.
Stubs, rewards, predictions, cards, and leaderboard progress cannot be redeemed for money, prizes, or cash-equivalent rewards.
Economy systems may be adjusted, reset, removed, or modified to fix bugs, prevent abuse, maintain fairness, or comply with platform rules.

Data Stored by the Bot

User IDs, guild IDs, channel IDs, role IDs, and message IDs where needed.
Command usage records and bot configuration settings.
Alert, watchlist, scheduled post, and permission settings.
Economy data, Stubs balances, prediction history, bet history, and mission progress.
Season Pass progress, Bingo progress, Trivia results, Guess results, and Diamond Dynasty collection/card ownership data.
Error logs and diagnostic logs used to maintain and secure bot functionality.

MLB Utility Bot is independent and is not affiliated with, endorsed by, sponsored by, or officially connected to Major League Baseball, MLB Advanced Media, MLB.com, Discord Inc., Top.gg, any MLB team, league, player, or organization unless explicitly stated.

MLB Bot is provided “as is” and “as available.” The bot creator does not guarantee uninterrupted access, permanent availability, error-free service, accurate data, timely alerts, or compensation for downtime, missed alerts, delayed alerts, incorrect information, API failures, Discord outages, or hosting issues.