discord-mcp by SaseQ: a community Discord bot server for AI assistants

• Reads recent messages in a channel, with who wrote them

  Reads up to 100 messages of a channel's history at a time, including authors, replies and attachment details, and can page further back.

  Try: “Read the last 50 messages in #general and summarise them”

  Read · read_messages

• Finds messages in a channel or thread that contain some text

  Scans up to the 1,000 most recent messages of a channel or thread for matching text, newest first.

  Try: “Find messages in #support that mention 'refund'”

  Read · search_messages

• Shows one message, and the message it replies to

  Fetches a single message by its ID in the same format as the history, including the message it replied to.

  Try: “Show me the message this link points to and what it was replying to”

  Read · get_message

• Finds the replies to a message

  Scans the messages posted after a message, up to 1,000, to find the ones that reply to it.

  Try: “Who replied to the announcement I posted this morning?”

  Read · get_message_replies

• Posts a message in a channel

  Sends a message to a channel as the bot.

  Try: “Post 'Server maintenance starts at 9pm UTC' in #announcements”

  Write · send_message

• Edits a message the bot posted

  Changes the text of a message in a channel.

  Try: “Fix the typo in the bot's last message in #announcements”

  Write · edit_message

• Deletes a message in a channel

  Removes a message from a channel.

  Try: “Delete the spam message that was just posted in #general”

  Delete · delete_message

• Adds an emoji reaction to a message

  Reacts to a message with an emoji.

  Try: “React with a thumbs up to the latest message in #ideas”

  Write · add_reaction

• Removes an emoji reaction from a message

  Takes a given emoji reaction off a message.

  Try: “Remove the bot's thumbs up from that message”

  Delete · remove_reaction

• Reads the bot's private messages with someone

  Reads the history of private messages between the bot and a user, up to 100 at a time.

  Try: “What has Alex sent the bot in private messages this week?”

  Read · read_private_messages

• Sends someone a private message from the bot

  Sends a direct message from the bot to a user.

  Try: “Send Sam a private message reminding them about tonight's event”

  Write · send_private_message

• Edits a private message the bot sent

  Changes a direct message the bot sent to a user.

  Try: “Change the time in the reminder the bot sent Sam to 8pm”

  Write · edit_private_message

• Deletes a private message the bot sent

  Removes a direct message between the bot and a user.

  Try: “Delete the last private message the bot sent to Sam”

  Delete · delete_private_message

• Shows details about your Discord server

  Returns information about the server, such as its name, members and settings.

  Try: “Give me an overview of my Discord server”

  Read · get_server_info

• Finds server members by name or ID

  Searches members by ID, username, display name or nickname and returns matches with their user IDs.

  Try: “Find members whose nickname contains 'mod'”

  Read · search_members

• Shows a member's names, roles and join date

  Looks up a member by user ID and returns their usernames, nickname, bot status, join time and roles.

  Try: “When did this user join and what roles do they have?”

  Read · get_member_by_id

• Lists every channel on the server

  Returns all channels on the server.

  Try: “List all the channels on my server”

  Read · list_channels

• Shows details about a channel

  Returns detailed information about one channel.

  Try: “What are the settings of #general?”

  Read · get_channel_info

• Creates a new text channel

  Adds a new text channel to the server.

  Try: “Create a #feedback text channel”

  Write · create_text_channel

• Changes a text channel's name, topic or settings

  Edits a text channel's name, topic, age-restricted flag, slowmode, category or position.

  Try: “Set a 10 second slowmode on #general”

  Write · edit_text_channel

• Moves a channel to another category or position

  Moves a channel into a different category or changes its order.

  Try: “Move #feedback into the Community category”

  Write · move_channel

• Deletes a channel

  Removes a channel from the server.

  Try: “Delete the #old-announcements channel”

  Delete · delete_channel

• Lists the channels in a category

  Returns the channels inside one category.

  Try: “Which channels are in the Voice category?”

  Read · list_channels_in_category

• Creates a channel category

  Adds a new category to group channels.

  Try: “Create a category called Events”

  Write · create_category

• Renames or moves a category

  Changes a category's name or position.

  Try: “Rename the Events category to Community Events”

  Write · edit_category

• Deletes a category

  Removes a channel category from the server.

  Try: “Delete the empty Archive category”

  Delete · delete_category

• Lists every role and its details

  Returns all roles on the server with their settings.

  Try: “List all roles on my server”

  Read · list_roles

• Creates a new role

  Adds a new role to the server.

  Try: “Create a role called Event Host”

  Write · create_role

