@pasympa/discord-mcp
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Returns a result when called with no setup: 0 of 2 tools tried
Contacts while installing and starting: nothing
Its tool definitions changed since version 2.3.0. If you approved the earlier ones, read them again.
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y @pasympa/discord-mcp@2.4.0
Installing a package runs its code. Use a sandbox for anything you have not read.
Calling its tools
2 tools that take no input and look read-only were called once with nothing. 0 returned a result.
discord_list_guilds | No usable answer tool reported an error: ❌ Error: DISCORD_TOKEN is required. Set it in your MCP client config or a .env file. |
discord_list_webhooks | No usable answer tool reported an error: ❌ Error: DISCORD_TOKEN is required. Set it in your MCP client config or a .env file. |
During the calls it contacted nothing it had not already contacted.
Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
discord_list_guilds
List the Discord servers (guilds) the bot is a member of (id, name, member count, icon). When DISCORD_ALLOWED_GUILDS is set, only those servers are listed. With DISCORD_GUILD_MEMBERS=false, the member count is not updated after the bot connects. Takes no arguments. Read-only. Start here to discover the guild_id needed by most other tools.
discord_get_guild_info guild_id
Get details about one server: name, description, member/channel/role counts, boost tier, owner, and creation date. The owner field is a user ID. roleCount includes the @everyone role. channelCount also counts the threads in the bot's cache. With DISCORD_GUILD_MEMBERS=false, memberCount is not updated after the bot connects. Use discord_get_server_stats for a finer breakdown (humans vs bots, channel types).
discord_list_channels guild_id
List all channels in a server, grouped by their parent category and ordered by position. Returns a JSON object keyed by category name. Channels that Discord hides from the bot behind the placeholder name ___hidden___ are left out, and discord_find_channel_by_name reports how many; a visible channel whose category is hidden is listed under "Hidden parent". Read-only. Use discord_find_channel_by_name to locate a specific channel.
discord_find_channel_by_name guild_id, name
Find channels whose name contains a substring (case-insensitive). Returns { matches: [...], hiddenChannels } with the id, name and type of every match, active threads included. Channels that Discord hides from the bot behind the placeholder name ___hidden___ are left out of matches and counted in hiddenChannels; when it is above 0, a note field says a channel missing from matches may still exist. The list is empty when nothing matches. Useful for resolving a channel_id when you only know the channel's name. Use discord_list_channels to see every channel grouped by category.discord_read_messages channel_id, limit, before, after, around, since
Read messages from a text channel or thread, oldest-to-newest. Page backwards by re-calling with before set to the id of the oldest message you received, which walks a channel past the 100-message per-call cap. Requires the View Channel and Read Message History permissions; without Read Message History an empty result fails with an error naming the permission. Returns { messages: [...] } with id, author, content, timestamp, attachment count, pinned flag, and the text of any embeds. Use discord_search_messages or discord_search_guild_messages to filter by keyword, or discord_fetch_pinned_messages for pinned messages only.95 more tools
discord_send_message channel_id, content
Send a plain-text message to a channel or thread. For rich content (title, color, fields, images) use discord_send_embed; to attach a reply reference to an existing message use discord_reply_message. Requires the bot to have the Send Messages permission. Returns the new message ID.
discord_reply_message channel_id, message_id, content
Reply to a specific message, attaching a reply reference so clients show it as a threaded reply. Use discord_send_message for a standalone message with no reference. Requires the Send Messages and Read Message History permissions. Discord refuses some system messages as reply targets. Returns the new reply's message ID.
discord_edit_message channel_id, message_id, content
Edit the text content of a message previously sent by this bot. Discord forbids editing other users' messages, so this fails for non-bot messages. Use discord_edit_embed for embed messages. Works in text channels and threads. Requires the View Channel and Read Message History permissions. Returns the edited message ID.
discord_add_reaction channel_id, message_id, emoji
Add a single emoji reaction to a message as the bot. Requires the Read Message History permission to look the message up, plus Add Reactions when no one has reacted with that emoji yet. Use discord_remove_reactions to undo. Idempotent: re-adding the bot's existing reaction has no effect.
discord_list_channel_threads channel_id, limit, type, before
List the threads in a text or announcement channel. Returns { threads: [...], hasMore, nextBefore }. The first call includes active threads plus the first page of archived ones; while hasMore is true pass nextBefore back as `before`. hasMore means that page came back full, so the last call can return nothing. messageCount excludes the starter message and deleted messages, and is inaccurate above 50 for threads created before July 1, 2022. Requires the View Channel and Read Message History permissions. Read-only. Use discord_list_forum_threads for a forum's posts.discord_create_thread channel_id, name, message_id, auto_archive_duration
Create a thread, either branching from an existing message (pass message_id) or as a standalone thread in a text channel (omit message_id). Standalone creation requires a parent text channel and fails if channel_id is itself a thread. Requires the Create Public Threads permission, plus Read Message History when message_id is set. Returns the new thread's ID.
discord_bulk_delete_messages channel_id, count, dry_run
Permanently delete multiple recent messages in one call. IRREVERSIBLE. SAFE BY DEFAULT: dry_run is true unless explicitly set to false, so call it first to preview, then re-call with dry_run:false to actually delete. Discord only allows bulk-deleting messages younger than 14 days; older ones are skipped. Requires the Manage Messages permission, and refuses to run without Read Message History. Returns the number deleted.
discord_send_embed channel_id, title, url, description, color, fields, author, thumbnail_url, footer, image_url, timestamp
Send a single rich embed (title, description, color, fields, author, footer, images, timestamp). Use discord_send_message for plain text, or discord_send_multiple_embeds to send several embeds at once. Requires the Send Messages and Embed Links permissions. Returns the new message ID.
discord_edit_embed channel_id, message_id, title, url, description, color, fields, author, thumbnail_url, footer, image_url, timestamp
Replace the embed on a message previously sent by this bot. Only this bot's messages can be edited. This is a full replace, not a merge: provided fields are applied and omitted fields are dropped from the embed. Requires the View Channel, Read Message History and Embed Links permissions. Returns a confirmation.
discord_send_multiple_embeds channel_id, content, embeds
Send up to 10 embeds in a single message, with optional text above them. Use discord_send_embed for a single embed. Requires the Send Messages and Embed Links permissions. Returns the new message ID.
discord_delete_message channel_id, message_id, reason
Permanently delete one specific message. IRREVERSIBLE. Requires the View Channel and Read Message History permissions to find the message. The bot can then delete its own messages; deleting another user's message also requires the Manage Messages permission. Use discord_bulk_delete_messages to remove many at once. Discord does not record a reason for a single message delete in the audit log.
discord_pin_message channel_id, message_id, pin
Pin or unpin a message in a channel, controlled by the pin flag. Requires the Pin Messages and Read Message History permissions (Pin Messages is a dedicated permission since early 2026, separate from Manage Messages). A channel holds at most 250 pins. Idempotent: pinning an already-pinned message (or unpinning an unpinned one) has no additional effect.
discord_search_messages channel_id, keyword, limit
Keyword search over a channel's recent messages using case-insensitive substring matching. Scans only up to the last 100 messages; it does not search full history. Returns { matches: [...] } with id, author, content, timestamp, and the text of any embeds. Matching checks message content only, so a word that appears only in an embed is not found. Requires the View Channel and Read Message History permissions; without Read Message History an empty scan fails with an error naming the permission. Use discord_read_messages to fetch recent messages without filtering. To search full history, in one channel or the whole server, use discord_search_guild_messages.discord_search_guild_messages guild_id, query, channel_id, author_id, limit
Search for messages across all channels in a guild using Discord's native search API. Returns at most 25 messages matching the query with channel context, with no way to page past them. Age-restricted (NSFW) channels are left out. Requires the Read Message History permission and the Message Content privileged intent, enabled in the Developer Portal. While Discord is still building the server's search index, the call fails and says how many seconds to wait. Use discord_search_messages for a substring scan of one channel's last 100 messages. To read the messages around a hit, use discord_read_messages with around.
discord_crosspost_message channel_id, message_id
Publish (crosspost) a message from an Announcement channel to every server that follows it. Only works in announcement channels on a message that has not already been published. Requires the Read Message History and Send Messages permissions (and Manage Messages for messages authored by others). Returns a confirmation.
discord_remove_reactions channel_id, message_id, emoji, user_id
Remove reactions from a message. With no emoji: removes ALL reactions. With emoji only: removes every reaction of that emoji. With emoji and user_id: removes that one user's reaction. user_id without emoji is rejected. Removing all reactions, every reaction of one emoji, or another user's reaction requires the Manage Messages permission. Use discord_add_reaction to add.
discord_get_reactions channel_id, message_id, emoji, limit
List the users who reacted to a message with a specific emoji. Returns { reactions: [...] } with id, username, bot flag. Returns 25 users by default and at most 100, with no cursor for the rest. Super reactions are not listed. Fails when no one reacted with that emoji. Requires the View Channel and Read Message History permissions.discord_get_message_attachments channel_id, message_id
List the file attachments of a message. Returns { attachments: [...] } with id, filename, title (the original name when Discord strips non-ASCII from filename), url, proxyUrl, contentType, size in bytes, width, height, alt-text description, voice-message duration and waveform, spoiler flag. Discord signs CDN urls with a 24-hour expiry and does not re-sign on every fetch; re-call this tool if a stored url has expired. Requires the View Channel and Read Message History permissions. Without the Message Content privileged intent, enabled in the Developer Portal, Discord returns no attachments for other users' messages unless they mention the bot. A forwarded message's files sit in its snapshot and are not listed. Read-only. Use discord_read_messages to find messages with attachments.discord_fetch_pinned_messages channel_id, limit, before
List a channel's pinned messages, most recently pinned first. Returns { messages: [...], hasMore, nextBefore } with id, author, content, timestamp, pinnedAt, and the text of any embeds. Discord serves at most 50 pins per call, so when hasMore is true pass nextBefore back as `before` to fetch the next page. Requires the View Channel and Read Message History permissions; without Read Message History an empty result fails with an error naming the permission. Use discord_pin_message to change which messages are pinned, or discord_read_messages to read the whole channel.discord_forward_message channel_id, message_id, target_channel_id
Forward an existing message to another channel using Discord's native forward, which links back to the original message. The forward carries a snapshot of the content, embeds and attachments, without the original author. Works across text channels and threads. Discord forwards only regular messages, replies and command responses, not polls, and refuses a message whose content the bot cannot read (error 160014). Use discord_send_message to compose new content instead. Requires the View Channel and Read Message History permissions in the source channel and Send Messages in the target channel. Returns a confirmation.
discord_create_channel guild_id, name, type, topic, category_id
Create a text channel, voice channel, or category in a server. Requires the Manage Channels permission. For forum channels use discord_create_forum_channel instead. Returns the new channel's name and ID.
discord_delete_channel channel_id, reason, dry_run
Permanently delete a channel and all of its messages. IRREVERSIBLE. SAFE BY DEFAULT: dry_run is true unless explicitly set to false, so call it first to preview, then re-call with dry_run:false to actually delete. Deleting a category keeps its channels, which leave the category. A DM channel ID only closes the DM, which is reversible. Requires the Manage Channels permission, or Manage Threads for a thread. An optional reason is recorded in the audit log.
discord_edit_channel channel_id, name, topic, slowmode, nsfw
Update a channel's name, topic, slowmode, or NSFW flag. Only provided fields change. This tool sends topic and slowmode for plain text channels only; on every other type, announcement channels included, it ignores them without an error. Requires the Manage Channels permission. Returns a confirmation.
discord_move_channel channel_id, category_id
Move a channel into a category, or remove it from its category when category_id is omitted. Requires the Manage Channels permission. Use discord_set_channel_position to reorder within a category. Returns a confirmation.
discord_clone_channel channel_id, new_name
Create a copy of a channel, including its name, topic, and permission overwrites (but not its messages). Requires the Manage Channels permission, and View Channel on the source: the tool refuses a source the bot cannot view, whose overwrites Discord may replace with a single @everyone View Channel deny. Returns the cloned channel's name and ID.
discord_set_channel_position channel_id, position
Set a channel's display order among the channels of its kind in its category. Text, announcement, forum and media channels sort together, voice and stage channels together, and categories among categories. A position equal to or above the number of channels in that group leaves the order unchanged. Use discord_move_channel to change which category it belongs to. Requires the Manage Channels permission. Returns a confirmation.
discord_follow_announcement_channel source_channel_id, target_channel_id
Subscribe a target channel to an announcement (news) channel, so the source's published messages are reposted into the target. The source must be an announcement channel. Requires the Manage Webhooks permission in the target. Returns a confirmation.
discord_lock_channel_permissions channel_id
Reset a channel's permission overwrites to exactly match its parent category (Discord's 'sync permissions'). The channel must be inside a category. Requires the Manage Channels and Manage Roles permissions, and View Channel on the category: the tool refuses a category the bot cannot view, whose overwrites Discord may replace with a single @everyone View Channel deny. Returns a confirmation.
discord_get_channel_permissions channel_id
List every permission overwrite on a channel, per role and per member, with the allowed and denied permission flags for each. Read-only. Refuses a channel that Discord hides from the bot behind the placeholder name ___hidden___: Discord shows a placeholder in place of its real overwrites, so grant the bot View Channel on it first. Use discord_audit_permissions for a server-wide report across all channels.
discord_set_role_permission channel_id, role_id, allow, deny, reason
Add or update a per-channel permission overwrite for a role, allowing and/or denying specific permissions. Merges with the role's existing overwrite (does not reset it). Denying View Channel to @everyone on a channel also hides it from the bot, unless the bot has Administrator or a View Channel allow overwrite there, on its own member or on one of its roles. Grant that allow first, for example with discord_set_member_permission, then deny. Requires the Manage Roles permission. Use discord_set_member_permission to target a single member instead.
discord_set_member_permission channel_id, user_id, allow, deny, reason
Add or update a per-channel permission overwrite for a single member, allowing and/or denying specific permissions. Merges with the member's existing overwrite. Requires the Manage Roles permission. Use discord_set_role_permission to target a whole role instead.
discord_reset_channel_permissions channel_id, reason
Remove ALL permission overwrites on a channel, so only role/server-level permissions apply. Does NOT re-sync with the category; use discord_lock_channel_permissions for that. IRREVERSIBLE: the cleared overwrites cannot be recovered. Requires the Manage Channels and Manage Roles permissions.
discord_copy_permissions source_channel_id, target_channel_id, reason
Replace the target channel's permission overwrites with a copy of the source channel's. The target's existing overwrites are overwritten. Requires the Manage Channels and Manage Roles permissions, and View Channel on the source: the tool refuses a source the bot cannot view, whose overwrites Discord may replace with a single @everyone View Channel deny. Returns a confirmation. To create a new channel with the same overwrites, use discord_clone_channel; to remove them all, use discord_reset_channel_permissions.
discord_audit_permissions guild_id
Generate a server-wide permission report: for every channel that has overwrites, lists each role/member and their allowed/denied permissions (entity names resolved). Read-only. Returns { channels: [...], hiddenChannels } with channel, channelId, overwrites. Channels that Discord hides from the bot behind the placeholder name ___hidden___ are left out and counted in hiddenChannels: Discord shows a placeholder in place of their real overwrites. Use discord_get_channel_permissions for a single channel.discord_list_members guild_id, limit, after
List members of a server with their roles, ordered by user ID. Returns { members: [...], nextCursor }. A page holds up to 1000 members; if nextCursor is non-null, pass it back as `after` to fetch the next page. Use discord_search_members to find specific members by name, or discord_get_member_info for one member's full details. Read-only.discord_get_member_info guild_id, user_id
Get full details for one server member: roles, effective permissions, account/join dates, bot flag, and current timeout status. Permissions come from the member's roles, server-wide: channel overwrites are not applied. The owner and Administrators list every flag. The permissions list ignores an active timeout, during which Discord keeps only View Channel and Read Message History. timedOutUntil can be a past date once a timeout has expired. To find a member by name use discord_search_members; to page through members use discord_list_members.
discord_kick_member guild_id, user_id, reason
Remove a member from the server. They can rejoin with a new invite (unlike a ban). Requires the Kick Members permission, and the bot's top role must be higher than the target's. Use discord_ban_member to block re-entry. The reason is recorded in the audit log.
discord_ban_member guild_id, user_id, reason, delete_message_days
Ban a user from the server, blocking re-entry until unbanned. Optionally bulk-deletes their recent messages. Requires the Ban Members permission, and the bot's top role must outrank the target's. Use discord_unban_member to reverse, or discord_kick_member for a non-permanent removal. The reason is recorded in the audit log.
discord_unban_member guild_id, user_id, reason
Lift a ban so the user may rejoin via a new invite. Requires the Ban Members permission. Reverses discord_ban_member. The reason is recorded in the audit log.
discord_timeout_member guild_id, user_id, duration_minutes, reason
Mute a member for a set duration (Discord 'timeout'): they cannot send messages, react, or speak until it expires. Pass duration_minutes = 0 to remove an active timeout early. Max 28 days (40320 minutes). Requires the Moderate Members permission. Discord refuses to time out the server owner or a member with Administrator.
discord_search_members guild_id, query, limit
Find server members whose username or nickname starts with a query string (prefix match). Returns { members: [...] } with id, username, nickname, roles. Use discord_list_members to page through everyone. Read-only.discord_set_nickname guild_id, user_id, nickname, reason
Set or clear a member's server nickname. Pass null (or the string 'null') to clear it. Requires the Manage Nicknames permission (or Change Nickname for the bot itself). To rename another member, their highest role must be below the bot's highest role. The reason is recorded in the audit log.
discord_list_bans guild_id, limit, after
List the users banned from the server, with their ban reasons. Returns { bans: [...], nextCursor }. A page holds up to 1000 bans; if nextCursor is non-null, pass it back as `after` to fetch the next page. Requires the Ban Members or View Audit Log permission. Read-only.discord_bulk_ban guild_id, user_ids, delete_message_seconds, dry_run, reason
Ban many users in a single call, intended for raid mitigation. SAFE BY DEFAULT: dry_run is true unless explicitly set to false, so call it first to preview the user IDs a real call would send to Discord, unchecked, then re-call with dry_run:false to actually ban them. Requires both the Ban Members and Manage Server permissions. Returns { dry_run, would_ban } for a preview, and { dry_run, banned, failed } with the user IDs after a real call; failed also lists users who were already banned. Discord rejects the whole call with an error if no user could be banned. Use discord_ban_member for a single ban with finer control.discord_prune_members guild_id, days, roles, dry_run, reason
Remove members who have been inactive (no roles, not seen) for a number of days. SAFE BY DEFAULT: dry_run is true unless explicitly set to false, so call it first to preview the count, then re-call with dry_run:false to actually remove them. Removal is irreversible (members must rejoin). Requires the Manage Server and Kick Members permissions (Administrator when the server has the PRUNE_REQUIRES_ADMIN feature).
discord_list_roles guild_id
List all roles in a server (excluding @everyone), highest-first, with color, position, member count, and permissions. Read-only. Returns { roles: [...] }. Use discord_get_role_members to see who holds a given role.discord_create_role guild_id, name, color, hoist, mentionable, permissions
Create a new role in a server. Requires the Manage Roles permission; the new role is placed below the bot's highest role. Use discord_add_role to then assign it to members. Returns the new role's name and ID. To change an existing role, use discord_edit_role.
discord_edit_role guild_id, role_id, name, color, hoist, mentionable, permissions
Update an existing role's name, color, permissions, hoist, or mentionable flag. Only provided fields change; passing permissions REPLACES the role's full permission set, and passing color sets a single solid color, removing any gradient or holographic colors. Requires the Manage Roles permission, and the role must be below the bot's highest role.
discord_delete_role guild_id, role_id, reason
Permanently delete a role from the server; it is automatically removed from every member who held it. IRREVERSIBLE. Requires the Manage Roles permission, and the role must be below the bot's highest role.
discord_add_role guild_id, user_id, role_id, reason
Assign an existing role to a member. Requires the Manage Roles permission, and the role must be below the bot's highest role. Idempotent: assigning a role the member already has has no effect. Use discord_remove_role to undo.
discord_remove_role guild_id, user_id, role_id, reason
Remove a role from a member. Requires the Manage Roles permission, and the role must be below the bot's highest role. Idempotent: removing a role the member doesn't have has no effect. Reverses discord_add_role.
discord_get_role_members guild_id, role_id
List members who currently hold a specific role, scanning up to 20,000 members. Returns { members: [...], truncated }; check `truncated` on very large servers. Read-only. Use discord_list_roles to discover role IDs first.discord_set_role_position guild_id, role_id, position
Move a role up or down in the server's role hierarchy, which determines permission precedence and member-list ordering. Higher position = higher in the list. Requires the Manage Roles permission, and the target position must be below the bot's highest role.
discord_set_role_icon guild_id, role_id, icon, unicode_emoji
Set or clear a role's icon, either a custom image or a unicode emoji. Requires the server to be Boost Level 2+ (the ROLE_ICONS feature) and the Manage Roles permission. Pass null to either field to remove that icon. Returns a confirmation.
discord_get_audit_log guild_id, limit, action_type
Fetch the server's audit log, the record of administrative actions (bans, kicks, role/channel changes, etc.) with who performed them and when. Requires the View Audit Log permission. Returns { entries: [...] } with id, action, executor, target, reason, createdAt. Read-only.discord_get_membership_screening guild_id
Fetch the server's membership screening form, the rules/questions new members must accept before gaining access. Requires the server to have the Community feature enabled. Read-only. Returns { version, description, form_fields } with each field's type, label, values, required flag and description; any other key Discord returns on a field is dropped.discord_update_membership_screening guild_id, description, form_fields
Update the server's membership screening form: set the welcome description and the rules new members must agree to. Only provided fields change. Passing form_fields replaces every existing field with TERMS rule blocks, which deletes any question field. Read the form first with discord_get_membership_screening. Requires the Community feature and the Manage Server permission. Returns the updated form.
discord_get_server_stats guild_id
Get a snapshot of server metrics: total members (humans vs cached bots), channel breakdown (text/voice/category), role count, boost tier and count, and creation date. Note: bots are counted from the member cache only, so botsInCache is a lower bound and humans (total minus cached bots) an upper bound. The roles count excludes @everyone. In channels, total covers every channel type plus the threads in the bot's cache, while text counts only text channels (not announcement), voice only voice channels (not stage), and categories only categories. With DISCORD_GUILD_MEMBERS=false, totalMembers is not updated after the bot connects. For the server's owner and description, use discord_get_guild_info.
discord_get_forum_channels guild_id
List the forum channels in a server (id, name, topic, parent category). From November 16, 2026, Discord leaves out forums the bot cannot view. Read-only. Use discord_get_forum_tags to see a forum's available tags, or discord_list_forum_threads for its posts.
discord_create_forum_channel guild_id, name, topic, category_id
Create a new forum channel in a server. A forum holds posts (threads) rather than a linear message feed. Requires the Manage Channels permission. Use discord_create_channel for text/voice channels instead. Returns the new channel's name and ID.
discord_create_forum_post forum_channel_id, title, content, applied_tags
Create a new post (a thread with a starter message) in a forum channel. Requires the Send Messages permission (Discord ignores Create Public Threads for forum posts). Use discord_reply_to_forum to add follow-up messages. Returns the new post's name and thread ID.
discord_get_forum_post thread_id, limit
Get a forum post's details (title, archived/locked state, applied tags, message count) plus its recent messages, oldest-to-newest. Read-only. Pass the post's thread_id. Requires the View Channel and Read Message History permissions on the forum; without Read Message History an empty message list fails with an error naming the permission. Returns a JSON object.
discord_list_forum_threads forum_channel_id, limit, before
List posts in a forum channel. Returns { threads: [...], hasMore, nextBefore }. The first call (no `before`) includes all active posts plus the first page of archived posts; archived posts are paginated, so if hasMore is true pass nextBefore back as `before` to fetch older archived posts. messageCount excludes the starter message and deleted messages, and is inaccurate above 50 for threads created before July 1, 2022. Use discord_get_forum_post to read one post's messages. For threads in a text or announcement channel, use discord_list_channel_threads.discord_reply_to_forum thread_id, content
Post a follow-up message inside an existing forum post (thread). Requires the Send Messages in Threads permission (shown as 'Send Messages in Posts' for forums). Use discord_create_forum_post to start a new post instead. Returns the new message ID.
discord_delete_forum_post thread_id
Permanently delete a forum post (thread) and all its messages. IRREVERSIBLE. To merely close it without deleting, use discord_update_forum_post with archived:true. Requires the Manage Threads permission.
discord_get_forum_tags forum_channel_id
List the tags available on a forum channel (id, name, emoji, emoji_id, moderated flag). Use these IDs with discord_create_forum_post or discord_update_forum_post; manage the tag set with discord_set_forum_tags. The emoji field holds a unicode emoji, or null when the tag has none or uses a custom server emoji. Fails when the channel is not a forum.
discord_set_forum_tags forum_channel_id, tags
Replace the full set of available tags on a forum channel with the provided list. Include every tag you want to keep: a listed tag whose name matches an existing tag (case-insensitive) keeps its ID and stays on posts, and keeps its emoji and moderated flag unless the input sets them. A tag left out is deleted from the forum, and posts that carried it keep its ID in applied_tags. Requires the Manage Channels permission. Returns a confirmation naming the tags created, deleted and changed, with the fields that changed.
discord_update_forum_post thread_id, title, archived, locked, applied_tags
Update a forum post's title, archived/locked state, or applied tags. Only provided fields change; passing applied_tags replaces the post's tags. Set archived:true to close a post without deleting it; archiving a pinned post unpins it. Requires the Manage Threads permission. To change which tags the forum offers, use discord_set_forum_tags; this tool picks among the forum's existing tags for one post.
discord_create_webhook channel_id, name, avatar
Create a webhook on a channel and return its ID and token. SECURITY: the returned token grants anyone the ability to post as this webhook without authentication; treat it as a secret. Requires the Manage Webhooks permission. Use the returned id+token with discord_send_webhook_message. On a forum or media channel, discord_send_webhook_message cannot post through the webhook, since Discord then requires a thread.
discord_send_webhook_message webhook_id, webhook_token, content, username, avatar_url, embeds
Send a message through a webhook using its ID and token (no bot permissions needed; the token authorizes the send). Supports per-message username/avatar overrides and up to 10 embeds. At least one of content or embeds is required. Returns the new message ID.
discord_edit_webhook webhook_id, name, avatar, channel_id
Update a webhook's name, avatar, or the channel it posts to. Only provided fields change. Requires the Manage Webhooks permission. Returns a confirmation.
discord_delete_webhook webhook_id
Permanently delete a webhook by its ID, invalidating its token. IRREVERSIBLE: any integrations using the old token will stop working. Requires the Manage Webhooks permission. To remove one message the webhook sent, use discord_delete_webhook_message instead; discord_list_webhooks finds the ID.
discord_list_webhooks channel_id, guild_id
List the webhooks in a single channel or across a whole server (id, name, channel, token when visible, creator). Provide channel_id or guild_id; when both are given, only channel_id is used. Requires the Manage Webhooks permission. SECURITY: a returned token lets anyone post as that webhook; treat it as a secret. Pass the id and token to discord_send_webhook_message, or create a webhook with discord_create_webhook.
discord_edit_webhook_message webhook_id, webhook_token, message_id, content, embeds
Edit a message previously sent through a webhook, using the webhook's ID and token. Replaces the provided fields. No bot permission is needed: the token authorizes the edit. For a message the bot sent itself, use discord_edit_message or discord_edit_embed. Returns a confirmation.
discord_delete_webhook_message webhook_id, webhook_token, message_id
Permanently delete a message that was sent through a webhook, using the webhook's ID and token. IRREVERSIBLE. No bot permission is needed: the token authorizes the call. To delete the webhook itself, use discord_delete_webhook.
discord_fetch_webhook_message webhook_id, webhook_token, message_id
Fetch a single message sent through a webhook (id, content, embed count, timestamp), using the webhook's ID and token. Read-only. Requires the original webhook token.
discord_list_scheduled_events guild_id
List all scheduled events in a server (id, name, status, type, time, location, interested count). Read-only. Use discord_get_scheduled_event for one event's full details.
discord_get_scheduled_event guild_id, event_id
Get full details for one scheduled event: name, description, status, type, channel/location, start/end times, creator, and interested-user count. Status is SCHEDULED, ACTIVE, COMPLETED or CANCELED, and entity_type is VOICE, STAGE_INSTANCE or EXTERNAL. Find the event_id with discord_list_scheduled_events; list the interested users with discord_get_event_subscribers.
discord_create_scheduled_event guild_id, name, description, entity_type, scheduled_start_time, scheduled_end_time, channel_id, location, image
Create a scheduled event. For 'VOICE'/'STAGE_INSTANCE' events provide channel_id; for 'EXTERNAL' events provide location AND scheduled_end_time. Requires the Create Events permission (Manage Events alone no longer suffices), plus View Channel and Connect in the channel for VOICE events, or Manage Channels, Mute Members and Move Members for STAGE_INSTANCE events. Returns the new event's name and ID. To change, start or cancel an existing event, use discord_edit_scheduled_event.
discord_edit_scheduled_event guild_id, event_id, name, description, scheduled_start_time, scheduled_end_time, channel_id, location, image, status
Update a scheduled event; only provided fields change. Use the status field to start ('ACTIVE'), end ('COMPLETED'), or cancel ('CANCELED') an event; Discord only allows certain status transitions. Discord rejects a location on VOICE and STAGE_INSTANCE events. An ACTIVE voice or stage event ends on its own a few minutes after its channel empties. Requires the Manage Events permission, or Create Events for an event the bot created, plus the same channel permissions as creating it.discord_delete_scheduled_event guild_id, event_id
Permanently delete a scheduled event. IRREVERSIBLE. To cancel an event while keeping a record, use discord_edit_scheduled_event with status:'CANCELED' instead. Requires the Manage Events permission, or Create Events for an event the bot created, plus the same channel permissions as creating it.
discord_get_event_subscribers guild_id, event_id, limit, after
List the users who marked themselves 'Interested' in a scheduled event. Returns { subscribers: [...], nextCursor }. A page holds up to 100 users; if nextCursor is non-null, pass it back as `after` to fetch the next page. Read-only.discord_create_event_invite guild_id, event_id, channel_id, max_age, max_uses
Create a shareable invite URL that points to a scheduled event, so recipients land on the event when joining. Requires the Create Instant Invite permission. Returns the invite URL; Discord may reuse a similar existing invite instead of creating a new one. EXTERNAL events need channel_id; other events reject it and use their own channel. The URL is an ordinary channel invite with ?event=<event ID> appended. Use discord_create_invite for a channel invite with the unique or temporary options.
discord_list_invites guild_id
List all active invites across a server (code, url, channel, inviter, uses, expiry). Requires the Manage Server or View Audit Log permission; without Manage Server or Manage Channels, Discord omits invite metadata, so uses, max_uses and max_age read 0, temporary reads false and created_at null. Read-only. Use discord_list_channel_invites to scope to one channel.
discord_get_invite invite_code
Look up a single invite by its code: target server and channel, inviter, and expiry. Works for any public invite, limited to the DISCORD_ALLOWED_GUILDS servers when that allow-list is set. This endpoint never returns invite metadata (uses/max_uses/max_age read 0, temporary reads false and created_at null); use discord_list_invites or discord_list_channel_invites for real counters. Read-only. Returns a JSON object.
discord_create_invite channel_id, max_age, max_uses, unique, temporary
Create an invite link for a channel, optionally limiting its lifetime, uses, and membership type. SECURITY: anyone with the returned link can join the server. Requires the Create Instant Invite permission. Returns the invite URL and code.
discord_delete_invite invite_code, reason
Revoke an invite by its code so it can no longer be used. IRREVERSIBLE (the code is freed). Requires the Manage Channels permission (or Manage Server). The reason is recorded in the audit log.
discord_list_channel_invites channel_id
List the active invites that point to one specific channel. Unlike discord_list_invites (server-wide), this scopes results to a single channel. Requires the Manage Channels permission. Read-only.
discord_send_dm user_id, content
Send a private direct message to a user by their user ID. Use discord_send_message to post in a server channel instead. Requires the bot to share at least one server with the user, and the user must allow DMs from server members (otherwise Discord rejects the send). Returns the new message ID.
discord_send_dm_embed user_id, content, title, url, description, color, fields, author, thumbnail_url, footer, image_url, timestamp
Send a rich embed as a private direct message to a user. Use discord_send_dm for plain text, or discord_send_embed to post an embed in a channel. Requires the bot to share a server with the user, and the user must allow DMs from server members. Returns the new message ID.
discord_edit_dm user_id, message_id, content
Edit the text content of a DM message previously sent by this bot. Only the bot's own DM messages can be edited. Use discord_edit_dm_embed for embed messages. Returns a confirmation.
discord_edit_dm_embed user_id, message_id, content, title, url, description, color, fields, author, thumbnail_url, footer, image_url, timestamp
Replace the embed on a DM message previously sent by this bot. Full replace, not merge: provided fields are applied and omitted fields are dropped. Omitting content, or passing an empty string, keeps the message's current text; this tool cannot clear it. Use discord_edit_dm to change only the text, or discord_edit_embed for a message in a server channel. Returns a confirmation.
discord_delete_dm user_id, message_id
Permanently delete a DM message previously sent by this bot. IRREVERSIBLE. The bot can only delete its own DM messages, not the recipient's. Returns a confirmation.
discord_read_dms user_id, limit
Read the most recent messages from the bot's DM conversation with a user, oldest-to-newest. Returns { messages: [...] } with id, author, content, embed count, timestamp. Read-only.discord_reply_dm user_id, message_id, content
Reply to a specific message in a DM, attaching a quoted reply reference. Unlike the edit/delete DM tools, this works on the bot's messages and the user's alike, though Discord refuses some system messages as reply targets. Use discord_send_dm for a standalone DM with no reference. Returns the new reply's message ID.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | MIT |
|---|---|
| Needs | node >=22.0.0 |
| Source | github.com/PaSympa/discord-mcp |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-xYG29zeUGOdDwvr0y+tL53e6kMD178j+3DH6ZCpL9GDW6mahO6Sq/T8TyFSvtK0OK6WEdBmyJ/5D1szKaLkwSQ== |
Versions reported
| Version | Run | Result | Tools |
|---|---|---|---|
| 2.4.0 | 2026-11-16 | Starts with no setup | 100 |
| 2.3.0 | 2026-11-12 | Starts with no setup | 100 |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/%40pasympa/discord-mcp)
New version out? Ask for a fresh report.