Discord MCP Server

A comprehensive Model Context Protocol (MCP) server that provides seamless integration with Discord's API. This server enables AI assistants and applications to interact with Discord guilds (servers), managing everything from channels and messages to members and roles through a unified interface.

Overview

The Discord MCP Server acts as a bridge between your AI applications and Discord, offering extensive capabilities for server management, communication, and moderation. Whether you need to send messages, manage channels, moderate members, or configure server settings, this server provides all the tools necessary to automate and enhance your Discord server operations.

Features

Guild Management

• Retrieve comprehensive information about your Discord server
• Access server metadata, member counts, and configuration details
• Monitor server status and properties

Channel Operations

• List all channels across your guild with detailed information
• Create new channels with customizable types (text, voice, category, announcement, stage, forum)
• Update existing channel properties including names, topics, and positions
• Delete channels when no longer needed
• Organize channels within categories for better structure

Messaging Capabilities

• Send rich messages with support for embeds and text-to-speech
• Retrieve message history with flexible pagination options
• Edit previously sent messages
• Delete individual messages or bulk delete up to 100 messages at once
• Get specific messages by ID for detailed inspection
• Manage pinned messages to highlight important content

Message Reactions

• Add emoji reactions to messages for engagement
• Remove specific reactions from users
• Clear all reactions or specific emoji reactions from messages
• Support for both Unicode emoji and custom server emoji

Member Management

• List all members in your guild with pagination support
• Retrieve detailed information about specific members
• Kick members from the server with optional reason logging
• Ban members with configurable message deletion periods
• Unban previously banned users
• View the complete list of banned users

Role Administration

• List all roles in your guild
• Create new roles with customizable properties (name, color, display settings)
• Delete roles that are no longer needed
• Assign roles to members for permission management
• Remove roles from members as needed

Invite Management

• Create server invites with configurable expiration and usage limits
• List all active invites across your guild
• Delete invites to revoke access

Webhook Integration

• List webhooks configured for specific channels
• Create new webhooks for external integrations
• Delete webhooks when no longer required

Tools

Guild Information

get_guild_info

• Retrieves information about the connected Discord guild/server
• No parameters required
• Returns server name, ID, member count, and other metadata

Channel Management

list_guild_channels

• Lists all channels in the guild
• No parameters required
• Returns channel names, IDs, types, and hierarchy

create_channel

• Creates a new channel in the guild
• Parameters:
  • name (required): Channel name
  • type (optional): Channel type - 0 for text, 2 for voice, 4 for category, 5 for announcement, 13 for stage, 15 for forum
  • topic (optional): Channel topic for text channels
  • parent_id (optional): Category ID to place the channel in

update_channel

• Updates an existing channel's properties
• Parameters:
  • channelId (required): Channel ID to update
  • name (optional): New channel name
  • topic (optional): New channel topic
  • position (optional): New channel position in the list

delete_channel

• Deletes a channel from the guild
• Parameters:
  • channelId (required): Channel ID to delete

Message Operations

list_channel_messages

• Lists messages from a Discord channel
• Parameters:
  • channelId (required): The ID of the channel
  • limit (optional): Number of messages to retrieve, between 1-100, defaults to 50
  • before (optional): Get messages before this message ID
  • after (optional): Get messages after this message ID
  • around (optional): Get messages around this message ID

get_message

• Retrieves a specific message
• Parameters:
  • channelId (required): Channel ID
  • messageId (required): Message ID

send_message

• Sends a message to a Discord channel
• Parameters:
  • channelId (required): The ID of the channel
  • content (required): The message content
  • embeds (optional): Array of embed objects for rich content
  • tts (optional): Send as text-to-speech message

edit_message

• Edits an existing message
• Parameters:
  • channelId (required): The ID of the channel
  • messageId (required): The ID of the message to edit
  • content (required): The new message content

delete_message

• Deletes a message from a channel
• Parameters:
  • channelId (required): The ID of the channel
  • messageId (required): The ID of the message to delete

bulk_delete_messages

• Deletes multiple messages at once (2-100 messages, not older than 14 days)
• Parameters:
  • channelId (required): Channel ID
  • messageIds (required): Array of message IDs to delete

