The catalogue/Discord

Discord

app.discord

Manage guilds, channels, messages, roles, and moderation in Discord

OAuth 2communicationRead the source
Version2.0.0
Categorycommunication
AuthOAuth 2
Tools22
Transportstdio
LicenceMIT
01

What it does

The app, in its own words.

Full Discord integration: guilds, channels, messages, members, roles, webhooks, reactions, and moderation. Uses Discord REST API v10 with OAuth 2.0 / Bot Token.

discordmessagingchatguildservercommunityvoicemoderation
02

Tools

22 tools the agent can call.

Every one is declared with typed parameters and returns structured results, so the host can render them instead of narrating them.

  • add-reactionAdd a reaction (emoji) to a message. Use Unicode emoji or custom emoji format name:id.
  • assign-roleAdd a role to a guild member. Requires Manage Roles permission with the bot's role above the target role.
  • ban-memberBan a member from a guild. Optionally delete their message history. Requires Ban Members permission.
  • create-channelCreate a new channel in a guild. Supports text, voice, category, announcement, and forum channels.
  • create-roleCreate a new role in a guild. Requires Manage Roles permission.
  • create-webhookCreate a new webhook in a channel. Requires Manage Webhooks permission. Returns the webhook token for sending messages.
  • delete-channelDelete a channel or close a DM. Requires Manage Channels permission for guild channels.
  • delete-messageDelete a message from a channel. Requires Manage Messages permission if not the message author.
  • get-channelGet detailed information about a specific channel by ID.
  • get-guildGet detailed information about a specific guild (server) by ID.
  • get-memberGet a specific guild member by user ID.
  • kick-memberKick a member from a guild. Requires Kick Members permission.
  • list-channelsList channels in a guild. Returns text, voice, category, and other channel types.
  • list-guildsList guilds (servers) the bot/user is a member of. Supports pagination.
  • list-membersList members of a guild. Supports pagination via limit and after user ID.
  • list-messagesList messages in a channel. Supports pagination via before/after/around message IDs.
  • list-rolesList all roles in a guild, ordered by position (highest first).
  • list-webhooksList webhooks in a guild or channel. Requires Manage Webhooks permission.
  • remove-roleRemove a role from a guild member. Requires Manage Roles permission.
  • send-messageSend a message to a Discord channel. Supports text, embeds, mentions, and replies.
  • send-webhook-messageSend a message via a webhook using the webhook URL. Supports text, embeds, and usernames.
  • timeout-memberTimeout (mute) a guild member for a specified duration. Requires Moderate Members permission.
03

Auth and permissions

What it asks for.

Declared in the manifest, in advance. The app cannot reach anything it did not ask for here.

Scopes

identifyguildsguilds.members.readbotmessages.readapplications.commands

System secrets

CLIENT_IDCLIENT_SECRET

User secrets

ACCESS_TOKENREFRESH_TOKEN

Reading further

The manifest and the source for Discord live in the monorepo, alongside the other apps.

Read the sourceBack to the catalogue

Discord · Agent Apps