Skip to main content
Glama
Discord MCP Server

Discord MCP Server

by Oratorian

Build License TAG

Discord MCP Server

An MCP (Model Context Protocol) server that enables LLMs to control Discord servers via a bot token. This server provides comprehensive Discord management tools including sending messages, managing members, roles, channels, permissions, and more.

Features

Guild/Server Management

  • discord_list_guilds - List all servers the bot has access to

  • discord_get_guild - Get detailed info about a specific server

  • discord_edit_guild - Edit server settings (name, verification level, system channels, etc.)

  • discord_leave_guild - Leave a server

Channel Management

  • discord_list_channels - List channels in a server (filter by type)

  • discord_get_channel - Get channel details (includes forum tags for forum channels)

  • discord_create_channel - Create text/voice/forum channels and categories

  • discord_edit_channel - Edit channel name, topic, position, category, forum tags, and more

  • discord_delete_channel - Delete a channel or category

Forum Channel Features

  • Create forum channels with type: "forum"

  • Set default reaction emoji, sort order, and layout

  • Manage forum tags (create, edit, delete)

  • Tags support custom emojis and moderation settings

Permission Management

  • discord_set_channel_permissions - Set permission overrides for roles/members on channels

  • discord_remove_channel_permissions - Remove permission overrides

  • discord_get_channel_permissions - View all permission overrides on a channel

  • discord_sync_channel_permissions - Sync channel permissions with parent category

Message Operations

  • discord_send_message - Send messages (with optional reply)

  • discord_get_messages - Retrieve channel messages (with pagination)

  • discord_edit_message - Edit bot's messages

  • discord_delete_message - Delete messages

  • discord_add_reaction - Add emoji reactions

  • discord_remove_reaction - Remove bot's reactions

  • discord_pin_message - Pin a message

  • discord_unpin_message - Unpin a message

  • discord_get_pinned_messages - Get all pinned messages

Member Management

  • discord_list_members - List server members (with pagination)

  • discord_get_member - Get member details

  • discord_kick_member - Kick a member

  • discord_ban_member - Ban a member (with message deletion option)

  • discord_unban_member - Unban a user

  • discord_set_nickname - Set/clear member nickname

  • discord_move_member - Move member to a different voice channel

  • discord_timeout_member - Timeout/mute a member (up to 28 days)

Role Management

  • discord_list_roles - List all server roles

  • discord_create_role - Create a new role

  • discord_edit_role - Edit role name, color, permissions, and settings

  • discord_delete_role - Delete a role

  • discord_add_role - Assign role to member

  • discord_remove_role - Remove role from member

  • discord_set_role_positions - Reorder role hierarchy

Server Administration

  • discord_list_bans - List all banned users

  • discord_prune_members - Remove inactive members (with dry-run option)

  • discord_get_audit_log - View audit log entries

Community Features

  • discord_get_community_settings - View community settings (rules channel, features, etc.)

  • discord_setup_community - Configure community channels (rules, updates, safety alerts)

Welcome Screen

  • discord_get_welcome_screen - Get welcome screen configuration

  • discord_edit_welcome_screen - Edit welcome screen (description, channels, emojis)

Onboarding

  • discord_get_onboarding - Get onboarding configuration

  • discord_edit_onboarding - Edit existing onboarding settings

  • discord_setup_onboarding - Setup onboarding from scratch (prompts, default channels, roles)

Auto Moderation

  • discord_list_automod_rules - List auto moderation rules

  • discord_get_automod_rule - Get details of an auto mod rule

  • discord_create_automod_rule - Create auto moderation rule

  • discord_edit_automod_rule - Edit auto moderation rule

  • discord_delete_automod_rule - Delete auto moderation rule

Emoji Management

  • discord_list_emojis - List custom emojis

  • discord_create_emoji - Create emoji from image URL

  • discord_delete_emoji - Delete a custom emoji

Sticker Management

  • discord_list_stickers - List custom stickers

  • discord_delete_sticker - Delete a custom sticker

Invite Management

  • discord_list_invites - List active invites

  • discord_create_invite - Create channel invite

  • discord_delete_invite - Delete an invite

Webhook Management

  • discord_list_webhooks - List webhooks (guild or channel)

  • discord_create_webhook - Create a webhook

  • discord_edit_webhook - Edit webhook name or channel

  • discord_delete_webhook - Delete a webhook