• Changes a role's settings

  Modifies an existing role, such as its name, color or permissions.

  Try: “Make the Event Host role green”

  Write · edit_role

• Deletes a role for good

  Permanently removes a role from the server.

  Try: “Delete the unused Beta Tester role”

  Delete · delete_role

• Gives a member a role

  Adds a role to a member.

  Try: “Give Sam the Moderator role”

  Write · assign_role

• Takes a role away from a member

  Removes a role from a member.

  Try: “Remove the Moderator role from Sam”

  Write · remove_role

• Mutes a member for a set time

  Stops a member from talking for a chosen duration.

  Try: “Time out spambot123 for 24 hours”

  Write · timeout_member

• Ends a member's timeout early

  Lifts a timeout before it expires.

  Try: “Remove the timeout on Sam”

  Write · remove_timeout

• Kicks a member off the server

  Removes a member from the server; they can rejoin with an invite.

  Try: “Kick spambot123 from the server”

  Delete · kick_member

• Bans a user from the server

  Bans a user so they cannot rejoin.

  Try: “Ban spambot123 for posting scam links”

  Delete · ban_member

• Lifts a ban

  Removes a user's ban so they can rejoin.

  Try: “Unban Alex, it was a mistake”

  Write · unban_member

• Lists banned users and why

  Returns the users banned from the server with the ban reasons.

  Try: “Show me everyone who is banned and why”

  Read · get_bans

• Changes a member's nickname

  Sets a member's nickname on the server.

  Try: “Set Sam's nickname to Sam (Mod)”

  Write · set_nickname

• Creates a voice channel

  Adds a new voice channel.

  Try: “Create a voice channel called Game Night”

  Write · create_voice_channel

• Creates a stage channel for audio events

  Adds a stage channel for talks and audio events.

  Try: “Create a stage channel for our town hall”

  Write · create_stage_channel

• Changes a voice channel's name, quality or user limit

  Edits a voice or stage channel's name, bitrate, user limit or region.

  Try: “Limit the Game Night voice channel to 10 people”

  Write · edit_voice_channel

• Moves someone to another voice channel

  Moves a member into a different voice channel.

  Try: “Move Sam to the Meeting voice channel”

  Write · move_member

• Disconnects someone from voice

  Removes a member from the voice channel they are in.

  Try: “Disconnect the AFK user from voice”

  Write · disconnect_member

• Server-mutes or deafens someone in voice

  Mutes or deafens a member in voice channels for the whole server.

  Try: “Server-mute Alex in voice”

  Write · modify_voice_state

• Lists upcoming and active server events

  Returns the server's scheduled and active events.

  Try: “What events are scheduled this month?”

  Read · list_guild_scheduled_events

• Shows who is interested in an event

  Lists the users who marked interest in a scheduled event.

  Try: “Who is interested in Game Night?”

  Read · get_guild_scheduled_event_users

• Schedules a server event

  Creates a voice, stage or external event on the server.

  Try: “Schedule Game Night for Friday at 8pm in the Game Night voice channel”

  Write · create_guild_scheduled_event

• Changes an event or starts, ends or cancels it

  Edits an event's details or changes its status to started, completed or cancelled.

  Try: “Move Game Night to Saturday”

  Write · edit_guild_scheduled_event

• Deletes a scheduled event

  Permanently removes a scheduled event.

  Try: “Delete the cancelled meetup event”

  Delete · delete_guild_scheduled_event

• Shows who has special access in a channel

  Lists the role and member permission overrides set on a channel.

  Try: “Who has special permissions in #staff?”

  Read · list_channel_permission_overwrites

• Sets what a role can do in a channel

  Creates or updates a role's permission override on a channel.

  Try: “Make #announcements read-only for everyone except Moderators”

  Write · upsert_role_channel_permissions

• Sets what one member can do in a channel

  Creates or updates a member's permission override on a channel.

  Try: “Let Sam post in #announcements”

  Write · upsert_member_channel_permissions

• Removes a special channel permission

  Deletes a role's or member's permission override from a channel.

  Try: “Remove Sam's special access to #staff”

  Delete · delete_channel_permission_overwrite

• Lists active invite links and their use

  Returns the server's active invites with their usage stats.

  Try: “Which invite links are active and how often were they used?”

  Read · list_invites

• Shows details about an invite link

  Returns information about an invite, including public invites to other servers.

  Try: “What server does this invite link go to?”

  Read · get_invite_details

• Creates an invite link

  Makes a new invite link for a channel.

  Try: “Create an invite to #welcome that expires in a day”

  Write · create_invite