Pinned Messages

pin_message

• Pins a message in a channel
• Parameters:
  • channelId (required): Channel ID
  • messageId (required): Message ID to pin

unpin_message

• Unpins a message in a channel
• Parameters:
  • channelId (required): Channel ID
  • messageId (required): Message ID to unpin

get_pinned_messages

• Retrieves all pinned messages in a channel
• Parameters:
  • channelId (required): Channel ID

Reaction Management

add_reaction

• Adds a reaction to a message
• Parameters:
  • channelId (required): Channel ID
  • messageId (required): Message ID
  • emoji (required): Emoji in Unicode format or custom emoji in name:id format

remove_reaction

• Removes a reaction from a message
• Parameters:
  • channelId (required): Channel ID
  • messageId (required): Message ID
  • emoji (required): Emoji to remove
  • userId (optional): User ID, defaults to bot if not specified

clear_reactions

• Removes all reactions from a message
• Parameters:
  • channelId (required): Channel ID
  • messageId (required): Message ID
  • emoji (optional): Specific emoji to clear, clears all reactions if not specified

Member Management

list_guild_members

• Lists members in the guild
• Parameters:
  • limit (optional): Maximum number of members to return, between 1-1000, defaults to 1
  • after (optional): Get members after this user ID for pagination

get_guild_member

• Retrieves information about a specific guild member
• Parameters:
  • userId (required): User ID

kick_member

• Kicks a member from the guild
• Parameters:
  • userId (required): User ID to kick
  • reason (optional): Reason for the kick

ban_member

• Bans a member from the guild
• Parameters:
  • userId (required): User ID to ban
  • deleteMessageDays (optional): Number of days of messages to delete, between 0-7
  • reason (optional): Reason for the ban

unban_member

• Removes a ban for a user
• Parameters:
  • userId (required): User ID to unban

list_bans

• Retrieves the list of banned users
• Parameters:
  • limit (optional): Maximum number of bans to return, between 1-1000

Role Management

list_roles

• Lists all roles in the guild
• No parameters required

create_role

• Creates a new role in the guild
• Parameters:
  • name (required): Role name
  • color (optional): Role color as a decimal color value
  • hoist (optional): Whether to display role separately in the member list
  • mentionable (optional): Whether to allow anyone to mention this role

delete_role

• Deletes a role from the guild
• Parameters:
  • roleId (required): Role ID to delete

add_member_role

• Adds a role to a guild member
• Parameters:
  • userId (required): User ID
  • roleId (required): Role ID to add

remove_member_role

• Removes a role from a guild member
• Parameters:
  • userId (required): User ID
  • roleId (required): Role ID to remove

Invite Management

create_invite

• Creates an invite for a channel
• Parameters:
  • channelId (required): Channel ID
  • maxAge (optional): Maximum age in seconds, 0 for never expires, defaults to 86400 (24 hours)
  • maxUses (optional): Maximum number of uses, 0 for unlimited, defaults to 0
  • temporary (optional): Whether to grant temporary membership

list_invites

• Retrieves all invites for the guild
• No parameters required

delete_invite

• Deletes an invite
• Parameters:
  • inviteCode (required): Invite code to delete

Webhook Management

list_webhooks

• Lists all webhooks in a channel
• Parameters:
  • channelId (required): Channel ID

create_webhook

• Creates a webhook for a channel
• Parameters:
  • channelId (required): Channel ID
  • name (required): Webhook name

delete_webhook

• Deletes a webhook
• Parameters:
  • webhookId (required): Webhook ID to delete

Use Cases

This Discord MCP Server is ideal for various automation and integration scenarios:

• Community Management: Automate moderation tasks, welcome messages, and member management
• Content Distribution: Send announcements, updates, and notifications to specific channels
• Server Administration: Manage channels, roles, and permissions programmatically
• Analytics and Monitoring: Track message history and member activity
• Bot Development: Build sophisticated Discord bots with AI capabilities
• Integration Workflows: Connect Discord with other services and platforms through webhooks

The comprehensive set of tools provided by this server enables full control over Discord server operations, making it an essential integration for any Discord-based workflow or application.