Scheduled Events

  • discord_list_events - List scheduled events

  • discord_create_event - Create a scheduled event (stage, voice, or external)

  • discord_delete_event - Delete a scheduled event

Related MCP server: Discord MCP

Setup

1. Create a Discord Bot

  1. Go to the Discord Developer Portal

  2. Click "New Application" and give it a name

  3. Go to the "Bot" section and click "Add Bot"

  4. Copy the bot token (keep this secret!)

  5. Enable these Privileged Gateway Intents:

    • Server Members Intent

    • Message Content Intent

2. Invite the Bot to Your Server

  1. Go to OAuth2 -> URL Generator

  2. Select scopes: bot, applications.commands

  3. Select bot permissions (choose based on features you need):

    Core Permissions:

    • Manage Channels

    • Manage Roles

    • Manage Messages

    • Read Message History

    • Send Messages

    • Add Reactions

    Member Management:

    • Kick Members

    • Ban Members

    • Manage Nicknames

    • Moderate Members (for timeouts)

    Server Administration:

    • Manage Guild (for server settings)

    • View Audit Log

    • Manage Emojis and Stickers

    • Manage Webhooks

    • Manage Events

    • Create Instant Invite

  4. Copy the generated URL and open it to invite the bot

3. Install the MCP Server

Option A: Install globally from npm

npm install -g @mahesvara/discord-mcpserver

Option B: Run directly with npx (no install required)

npx @mahesvara/discord-mcpserver

Usage

MCP Client Configuration

Add to your MCP client configuration (e.g., Claude Desktop or Claude Code):

Using globally installed package:

{
  "mcpServers": {
    "discord": {
      "command": "discord-mcpserver",
      "env": {
        "DISCORD_BOT_TOKEN": "your_bot_token_here"
      }
    }
  }
}

Using npx (no install required):

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@mahesvara/discord-mcpserver"],
      "env": {
        "DISCORD_BOT_TOKEN": "your_bot_token_here"
      }
    }
  }
}

Environment Variables

The server supports loading environment variables from a .env file in the current directory:

DISCORD_BOT_TOKEN=your_bot_token_here
TRANSPORT=http
PORT=3000
HOST=localhost

Variable

Description

Default

DISCORD_BOT_TOKEN

Your Discord bot token (required)

-

TRANSPORT

Transport mode: stdio or http

stdio

PORT

HTTP server port (when using http transport)

3000

HOST

HTTP server host (use 0.0.0.0 for remote access)

localhost

HTTP Transport

For remote access, run the server with HTTP transport enabled:

Linux/macOS:

DISCORD_BOT_TOKEN=your_token TRANSPORT=http PORT=3000 HOST=0.0.0.0 discord-mcpserver

Windows (Command Prompt):

set DISCORD_BOT_TOKEN=your_token && set TRANSPORT=http && set PORT=3000 && set HOST=0.0.0.0 && discord-mcpserver

Windows (PowerShell):

$env:DISCORD_BOT_TOKEN="your_token"; $env:TRANSPORT="http"; $env:PORT="3000"; $env:HOST="0.0.0.0"; discord-mcpserver

Or use a .env file (works on all platforms):

discord-mcpserver

Then configure your MCP client to connect via HTTP:

{
  "mcpServers": {
    "discord": {
      "type": "http",
      "url": "http://your-server-ip:3000/mcp"
    }
  }
}

Tool Examples

Create a Forum Channel with Tags

{
  "tool": "discord_create_channel",
  "params": {
    "guild_id": "1234567890123456789",
    "name": "help-forum",
    "type": "forum",
    "topic": "Ask questions and get help",
    "default_reaction_emoji": "✅",
    "default_sort_order": "latest_activity",
    "default_forum_layout": "list_view",
    "available_tags": [
      { "name": "Solved", "emoji_name": "✅", "moderated": false },
      { "name": "Bug", "emoji_name": "🐛", "moderated": false },
      { "name": "Question", "emoji_name": "❓", "moderated": false },
      { "name": "Announcement", "emoji_name": "📢", "moderated": true }
    ]
  }
}

Setup Server Onboarding

