List all Discord servers (guilds) the bot has access to.

Returns server names, IDs, member counts, and owner information.

Args:

• response_format ('markdown' | 'json'): Output format (default: 'json')

Returns: List of guilds with id, name, memberCount, icon, ownerId

Get detailed information about a specific Discord server.

Args:

• guild_id (string): Discord server/guild ID

• response_format ('markdown' | 'json'): Output format (default: 'json')

Returns: Server details including name, member count, owner, and icon

Leave a Discord server (guild). The bot will no longer have access to this server.

WARNING: This is a destructive action. The bot will need to be re-invited to rejoin.

Args:

• guild_id (string): Discord server/guild ID to leave

• confirm (boolean): Must be set to true to confirm leaving

Returns: Confirmation message with server details

Edit server settings like name, verification level, and system channel.

Args:

• guild_id (string): Discord server/guild ID

• name (string, optional): New server name

• verification_level (string, optional): 'none', 'low', 'medium', 'high', 'very_high'

• default_notifications (string, optional): 'all_messages' or 'only_mentions'

• afk_channel_id (string, optional): AFK voice channel ID

• afk_timeout (number, optional): AFK timeout in seconds

• system_channel_id (string, optional): System messages channel

• system_channel_flags (object, optional): System channel behavior

Returns: Updated server details

List channels in a Discord server.

Args:

• guild_id (string): Discord server/guild ID

• type ('text' | 'voice' | 'category' | 'all'): Filter by channel type (default: 'all')

• response_format ('markdown' | 'json'): Output format (default: 'json')

Returns: List of channels with id, name, type, topic, and category info

Get detailed information about a specific channel.

Args:

• channel_id (string): Discord channel ID

• response_format ('markdown' | 'json'): Output format (default: 'json')

Returns: Channel details including name, type, topic, and category

Create a new channel or category in a Discord server.

Args:

• guild_id (string): Discord server/guild ID

• name (string): Channel name

• type ('text' | 'voice' | 'category' | 'forum'): Channel type (default: 'text')

• topic (string, optional): Channel topic (text/forum channels only)

• parent_id (string, optional): Category ID to create channel under (not for categories)

• nsfw (boolean, optional): Whether the channel is NSFW (text/forum channels only)

• bitrate (number, optional): Bitrate for voice channels (8000-384000)

• user_limit (number, optional): User limit for voice channels (0 = unlimited)

• default_reaction_emoji (string, optional): Default emoji for forum posts (emoji char or custom ID)

• default_sort_order ('latest_activity' | 'creation_date', optional): Sort order for forum posts

• default_forum_layout ('not_set' | 'list_view' | 'gallery_view', optional): Forum layout

• available_tags (array, optional): Tags for forum posts (max 20)

  • name (string): Tag name (max 20 chars)

  • moderated (boolean, optional): Only mods can apply this tag

  • emoji_name (string, optional): Unicode emoji (e.g., '🎮')

  • emoji_id (string, optional): Custom emoji ID

Returns: The created channel's details

Delete a channel from a Discord server. This action is permanent!

Args:

• channel_id (string): Discord channel ID to delete

Returns: Confirmation of deletion

Edit a channel's properties including name, topic, category, position, and more.

Args:

• channel_id (string): Discord channel ID

• name (string, optional): New channel name

• topic (string, optional): New channel topic

• parent_id (string, optional): Move to a different category (or 'none' to remove from category)

• position (number, optional): New position of the channel

• nsfw (boolean, optional): Whether the channel is NSFW

• bitrate (number, optional): Bitrate for voice channels (8000-384000)

• user_limit (number, optional): User limit for voice channels

• default_reaction_emoji (string, optional): Default emoji for forum posts (emoji char or custom ID, 'none' to remove)

• default_sort_order ('latest_activity' | 'creation_date', optional): Sort order for forum posts

• default_forum_layout ('not_set' | 'list_view' | 'gallery_view', optional): Forum layout

• available_tags (array, optional): Tags for forum posts (max 20) WARNING: This REPLACES all existing tags! To keep existing tags, first use discord_get_channel to get current tags with their IDs, then include them in this array with their id field.

  • id (string): Tag ID - REQUIRED to preserve existing tags, omit only for new tags

  • name (string): Tag name (max 20 chars)

  • moderated (boolean, optional): Only mods can apply this tag

  • emoji_name (string, optional): Unicode emoji (e.g., '🎮')

  • emoji_id (string, optional): Custom emoji ID

Returns: Updated channel details

