> For the complete documentation index, see [llms.txt](https://stitch-bot.gitbook.io/mlb-bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stitch-bot.gitbook.io/mlb-bot/mlb-bot-documentation.md).

# MLB Bot Documentation

MLB Bot brings live baseball information, automatic game coverage, and server-based games into Discord. It includes scores, schedules, standings, lineups, box scores, player and team stats, Statcast tools, alerts, news, highlights, a virtual Stubs economy, Season Pass progression, Bingo, Trivia, Guess the Player, Wordle, and Diamond Dynasty.

Most commands use autocomplete. Start typing a team, player, game, date, division, or stat and choose the result instead of looking up an ID yourself.

**The easiest way to set up MLB Bot is on** [**The Baseball Exchange**](https://baseballexchange.app/)**.** Sign in with Discord, choose your server, and open **Server Management** below Profile. You can choose channels, add alerts, schedule games, and review server activity in one place.

Server Management is available to members with **Manage Server** permission or the configured **MLB staff role**. Some settings have additional permission requirements; see the [website guide](/mlb-bot/mlb-bot-documentation/baseball-exchange.md#server-management). If you prefer Discord, [`/setup`](/mlb-bot/mlb-bot-documentation/admin-support.md) checks your current configuration and recommends the next commands.

***

## 📚 Documentation

* [🌐 The Baseball Exchange](/mlb-bot/mlb-bot-documentation/baseball-exchange.md) — server setup and management, profiles, predictions, Season Pass, Bingo, Wordle, and Diamond Dynasty
* [📺 Live / Scoreboard](/mlb-bot/mlb-bot-documentation/live-scoreboard.md) — scores, live trackers, lineups, calendars, standings, and scheduled game channels
* [🎟️ Stubs Economy](/mlb-bot/mlb-bot-documentation/stubs-economy.md) — claims, predictions, pools, missions, profiles, shop items, and leaderboards
* [🎫 Season Pass](/mlb-bot/mlb-bot-documentation/season-pass.md) — Season XP, rewards, profile upgrades, and Prestige levels
* [🎮 Diamond Dynasty](/mlb-bot/mlb-bot-documentation/diamond-dynasty.md) — cards, packs, collections, teams, challenges, and the market
* [🔠 Bingo](/mlb-bot/mlb-bot-documentation/bingo.md) — live game boards, difficulty levels, rewards, and leaderboards
* [📚 Trivia](/mlb-bot/mlb-bot-documentation/trivia.md) — trivia categories, round settings, rewards, stats, and leaderboards
* [🧩 Guess / Wordle](/mlb-bot/mlb-bot-documentation/guess-wordle.md) — private player puzzles with Stubs and Season Pass XP rewards
* [🎲 Game Details](/mlb-bot/mlb-bot-documentation/game-details.md) — highlights, scoring plays, Statcast, pitcher arsenals, and umpires
* [📊 Stats / Teams / Players](/mlb-bot/mlb-bot-documentation/stats-teams-players.md) — player profiles, comparisons, rosters, payroll, injuries, and transactions
* [📢 Alerts / Updates](/mlb-bot/mlb-bot-documentation/alerts-updates.md) — team alerts, player watchlists, news, daily scoreboards, and birthdays
* [🛠️ Admin / Support](/mlb-bot/mlb-bot-documentation/admin-support.md) — setup, permissions, server controls, voting, and support

***

## Recommended server setup

The simplest setup is one MLB category with separate channels for daily games, news, birthdays, Stubs activity, and general bot commands.

1. Add MLB Bot to your Discord server, then [sign in to The Baseball Exchange](https://baseballexchange.app/).
2. Choose your server and open **Server Management** below Profile.
3. With **Manage Server** permission, select the MLB staff role. Assign that role to trusted members in Discord, including yourself if you will manage alerts or scheduled games.
4. Choose channels for daily scoreboards, birthdays, news, and Stubs activity. Enable prediction buttons if you want them.
5. Choose a Diamond Dynasty market channel if your members use it.
6. Add team alerts or scheduled game coverage. Review the saved lists to see what is active.

Changes also apply in Discord. The same settings are available through `/staffrole`, `/daily`, `/birthdays`, `/news`, `/stubschannel`, `/dd marketchannel`, `/alerts`, and `/schedulegame`.

For a full-season tracker, a common starting command is:

```txt
/schedulegame add team:Yankees count:162 bets:true
```

Use `team:All Teams` with a category when you want the bot to create matchup channels for every game. For team-specific servers, schedule only the team your community follows.

<figure><img src="https://2987499891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTXfxLOqMTFBr6GNQ6nSb%2Fuploads%2Fgit-blob-17ed3add48bb193d47e1b0c754e0b366c7038d33%2Fimage.png?alt=media" alt="Example MLB Bot server category" width="143"><figcaption><p>A simple channel layout for MLB Bot features.</p></figcaption></figure>

***

## Quick start for members

* `/scores` — today’s complete scoreboard
* `/boxscore game:<game>` — a detailed box score for one game
* `/calendar team:<team>` — a monthly team schedule image
* `/player name:<player>` — player profile, season stats, career totals, and advanced information
* `/profile` — your server Stubs and gameplay profile
* `/missions` — current daily and weekly goals
* `/guess` and `/wordle` — private player puzzles
* `/dd help` — the private interactive Diamond Dynasty guide

`/live` starts an automatically refreshing tracker and requires the MLB staff role or Manage Server permission.

***

## Important notes

* Scheduled posts use Eastern Time unless a section says otherwise.
* Starting times are displayed with Discord timestamps where available, so members see them in their own local time.
* Server settings, balances, progression, collections, and leaderboards are server-specific.
* Previous seasons remain stored. Use a command’s `season` option or a website season selector to view available history.
* Daily scoreboards pause after the postseason and resume for spring training.
* MLB and third-party data can be delayed, incomplete, unavailable, or corrected later.
* The bot needs permission to view the channel, send messages, embed links, attach files, and use application commands.
* `All Teams` is supported where the command offers it. For alerts, it is intended primarily for Home Run alerts; other alert types require one team.
* Stubs, cards, tokens, and other bot rewards are virtual entertainment items. They have no real-world value and cannot be purchased, sold, or redeemed for money.
* Abuse, spam, exploit attempts, or harassment may result in a user or server losing access to the bot.

***

## 🔗 Useful links

* [Terms of Service](/mlb-bot/mlb-bot-documentation/terms-of-service.md)
* [Privacy Policy](/mlb-bot/mlb-bot-documentation/privacy-policy.md)
* [Legal Disclaimer](/mlb-bot/mlb-bot-documentation/legal-disclaimer.md)
* [Support Server](https://discord.gg/wc2vbmXSGZ)
* [Change Log Channel](https://discord.com/channels/1511455923846123610/1513773142408167524)

***

## Credits and attributions

MLB Bot uses data, tools, libraries, and services maintained by third parties.

* **Major League Baseball, MLB.com, and MLB Advanced Media** — scores, schedules, standings, teams, players, game data, play-by-play, headshots, highlights, and related baseball content
* **Baseball Savant / Statcast** — Statcast search, percentiles, expected statistics, batted-ball data, pitch data, and advanced metrics
* **ESPN** — MLB news, injuries, and related baseball information used by some features
* **SportsLogos.net** — team-logo references and artwork used for some visuals: [sportslogos.net](https://www.sportslogos.net/)
* **UmpScorecards** — umpire scorecard images: [umpscorecards.com](https://umpscorecards.com/)

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

All team names, logos, player names, statistics, trademarks, and related materials belong to their respective owners and are used for informational, documentation, and entertainment purposes only.
