Discord
Discord API integration for messaging, channels, and server management
The Discord integration lets your agents send messages, read channel history, and manage interactions across Discord servers.
Prerequisites
You need one of the following:
- Discord Bot Token — Create a bot at the Discord Developer Portal. Under your application, go to Bot, copy the token, and enable the required intents (Message Content, Server Members, etc.). Add the bot to your server using the OAuth2 URL generator.
- OAuth — For user-level access where each chat user authorizes with their own Discord account.
Setup
- Open your agent in Agent Studio
- In the Integrations panel, click Add Integration Config
- Select Discord from the integration list
- Give the config a display name (e.g., "Discord - Community Server")
- Choose your authentication method:
- Bot Token — Paste your Discord bot token
- OAuth — Click Connect to start the Discord OAuth flow
- Save the agent revision
Using in Your Agent
- In an Agent Step, attach Discord tools from the tools panel
- The agent uses your integration config for all Discord API calls
- Tools are referenced as
discord.send_message,discord.list_channels, etc.
Available Tools
| Tool | Description | Action Type |
|---|---|---|
send_message | Send a message to a Discord channel | Irreversible |
read_messages | Read messages from a Discord channel | ReadOnly |
list_guilds | List all Discord guilds (servers) the bot has access to | ReadOnly |
list_channels | List all channels in a Discord guild | ReadOnly |
react_to_message | Add a reaction emoji to a message | Reversible |
create_thread | Create a new thread in a Discord channel | Reversible |