Set permission overrides for a role or member on a channel.

Common permission names:

• View: ViewChannel

• Messages: SendMessages, ReadMessageHistory, ManageMessages, EmbedLinks, AttachFiles, AddReactions

• Voice: Connect, Speak, Stream, MuteMembers, DeafenMembers, MoveMembers

• Threads: CreatePublicThreads, CreatePrivateThreads, SendMessagesInThreads

• Management: ManageChannels, ManageRoles, ManageWebhooks

Args:

• channel_id (string): Discord channel ID

• target_id (string): Role or User ID to set permissions for

• target_type ('role' | 'member'): Whether target is a role or member

• allow (string[], optional): Permissions to allow (e.g., ['ViewChannel', 'SendMessages'])

• deny (string[], optional): Permissions to deny (e.g., ['SendMessages'])

Returns: Confirmation of permission changes

Remove all permission overrides for a role or member on a channel.

Args:

• channel_id (string): Discord channel ID

• target_id (string): Role or User ID to remove permission overrides for

Returns: Confirmation of removal

Get all permission overrides for a channel.

Args:

• channel_id (string): Discord channel ID

• response_format ('markdown' | 'json'): Output format (default: 'json')

Returns: List of permission overrides with allow/deny for each role/member

Sync a channel's permissions with its parent category.

Args:

• channel_id (string): Discord channel ID

Returns: Confirmation of sync

Send a message to a Discord channel.

Args:

• channel_id (string): Discord channel ID

• content (string): Message content (max 2000 characters)

• reply_to (string, optional): Message ID to reply to

Returns: The sent message details including ID

Retrieve messages from a Discord channel.

Args:

• channel_id (string): Discord channel ID

• limit (number): Number of messages to retrieve (1-100, default: 20)

• before (string, optional): Get messages before this message ID

• after (string, optional): Get messages after this message ID

• response_format ('markdown' | 'json'): Output format (default: 'json')

Returns: List of messages with content, author, timestamp, attachments

Delete a message from a Discord channel.

Args:

• channel_id (string): Discord channel ID

• message_id (string): Message ID to delete

Returns: Confirmation of deletion

Edit a message sent by the bot.

Args:

• channel_id (string): Discord channel ID

• message_id (string): Message ID to edit

• content (string): New message content (max 2000 characters)

Returns: Confirmation of edit

Add an emoji reaction to a message.

Args:

• channel_id (string): Discord channel ID

• message_id (string): Message ID to react to

• emoji (string): Emoji to react with (e.g., '👍' or custom emoji format)

Returns: Confirmation of reaction added

Remove the bot's emoji reaction from a message.

Args:

• channel_id (string): Discord channel ID

• message_id (string): Message ID

• emoji (string): Emoji to remove

Returns: Confirmation of reaction removed

Pin a message in a channel.

Args:

• channel_id (string): Discord channel ID

• message_id (string): Message ID to pin

Returns: Confirmation of message pinned

Unpin a message in a channel.

Args:

• channel_id (string): Discord channel ID

• message_id (string): Message ID to unpin

Returns: Confirmation of message unpinned

Get all pinned messages in a channel.

Args:

• channel_id (string): Discord channel ID

• response_format ('markdown' | 'json'): Output format (default: 'json')

Returns: List of pinned messages

List members in a Discord server.

Args:

• guild_id (string): Discord server/guild ID

• limit (number): Maximum number of members (1-100, default: 20)

• after (string, optional): Get members after this user ID (for pagination)

• response_format ('markdown' | 'json'): Output format (default: 'json')

Returns: List of members with username, nickname, roles, join date

Get detailed information about a specific member.

Args:

• guild_id (string): Discord server/guild ID

• user_id (string): Discord user ID

• response_format ('markdown' | 'json'): Output format (default: 'json')

Returns: Member details including username, nickname, roles, join date

Move a member to a different voice channel or disconnect them from voice.

The member must currently be connected to a voice channel to be moved.

Args:

• guild_id (string): Discord server/guild ID

• user_id (string): Discord user ID to move

• channel_id (string | null): Target voice channel ID, or null to disconnect

Returns: Confirmation of move or disconnect

Set or clear a member's nickname.

Args:

• guild_id (string): Discord server/guild ID

• user_id (string): Discord user ID

• nickname (string, optional): New nickname (empty/null to reset)

Returns: Confirmation of nickname change

List all roles in a Discord server.

Args:

• guild_id (string): Discord server/guild ID