{
  "tool": "discord_setup_onboarding",
  "params": {
    "guild_id": "1234567890123456789",
    "default_channel_ids": ["1111111111111111111"],
    "prompts": [
      {
        "type": "multiple_choice",
        "title": "What are you interested in?",
        "single_select": false,
        "required": true,
        "options": [
          { "title": "Gaming", "emoji_name": "🎮", "role_ids": ["2222222222222222222"] },
          { "title": "Tech", "emoji_name": "💻", "role_ids": ["3333333333333333333"] }
        ]
      }
    ]
  }
}

Configure Community Settings

{
  "tool": "discord_setup_community",
  "params": {
    "guild_id": "1234567890123456789",
    "rules_channel_id": "1111111111111111111",
    "public_updates_channel_id": "2222222222222222222",
    "description": "A friendly gaming community",
    "preferred_locale": "en-US"
  }
}

Edit Welcome Screen

{
  "tool": "discord_edit_welcome_screen",
  "params": {
    "guild_id": "1234567890123456789",
    "enabled": true,
    "description": "Welcome to our server!",
    "welcome_channels": [
      { "channel_id": "1111111111111111111", "description": "Read the rules", "emoji_name": "📜" },
      { "channel_id": "2222222222222222222", "description": "Introduce yourself", "emoji_name": "👋" }
    ]
  }
}

Create a Category

{
  "tool": "discord_create_channel",
  "params": {
    "guild_id": "1234567890123456789",
    "name": "Bot Testing",
    "type": "category"
  }
}

Create a Channel in a Category

{
  "tool": "discord_create_channel",
  "params": {
    "guild_id": "1234567890123456789",
    "name": "bot-commands",
    "type": "text",
    "topic": "Channel for bot interactions",
    "parent_id": "CATEGORY_ID_HERE"
  }
}

Set Channel Permissions

{
  "tool": "discord_set_channel_permissions",
  "params": {
    "channel_id": "1234567890123456789",
    "target_id": "ROLE_ID_HERE",
    "target_type": "role",
    "allow": ["ViewChannel", "SendMessages", "ReadMessageHistory"],
    "deny": ["CreatePublicThreads"]
  }
}

Common Permission Names

View & Access:

  • ViewChannel - See the channel

Messages:

  • SendMessages, ReadMessageHistory, ManageMessages

  • EmbedLinks, AttachFiles, AddReactions

  • UseExternalEmojis, UseExternalStickers

  • MentionEveryone

Threads:

  • CreatePublicThreads, CreatePrivateThreads

  • SendMessagesInThreads, ManageThreads

Voice:

  • Connect, Speak, Stream

  • MuteMembers, DeafenMembers, MoveMembers

  • UseVAD, PrioritySpeaker

Management:

  • ManageChannels, ManageRoles, ManageWebhooks

Send a Message

{
  "tool": "discord_send_message",
  "params": {
    "channel_id": "1234567890123456789",
    "content": "Hello from the MCP server!"
  }
}

Assign a Role

{
  "tool": "discord_add_role",
  "params": {
    "guild_id": "1234567890123456789",
    "user_id": "9876543210987654321",
    "role_id": "1111111111111111111"
  }
}

Response Formats

Most read operations support two response formats:

  • json (default): Structured data for programmatic processing

  • markdown: Human-readable formatted output

Error Handling

All tools return clear error messages with suggestions when operations fail:

  • Missing permissions

  • Invalid IDs (guild, channel, user, role, message)

  • Rate limiting

  • Network issues

Security Notes

  • Never commit your bot token - use environment variables

  • The bot can only operate in servers it's been invited to

  • Destructive operations (delete, kick, ban) are marked with destructiveHint: true

  • All inputs are validated with Zod schemas

Required Bot Permissions

Depending on which tools you use, your bot needs these permissions:

Tool Category

Required Permissions

Messages

Send Messages, Read Message History, Manage Messages

Channels

Manage Channels

Permissions

Manage Roles (for channel permission overrides)

Members

Kick Members, Ban Members, Manage Nicknames, Moderate Members

Roles

Manage Roles

Reactions

Add Reactions

Server Settings

Manage Guild

Emojis/Stickers

Manage Emojis and Stickers

Invites

Create Instant Invite, Manage Guild

Webhooks

Manage Webhooks

Events

Manage Events

Audit Log

View Audit Log

Community/Onboarding

Manage Guild

Tool Examples

