> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Discord Toolkit

> Send messages, manage channels and roles, and moderate Discord servers with a bot token

The **Discord** toolkit lets agents send messages (bot or webhook), list guilds, channels, members, and roles, create or rename channels, manage roles, and moderate members (kick, ban, unban). Authentication uses a **Discord bot token** saved as a connection (not OAuth).

Add it on the agent **Toolkits** tab and create or select a Discord connection with your bot token.

## Prerequisites

* A Discord application and bot from the [Discord Developer Portal](https://discord.com/developers/applications)
* The bot invited to the target server(s) with the permissions the agent needs
* **Server Members Intent** enabled if you need member listing
* An agent you can edit

## Setup

1. Create a Discord application → **Bot** → copy the bot token.
2. Invite the bot to your server with the required permissions (and enable privileged intents if needed).
3. Open the agent → **Toolkits** → add **Discord**.
4. Create a connection and paste the **bot token**.
5. Save the agent. `@`-mention Discord tools in the personality prompt for server tasks.

## Available tools

### Messaging

| Tool                       | Description                                                                     |
| -------------------------- | ------------------------------------------------------------------------------- |
| **Send Message (Webhook)** | Sends a message via webhook URL (does not require the bot token for this call). |
| **Send Channel Message**   | Sends a message to a channel as the bot.                                        |

### Guilds, channels & members

| Tool                    | Description                                     |
| ----------------------- | ----------------------------------------------- |
| **List Guilds**         | Lists guilds (servers) the bot is in.           |
| **List Guild Channels** | Lists channels in a guild.                      |
| **Find Channel**        | Finds a channel by name or criteria.            |
| **Create Channel**      | Creates a channel.                              |
| **Rename Channel**      | Renames a channel.                              |
| **Delete Channel**      | Deletes a channel.                              |
| **List Guild Members**  | Lists members (requires Server Members Intent). |
| **List Guild Roles**    | Lists roles in a guild.                         |

### Roles & moderation

| Tool                         | Description                   |
| ---------------------------- | ----------------------------- |
| **Create Guild Role**        | Creates a role.               |
| **Delete Guild Role**        | Deletes a role.               |
| **Add Role to Member**       | Assigns a role to a member.   |
| **Remove Role from Member**  | Removes a role from a member. |
| **Remove Member from Guild** | Kicks a member.               |
| **Ban Guild Member**         | Bans a member.                |
| **Remove Ban from User**     | Removes a ban.                |

## Use cases

* Post release or incident notices to a channel
* Create a temporary channel for a project and rename it later
* Assign or remove roles during onboarding
* Moderate spam with kick/ban tools when policy allows

## Tips

* Role tools need **Manage Roles** and the bot's role must sit **above** roles it manages.
* Prefer webhook send for simple announcements when you already have a webhook URL.
* Store the bot token in a saved connection — do not put it in the personality prompt.
* Access is limited to servers and channels the **bot** can see.

## Troubleshooting

| Symptom                      | What to check                                            |
| ---------------------------- | -------------------------------------------------------- |
| Unauthorized / invalid token | Regenerate the bot token and update the connection       |
| Empty member list            | Enable **Server Members Intent** and re-invite if needed |
| Cannot manage roles          | Bot role hierarchy and Manage Roles permission           |
| Cannot send to channel       | Bot can view/send in that channel; confirm channel ID    |

## Related

* [Slack](/agents/toolkits/slack)
* [Telegram](/agents/toolkits/telegram)
* [Toolkits overview](/agents/toolkits/overview)