• response_format ('markdown' | 'json'): Output format (default: 'json')

Returns: List of roles with name, color, position, permissions

Add a role to a Discord member.

Args:

• guild_id (string): Discord server/guild ID

• user_id (string): Discord user ID

• role_id (string): Discord role ID to add

Returns: Confirmation of role added

Remove a role from a Discord member.

Args:

• guild_id (string): Discord server/guild ID

• user_id (string): Discord user ID

• role_id (string): Discord role ID to remove

Returns: Confirmation of role removed

Create a new role in a Discord server.

Args:

• guild_id (string): Discord server/guild ID

• name (string): Role name

• color (number, optional): Role color as decimal integer (e.g., 16711680 for red)

• mentionable (boolean): Whether the role can be mentioned (default: false)

• hoist (boolean): Whether to display role members separately (default: false)

Returns: The created role's details

Delete a role from a Discord server. This action is permanent!

Args:

• guild_id (string): Discord server/guild ID

• role_id (string): Discord role ID to delete

Returns: Confirmation of deletion

Edit a role's properties including name, color, and permissions.

Common permission names:

• Admin: Administrator (grants all permissions)

• General: ManageGuild, ManageRoles, ManageChannels, KickMembers, BanMembers, ModerateMembers

• Messages: SendMessages, ManageMessages, EmbedLinks, AttachFiles, ReadMessageHistory, MentionEveryone

• Voice: Connect, Speak, MuteMembers, DeafenMembers, MoveMembers, Stream

• Other: ManageEmojisAndStickers, ManageWebhooks, ManageEvents, ViewAuditLog

Args:

• guild_id (string): Discord server/guild ID

• role_id (string): Discord role ID to edit

• name (string, optional): New role name

• color (number, optional): Role color as decimal integer (e.g., 16711680 for red)

• mentionable (boolean, optional): Whether the role can be mentioned

• hoist (boolean, optional): Whether to display role members separately

• permissions (string[], optional): Permissions to grant (replaces existing). Examples: ['SendMessages', 'ViewChannel']

Returns: Updated role details

Reorder role hierarchy by setting role positions.

Higher position = more authority in the hierarchy. The @everyone role is always at position 0. Roles can only manage other roles below them in the hierarchy.

IMPORTANT: The bot can only move roles that are below its own highest role in the hierarchy.

Args:

• guild_id (string): Discord server/guild ID

• positions (array): Array of objects with:

  • role_id (string): Discord role ID

  • position (number): New position for the role (higher = more authority)

Returns: Confirmation of position changes

Kick a member from a Discord server.

Args:

• guild_id (string): Discord server/guild ID

• user_id (string): Discord user ID to kick

• reason (string, optional): Reason for kick (visible in audit log)

Returns: Confirmation of kick

Ban a member from a Discord server.

Args:

• guild_id (string): Discord server/guild ID

• user_id (string): Discord user ID to ban

• reason (string, optional): Reason for ban (visible in audit log)

• delete_message_days (number): Days of messages to delete (0-7, default: 0)

Returns: Confirmation of ban

Remove a ban from a user.

Args:

• guild_id (string): Discord server/guild ID

• user_id (string): Discord user ID to unban

Returns: Confirmation of unban

Timeout (mute) a member for a specified duration. They cannot send messages, react, or join voice.

Args:

• guild_id (string): Discord server/guild ID

• user_id (string): Discord user ID to timeout

• duration_minutes (number): Timeout duration in minutes (0 to remove, max 40320 = 28 days)

• reason (string, optional): Reason for timeout (visible in audit log)

Returns: Confirmation of timeout

List all banned users in a server.

Args:

• guild_id (string): Discord server/guild ID

• limit (number): Number of bans to return (1-1000, default 100)

• response_format ('json' | 'markdown'): Output format

Returns: List of banned users with reasons

Remove inactive members from the server.

Args:

• guild_id (string): Discord server/guild ID

• days (number): Days of inactivity required (1-30)

• include_roles (string[], optional): Role IDs to include in prune (by default only members without roles)

• dry_run (boolean): If true, returns count without actually pruning (default true)

Returns: Number of members pruned (or would be pruned if dry_run)

Get the audit log for a server. Shows who did what actions.

Common action types: 1=GuildUpdate, 10=ChannelCreate, 11=ChannelUpdate, 12=ChannelDelete, 20=MemberKick, 22=MemberBanAdd, 23=MemberBanRemove, 24=MemberUpdate, 25=MemberRoleUpdate, 30=RoleCreate, 31=RoleUpdate, 32=RoleDelete, 72=MessageDelete, 73=MessageBulkDelete