Edit Role Permissions

{
  "tool": "discord_edit_role",
  "params": {
    "guild_id": "1234567890123456789",
    "role_id": "1111111111111111111",
    "name": "Moderators",
    "color": 3447003,
    "permissions": ["KickMembers", "BanMembers", "ManageMessages", "ModerateMembers"]
  }
}

Reorder Role Hierarchy

{
  "tool": "discord_set_role_positions",
  "params": {
    "guild_id": "1234567890123456789",
    "positions": [
      { "role_id": "1111111111111111111", "position": 5 },
      { "role_id": "2222222222222222222", "position": 4 }
    ]
  }
}

Timeout a Member

{
  "tool": "discord_timeout_member",
  "params": {
    "guild_id": "1234567890123456789",
    "user_id": "9876543210987654321",
    "duration_minutes": 60,
    "reason": "Spamming in chat"
  }
}

Create an Invite

{
  "tool": "discord_create_invite",
  "params": {
    "channel_id": "1234567890123456789",
    "max_age": 86400,
    "max_uses": 10,
    "temporary": false
  }
}

Create a Scheduled Event

{
  "tool": "discord_create_event",
  "params": {
    "guild_id": "1234567890123456789",
    "name": "Community Game Night",
    "description": "Join us for games!",
    "scheduled_start_time": "2024-12-01T20:00:00Z",
    "entity_type": "voice",
    "channel_id": "1111111111111111111"
  }
}

Role Permission Names

When editing roles, use these permission names:

General:

  • Administrator - Full access (use with caution)

  • ManageGuild, ManageRoles, ManageChannels

  • KickMembers, BanMembers, ModerateMembers

  • ViewAuditLog, ViewGuildInsights

Messages:

  • SendMessages, ManageMessages, ReadMessageHistory

  • EmbedLinks, AttachFiles, AddReactions

  • MentionEveryone, UseExternalEmojis

Voice:

  • Connect, Speak, Stream

  • MuteMembers, DeafenMembers, MoveMembers

Other:

  • ManageWebhooks, ManageEmojisAndStickers

  • ManageEvents, CreateEvents

License

MIT

Available Tools

67 tools
discord_add_reactionAdd Reaction to MessageA
Idempotent

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

Inputs: emoji (required), channel_id (required), message_id (required).

discord_add_roleAdd Role to MemberA
Idempotent

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

Inputs: role_id (required), user_id (required), guild_id (required).

discord_ban_memberBan Discord MemberB
Destructive

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

Inputs: user_id (required), guild_id (required), reason, delete_message_days.

discord_create_automod_ruleCreate Auto Moderation RuleA

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

Inputs: name (required), actions (required), guild_id (required), event_type (required), +5 more.

discord_create_channelCreate Discord ChannelA

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

Inputs: name (required), guild_id (required), nsfw, type, +8 more.

discord_create_emojiCreate EmojiA

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

Inputs: name (required), guild_id (required), image_url (required).

discord_create_eventCreate Scheduled EventB

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

Inputs: name (required), guild_id (required), entity_type (required), scheduled_start_time (required), +4 more.

discord_create_inviteCreate InviteA

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

Inputs: channel_id (required), unique, max_age, max_uses, +1 more.

discord_create_roleCreate Discord RoleA

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

Inputs: name (required), guild_id (required), color, hoist, +2 more.

discord_create_webhookCreate WebhookB

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

Inputs: name (required), channel_id (required), avatar_url.

discord_delete_automod_ruleDelete Auto Moderation RuleA
Destructive

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

Inputs: rule_id (required), guild_id (required).

discord_delete_channelDelete Discord ChannelA
Destructive

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

Args:

  • channel_id (string): Discord channel ID to delete

Returns: Confirmation of deletion

Inputs: channel_id (required).

discord_delete_emojiDelete EmojiA
DestructiveIdempotent

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

Inputs: emoji_id (required), guild_id (required).

discord_delete_eventDelete Scheduled EventA
DestructiveIdempotent

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

Inputs: event_id (required), guild_id (required).

discord_delete_inviteDelete InviteA
DestructiveIdempotent

Delete an invite by its code.

Args:

  • invite_code (string): The invite code to delete

Returns: Confirmation of deletion

Inputs: invite_code (required).

discord_delete_messageDelete Discord MessageA
Destructive

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

