> For the complete documentation index, see [llms.txt](https://docs.moodymusic.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.moodymusic.xyz/getting-started/adding-the-bot.md).

# Adding the Bot

Adding Moody Music to your server requires the **Manage Server** permission. Use the invite link below:

[Invite Moody Music](https://discord.com/api/oauth2/authorize?client_id=YOUR_CLIENT_ID\&permissions=0\&scope=bot)

## Required Permissions

| Permission             | Purpose                        |
| ---------------------- | ------------------------------ |
| `Send Messages`        | Respond to commands            |
| `Connect`              | Join voice channels            |
| `Speak`                | Stream audio to voice channels |
| `Use Voice Activity`   | Detect voice state changes     |
| `Read Message History` | Process message commands       |
| `Add Reactions`        | Interactive command controls   |
| `Embed Links`          | Rich response embeds           |
| `Attach Files`         | Welcome cards and images       |

## Intents

The bot requires these privileged gateway intents:

* **Server Members Intent** — Member join/leave tracking for welcome messages
* **Message Content Intent** — Reading message-based commands
* **Voice States Intent** — Voice channel join/leave/move detection

## After Inviting

Once the bot is in your server, type `mplay <song name or URL>` in any text channel while in a voice channel. See the Quickstart Guide for your first steps.