discord-mcp

Tools

100 tools in 14 toolsets, generated from the server's own tools/list: what each one can change, what it returns, and what it costs in context. To load fewer of them, build your toolset line.

Showing all 100 tools

Discovery

discovery 4 tools: 4 read-only, ~1.2k tokens

Find servers and channels, and the IDs most other tools need.

  1. Read-only List servers discord_list_guilds List the Discord servers (guilds) the bot is a member of (id, name, member count, icon). ~225 tokens
  2. Read-only Get server info discord_get_guild_info Get details about one server: name, description, member/channel/role counts, boost tier, owner, and creation date. ~316 tokens
  3. Read-only List channels discord_list_channels List all channels in a server, grouped by their parent category and ordered by position. ~259 tokens
  4. Read-only Find channel by name discord_find_channel_by_name Find channels whose name contains a substring (case-insensitive). ~369 tokens

Messages

messages 21 tools: 7 read-only, 11 write, 3 destructive, ~9.2k tokens

Read, search, send, edit, react to, pin, forward and delete messages, and manage threads.

  1. Read-only Read messages discord_read_messages Read messages from a text channel or thread, oldest-to-newest. ~981 tokens
  2. Write Send message discord_send_message Send a plain-text message to a channel or thread. ~197 tokens
  3. Write Reply to message discord_reply_message Reply to a specific message, attaching a reply reference so clients show it as a threaded reply. ~241 tokens
  4. Write Edit message discord_edit_message Edit the text content of a message previously sent by this bot. ~257 tokens
  5. Write Add reaction discord_add_reaction Add a single emoji reaction to a message as the bot. ~234 tokens
  6. Read-only List channel threads discord_list_channel_threads List the threads in a text or announcement channel. ~627 tokens
  7. Write Create thread 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). ~321 tokens
  8. Destructive Bulk delete messagesDry run by default discord_bulk_delete_messages Permanently delete multiple recent messages in one call. ~286 tokens
  9. Write Send embed discord_send_embed Send a single rich embed (title, description, color, fields, author, footer, images, timestamp). ~619 tokens
  10. Write Edit embed discord_edit_embed Replace the embed on a message previously sent by this bot. ~677 tokens
  11. Write Send multiple embeds discord_send_multiple_embeds Send up to 10 embeds in a single message, with optional text above them. ~669 tokens
  12. Destructive Delete message discord_delete_message Permanently delete one specific message. ~264 tokens
  13. Write Pin or unpin message discord_pin_message Pin or unpin a message in a channel, controlled by the pin flag. ~246 tokens
  14. Read-only Search messages discord_search_messages Keyword search over a channel's recent messages using case-insensitive substring matching. ~557 tokens
  15. Read-only Search guild messages discord_search_guild_messages Search for messages across all channels in a guild using Discord's native search API. ~615 tokens
  16. Write Crosspost message discord_crosspost_message Publish (crosspost) a message from an Announcement channel to every server that follows it. ~219 tokens
  17. Destructive Remove reactions discord_remove_reactions Remove reactions from a message. ~309 tokens
  18. Read-only Get reactions discord_get_reactions List the users who reacted to a message with a specific emoji. ~342 tokens
  19. Read-only Get message attachments discord_get_message_attachments List the file attachments of a message. ~519 tokens
  20. Read-only Fetch pinned messages discord_fetch_pinned_messages List a channel's pinned messages, most recently pinned first. ~687 tokens
  21. Write Forward message discord_forward_message Forward an existing message to another channel using Discord's native forward, which links back to the original message. ~329 tokens

Channels

channels 8 tools: 7 write, 1 destructive, ~1.9k tokens

Create, edit, move, clone, follow and delete channels.

  1. Write Create channel discord_create_channel Create a text channel, voice channel, or category in a server. ~269 tokens
  2. Destructive Delete channelDry run by default discord_delete_channel Permanently delete a channel and all of its messages. ~280 tokens
  3. Write Edit channel discord_edit_channel Update a channel's name, topic, slowmode, or NSFW flag. ~292 tokens
  4. Write Move channel discord_move_channel Move a channel into a category, or remove it from its category when category_id is omitted. ~189 tokens
  5. Write Clone channel discord_clone_channel Create a copy of a channel, including its name, topic, and permission overwrites (but not its messages). ~213 tokens
  6. Write Set channel position discord_set_channel_position Set a channel's display order among the channels of its kind in its category. ~253 tokens
  7. Write Follow announcement channel discord_follow_announcement_channel Subscribe a target channel to an announcement (news) channel, so the source's published messages are reposted into the target. ~216 tokens
  8. Write Sync channel permissions discord_lock_channel_permissions Reset a channel's permission overwrites to exactly match its parent category (Discord's 'sync permissions'). ~208 tokens

Permissions

permissions 6 tools: 2 read-only, 2 write, 2 destructive, ~1.9k tokens

