DocsIntegrations

Discord

Discord connects bot-token messaging, guild, channel, thread, and reaction actions to Mobius assistants.

A Discord integration connects a Discord bot token to Mobius so assistants can inspect guilds and channels, send messages, update threads, and manage reactions.

Use Discord when an assistant's output belongs in a Discord community or when it needs to read recent channel context before replying. A deployment using the Mobius Discord app can also turn new guild messages into source events through its Discord Gateway listener.

Capability map

CapabilityValue
Provider IDdiscord
Auth kindOAuth when the Mobius Discord app is configured; otherwise api_key
Connect flowAdd to Discord or an inline bot token
ActionsYes
EventsYes, when the Discord Gateway listener is enabled
Webhook deliveryNo; inbound messages arrive over the Discord Gateway
Event samplesNo
Live statusYes

Connect Discord

SurfaceSupport
AppOpen Build > Integrations, choose Discord, then select Add to Discord. A deployment without the Mobius Discord app shows the legacy bot-token form instead.
CLIThe mobius CLI does not connect Discord integrations yet. Use the app or API.
APICall POST /v1/integrations/providers/discord/connect with the Discord credential body from the API reference.

After connecting, run the live-status check from the app or API if actions report missing guilds or channels. The bot must be invited to the server and granted the permissions each action needs.

Discord server connections are team-managed, so an organization administrator connects them. Grant the exact bot connection under Assistant access, then add only the Discord actions that assistant should use.

Actions

discord.channel.get
discord.channel.list
discord.guild.get
discord.guild.list
discord.message.delete
discord.message.get
discord.message.history
discord.message.send
discord.message.update
discord.reaction.add
discord.reaction.remove
discord.thread.create

Use read actions to resolve guild and channel IDs before sending messages. Sending, updating, deleting, reacting, or creating a thread runs without an automatic Mobius confirmation after the selected server connection and grant are rechecked. The grant's result audience does not validate the destination channel.

Events

discord.message.received

This event records a message posted in a guild channel the Mobius Discord bot can see. Direct messages have no guild ID and are not emitted. Messages from bots are ignored to prevent reply loops. The deployment must enable its single Discord Gateway listener and the Message Content intent for event text to arrive.

Use the event as a routine source when a selected guild channel should start work. It is separate from an explicit discord.message.send action.

Next