Inputs: channel_id (required), message_id (required).

discord_delete_roleDelete Discord RoleA
Destructive

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

Inputs: role_id (required), guild_id (required).

discord_delete_stickerDelete StickerA
DestructiveIdempotent

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

Inputs: guild_id (required), sticker_id (required).

discord_delete_webhookDelete WebhookA
DestructiveIdempotent

Delete a webhook.

Args:

  • webhook_id (string): Discord webhook ID

Returns: Confirmation of deletion

Inputs: webhook_id (required).

discord_edit_automod_ruleEdit Auto Moderation RuleB
Idempotent

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

Inputs: rule_id (required), guild_id (required), name, actions, +5 more.

discord_edit_channelEdit Discord ChannelA
Idempotent

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

Inputs: channel_id (required), name, nsfw, topic, +8 more.

discord_edit_guildEdit Discord ServerA
Idempotent

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

Inputs: guild_id (required), name, afk_timeout, afk_channel_id, +4 more.

discord_edit_messageEdit Discord MessageA
Idempotent

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

Inputs: content (required), channel_id (required), message_id (required).

discord_edit_onboardingEdit Server OnboardingA
Idempotent

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

Inputs: guild_id (required), mode, enabled, prompts, +1 more.

discord_edit_roleEdit Discord RoleA
Idempotent

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

Inputs: role_id (required), guild_id (required), name, color, +3 more.

discord_edit_webhookEdit WebhookA
Idempotent

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

Inputs: webhook_id (required), name, channel_id.

discord_edit_welcome_screenEdit Welcome ScreenA
Idempotent

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

Inputs: guild_id (required), enabled, description, welcome_channels.

discord_get_audit_logGet Audit LogA
Read-onlyIdempotent

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

Inputs: guild_id (required), limit, user_id, action_type, +1 more.

discord_get_automod_ruleGet Auto Moderation RuleA
Read-onlyIdempotent

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

Inputs: rule_id (required), guild_id (required), response_format.

discord_get_channelGet Discord Channel InfoA
Read-onlyIdempotent

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

Inputs: channel_id (required), response_format.

discord_get_channel_permissionsGet Channel PermissionsA
Read-onlyIdempotent

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

Inputs: channel_id (required), response_format.

discord_get_community_settingsGet Community SettingsB
Read-onlyIdempotent

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

Inputs: guild_id (required), response_format.

discord_get_guildGet Discord Server InfoA
Read-onlyIdempotent

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

Inputs: guild_id (required), response_format.

discord_get_memberGet Discord MemberA
Read-onlyIdempotent

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

Inputs: user_id (required), guild_id (required), response_format.

discord_get_messagesGet Discord MessagesA
Read-onlyIdempotent

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

Inputs: channel_id (required), after, limit, before, +1 more.

discord_get_onboardingGet Server OnboardingA
Read-onlyIdempotent

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

Inputs: guild_id (required), response_format.

discord_get_pinned_messagesGet Pinned MessagesB
Read-onlyIdempotent

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

Inputs: channel_id (required), response_format.

discord_get_welcome_screenGet Welcome ScreenA
Read-onlyIdempotent

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

Inputs: guild_id (required), response_format.

discord_kick_memberKick Discord MemberA
Destructive

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

Inputs: user_id (required), guild_id (required), reason.

discord_leave_guildLeave Discord ServerA
Destructive

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

Inputs: confirm (required), guild_id (required).

discord_list_automod_rulesList Auto Moderation RulesA
Read-onlyIdempotent

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

Inputs: guild_id (required), response_format.

discord_list_bansList BansA
Read-onlyIdempotent

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

Inputs: guild_id (required), limit, response_format.

discord_list_channelsList Discord ChannelsA
Read-onlyIdempotent

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

Inputs: guild_id (required), type, response_format.

discord_list_emojisList EmojisA
Read-onlyIdempotent

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

Inputs: guild_id (required), response_format.

discord_list_eventsList Scheduled EventsA
Read-onlyIdempotent

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

Inputs: guild_id (required), response_format.

discord_list_guildsList Discord ServersA
Read-onlyIdempotent

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

Inputs: response_format.

discord_list_invitesList InvitesA
Read-onlyIdempotent

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

Inputs: guild_id (required), response_format.