Inspect, set, copy and reset channel permission overwrites.

  1. Read-only Get channel permissions 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. ~292 tokens
  2. Write Set role channel permission discord_set_role_permission Add or update a per-channel permission overwrite for a role, allowing and/or denying specific permissions. ~414 tokens
  3. Write Set member channel permission discord_set_member_permission Add or update a per-channel permission overwrite for a single member, allowing and/or denying specific permissions. ~333 tokens
  4. Destructive Reset channel permissions discord_reset_channel_permissions Remove ALL permission overwrites on a channel, so only role/server-level permissions apply. ~206 tokens
  5. Destructive Copy channel permissions discord_copy_permissions Replace the target channel's permission overwrites with a copy of the source channel's. ~301 tokens
  6. Read-only Audit permissions 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). ~390 tokens

Members

members 11 tools: 4 read-only, 3 write, 4 destructive, ~3.6k tokens

List and search members, set nicknames, and kick, ban, time out or prune.

  1. Read-only List members discord_list_members List members of a server with their roles, ordered by user ID. ~397 tokens
  2. Read-only Get member info discord_get_member_info Get full details for one server member: roles, effective permissions, account/join dates, bot flag, and current timeout status. ~412 tokens
  3. Destructive Kick member discord_kick_member Remove a member from the server. ~216 tokens
  4. Destructive Ban member discord_ban_member Ban a user from the server, blocking re-entry until unbanned. ~277 tokens
  5. Write Unban member discord_unban_member Lift a ban so the user may rejoin via a new invite. ~193 tokens
  6. Write Timeout member discord_timeout_member Mute a member for a set duration (Discord 'timeout'): they cannot send messages, react, or speak until it expires. ~284 tokens
  7. Read-only Search members discord_search_members Find server members whose username or nickname starts with a query string (prefix match). ~321 tokens
  8. Write Set nickname discord_set_nickname Set or clear a member's server nickname. ~261 tokens
  9. Read-only List bans discord_list_bans List the users banned from the server, with their ban reasons. ~321 tokens
  10. Destructive Bulk banDry run by default discord_bulk_ban Ban many users in a single call, intended for raid mitigation. ~561 tokens
  11. Destructive Prune inactive membersDry run by default discord_prune_members Remove members who have been inactive (no roles, not seen) for a number of days. ~364 tokens

Roles

roles 9 tools: 2 read-only, 6 write, 1 destructive, ~2.4k tokens

Create, edit, assign, order and delete roles.

  1. Read-only List roles discord_list_roles List all roles in a server (excluding @everyone), highest-first, with color, position, member count, and permissions. ~272 tokens
  2. Write Create role discord_create_role Create a new role in a server. ~320 tokens
  3. Write Edit role discord_edit_role Update an existing role's name, color, permissions, hoist, or mentionable flag. ~368 tokens
  4. Destructive Delete role discord_delete_role Permanently delete a role from the server; it is automatically removed from every member who held it. ~199 tokens
  5. Write Add role to member discord_add_role Assign an existing role to a member. ~241 tokens
  6. Write Remove role from member discord_remove_role Remove a role from a member. ~240 tokens
  7. Read-only Get role members discord_get_role_members List members who currently hold a specific role, scanning up to 20,000 members. ~272 tokens
  8. Write Set role position discord_set_role_position Move a role up or down in the server's role hierarchy, which determines permission precedence and member-list ordering. ~243 tokens
  9. Write Set role icon discord_set_role_icon Set or clear a role's icon, either a custom image or a unicode emoji. ~269 tokens

Moderation

moderation 1 tool: 1 read-only, ~431 tokens

Read the audit log.

  1. Read-only Get audit log 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. ~431 tokens

Screening

screening 2 tools: 1 read-only, 1 write, ~685 tokens

Read and update the membership screening form.

  1. Read-only Get membership screening discord_get_membership_screening Fetch the server's membership screening form, the rules/questions new members must accept before gaining access. ~324 tokens
  2. Write Update membership screening discord_update_membership_screening Update the server's membership screening form: set the welcome description and the rules new members must agree to. ~362 tokens

Stats

stats 1 tool: 1 read-only, ~426 tokens

A snapshot of server metrics.

  1. Read-only Get server stats 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. ~426 tokens

Forums

forums 10 tools: 4 read-only, 4 write, 2 destructive, ~3.3k tokens

