Discord MCP Server
Provides comprehensive tools for managing Discord servers, including guild settings, channels, messages, members, roles, permissions, forum channels, auto moderation, emojis, stickers, invites, webhooks, scheduled events, community features, onboarding, and welcome screen.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Discord MCP Server send a message to #general saying 'Hello everyone!'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 todiscord_get_guild- Get detailed info about a specific serverdiscord_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 categoriesdiscord_edit_channel- Edit channel name, topic, position, category, forum tags, and morediscord_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 channelsdiscord_remove_channel_permissions- Remove permission overridesdiscord_get_channel_permissions- View all permission overrides on a channeldiscord_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 messagesdiscord_delete_message- Delete messagesdiscord_add_reaction- Add emoji reactionsdiscord_remove_reaction- Remove bot's reactionsdiscord_pin_message- Pin a messagediscord_unpin_message- Unpin a messagediscord_get_pinned_messages- Get all pinned messages
Member Management
discord_list_members- List server members (with pagination)discord_get_member- Get member detailsdiscord_kick_member- Kick a memberdiscord_ban_member- Ban a member (with message deletion option)discord_unban_member- Unban a userdiscord_set_nickname- Set/clear member nicknamediscord_move_member- Move member to a different voice channeldiscord_timeout_member- Timeout/mute a member (up to 28 days)
Role Management
discord_list_roles- List all server rolesdiscord_create_role- Create a new rolediscord_edit_role- Edit role name, color, permissions, and settingsdiscord_delete_role- Delete a rolediscord_add_role- Assign role to memberdiscord_remove_role- Remove role from memberdiscord_set_role_positions- Reorder role hierarchy
Server Administration
discord_list_bans- List all banned usersdiscord_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 configurationdiscord_edit_welcome_screen- Edit welcome screen (description, channels, emojis)
Onboarding
discord_get_onboarding- Get onboarding configurationdiscord_edit_onboarding- Edit existing onboarding settingsdiscord_setup_onboarding- Setup onboarding from scratch (prompts, default channels, roles)
Auto Moderation
discord_list_automod_rules- List auto moderation rulesdiscord_get_automod_rule- Get details of an auto mod rulediscord_create_automod_rule- Create auto moderation rulediscord_edit_automod_rule- Edit auto moderation rulediscord_delete_automod_rule- Delete auto moderation rule
Emoji Management
discord_list_emojis- List custom emojisdiscord_create_emoji- Create emoji from image URLdiscord_delete_emoji- Delete a custom emoji
Sticker Management
discord_list_stickers- List custom stickersdiscord_delete_sticker- Delete a custom sticker
Invite Management
discord_list_invites- List active invitesdiscord_create_invite- Create channel invitediscord_delete_invite- Delete an invite
Webhook Management
discord_list_webhooks- List webhooks (guild or channel)discord_create_webhook- Create a webhookdiscord_edit_webhook- Edit webhook name or channeldiscord_delete_webhook- Delete a webhook
Scheduled Events
discord_list_events- List scheduled eventsdiscord_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
Go to the Discord Developer Portal
Click "New Application" and give it a name
Go to the "Bot" section and click "Add Bot"
Copy the bot token (keep this secret!)
Enable these Privileged Gateway Intents:
Server Members Intent
Message Content Intent
2. Invite the Bot to Your Server
Go to OAuth2 -> URL Generator
Select scopes:
bot,applications.commandsSelect 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
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-mcpserverOption B: Run directly with npx (no install required)
npx @mahesvara/discord-mcpserverUsage
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=localhostVariable | Description | Default |
| Your Discord bot token (required) | - |
| Transport mode: |
|
| HTTP server port (when using http transport) |
|
| HTTP server host (use |
|
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-mcpserverWindows (Command Prompt):
set DISCORD_BOT_TOKEN=your_token && set TRANSPORT=http && set PORT=3000 && set HOST=0.0.0.0 && discord-mcpserverWindows (PowerShell):
$env:DISCORD_BOT_TOKEN="your_token"; $env:TRANSPORT="http"; $env:PORT="3000"; $env:HOST="0.0.0.0"; discord-mcpserverOr use a .env file (works on all platforms):
discord-mcpserverThen 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,ManageMessagesEmbedLinks,AttachFiles,AddReactionsUseExternalEmojis,UseExternalStickersMentionEveryone
Threads:
CreatePublicThreads,CreatePrivateThreadsSendMessagesInThreads,ManageThreads
Voice:
Connect,Speak,StreamMuteMembers,DeafenMembers,MoveMembersUseVAD,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: trueAll 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,ManageChannelsKickMembers,BanMembers,ModerateMembersViewAuditLog,ViewGuildInsights
Messages:
SendMessages,ManageMessages,ReadMessageHistoryEmbedLinks,AttachFiles,AddReactionsMentionEveryone,UseExternalEmojis
Voice:
Connect,Speak,StreamMuteMembers,DeafenMembers,MoveMembers
Other:
ManageWebhooks,ManageEmojisAndStickersManageEvents,CreateEvents
License
MIT
Available Tools
67 toolsdiscord_add_reactionAdd Reaction to MessageAIdempotent
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 MemberAIdempotent
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 MemberBDestructive
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 RuleADestructive
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 ChannelADestructive
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 EmojiADestructiveIdempotent
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 EventADestructiveIdempotent
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 InviteADestructiveIdempotent
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 MessageADestructive
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 RoleADestructive
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 StickerADestructiveIdempotent
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 WebhookADestructiveIdempotent
Delete a webhook.
Args:
webhook_id (string): Discord webhook ID
Returns: Confirmation of deletion
Inputs: webhook_id (required).
discord_edit_automod_ruleEdit Auto Moderation RuleBIdempotent
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 ChannelAIdempotent
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 ServerAIdempotent
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 MessageAIdempotent
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 OnboardingAIdempotent
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 RoleAIdempotent
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 WebhookAIdempotent
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 ScreenAIdempotent
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 LogARead-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 RuleARead-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 InfoARead-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 PermissionsARead-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 SettingsBRead-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 InfoARead-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 MemberARead-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 MessagesARead-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 OnboardingARead-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 MessagesBRead-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 ScreenARead-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 MemberADestructive
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 ServerADestructive
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 RulesARead-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 BansARead-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 ChannelsARead-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 EmojisARead-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 EventsARead-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 ServersARead-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 InvitesARead-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 MembersARead-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 RolesARead-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 StickersARead-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 WebhooksARead-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 ChannelAIdempotent
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 MessageBIdempotent
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 MembersADestructive
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 OverridesBDestructiveIdempotent
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 MessageAIdempotent
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 MemberAIdempotent
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 PermissionsAIdempotent
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 NicknameAIdempotent
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 PositionsAIdempotent
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 ServerAIdempotent
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 CategoryAIdempotent
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 MemberAIdempotent
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 MemberAIdempotent
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 MessageAIdempotent
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
Scored across 67 tools
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.
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.
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.
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
Related MCP Connectors
An MCP server that integrates with Discord to provide AI-powered features.
- Discortics - Discord BotDeprecatedcom.discortics
Set up and manage your Discord server from MCP: channels, roles, verification, tickets and security.
MCP server for AI dialogue using various LLM models via AceDataCloud
Discord MCP server for ChatGPT, Claude and any AI agent: list servers and channels, read channel messages, search messages, send message, reply to message, send DM, read mentions and assign role in your own Discord account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Discord yourself; Cotlet does not store your password and you need no Discord API key. About the official Discord API: Yes, Discord has an official API for bots and OAuth2 apps, but it acts as a bot that a server manager adds, not as you, and Discord has no official MCP server for it (checked 5 Nov 2026). The MCP server on Discord's docs site only searches documentation. Setup and FAQ: https://cotlet.dev/integrations/discord-api-mcp-server
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server for Discord that enables AI assistants to interact with Discord servers, channels, and messages via the Discord API.67 npmMIT
- FlicenseCqualityDmaintenanceAn MCP server that exposes Discord bot actions as tools for LLM clients.291-
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI assistants to manage Discord servers, including roles, channels, members, messages, and moderation, via natural language commands.1MIT
- AlicenseBqualityCmaintenanceA 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.20MIT