discord_list_membersList Discord MembersA
Read-onlyIdempotent

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

Inputs: guild_id (required), after, limit, response_format.

discord_list_rolesList Discord RolesA
Read-onlyIdempotent

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

Inputs: guild_id (required), response_format.

discord_list_stickersList StickersA
Read-onlyIdempotent

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

Inputs: guild_id (required), response_format.

discord_list_webhooksList WebhooksA
Read-onlyIdempotent

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

Inputs: guild_id, channel_id, response_format.

discord_move_memberMove Member to Voice ChannelA
Idempotent

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

Inputs: user_id (required), guild_id (required), channel_id (required).

discord_pin_messagePin Discord MessageB
Idempotent

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

Inputs: channel_id (required), message_id (required).

discord_prune_membersPrune MembersA
Destructive

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)

Inputs: days (required), guild_id (required), dry_run, include_roles.

discord_remove_channel_permissionsRemove Channel Permission OverridesB
DestructiveIdempotent

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

Inputs: target_id (required), channel_id (required).

discord_remove_reactionRemove Reaction from MessageA
Idempotent

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

Inputs: emoji (required), channel_id (required), message_id (required).

discord_remove_roleRemove Role from MemberA
Idempotent

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

Inputs: role_id (required), user_id (required), guild_id (required).

discord_send_messageSend Discord MessageA

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

Inputs: content (required), channel_id (required), reply_to.

discord_set_channel_permissionsSet Channel PermissionsA
Idempotent

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

Inputs: target_id (required), channel_id (required), target_type (required), deny, +1 more.

discord_set_nicknameSet Member NicknameA
Idempotent

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

Inputs: user_id (required), guild_id (required), nickname (required).

discord_set_role_positionsSet Role PositionsA
Idempotent

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

Inputs: guild_id (required), positions (required).

discord_setup_communitySetup Community ServerA
Idempotent

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

Inputs: guild_id (required), rules_channel_id (required), public_updates_channel_id (required), description, +2 more.

discord_setup_onboardingSetup Server OnboardingA

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

Inputs: prompts (required), guild_id (required), default_channel_ids (required), mode, +1 more.

discord_sync_channel_permissionsSync Channel Permissions with CategoryA
Idempotent

Sync a channel's permissions with its parent category.

Args:

  • channel_id (string): Discord channel ID

Returns: Confirmation of sync

Inputs: channel_id (required).

discord_timeout_memberTimeout MemberA
Idempotent

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

Inputs: user_id (required), guild_id (required), duration_minutes (required), reason.

discord_unban_memberUnban Discord MemberA
Idempotent

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

Inputs: user_id (required), guild_id (required).

discord_unpin_messageUnpin Discord MessageA
Idempotent

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

Inputs: channel_id (required), message_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 67 tools

    Disambiguation5/5

    Each tool targets a distinct action and resource pair. For example, 'discord_add_role' and 'discord_remove_role' are clearly opposite, and all creation, editing, and deletion tools are clearly separated. There is no overlap or ambiguity between tools.

    Naming Consistency5/5

    All tools follow a consistent 'discord_verb_noun' pattern using snake_case. The verb is always a clear action (create, edit, delete, list, get, etc.) and the noun is the Discord resource (channel, role, member, etc.). The pattern is uniform throughout.

    Tool Count4/5

    With 67 tools, the set is large but covers the extensive Discord API. It provides comprehensive management capabilities for servers, channels, roles, members, emojis, stickers, webhooks, automod, onboarding, and more. While slightly on the higher side, each tool serves a distinct purpose within this broad scope.

    Completeness4/5

    The tool set covers most CRUD operations for the major Discord resources. Notable gaps include missing 'discord_edit_emoji', 'discord_edit_event', and 'discord_create_sticker'. However, the overall coverage is extensive, and these gaps are minor given the breadth of functionality provided.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      C
      quality
      D
      maintenance
      An MCP server that exposes Discord bot actions as tools for LLM clients.
      29
      1
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables AI assistants to manage Discord servers, including roles, channels, members, messages, and moderation, via natural language commands.
      1
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      A local MCP server that lets AI clients control a Discord bot via Discord's REST API, offering messaging, administration, and moderation tools. Includes safety features such as guild scoping, allowlists, and opt-in write permissions.
      20
      MIT