Args:

• guild_id (string): Discord server/guild ID

• user_id (string, optional): Filter by user who performed action

• action_type (number, optional): Filter by action type

• limit (number): Number of entries (1-100, default 20)

• response_format ('json' | 'markdown'): Output format

Returns: Audit log entries with action, user, target, and changes

List all auto moderation rules for a server.

Args:

• guild_id (string): Discord server/guild ID

• response_format ('markdown' | 'json'): Output format (default: 'json')

Returns: List of auto moderation rules

Get details of a specific auto moderation rule.

Args:

• guild_id (string): Discord server/guild ID

• rule_id (string): Auto moderation rule ID

• response_format ('markdown' | 'json'): Output format (default: 'json')

Returns: Auto moderation rule details

Create a new auto moderation rule for a server.

Args:

• guild_id (string): Discord server/guild ID

• name (string): Rule name

• event_type ('message_send'): Event that triggers the rule

• trigger_type ('keyword' | 'spam' | 'keyword_preset' | 'mention_spam'): Trigger type

• trigger_metadata (object, optional): Trigger configuration (keyword_filter, presets, etc.)

• actions (array): Actions to take (block_message, send_alert_message, timeout)

• enabled (boolean): Whether rule is enabled (default: true)

• exempt_roles (array, optional): Role IDs exempt from this rule

• exempt_channels (array, optional): Channel IDs exempt from this rule

Returns: Created rule details

Edit an existing auto moderation rule.

Args:

• guild_id (string): Discord server/guild ID

• rule_id (string): Auto moderation rule ID

• name (string, optional): New rule name

• trigger_metadata (object, optional): New trigger configuration

• actions (array, optional): New actions

• enabled (boolean, optional): Enable/disable rule

• exempt_roles (array, optional): New exempt roles

• exempt_channels (array, optional): New exempt channels

Returns: Updated rule details

Delete an auto moderation rule from a server.

Args:

• guild_id (string): Discord server/guild ID

• rule_id (string): Auto moderation rule ID to delete

Returns: Confirmation of deletion

List all custom emojis in a server.

Args:

• guild_id (string): Discord server/guild ID

• response_format ('json' | 'markdown'): Output format

Returns: List of emojis with name, ID, and whether animated

Create a custom emoji in a server.

Args:

• guild_id (string): Discord server/guild ID

• name (string): Emoji name (2-32 chars, alphanumeric and underscores)

• image_url (string): URL of image (PNG, JPG, GIF under 256KB)

• roles (string[], optional): Role IDs that can use this emoji

Returns: Created emoji details

Delete a custom emoji from a server.

Args:

• guild_id (string): Discord server/guild ID

• emoji_id (string): Discord emoji ID

Returns: Confirmation of deletion

List all custom stickers in a server.

Args:

• guild_id (string): Discord server/guild ID

• response_format ('json' | 'markdown'): Output format

Returns: List of stickers with name, description, and format

Delete a custom sticker from a server.

Args:

• guild_id (string): Discord server/guild ID

• sticker_id (string): Discord sticker ID

Returns: Confirmation of deletion

List webhooks in a guild or channel.

Args:

• guild_id (string, optional): List all webhooks in the server

• channel_id (string, optional): List webhooks for a specific channel

• response_format ('json' | 'markdown'): Output format

Returns: List of webhooks with name, channel, and URL

Create a webhook in a channel.

Args:

• channel_id (string): Discord channel ID

• name (string): Webhook name

• avatar_url (string, optional): Avatar image URL

Returns: Created webhook details including URL

Edit an existing webhook.

Args:

• webhook_id (string): Discord webhook ID

• name (string, optional): New webhook name

• channel_id (string, optional): Move webhook to different channel

Returns: Updated webhook details

Delete a webhook.

Args:

• webhook_id (string): Discord webhook ID

Returns: Confirmation of deletion

List all active invites in a server.

Args:

• guild_id (string): Discord server/guild ID

• response_format ('json' | 'markdown'): Output format

Returns: List of invites with code, uses, max uses, expiration

Create an invite link for a channel.

Args:

• channel_id (string): Discord channel ID

• max_age (number): Duration in seconds (0 = never expires, max 604800 = 7 days)

• max_uses (number): Max uses (0 = unlimited)

• temporary (boolean): Kick members when they disconnect if not assigned a role

• unique (boolean): Create new unique invite vs reuse existing

