# discord-mcp > An MCP server that connects Claude, Codex, Cursor, VS Code and other MCP clients to your Discord server through your own bot. 100 tools in 14 toolsets, dry runs for mass actions, a read-only mode. Version 2.4.0. Run it with `npx -y @pasympa/discord-mcp` and your bot's token in `DISCORD_TOKEN`. Each tool line gives its purpose (the first sentence of its description) and its risk: read-only, write or destructive. Toolset names in headings are the values of `DISCORD_MCP_TOOLSETS`. ## Documentation - [Guide](https://pasympa.github.io/discord-mcp/guide/): setup and every client. - [Recipes](https://pasympa.github.io/discord-mcp/recipes/): whole tasks, prompt by prompt. - [Configuration](https://pasympa.github.io/discord-mcp/configuration/): every variable. - [Troubleshooting](https://pasympa.github.io/discord-mcp/troubleshooting/): errors and FAQ. ## Toolsets One page per toolset, with its tools, risk mix, context cost and the README profiles that include it. [All toolsets](https://pasympa.github.io/discord-mcp/toolsets/) is where you build the `DISCORD_MCP_TOOLSETS` line. - [Discovery](https://pasympa.github.io/discord-mcp/toolsets/discovery/): `discovery`, 4 tools, 4 read-only, about 1.2k tokens. - [Messages](https://pasympa.github.io/discord-mcp/toolsets/messages/): `messages`, 21 tools, 7 read-only, about 9.2k tokens. - [Channels](https://pasympa.github.io/discord-mcp/toolsets/channels/): `channels`, 8 tools, none read-only, about 1.9k tokens. - [Permissions](https://pasympa.github.io/discord-mcp/toolsets/permissions/): `permissions`, 6 tools, 2 read-only, about 1.9k tokens. - [Members](https://pasympa.github.io/discord-mcp/toolsets/members/): `members`, 11 tools, 4 read-only, about 3.6k tokens. - [Roles](https://pasympa.github.io/discord-mcp/toolsets/roles/): `roles`, 9 tools, 2 read-only, about 2.4k tokens. - [Moderation](https://pasympa.github.io/discord-mcp/toolsets/moderation/): `moderation`, 1 tool, 1 read-only, about 0.4k tokens. - [Screening](https://pasympa.github.io/discord-mcp/toolsets/screening/): `screening`, 2 tools, 1 read-only, about 0.7k tokens. - [Stats](https://pasympa.github.io/discord-mcp/toolsets/stats/): `stats`, 1 tool, 1 read-only, about 0.4k tokens. - [Forums](https://pasympa.github.io/discord-mcp/toolsets/forums/): `forums`, 10 tools, 4 read-only, about 3.3k tokens. - [Webhooks](https://pasympa.github.io/discord-mcp/toolsets/webhooks/): `webhooks`, 8 tools, 2 read-only, about 3.0k tokens. - [Scheduled events](https://pasympa.github.io/discord-mcp/toolsets/scheduled_events/): `scheduled_events`, 7 tools, 3 read-only, about 3.0k tokens. - [Invites](https://pasympa.github.io/discord-mcp/toolsets/invites/): `invites`, 5 tools, 3 read-only, about 1.7k tokens. - [Direct messages](https://pasympa.github.io/discord-mcp/toolsets/dm/): `dm`, 7 tools, 1 read-only, about 2.4k tokens. ## Discovery (`discovery`) - [discord_list_guilds](https://pasympa.github.io/discord-mcp/tools/discord_list_guilds/): List the Discord servers (guilds) the bot is a member of (id, name, member count, icon). Risk: read-only. - [discord_get_guild_info](https://pasympa.github.io/discord-mcp/tools/discord_get_guild_info/): Get details about one server: name, description, member/channel/role counts, boost tier, owner, and creation date. Risk: read-only. - [discord_list_channels](https://pasympa.github.io/discord-mcp/tools/discord_list_channels/): List all channels in a server, grouped by their parent category and ordered by position. Risk: read-only. - [discord_find_channel_by_name](https://pasympa.github.io/discord-mcp/tools/discord_find_channel_by_name/): Find channels whose name contains a substring (case-insensitive). Risk: read-only. ## Messages (`messages`) - [discord_read_messages](https://pasympa.github.io/discord-mcp/tools/discord_read_messages/): Read messages from a text channel or thread, oldest-to-newest. Risk: read-only. - [discord_send_message](https://pasympa.github.io/discord-mcp/tools/discord_send_message/): Send a plain-text message to a channel or thread. Risk: write. - [discord_reply_message](https://pasympa.github.io/discord-mcp/tools/discord_reply_message/): Reply to a specific message, attaching a reply reference so clients show it as a threaded reply. Risk: write. - [discord_edit_message](https://pasympa.github.io/discord-mcp/tools/discord_edit_message/): Edit the text content of a message previously sent by this bot. Risk: write. - [discord_add_reaction](https://pasympa.github.io/discord-mcp/tools/discord_add_reaction/): Add a single emoji reaction to a message as the bot. Risk: write. - [discord_list_channel_threads](https://pasympa.github.io/discord-mcp/tools/discord_list_channel_threads/): List the threads in a text or announcement channel. Risk: read-only. - [discord_create_thread](https://pasympa.github.io/discord-mcp/tools/discord_create_thread/): Create a thread, either branching from an existing message (pass message_id) or as a standalone thread in a text channel (omit message_id). Risk: write. - [discord_bulk_delete_messages](https://pasympa.github.io/discord-mcp/tools/discord_bulk_delete_messages/): Permanently delete multiple recent messages in one call. Risk: destructive, dry run by default. - [discord_send_embed](https://pasympa.github.io/discord-mcp/tools/discord_send_embed/): Send a single rich embed (title, description, color, fields, author, footer, images, timestamp). Risk: write. - [discord_edit_embed](https://pasympa.github.io/discord-mcp/tools/discord_edit_embed/): Replace the embed on a message previously sent by this bot. Risk: write. - [discord_send_multiple_embeds](https://pasympa.github.io/discord-mcp/tools/discord_send_multiple_embeds/): Send up to 10 embeds in a single message, with optional text above them. Risk: write. - [discord_delete_message](https://pasympa.github.io/discord-mcp/tools/discord_delete_message/): Permanently delete one specific message. Risk: destructive. - [discord_pin_message](https://pasympa.github.io/discord-mcp/tools/discord_pin_message/): Pin or unpin a message in a channel, controlled by the pin flag. Risk: write. - [discord_search_messages](https://pasympa.github.io/discord-mcp/tools/discord_search_messages/): Keyword search over a channel's recent messages using case-insensitive substring matching. Risk: read-only. - [discord_search_guild_messages](https://pasympa.github.io/discord-mcp/tools/discord_search_guild_messages/): Search for messages across all channels in a guild using Discord's native search API. Risk: read-only. - [discord_crosspost_message](https://pasympa.github.io/discord-mcp/tools/discord_crosspost_message/): Publish (crosspost) a message from an Announcement channel to every server that follows it. Risk: write. - [discord_remove_reactions](https://pasympa.github.io/discord-mcp/tools/discord_remove_reactions/): Remove reactions from a message. Risk: destructive. - [discord_get_reactions](https://pasympa.github.io/discord-mcp/tools/discord_get_reactions/): List the users who reacted to a message with a specific emoji. Risk: read-only. - [discord_get_message_attachments](https://pasympa.github.io/discord-mcp/tools/discord_get_message_attachments/): List the file attachments of a message. Risk: read-only. - [discord_fetch_pinned_messages](https://pasympa.github.io/discord-mcp/tools/discord_fetch_pinned_messages/): List a channel's pinned messages, most recently pinned first. Risk: read-only. - [discord_forward_message](https://pasympa.github.io/discord-mcp/tools/discord_forward_message/): Forward an existing message to another channel using Discord's native forward, which links back to the original message. Risk: write. ## Channels (`channels`) - [discord_create_channel](https://pasympa.github.io/discord-mcp/tools/discord_create_channel/): Create a text channel, voice channel, or category in a server. Risk: write. - [discord_delete_channel](https://pasympa.github.io/discord-mcp/tools/discord_delete_channel/): Permanently delete a channel and all of its messages. Risk: destructive, dry run by default. - [discord_edit_channel](https://pasympa.github.io/discord-mcp/tools/discord_edit_channel/): Update a channel's name, topic, slowmode, or NSFW flag. Risk: write. - [discord_move_channel](https://pasympa.github.io/discord-mcp/tools/discord_move_channel/): Move a channel into a category, or remove it from its category when category_id is omitted. Risk: write. - [discord_clone_channel](https://pasympa.github.io/discord-mcp/tools/discord_clone_channel/): Create a copy of a channel, including its name, topic, and permission overwrites (but not its messages). Risk: write. - [discord_set_channel_position](https://pasympa.github.io/discord-mcp/tools/discord_set_channel_position/): Set a channel's display order among the channels of its kind in its category. Risk: write. - [discord_follow_announcement_channel](https://pasympa.github.io/discord-mcp/tools/discord_follow_announcement_channel/): Subscribe a target channel to an announcement (news) channel, so the source's published messages are reposted into the target. Risk: write. - [discord_lock_channel_permissions](https://pasympa.github.io/discord-mcp/tools/discord_lock_channel_permissions/): Reset a channel's permission overwrites to exactly match its parent category (Discord's 'sync permissions'). Risk: write. ## Permissions (`permissions`) - [discord_get_channel_permissions](https://pasympa.github.io/discord-mcp/tools/discord_get_channel_permissions/): List every permission overwrite on a channel, per role and per member, with the allowed and denied permission flags for each. Risk: read-only. - [discord_set_role_permission](https://pasympa.github.io/discord-mcp/tools/discord_set_role_permission/): Add or update a per-channel permission overwrite for a role, allowing and/or denying specific permissions. Risk: write. - [discord_set_member_permission](https://pasympa.github.io/discord-mcp/tools/discord_set_member_permission/): Add or update a per-channel permission overwrite for a single member, allowing and/or denying specific permissions. Risk: write. - [discord_reset_channel_permissions](https://pasympa.github.io/discord-mcp/tools/discord_reset_channel_permissions/): Remove ALL permission overwrites on a channel, so only role/server-level permissions apply. Risk: destructive. - [discord_copy_permissions](https://pasympa.github.io/discord-mcp/tools/discord_copy_permissions/): Replace the target channel's permission overwrites with a copy of the source channel's. Risk: destructive. - [discord_audit_permissions](https://pasympa.github.io/discord-mcp/tools/discord_audit_permissions/): Generate a server-wide permission report: for every channel that has overwrites, lists each role/member and their allowed/denied permissions (entity names resolved). Risk: read-only. ## Members (`members`) - [discord_list_members](https://pasympa.github.io/discord-mcp/tools/discord_list_members/): List members of a server with their roles, ordered by user ID. Risk: read-only. - [discord_get_member_info](https://pasympa.github.io/discord-mcp/tools/discord_get_member_info/): Get full details for one server member: roles, effective permissions, account/join dates, bot flag, and current timeout status. Risk: read-only. - [discord_kick_member](https://pasympa.github.io/discord-mcp/tools/discord_kick_member/): Remove a member from the server. Risk: destructive. - [discord_ban_member](https://pasympa.github.io/discord-mcp/tools/discord_ban_member/): Ban a user from the server, blocking re-entry until unbanned. Risk: destructive. - [discord_unban_member](https://pasympa.github.io/discord-mcp/tools/discord_unban_member/): Lift a ban so the user may rejoin via a new invite. Risk: write. - [discord_timeout_member](https://pasympa.github.io/discord-mcp/tools/discord_timeout_member/): Mute a member for a set duration (Discord 'timeout'): they cannot send messages, react, or speak until it expires. Risk: write. - [discord_search_members](https://pasympa.github.io/discord-mcp/tools/discord_search_members/): Find server members whose username or nickname starts with a query string (prefix match). Risk: read-only. - [discord_set_nickname](https://pasympa.github.io/discord-mcp/tools/discord_set_nickname/): Set or clear a member's server nickname. Risk: write. - [discord_list_bans](https://pasympa.github.io/discord-mcp/tools/discord_list_bans/): List the users banned from the server, with their ban reasons. Risk: read-only. - [discord_bulk_ban](https://pasympa.github.io/discord-mcp/tools/discord_bulk_ban/): Ban many users in a single call, intended for raid mitigation. Risk: destructive, dry run by default. - [discord_prune_members](https://pasympa.github.io/discord-mcp/tools/discord_prune_members/): Remove members who have been inactive (no roles, not seen) for a number of days. Risk: destructive, dry run by default. ## Roles (`roles`) - [discord_list_roles](https://pasympa.github.io/discord-mcp/tools/discord_list_roles/): List all roles in a server (excluding @everyone), highest-first, with color, position, member count, and permissions. Risk: read-only. - [discord_create_role](https://pasympa.github.io/discord-mcp/tools/discord_create_role/): Create a new role in a server. Risk: write. - [discord_edit_role](https://pasympa.github.io/discord-mcp/tools/discord_edit_role/): Update an existing role's name, color, permissions, hoist, or mentionable flag. Risk: write. - [discord_delete_role](https://pasympa.github.io/discord-mcp/tools/discord_delete_role/): Permanently delete a role from the server; it is automatically removed from every member who held it. Risk: destructive. - [discord_add_role](https://pasympa.github.io/discord-mcp/tools/discord_add_role/): Assign an existing role to a member. Risk: write. - [discord_remove_role](https://pasympa.github.io/discord-mcp/tools/discord_remove_role/): Remove a role from a member. Risk: write. - [discord_get_role_members](https://pasympa.github.io/discord-mcp/tools/discord_get_role_members/): List members who currently hold a specific role, scanning up to 20,000 members. Risk: read-only. - [discord_set_role_position](https://pasympa.github.io/discord-mcp/tools/discord_set_role_position/): Move a role up or down in the server's role hierarchy, which determines permission precedence and member-list ordering. Risk: write. - [discord_set_role_icon](https://pasympa.github.io/discord-mcp/tools/discord_set_role_icon/): Set or clear a role's icon, either a custom image or a unicode emoji. Risk: write. ## Moderation (`moderation`) - [discord_get_audit_log](https://pasympa.github.io/discord-mcp/tools/discord_get_audit_log/): Fetch the server's audit log, the record of administrative actions (bans, kicks, role/channel changes, etc.) with who performed them and when. Risk: read-only. ## Screening (`screening`) - [discord_get_membership_screening](https://pasympa.github.io/discord-mcp/tools/discord_get_membership_screening/): Fetch the server's membership screening form, the rules/questions new members must accept before gaining access. Risk: read-only. - [discord_update_membership_screening](https://pasympa.github.io/discord-mcp/tools/discord_update_membership_screening/): Update the server's membership screening form: set the welcome description and the rules new members must agree to. Risk: write. ## Stats (`stats`) - [discord_get_server_stats](https://pasympa.github.io/discord-mcp/tools/discord_get_server_stats/): 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. Risk: read-only. ## Forums (`forums`) - [discord_get_forum_channels](https://pasympa.github.io/discord-mcp/tools/discord_get_forum_channels/): List the forum channels in a server (id, name, topic, parent category). Risk: read-only. - [discord_create_forum_channel](https://pasympa.github.io/discord-mcp/tools/discord_create_forum_channel/): Create a new forum channel in a server. Risk: write. - [discord_create_forum_post](https://pasympa.github.io/discord-mcp/tools/discord_create_forum_post/): Create a new post (a thread with a starter message) in a forum channel. Risk: write. - [discord_get_forum_post](https://pasympa.github.io/discord-mcp/tools/discord_get_forum_post/): Get a forum post's details (title, archived/locked state, applied tags, message count) plus its recent messages, oldest-to-newest. Risk: read-only. - [discord_list_forum_threads](https://pasympa.github.io/discord-mcp/tools/discord_list_forum_threads/): List posts in a forum channel. Risk: read-only. - [discord_reply_to_forum](https://pasympa.github.io/discord-mcp/tools/discord_reply_to_forum/): Post a follow-up message inside an existing forum post (thread). Risk: write. - [discord_delete_forum_post](https://pasympa.github.io/discord-mcp/tools/discord_delete_forum_post/): Permanently delete a forum post (thread) and all its messages. Risk: destructive. - [discord_get_forum_tags](https://pasympa.github.io/discord-mcp/tools/discord_get_forum_tags/): List the tags available on a forum channel (id, name, emoji, emoji_id, moderated flag). Risk: read-only. - [discord_set_forum_tags](https://pasympa.github.io/discord-mcp/tools/discord_set_forum_tags/): Replace the full set of available tags on a forum channel with the provided list. Risk: destructive. - [discord_update_forum_post](https://pasympa.github.io/discord-mcp/tools/discord_update_forum_post/): Update a forum post's title, archived/locked state, or applied tags. Risk: write. ## Webhooks (`webhooks`) - [discord_create_webhook](https://pasympa.github.io/discord-mcp/tools/discord_create_webhook/): Create a webhook on a channel and return its ID and token. Risk: write. - [discord_send_webhook_message](https://pasympa.github.io/discord-mcp/tools/discord_send_webhook_message/): Send a message through a webhook using its ID and token (no bot permissions needed; the token authorizes the send). Risk: write. - [discord_edit_webhook](https://pasympa.github.io/discord-mcp/tools/discord_edit_webhook/): Update a webhook's name, avatar, or the channel it posts to. Risk: write. - [discord_delete_webhook](https://pasympa.github.io/discord-mcp/tools/discord_delete_webhook/): Permanently delete a webhook by its ID, invalidating its token. Risk: destructive. - [discord_list_webhooks](https://pasympa.github.io/discord-mcp/tools/discord_list_webhooks/): List the webhooks in a single channel or across a whole server (id, name, channel, token when visible, creator). Risk: read-only. - [discord_edit_webhook_message](https://pasympa.github.io/discord-mcp/tools/discord_edit_webhook_message/): Edit a message previously sent through a webhook, using the webhook's ID and token. Risk: write. - [discord_delete_webhook_message](https://pasympa.github.io/discord-mcp/tools/discord_delete_webhook_message/): Permanently delete a message that was sent through a webhook, using the webhook's ID and token. Risk: destructive. - [discord_fetch_webhook_message](https://pasympa.github.io/discord-mcp/tools/discord_fetch_webhook_message/): Fetch a single message sent through a webhook (id, content, embed count, timestamp), using the webhook's ID and token. Risk: read-only. ## Scheduled events (`scheduled_events`) - [discord_list_scheduled_events](https://pasympa.github.io/discord-mcp/tools/discord_list_scheduled_events/): List all scheduled events in a server (id, name, status, type, time, location, interested count). Risk: read-only. - [discord_get_scheduled_event](https://pasympa.github.io/discord-mcp/tools/discord_get_scheduled_event/): Get full details for one scheduled event: name, description, status, type, channel/location, start/end times, creator, and interested-user count. Risk: read-only. - [discord_create_scheduled_event](https://pasympa.github.io/discord-mcp/tools/discord_create_scheduled_event/): Create a scheduled event. Risk: write. - [discord_edit_scheduled_event](https://pasympa.github.io/discord-mcp/tools/discord_edit_scheduled_event/): Update a scheduled event; only provided fields change. Risk: write. - [discord_delete_scheduled_event](https://pasympa.github.io/discord-mcp/tools/discord_delete_scheduled_event/): Permanently delete a scheduled event. Risk: destructive. - [discord_get_event_subscribers](https://pasympa.github.io/discord-mcp/tools/discord_get_event_subscribers/): List the users who marked themselves 'Interested' in a scheduled event. Risk: read-only. - [discord_create_event_invite](https://pasympa.github.io/discord-mcp/tools/discord_create_event_invite/): Create a shareable invite URL that points to a scheduled event, so recipients land on the event when joining. Risk: write. ## Invites (`invites`) - [discord_list_invites](https://pasympa.github.io/discord-mcp/tools/discord_list_invites/): List all active invites across a server (code, url, channel, inviter, uses, expiry). Risk: read-only. - [discord_get_invite](https://pasympa.github.io/discord-mcp/tools/discord_get_invite/): Look up a single invite by its code: target server and channel, inviter, and expiry. Risk: read-only. - [discord_create_invite](https://pasympa.github.io/discord-mcp/tools/discord_create_invite/): Create an invite link for a channel, optionally limiting its lifetime, uses, and membership type. Risk: write. - [discord_delete_invite](https://pasympa.github.io/discord-mcp/tools/discord_delete_invite/): Revoke an invite by its code so it can no longer be used. Risk: destructive. - [discord_list_channel_invites](https://pasympa.github.io/discord-mcp/tools/discord_list_channel_invites/): List the active invites that point to one specific channel. Risk: read-only. ## Direct messages (`dm`) - [discord_send_dm](https://pasympa.github.io/discord-mcp/tools/discord_send_dm/): Send a private direct message to a user by their user ID. Risk: write. - [discord_send_dm_embed](https://pasympa.github.io/discord-mcp/tools/discord_send_dm_embed/): Send a rich embed as a private direct message to a user. Risk: write. - [discord_edit_dm](https://pasympa.github.io/discord-mcp/tools/discord_edit_dm/): Edit the text content of a DM message previously sent by this bot. Risk: write. - [discord_edit_dm_embed](https://pasympa.github.io/discord-mcp/tools/discord_edit_dm_embed/): Replace the embed on a DM message previously sent by this bot. Risk: write. - [discord_delete_dm](https://pasympa.github.io/discord-mcp/tools/discord_delete_dm/): Permanently delete a DM message previously sent by this bot. Risk: destructive. - [discord_read_dms](https://pasympa.github.io/discord-mcp/tools/discord_read_dms/): Read the most recent messages from the bot's DM conversation with a user, oldest-to-newest. Risk: read-only. - [discord_reply_dm](https://pasympa.github.io/discord-mcp/tools/discord_reply_dm/): Reply to a specific message in a DM, attaching a quoted reply reference. Risk: write. ## Optional - [tools.json](https://pasympa.github.io/discord-mcp/tools.json): the 100 tool definitions as `tools/list` serves them, with toolset, risk and estimated token cost. - [Tool catalog](https://pasympa.github.io/discord-mcp/tools/): search, risk and toolset filters, and each tool's schemas. - [README](https://github.com/PaSympa/discord-mcp#readme): the project README.