Forum channels, posts, replies and tags.

  1. Read-only List forum channels discord_get_forum_channels List the forum channels in a server (id, name, topic, parent category). ~243 tokens
  2. Write Create forum channel discord_create_forum_channel Create a new forum channel in a server. ~242 tokens
  3. Write Create forum post discord_create_forum_post Create a new post (a thread with a starter message) in a forum channel. ~264 tokens
  4. Read-only Get forum post 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. ~534 tokens
  5. Read-only List forum threads discord_list_forum_threads List posts in a forum channel. ~560 tokens
  6. Write Reply to forum post discord_reply_to_forum Post a follow-up message inside an existing forum post (thread). ~192 tokens
  7. Destructive Delete forum post discord_delete_forum_post Permanently delete a forum post (thread) and all its messages. ~153 tokens
  8. Read-only Get forum tags discord_get_forum_tags List the tags available on a forum channel (id, name, emoji, emoji_id, moderated flag). ~300 tokens
  9. Destructive Set forum tags discord_set_forum_tags Replace the full set of available tags on a forum channel with the provided list. ~452 tokens
  10. Write Update forum post discord_update_forum_post Update a forum post's title, archived/locked state, or applied tags. ~316 tokens

Webhooks

webhooks 8 tools: 2 read-only, 4 write, 2 destructive, ~3.0k tokens

Create webhooks and post, edit or delete messages through them.

  1. Write Create webhook discord_create_webhook Create a webhook on a channel and return its ID and token. ~262 tokens
  2. Write Send webhook message discord_send_webhook_message Send a message through a webhook using its ID and token (no bot permissions needed; the token authorizes the send). ~795 tokens
  3. Write Edit webhook discord_edit_webhook Update a webhook's name, avatar, or the channel it posts to. ~220 tokens
  4. Destructive Delete webhook discord_delete_webhook Permanently delete a webhook by its ID, invalidating its token. ~172 tokens
  5. Read-only List webhooks discord_list_webhooks List the webhooks in a single channel or across a whole server (id, name, channel, token when visible, creator). ~340 tokens
  6. Write Edit webhook message discord_edit_webhook_message Edit a message previously sent through a webhook, using the webhook's ID and token. ~750 tokens
  7. Destructive Delete webhook message discord_delete_webhook_message Permanently delete a message that was sent through a webhook, using the webhook's ID and token. ~217 tokens
  8. Read-only Fetch webhook message discord_fetch_webhook_message Fetch a single message sent through a webhook (id, content, embed count, timestamp), using the webhook's ID and token. ~247 tokens

Scheduled events

scheduled_events 7 tools: 3 read-only, 3 write, 1 destructive, ~3.0k tokens

Create and manage events, see who is interested, and invite people to them.

  1. Read-only List scheduled events discord_list_scheduled_events List all scheduled events in a server (id, name, status, type, time, location, interested count). ~336 tokens
  2. Read-only Get scheduled event 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. ~385 tokens
  3. Write Create scheduled event discord_create_scheduled_event Create a scheduled event. ~660 tokens
  4. Write Edit scheduled event discord_edit_scheduled_event Update a scheduled event; only provided fields change. ~651 tokens
  5. Destructive Delete scheduled event discord_delete_scheduled_event Permanently delete a scheduled event. ~205 tokens
  6. Read-only Get event subscribers discord_get_event_subscribers List the users who marked themselves 'Interested' in a scheduled event. ~349 tokens
  7. Write Create event invite discord_create_event_invite Create a shareable invite URL that points to a scheduled event, so recipients land on the event when joining. ~413 tokens

Invites

invites 5 tools: 3 read-only, 1 write, 1 destructive, ~1.7k tokens

List, inspect, create and revoke invites.

  1. Read-only List invites discord_list_invites List all active invites across a server (code, url, channel, inviter, uses, expiry). ~409 tokens
  2. Read-only Get invite discord_get_invite Look up a single invite by its code: target server and channel, inviter, and expiry. ~400 tokens
  3. Write Create invite discord_create_invite Create an invite link for a channel, optionally limiting its lifetime, uses, and membership type. ~320 tokens
  4. Destructive Delete invite discord_delete_invite Revoke an invite by its code so it can no longer be used. ~172 tokens
  5. Read-only List channel invites discord_list_channel_invites List the active invites that point to one specific channel. ~375 tokens

Direct messages

dm 7 tools: 1 read-only, 5 write, 1 destructive, ~2.4k tokens

Send, read, edit and delete direct messages.

  1. Write Send DM discord_send_dm Send a private direct message to a user by their user ID. ~195 tokens
  2. Write Send DM embed discord_send_dm_embed Send a rich embed as a private direct message to a user. ~638 tokens
  3. Write Edit DM discord_edit_dm Edit the text content of a DM message previously sent by this bot. ~211 tokens
  4. Write Edit DM embed discord_edit_dm_embed Replace the embed on a DM message previously sent by this bot. ~700 tokens
  5. Destructive Delete DM discord_delete_dm Permanently delete a DM message previously sent by this bot. ~172 tokens
  6. Read-only Read DMs discord_read_dms Read the most recent messages from the bot's DM conversation with a user, oldest-to-newest. ~280 tokens
  7. Write Reply to DM discord_reply_dm Reply to a specific message in a DM, attaching a quoted reply reference. ~237 tokens