Returns: Created invite URL

Delete an invite by its code.

Args:

• invite_code (string): The invite code to delete

Returns: Confirmation of deletion

List all scheduled events in a server.

Args:

• guild_id (string): Discord server/guild ID

• response_format ('json' | 'markdown'): Output format

Returns: List of events with name, time, location, and status

Create a scheduled event in a server.

Args:

• guild_id (string): Discord server/guild ID

• name (string): Event name

• description (string, optional): Event description

• scheduled_start_time (string): ISO8601 timestamp for start

• scheduled_end_time (string, optional): ISO8601 timestamp for end

• entity_type ('stage' | 'voice' | 'external'): Type of event

• channel_id (string, optional): Channel ID for stage/voice events

• location (string, optional): Location for external events

Returns: Created event details

Delete a scheduled event from a server.

Args:

• guild_id (string): Discord server/guild ID

• event_id (string): Discord scheduled event ID

Returns: Confirmation of deletion

Get the welcome screen configuration for a server.

Requires the server to have Community features enabled.

Args:

• guild_id (string): Discord server/guild ID

• response_format ('markdown' | 'json'): Output format (default: 'json')

Returns: Welcome screen settings including description and channels

Edit the welcome screen configuration for a server.

Requires the server to have Community features enabled and bot must have MANAGE_GUILD permission.

Args:

• guild_id (string): Discord server/guild ID

• enabled (boolean, optional): Enable/disable the welcome screen

• description (string, optional): Server description (max 140 chars)

• welcome_channels (array, optional): Up to 5 channels to show (channel_id, description, emoji)

Returns: Updated welcome screen settings

Get the onboarding configuration for a server.

Onboarding guides new members through a questionnaire to customize their experience.

Args:

• guild_id (string): Discord server/guild ID

• response_format ('markdown' | 'json'): Output format (default: 'json')

Returns: Onboarding settings including prompts, options, and default channels

Edit the onboarding configuration for a server.

Configure prompts/questions that new members answer to customize their server experience. Each prompt can assign roles or show channels based on member selections.

Args:

• guild_id (string): Discord server/guild ID

• prompts (array, optional): Onboarding prompts with options

• default_channel_ids (array, optional): Channels shown to all new members

• enabled (boolean, optional): Enable/disable onboarding

• mode ('onboarding_default' | 'onboarding_advanced', optional): Onboarding mode

Returns: Updated onboarding configuration

Setup and enable onboarding for a server from scratch.

This tool configures the complete onboarding experience for new members. The server must have Community features enabled.

Requirements:

• Server must have Community features enabled (done in Discord Server Settings)

• At least one default channel must be specified

• At least one prompt with options must be provided

• Each option must have at least one role_ids OR channel_ids

Args:

• guild_id (string): Discord server/guild ID

• default_channel_ids (string[]): Channels shown to all new members (required, at least one)

• prompts (array): Onboarding questions (required, at least one)

  • type ('multiple_choice' | 'dropdown'): Prompt type

  • title (string): Question title

  • single_select (boolean): Allow only one selection (default: true)

  • required (boolean): Must answer to continue (default: false)

  • in_onboarding (boolean): Show during onboarding (default: true)

  • options (array): Available choices (at least one)

    • title (string): Option title

    • description (string, optional): Option description

    • emoji_name (string, optional): Unicode emoji (e.g., '🎮')

    • role_ids (string[], optional): Roles to assign when selected

    • channel_ids (string[], optional): Channels to show when selected

• mode ('onboarding_default' | 'onboarding_advanced', optional): Mode (default: 'onboarding_default')

• enabled (boolean, optional): Enable after setup (default: true)

Returns: Confirmation with onboarding status

Get the community settings for a server.

Shows rules channel, updates channel, and other community-related settings.

Args:

• guild_id (string): Discord server/guild ID

• response_format ('markdown' | 'json'): Output format (default: 'json')

Returns: Community settings including channels and features

Configure the required channels for a Community server.

Sets the rules channel and public updates channel which are required for Community features. The server must already have Community enabled in Discord Server Settings.

Args:

• guild_id (string): Discord server/guild ID

• rules_channel_id (string): Channel for server rules (required)

• public_updates_channel_id (string): Channel for Discord updates (required)

• description (string, optional): Server description (max 120 chars)

• preferred_locale (string, optional): Preferred language (e.g., 'en-US', 'de')

• safety_alerts_channel_id (string, optional): Channel for safety alerts

Returns: Updated community settings