• Revokes an invite link

  Deletes an invite so the link stops working.

  Try: “Revoke the old invite link we posted on Twitter”

  Delete · delete_invite

• Lists active threads across the server

  Returns all active threads on the server.

  Try: “What threads are active right now?”

  Read · list_active_threads

• Lists the threads in one channel

  Returns a channel's threads, including recent archived public ones.

  Try: “List the threads in #support, including archived ones”

  Read · list_threads

• Shows details about a thread

  Returns a thread's parent channel, owner, archived or locked state and message and member counts.

  Try: “Who started this thread and is it locked?”

  Read · get_thread_info

• Lists forum channels

  Returns all forum channels on the server.

  Try: “Which forum channels do we have?”

  Read · list_forum_channels

• Shows a forum's settings and tags

  Returns a forum channel's details, including tags and settings.

  Try: “What tags and settings does the #help forum use?”

  Read · get_forum_channel_info

• Lists the tags in a forum

  Returns the tags available in a forum channel.

  Try: “List the tags in #help”

  Read · list_forum_tags

• Lists active posts in a forum

  Returns the active posts in a forum channel.

  Try: “Show me the open posts in #help”

  Read · list_forum_posts

• Creates a forum channel

  Adds a new forum channel.

  Try: “Create a #help forum for support questions”

  Write · create_forum_channel

• Changes a forum's settings

  Edits a forum's name, topic, slowmode, category, position, default sort or layout.

  Try: “Sort the #help forum by newest activity”

  Write · edit_forum_channel

• Starts a new forum post

  Creates a post with a first message in a forum channel.

  Try: “Post a 'Read before asking' guide in #help”

  Write · create_forum_post

• Locks, archives, pins or retags a forum post

  Locks or unlocks, archives or unarchives, pins or unpins a post, or changes its tags.

  Try: “Lock and archive the solved posts in #help”

  Write · modify_forum_post

• Lists the server's custom emojis

  Returns all custom emojis on the server.

  Try: “Show our custom emojis”

  Read · list_emojis

• Shows details about a custom emoji

  Returns information about one custom emoji.

  Try: “Who can use the :partyparrot: emoji?”

  Read · get_emoji_details

• Uploads a new custom emoji

  Adds a custom emoji from an image or image link, up to 256KB.

  Try: “Add this image as a :wave: emoji”

  Write · create_emoji

• Renames an emoji or limits who can use it

  Changes a custom emoji's name or the roles allowed to use it.

  Try: “Rename :wave: to :hello:”

  Write · edit_emoji

• Deletes a custom emoji

  Permanently removes a custom emoji.

  Try: “Delete the :oldlogo: emoji”

  Delete · delete_emoji

• Lists a channel's webhooks

  Returns the webhooks set up on a channel.

  Try: “Which webhooks post into #deploys?”

  Read · list_webhooks

• Creates a webhook on a channel

  Adds a webhook that other apps can use to post into a channel.

  Try: “Create a webhook on #deploys for our CI”

  Write · create_webhook

• Posts a message through a webhook

  Sends a message to a channel through a webhook, under the webhook's name.

  Try: “Post the release notes in #deploys through the CI webhook”

  Write · send_webhook_message

• Deletes a webhook

  Removes a webhook so it can no longer post.

  Try: “Delete the old CI webhook”

  Delete · delete_webhook

• Used by the assistant behind the scenes

  Looks up a member's user ID from their name

  Finds a member's user ID from their username so the assistant can mention them. Used by the assistant for itself.

  Try: “What is Sam's user ID?”

  Read · get_user_id_by_name

• Looks up a channel's ID from its name

  Finds a channel's type and ID from its name. Used by the assistant before other channel actions.

  Try: “What is the ID of #general?”

  Read · find_channel

• Looks up a category's ID from its name

  Finds a category's ID from its name. Used by the assistant before other category actions.

  Try: “What is the ID of the Events category?”

  Read · find_category

Watch out for

• Anyone who reaches the port can use your bot

  The HTTP endpoint has no login. Keep it on localhost and never publish port 8085 to the internet or a shared network. github.com

• It can ban, kick and delete, not just read

  Tools include deleting channels, roles, messages and emojis and banning members. Grant the bot only the permissions it needs in Discord. github.com

• Extra admin pages could leak your bot token

  Expose only the health check. Other admin endpoints, such as env, would reveal the token. github.com

• The token only goes to Discord

  A security review found it is never logged or sent elsewhere, and the server has no telemetry. github.com

Security advisories

In their words