discord-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | Host for the Streamable HTTP endpoint in serve mode. | |
| PORT | No | Port for the Streamable HTTP endpoint in serve mode. | |
| DISCORD_TOKEN | No | Use this token instead of the saved login. | |
| DISCORD_LOCALE | No | Sent as the client locale. Default: system. | |
| MCP_AUTH_TOKEN | No | Authentication token for remote mode (24+ characters). The server refuses to start without it in serve mode. | |
| DISCORD_GATEWAY | No | `off` turns off the live connection. Status, voice, slash commands, events and unread counts need it. Default: `on`. | |
| DISCORD_MCP_HOME | No | Where the login, caches and downloads live. Default: `~/.discord-mcp`. | |
| DISCORD_TIMEZONE | No | Sent as the client timezone. Default: system. | |
| DISCORD_TOOLSETS | No | Comma-separated categories to expose. `core` gives the 212 everyday tools; see TOOLS.md for category names. Default: all. | |
| DISCORD_READ_ONLY | No | `1` exposes only read-only tools. | |
| DISCORD_TOKEN_TYPE | No | `bot` for bot tokens (a `Bot ` prefix also works). Default: `user`. | |
| DISCORD_DISABLED_TOOLS | No | Comma-separated tool names to hide. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Discord as your own account (or a bot). "guild" = server. IDs are snowflake strings. Not logged in? Call discord_login and show the user the QR code to scan in the Discord phone app (Settings → Scan QR Code), then discord_login_status wait=true. Start with whoami, list_guilds, get_channel_tree, list_dms, list_unread. Read chats with read_messages, send with send_message (files: local paths/URLs), search with search_messages. Bots: list_commands / run_slash_command / click_button / select_menu_option / submit_modal. Live: get_events, wait_for_message, set_status, join_voice_channel. Most tools accept extra Discord API fields beyond those listed; discord_api_request reaches any route.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| discord_loginA | Log in to your personal Discord account by QR code (no password): returns a QR image to scan with the Discord phone app (Settings → Scan QR Code). Then call discord_login_status with wait=true. The token is saved locally. |
| discord_login_statusB | Check (or wait for) the QR-code login started with discord_login. |
| discord_login_tokenA | Log in with a token you already have (user token, or "Bot " / type=bot for a bot). Verifies it and saves it locally. |
| discord_logoutA | Forget the saved login on this machine. With revoke=true also invalidates the token at Discord (logs this session out everywhere it is used). |
| whoamiA | Who is logged in, account type (user/bot), and live connection status (gateway, servers, DMs cached). Start here. |
| reconnect_gatewayA | Reconnect the live gateway connection (use if live tools say the gateway is not ready). |
| send_messageA | Send a message to a channel, thread or DM — text, replies, file/image uploads (local path or URL), stickers, silent messages. Use user_id to DM someone. |
| send_dmB | Send a direct message to a user by user ID (opens the DM if needed). |
| reply_to_messageB | Reply to a specific message (give its link, or channel_id + message_id). |
| forward_messageA | Forward a message to another channel or DM (Discord's native forward). |
| create_pollC | Post a poll in a channel or DM. |
| read_messagesA | Read chat history of a channel, thread or DM in readable form (oldest → newest). Paginates up to 500 messages. Use since/before/after/around to move in time. |
| open_message_linkA | Open a discord.com/channels/… message link: returns the message plus a few messages of context around it. |
| search_messagesA | Search messages like the Discord search bar: in a server (guild_id) or a DM/channel (channel_id). Filter by text, author, mentions, attachments/links (has), channel, date range, pinned. |
| download_attachmentsA | Download a message's attachments (or any CDN URL) to local files and return their paths. |
| view_imageB | Look at an image: a message attachment (message link/ID + optional index) or any image URL. Returns the image itself. |
| purge_my_messagesA | Delete your own recent messages in a channel/DM (optionally only those containing some text). Goes slowly to respect rate limits. |
| edit_my_messageA | Change the text of one of your messages (message link, or ID + channel_id). |
| reactB | React to a message by link (or channel_id + message_id) with one or more emojis. |
| list_guildsA | List the servers you are in (name, id, member counts, owner, unread/mention counts when live). |
| get_channel_treeA | Show a server's channels as a tree (categories → channels) with types, topics and unread markers; hides channels you cannot see. |
| list_dmsA | List your DMs and group DMs, most recent first, with unread markers. |
| open_dmA | Open (or get) the DM channel with a user; returns its channel ID. |
| create_group_dmB | Create a group DM with friends (up to 9 others). |
| find_channelsB | Find channels by name across all your servers (and DMs by person name). Needs the live connection. |
| find_usersA | Find people by name among your friends, DM contacts and (with guild_id) a server's members. |
| list_friendsA | List friends, blocked users and pending friend requests in readable form. |
| add_friendB | Send a friend request by username (e.g. "jane" or "jane#1234" for old tags). |
| accept_friend_requestC | Accept an incoming friend request (or send one by user ID). |
| block_userC | Block a user. |
| unblock_userC | Unblock a user. |
| remove_friendB | Remove a friend (or cancel/decline a friend request). |
| get_my_permissionsB | Your effective permissions in a server, or in a specific channel (computed from roles and overwrites). |
| snowflake_infoA | Convert a Discord ID to its creation time, or a time to an ID (for before/after cursors). |
| list_unreadA | What is unread right now: DMs with new messages, channels where you were mentioned, and (all=true) every unread unmuted channel. Needs the live connection. |
| mark_readA | Mark as read: one channel/DM (channel_id), a whole server (guild_id), or everything (all=true). |
| get_channel_infoB | Readable info about a channel/thread/DM (type, server, topic, recipients, last activity). |
| set_statusA | Set your online status: online, idle, dnd (Do Not Disturb) or invisible. |
| set_custom_statusA | Set (or clear) your custom status text/emoji, optionally expiring after N minutes. |
| set_activityA | Show an activity on your profile: Playing / Listening to / Watching / Competing in / Streaming . Lasts while this MCP is connected. |
| clear_activityA | Remove the activity set with set_activity (keeps your custom status). |
| join_voice_channelA | Join a voice/stage channel, or start/join a DM call (pass the DM channel_id; ring=true rings them). Note: you appear connected but no audio is streamed. |
| leave_voice_channelA | Disconnect from voice (in a server: pass guild_id; omit for DM calls). |
| set_voice_muteA | Mute/deafen/camera yourself in the voice channel you are in. |
| list_voice_membersB | Who is in voice channels of a server right now (optionally one channel), with mute/deafen/stream flags. Also shows where you are connected. |
| search_membersB | Look up server members by name prefix (or by user_ids) through the live connection — works for normal user accounts. |
| get_eventsA | Recent live events received since connecting (new/edited/deleted messages, reactions, friend requests, calls, joins…). Use since_seq to poll for only new ones. |
| wait_for_messageB | Wait for the next incoming message (e.g. a reply) matching filters, up to timeout_seconds. |
| wait_for_eventB | Wait for any gateway event type (e.g. MESSAGE_REACTION_ADD, RELATIONSHIP_ADD, CALL_CREATE, GUILD_MEMBER_ADD, VOICE_STATE_UPDATE). |
| list_commandsB | List slash commands and context-menu commands you can use in a channel/DM (from all bots there and your user-installed apps). |
| run_slash_commandA | Run a bot's slash command in a channel/DM, like typing /command. command can include subcommands ("music play"). options are by name. Returns the bot's reply (or a modal to fill). |
| run_context_commandB | Run an "Apps" right-click command on a user or a message (context-menu command). |
| click_buttonB | Click a button on a bot message (by label or custom_id). Returns the bot's response or a modal to fill. |
| select_menu_optionB | Choose option(s) in a select menu on a bot message (values = option values, or user/role/channel IDs for those menus). |
| list_pending_modalsB | Forms (modals) bots opened for you recently and their input fields. |
| submit_modalB | Fill in and submit a bot form (modal). values maps each input custom_id to text (or a list for selects). Defaults to the most recent modal. |
| timeout_memberB | Time out a member (they cannot chat or join voice) for N minutes (max 40320 = 28 days). |
| remove_timeoutC | Remove a member's timeout. |
| set_member_nicknameB | Change a member's server nickname (empty resets). For yourself use set_my_nickname. |
| set_member_rolesB | Replace a member's whole role list. |
| move_member_to_voiceA | Move a member to another voice channel (needs Move Members). |
| disconnect_member_from_voiceC | Disconnect a member from voice. |
| server_mute_memberC | Server-mute or unmute a member in voice. |
| server_deafen_memberC | Server-deafen or undeafen a member in voice. |
| set_my_nicknameA | Change your own nickname in a server (empty resets). |
| mute_serverB | Mute a server's notifications (optionally for N minutes). |
| unmute_serverC | Unmute a server. |
| set_server_notificationsB | Choose which messages notify you in a server: all, mentions or nothing; optionally suppress @everyone / role pings. |
| mute_channelC | Mute a channel or DM (optionally for N minutes). |
| unmute_channelC | Unmute a channel or DM. |
| create_serverA | Create a new server (you become the owner). Optionally from a template code. |
| join_serverA | Join a server with an invite link or code (same as clicking an invite). New accounts may be asked for a captcha. |
| create_inviteB | Create an invite link to a channel (defaults: 24h, unlimited uses). |
| set_channel_permissionA | Allow/deny permissions for a role or member on a channel using names (e.g. allow ["VIEW_CHANNEL"], deny ["SEND_MESSAGES"]). Lock a channel: deny SEND_MESSAGES for @everyone (role id = server id). |
| get_server_insightsB | Server Insights analytics (Community servers, needs View Server Insights): growth, joins, leavers, retention, engagement, channel stats, audience. |
| discord_api_requestA | Escape hatch: call any Discord HTTP API route as your account (path relative to /api/v9, e.g. "/users/@me/billing/subscriptions"). Use when no dedicated tool exists. |
| list_login_sessionsA | Devices logged into your account (Settings → Devices). [GET /auth/sessions] |
| logout_login_sessionsA | Log out other devices by session hash (session_id_hashes from list_login_sessions). [POST /auth/sessions/logout] |
| list_authorized_appsB | Apps you have authorized with your account (Settings → Authorized Apps). [GET /oauth2/tokens] |
| preview_app_authorizationA | Preview an OAuth2 authorization (e.g. adding a bot to a server): shows the app, scopes and servers you can add it to. [GET /oauth2/authorize] |
| authorize_appA | Authorize an app — e.g. add a bot to a server (scope "bot applications.commands", guild_id, permissions) or install a user app (integration_type 1). [POST /oauth2/authorize] |
| get_authorized_appB | Get OAuth2 Authorization. [GET /oauth2/tokens/{token_id}] |
| deauthorize_appB | Revoke an app's access to your account. [DELETE /oauth2/tokens/{token_id}] |
| acknowledge_messageB | Mark a channel as read up to a message. (mark_read does this for you.) [POST /channels/{channel_id}/messages/{message_id}/ack] |
| acknowledge_pinned_messagesB | Mark a channel's pins as seen. [POST /channels/{channel_id}/pins/ack] |
| acknowledge_guild_featureC | Acknowledge Guild Feature. [POST /guilds/{guild_id}/ack/{read_state_type}/{entity_id}] |
| acknowledge_user_featureC | Acknowledge User Feature. [POST /users/@me/{read_state_type}/{entity_id}/ack] |
| bulk_update_read_statesB | Mark many channels read: read_states [{channel_id, message_id}]. [POST /read-states/ack-bulk] |
| delete_read_stateB | Mark a channel as unread (delete its read state). [DELETE /channels/{channel_id}/messages/ack] |
| list_app_directory_categoriesC | List Application Directory Categories. [GET /application-directory-static/categories] |
| list_app_directory_collectionsC | List Application Directory Collections. [GET /application-directory-static/collections] |
| get_app_directory_appC | Get Application Directory Application. [GET /application-directory-static/applications/{application_id}] |
| list_similar_directory_appsC | List Application Directory Similar Applications. [GET /application-directory-static/applications/{application_id}/similar] |
| search_app_directoryC | Search Applications Directory. [GET /application-directory-static/search] |
| list_applicationsC | Apps you own in the developer portal. [GET /applications] |
| create_applicationC | Create Application. [POST /applications] |
| get_applicationC | Get Application. [GET /applications/{application_id}] |
| modify_applicationC | Modify Application. [PATCH /applications/{application_id}] |
| list_application_testersC | List Application Testers. [GET /oauth2/applications/{application_id}/allowlist] |
| add_application_testerC | Add Application Tester. [POST /oauth2/applications/{application_id}/allowlist] |
| remove_application_testerB | Remove Application Tester. [DELETE /oauth2/applications/{application_id}/allowlist/{user_id}] |
| list_embedded_activitiesC | List Embedded Activities. [GET /activities/shelf] |
| launch_embedded_activityA | Launch an Activity (game/app) in a voice channel you are in. [POST /activities/{channel_id}/{application_id}] |
| get_partial_applicationC | Get Partial Application. [GET /applications/{application_id}/public] |
| get_rpc_applicationC | Get RPC Application. [GET /applications/{application_id}/rpc] |
| list_guild_applicationsC | Bots/apps installed in a server. [GET /guilds/{guild_id}/applications] |
| list_my_app_role_connectionsB | List User Application Role Connections. [GET /users/@me/applications/role-connections] |
| get_my_app_role_connectionC | Get User Application Role Connection. [GET /users/@me/applications/{application_id}/role-connection] |
| set_my_app_role_connectionB | Modify User Application Role Connection. [PUT /users/@me/applications/{application_id}/role-connection] |
| get_audit_logA | Read the server audit log (needs View Audit Log). Filter by user_id, action_type, before/after. [GET /guilds/{guild_id}/audit-logs] |
| list_guild_automod_rulesB | List Guild AutoMod Rules. [GET /guilds/{guild_id}/auto-moderation/rules] |
| get_guild_automod_ruleB | Get Guild AutoMod Rule. [GET /guilds/{guild_id}/auto-moderation/rules/{rule_id}] |
| create_guild_automod_ruleC | Create Guild AutoMod Rule. [POST /guilds/{guild_id}/auto-moderation/rules] |
| validate_guild_automod_ruleC | Validate Guild AutoMod Rule. [POST /guilds/{guild_id}/auto-moderation/rules/validate] |
| modify_guild_automod_ruleC | Modify Guild AutoMod Rule. [PATCH /guilds/{guild_id}/auto-moderation/rules/{rule_id}] |
| delete_guild_automod_ruleB | Delete Guild AutoMod Rule. [DELETE /guilds/{guild_id}/auto-moderation/rules/{rule_id}] |
| execute_automod_alert_actionC | Execute AutoMod Alert Action. [POST /guilds/{guild_id}/auto-moderation/alert-action] |
| modify_automod_incident_actionsC | Modify AutoMod Incident Actions. [PUT /guilds/{guild_id}/incident-actions] |
| resolve_automod_incidentC | Resolve AutoMod Incident. [POST /guilds/{guild_id}/auto-moderation/false-alarm] |
| report_automod_incidentC | Report AutoMod Incident. [POST /guilds/{guild_id}/auto-moderation/report-raid] |
| clear_mention_raid_incidentC | Clear Mention Raid Incident. [POST /guilds/{guild_id}/auto-moderation/clear-mention-raid] |
| get_dm_channelA | Get the existing DM channel with a user (if any). [GET /users/@me/dms/{user_id}] |
| list_guild_channelsA | List all channels of a server with full details (permission overwrites, topics…). For a compact tree use get_channel_tree. [GET /guilds/{guild_id}/channels] |
| create_guild_channelC | Create a channel in a server. type: 0 text, 2 voice, 4 category, 5 announcement, 13 stage, 15 forum, 16 media. [POST /guilds/{guild_id}/channels] |
| modify_guild_channel_positionsA | Reorder channels / move them between categories. positions: [{id, position?, parent_id?, lock_permissions?}]. [PATCH /guilds/{guild_id}/channels] |
| get_channelB | Get a channel, thread or DM by ID (raw object). [GET /channels/{channel_id}] |
| modify_channelA | Edit a channel, thread or group DM: name, topic, slowmode, NSFW, category, permissions, bitrate, thread archive/lock, group DM icon… [PATCH /channels/{channel_id}] |
| delete_channelA | Delete a server channel / category, close a DM, leave a group DM, or delete a thread. [DELETE /channels/{channel_id}] |
| bulk_leave_group_dmsC | Leave several group DMs at once. [POST /users/@me/channels/bulk-leave] |
| set_voice_channel_statusC | Set the status text shown under a voice channel. [PUT /channels/{channel_id}/voice-status] |
| modify_channel_permissionsA | Set a permission overwrite on a channel for a role or member (type 0 = role, 1 = member). allow/deny accept names like ["SEND_MESSAGES"]. [PUT /channels/{channel_id}/permissions/{overwrite_id}] |
| delete_channel_permissionA | Remove a role/member permission overwrite from a channel. [DELETE /channels/{channel_id}/permissions/{overwrite_id}] |
| follow_channelB | Follow an announcement channel into one of your server channels (needs Manage Webhooks there). [POST /channels/{channel_id}/followers] |
| start_typingA | Show "is typing…" in a channel for ~10 seconds. [POST /channels/{channel_id}/typing] |
| get_call_eligibilityC | Get Call Eligibility. [GET /channels/{channel_id}/call] |
| modify_callA | Change the voice region of a DM/group call. [PATCH /channels/{channel_id}/call] |
| ring_channel_recipientsA | Ring people in a DM/group DM call (start a call with join_voice_channel first). Empty recipients rings everyone. [POST /channels/{channel_id}/call/ring] |
| stop_ringing_channel_recipientsA | Stop ringing people in a DM/group DM call (or decline an incoming call by passing your own ID). [POST /channels/{channel_id}/call/stop-ringing] |
| add_channel_recipientB | Add a user (a friend) to a group DM. [PUT /channels/{channel_id}/recipients/{user_id}] |
| remove_channel_recipientA | Remove a user from a group DM you own. [DELETE /channels/{channel_id}/recipients/{user_id}] |
| accept_message_requestB | Accept a DM message request. [PUT /channels/{channel_id}/recipients/@me] |
| reject_message_requestB | Reject (delete) a DM message request. [DELETE /channels/{channel_id}/recipients/@me] |
| batch_reject_message_requestsB | Reject several DM message requests. [PUT /channels/recipients/@me/batch-reject] |
| get_message_request_detailsB | Get extra details (e.g. mutual servers) for pending message requests. [GET /users/@me/message-requests/supplemental-data] |
| list_guild_active_threadsB | List all active threads in a server that you can see. [GET /guilds/{guild_id}/threads/active] |
| list_public_archived_threadsC | List Public Archived Threads. [GET /channels/{channel_id}/threads/archived/public] |
| list_private_archived_threadsC | List Private Archived Threads. [GET /channels/{channel_id}/threads/archived/private] |
| list_joined_private_archived_threadsC | List Joined Private Archived Threads. [GET /channels/{channel_id}/users/@me/threads/archived/private] |
| search_threadsC | Search Threads. [GET /channels/{channel_id}/threads/search] |
| create_thread_from_messageB | Start a thread from an existing message. [POST /channels/{channel_id}/messages/{message_id}/threads] |
| create_threadA | Create a thread in a text channel, or a post in a forum/media channel (pass message: {content} and optional files for forum posts). type: 11 public, 12 private. [POST /channels/{channel_id}/threads] |
| list_thread_membersC | List Thread Members. [GET /channels/{channel_id}/thread-members] |
| get_thread_memberC | Get Thread Member. [GET /channels/{channel_id}/thread-members/{user_id}] |
| join_threadC | Join a thread. [PUT /channels/{channel_id}/thread-members/@me] |
| add_thread_memberC | Add Thread Member. [PUT /channels/{channel_id}/thread-members/{user_id}] |
| modify_thread_settingsB | Change your notification settings for a thread. [PATCH /channels/{channel_id}/thread-members/@me/settings] |
| leave_threadB | Leave a thread. [DELETE /channels/{channel_id}/thread-members/@me] |
| remove_thread_memberC | Remove Thread Member. [DELETE /channels/{channel_id}/thread-members/{user_id}] |
| create_channel_tagB | Add a tag to a forum/media channel. [POST /channels/{channel_id}/tags] |
| modify_channel_tagC | Edit a forum tag. [PUT /channels/{channel_id}/tags/{tag_id}] |
| delete_channel_tagB | Delete a forum tag. [DELETE /channels/{channel_id}/tags/{tag_id}] |
| list_user_connectionsC | List User Connections. [GET /users/@me/connections] |
| list_user_connection_subredditsC | List User Connection Subreddits. [GET /users/@me/connections/reddit/{connection_id}/subreddits] |
| refresh_user_connectionC | Refresh User Connection. [POST /users/@me/connections/{connection_type}/{connection_id}/refresh] |
| modify_user_connectionB | Modify User Connection. [PATCH /users/@me/connections/{connection_type}/{connection_id}] |
| delete_user_connectionC | Delete User Connection. [DELETE /users/@me/connections/{connection_type}/{connection_id}] |
| list_user_linked_connectionsB | List User Linked Connections. [GET /users/@me/linked-connections] |
| get_directory_countsC | Get Directory Counts. [GET /channels/{channel_id}/directory-entries/counts] |
| list_directory_entriesC | List Directory Entries. [GET /channels/{channel_id}/directory-entries] |
| list_partial_directory_entriesC | List Partial Directory Entries. [GET /channels/{channel_id}/directory-entries/list] |
| search_directory_entriesC | Search Directory Entries. [GET /channels/{channel_id}/directory-entries/search] |
| get_directory_entryC | Get Directory Entry. [GET /channels/{channel_id}/directory-entry/{entity_id}] |
| create_directory_entryC | Create Directory Entry. [POST /channels/{channel_id}/directory-entry/{entity_id}] |
| modify_directory_entryB | Modify Directory Entry. [PATCH /channels/{channel_id}/directory-entry/{entity_id}] |
| delete_directory_entryC | Delete Directory Entry. [DELETE /channels/{channel_id}/directory-entry/{entity_id}] |
| list_discoverable_guildsC | Browse featured public servers. [GET /discoverable-guilds] |
| search_discoverable_guildsC | Search public servers in Server Discovery. [GET /discoverable-guilds/search] |
| search_published_guildsC | Search Published Guilds. [GET /discovery/search] |
| get_discovery_slugC | Get Discovery Slug. [GET /discovery/{guild_id}] |
| list_discovery_categoriesC | List Discovery Categories. [GET /discovery/categories] |
| validate_discovery_search_termC | Validate Discovery Search Term. [GET /discovery/valid-term] |
| get_guild_discovery_requirementsC | Get Guild Discovery Requirements. [GET /guilds/{guild_id}/discovery-requirements] |
| get_guild_discovery_metadataC | Get Guild Discovery Metadata. [GET /guilds/{guild_id}/discovery-metadata] |
| modify_guild_discovery_metadataD | Modify Guild Discovery Metadata. [PATCH /guilds/{guild_id}/discovery-metadata] |
| add_guild_discovery_subcategoryC | Add Guild Discovery Subcategory. [PUT /guilds/{guild_id}/discovery-categories/{category_id}] |
| remove_guild_discovery_subcategoryC | Remove Guild Discovery Subcategory. [DELETE /guilds/{guild_id}/discovery-categories/{category_id}] |
| get_guild_profileC | Get Guild Profile. [GET /guilds/{guild_id}/profile] |
| modify_guild_profileC | Modify Guild Profile. [PATCH /guilds/{guild_id}/profile] |
| list_guild_emojisB | List a server's custom emojis. [GET /guilds/{guild_id}/emojis] |
| get_guild_emojiC | Get Guild Emoji. [GET /guilds/{guild_id}/emojis/{emoji_id}] |
| list_guild_top_emojisC | List Guild Top Emojis. [GET /guilds/{guild_id}/top-emojis] |
| get_emoji_guildC | Get Emoji Guild. [GET /emojis/{emoji_id}/guild] |
| get_emoji_sourceA | Find which server a custom emoji is from (and whether you can join it). [GET /emojis/{emoji_id}/source] |
| create_guild_emojiB | Upload a custom emoji (image ≤256KB: path, URL or data URI). [POST /guilds/{guild_id}/emojis] |
| modify_guild_emojiB | Rename an emoji or change which roles can use it. [PATCH /guilds/{guild_id}/emojis/{emoji_id}] |
| delete_guild_emojiC | Delete a custom emoji. [DELETE /guilds/{guild_id}/emojis/{emoji_id}] |
| list_application_emojisC | List Application Emojis. [GET /applications/{application_id}/emojis] |
| get_application_emojiC | Get Application Emoji. [GET /applications/{application_id}/emojis/{emoji_id}] |
| create_application_emojiC | Create Application Emoji. [POST /applications/{application_id}/emojis] |
| modify_application_emojiC | Modify Application Emoji. [PATCH /applications/{application_id}/emojis/{emoji_id}] |
| delete_application_emojiC | Delete Application Emoji. [DELETE /applications/{application_id}/emojis/{emoji_id}] |
| list_user_guild_scheduled_eventsB | List events you marked as interested in, across servers. [GET /users/@me/scheduled-events] |
| list_guild_scheduled_eventsC | List Guild Scheduled Events. [GET /guilds/{guild_id}/scheduled-events] |
| get_guild_scheduled_eventC | Get Guild Scheduled Event. [GET /guilds/{guild_id}/scheduled-events/{event_id}] |
| create_guild_scheduled_eventA | Create a scheduled event (stage, voice or external). For external events set entity_metadata {location} and scheduled_end_time. [POST /guilds/{guild_id}/scheduled-events] |
| modify_guild_scheduled_eventB | Edit or start/end/cancel an event (status: 2 active, 3 completed, 4 cancelled). [PATCH /guilds/{guild_id}/scheduled-events/{event_id}] |
| delete_guild_scheduled_eventC | Delete a scheduled event. [DELETE /guilds/{guild_id}/scheduled-events/{event_id}] |
| create_guild_scheduled_event_exceptionD | Create Guild Scheduled Event Exception. [POST /guilds/{guild_id}/scheduled-events/{event_id}/exceptions] |
| modify_guild_scheduled_event_exceptionC | Modify Guild Scheduled Event Exception. [PATCH /guilds/{guild_id}/scheduled-events/{event_id}/exceptions/{exception_id}] |
| delete_guild_scheduled_event_exceptionC | Delete Guild Scheduled Event Exception. [DELETE /guilds/{guild_id}/scheduled-events/{event_id}/exceptions/{exception_id}] |
| get_guild_scheduled_event_user_countC | Get Guild Scheduled Event User Count. [GET /guilds/{guild_id}/scheduled-events/{event_id}/users/counts] |
| list_guild_scheduled_event_usersC | List Guild Scheduled Event Users. [GET /guilds/{guild_id}/scheduled-events/{event_id}/users] |
| mark_interested_in_eventB | Mark yourself as interested in an event. [PUT /guilds/{guild_id}/scheduled-events/{event_id}/users/@me] |
| unmark_interested_in_eventA | Remove your interest in an event. [DELETE /guilds/{guild_id}/scheduled-events/{event_id}/users/@me] |
| list_guild_scheduled_event_exception_usersC | List Guild Scheduled Event Exception Users. [GET /guilds/{guild_id}/scheduled-events/{event_id}/{exception_id}/users] |
| mark_interested_in_event_occurrenceC | Create Guild Scheduled Event Exception User. [PUT /guilds/{guild_id}/scheduled-events/{event_id}/{exception_id}/users/@me] |
| unmark_interested_in_event_occurrenceC | Delete Guild Scheduled Event Exception User. [DELETE /guilds/{guild_id}/scheduled-events/{event_id}/{exception_id}/users/@me] |
| get_guild_templateB | Look up a server template by code. [GET /guilds/templates/{template_code}] |
| use_guild_templateB | Create a new server from a template. [POST /guilds/templates/{template_code}] |
| list_guild_templatesC | List Guild Templates. [GET /guilds/{guild_id}/templates] |
| create_guild_templateC | Create Guild Template. [POST /guilds/{guild_id}/templates] |
| sync_guild_templateC | Sync Guild Template. [PUT /guilds/{guild_id}/templates/{template_code}] |
| modify_guild_templateC | Modify Guild Template. [PATCH /guilds/{guild_id}/templates/{template_code}] |
| delete_guild_templateC | Delete Guild Template. [DELETE /guilds/{guild_id}/templates/{template_code}] |
| leave_guildC | Leave a server. [DELETE /users/@me/guilds/{guild_id}] |
| get_guildB | Get a server's full settings object. [GET /guilds/{guild_id}] |
| get_guild_previewA | Preview a server (name, counts, emojis, features) — works for discoverable servers you are not in. [GET /guilds/{guild_id}/preview] |
| modify_guildB | Edit server settings: name, icon, banner, description, verification level, system/rules/AFK channels, ownership… [PATCH /guilds/{guild_id}] |
| delete_guildB | Permanently delete a server you own. Irreversible. [DELETE /guilds/{guild_id}] |
| list_guild_membersA | List server members (bots; user accounts usually need Manage Server). For search use search_members. [GET /guilds/{guild_id}/members] |
| query_guild_membersA | Search server members whose username/nickname starts with a query (REST; bots). User accounts: use search_members. [GET /guilds/{guild_id}/members/search] |
| search_guild_membersB | Advanced member search (Manage Server/moderators): filters by roles, join date, join source, safety signals. [POST /guilds/{guild_id}/members-search] |
| list_members_with_unusual_dm_activityB | List members flagged for unusual DM activity (moderators). [GET /guilds/{guild_id}/members/unusual-dm-activity] |
| get_current_guild_memberA | Get your own member object in a server. [GET /users/@me/guilds/{guild_id}/member] |
| get_guild_memberA | Get one member of a server (roles, nickname, join date, timeout). [GET /guilds/{guild_id}/members/{user_id}] |
| join_guildB | Join a discoverable server by ID (or lurk with lurker=true). [PUT /guilds/{guild_id}/members/@me] |
| add_guild_memberA | Add a user to a server with an OAuth2 access token (bot apps only). [PUT /guilds/{guild_id}/members/{user_id}] |
| modify_guild_memberA | Edit a member: nickname, roles, server mute/deafen, move/disconnect voice (channel_id), timeout (communication_disabled_until). [PATCH /guilds/{guild_id}/members/{user_id}] |
| modify_current_guild_memberA | Change your own server nickname / server avatar / banner / bio. [PATCH /guilds/{guild_id}/members/@me] |
| modify_guild_member_profileB | Edit your per-server profile (server avatar, banner, bio, pronouns). [PATCH /guilds/{guild_id}/profile/@me] |
| add_member_roleC | Give a role to a member. [PUT /guilds/{guild_id}/members/{user_id}/roles/{role_id}] |
| remove_member_roleC | Take a role away from a member. [DELETE /guilds/{guild_id}/members/{user_id}/roles/{role_id}] |
| kick_memberB | Kick a member from a server. [DELETE /guilds/{guild_id}/members/{user_id}] |
| list_guild_bansB | List banned users. [GET /guilds/{guild_id}/bans] |
| search_guild_bansB | Search the ban list by username. [GET /guilds/{guild_id}/bans/search] |
| get_guild_banB | Check whether a user is banned (and why). [GET /guilds/{guild_id}/bans/{user_id}] |
| ban_memberA | Ban a user from a server, optionally deleting their recent messages. [PUT /guilds/{guild_id}/bans/{user_id}] |
| bulk_ban_membersA | Ban up to 200 users at once. [POST /guilds/{guild_id}/bulk-ban/v2] |
| unban_memberC | Unban a user. [DELETE /guilds/{guild_id}/bans/{user_id}] |
| list_guild_rolesA | List all roles in a server (with permissions). [GET /guilds/{guild_id}/roles] |
| get_guild_roleC | Get Guild Role. [GET /guilds/{guild_id}/roles/{role_id}] |
| get_guild_role_member_countsC | Member count of every role. [GET /guilds/{guild_id}/roles/member-counts] |
| list_guild_role_membersB | List member IDs that have a role (up to 100). [GET /guilds/{guild_id}/roles/{role_id}/member-ids] |
| add_guild_role_membersA | Give a role to several members at once (max 30). [PATCH /guilds/{guild_id}/roles/{role_id}/members] |
| get_role_linked_requirementsB | Get Guild Role Connection Configuration. [GET /guilds/{guild_id}/roles/{role_id}/connections/configuration] |
| set_role_linked_requirementsC | Modify Guild Role Connection Configuration. [PUT /guilds/{guild_id}/roles/{role_id}/connections/configuration] |
| create_guild_roleC | Create a role. permissions accept names like ["MANAGE_MESSAGES"]. [POST /guilds/{guild_id}/roles] |
| modify_guild_role_positionsB | Reorder roles. positions: [{id, position}]. [PATCH /guilds/{guild_id}/roles] |
| modify_guild_roleB | Edit a role: name, colour, permissions, hoist, mentionable, icon. [PATCH /guilds/{guild_id}/roles/{role_id}] |
| delete_guild_roleB | Delete a role. [DELETE /guilds/{guild_id}/roles/{role_id}] |
| get_guild_pruneB | Count members a prune would remove (inactive for N days). [GET /guilds/{guild_id}/prune] |
| prune_guildB | Kick members inactive for N days (optionally only those with given roles). [POST /guilds/{guild_id}/prune] |
| get_guild_widget_settingsC | Get Guild Widget Settings. [GET /guilds/{guild_id}/widget] |
| modify_guild_widgetC | Modify Guild Widget. [PATCH /guilds/{guild_id}/widget] |
| get_guild_widgetC | Get Guild Widget. [GET /guilds/{guild_id}/widget.json] |
| get_guild_vanity_inviteC | Get Guild Vanity Invite. [GET /guilds/{guild_id}/vanity-url] |
| modify_guild_vanity_inviteC | Modify Guild Vanity Invite. [PATCH /guilds/{guild_id}/vanity-url] |
| get_guild_member_verificationC | Get Guild Member Verification. [GET /guilds/{guild_id}/member-verification] |
| modify_guild_member_verificationC | Modify Guild Member Verification. [PATCH /guilds/{guild_id}/member-verification] |
| list_guild_join_requestsC | List Guild Join Requests. [GET /guilds/{guild_id}/requests] |
| get_guild_join_requestC | Get Guild Join Request. [GET /join-requests/{request_id}] |
| get_current_user_guild_join_requestC | Get Current User Guild Join Request. [GET /guilds/{guild_id}/requests/@me] |
| get_guild_join_request_cooldownC | Get Guild Join Request Cooldown. [GET /guilds/{guild_id}/requests/@me/cooldown] |
| create_guild_join_requestC | Create Guild Join Request. [PUT /guilds/{guild_id}/requests/@me] |
| reset_guild_join_requestC | Reset Guild Join Request. [POST /guilds/{guild_id}/requests/@me] |
| acknowledge_guild_join_requestC | Acknowledge Guild Join Request. [POST /guilds/{guild_id}/requests/{request_id}/ack] |
| delete_guild_join_requestA | Delete Guild Join Request. [DELETE /guilds/{guild_id}/requests/@me] |
| action_guild_join_requestC | Action Guild Join Request. [PATCH /guilds/{guild_id}/requests/{request_id}] |
| bulk_action_guild_join_requestsC | Bulk Action Guild Join Requests. [PATCH /guilds/{guild_id}/requests] |
| list_user_guild_join_requestsC | List User Guild Join Requests. [GET /guilds/{guild_id}/requests/users/{user_id}] |
| get_guild_welcome_screenC | Get Guild Welcome Screen. [GET /guilds/{guild_id}/welcome-screen] |
| modify_guild_welcome_screenC | Modify Guild Welcome Screen. [PATCH /guilds/{guild_id}/welcome-screen] |
| get_guild_onboardingC | Get Guild Onboarding. [GET /guilds/{guild_id}/onboarding] |
| modify_guild_onboardingC | Modify Guild Onboarding. [PUT /guilds/{guild_id}/onboarding] |
| list_guild_onboarding_allowed_applicationsC | List Guild Onboarding Allowed Applications. [GET /guilds/{guild_id}/onboarding/allowed-applications] |
| create_guild_onboarding_responsesC | Create Guild Onboarding Responses. [POST /guilds/{guild_id}/onboarding-responses] |
| modify_guild_onboarding_responsesC | Modify Guild Onboarding Responses. [PUT /guilds/{guild_id}/onboarding-responses] |
| get_guild_new_member_welcomeC | Get Guild New Member Welcome. [GET /guilds/{guild_id}/new-member-welcome] |
| modify_guild_new_member_welcomeC | Modify Guild New Member Welcome. [PUT /guilds/{guild_id}/new-member-welcome] |
| get_guild_new_member_actionsC | Get Guild New Member Actions. [GET /guilds/{guild_id}/new-member-actions] |
| list_premium_guild_subscriptionsB | List Premium Guild Subscriptions. [GET /guilds/{guild_id}/premium/subscriptions] |
| list_guild_integrationsC | List Guild Integrations. [GET /guilds/{guild_id}/integrations] |
| delete_guild_integrationC | Delete Guild Integration. [DELETE /guilds/{guild_id}/integrations/{integration_id}] |
| get_guild_integration_application_idsC | Get Guild Integration Application IDs. [GET /users/@me/guilds/integration-application-ids] |
| list_channel_integrationsC | List Channel Integrations. [GET /channels/{channel_id}/integrations] |
| delete_channel_integrationC | Delete Channel Integration. [DELETE /channels/{channel_id}/integrations/{integration_id}] |
| search_gifsA | Search GIFs (Tenor/Giphy) like the GIF picker. Send the returned url as message content. [GET /gifs/search] |
| list_trending_gif_categoriesB | List Trending GIF Categories. [GET /gifs/trending] |
| list_trending_gifsC | List Trending GIFs. [GET /gifs/trending-gifs] |
| get_inviteA | Look up an invite (server, channel, inviter, counts) without joining. [GET /invites/{invite_code}] |
| list_invite_friend_membersC | List Invite Friend Members. [GET /invites/{invite_code}/friend-members] |
| accept_inviteA | Join a server or group DM with an invite code/link. May require a captcha on new accounts. [POST /invites/{invite_code}] |
| delete_inviteC | Revoke an invite. [DELETE /invites/{invite_code}] |
| list_guild_invitesA | List all invites of a server (needs Manage Server). [GET /guilds/{guild_id}/invites] |
| list_channel_invitesB | List invites to a channel. [GET /channels/{channel_id}/invites] |
| create_channel_inviteB | Create an invite link for a channel. Returns the code (https://discord.gg/). [POST /channels/{channel_id}/invites] |
| list_user_invitesA | List your friend invites. [GET /users/@me/invites] |
| create_user_inviteB | Create a friend invite link (anyone using it becomes your friend). [POST /users/@me/invites] |
| revoke_user_invitesA | Revoke all your friend invites. [DELETE /users/@me/invites] |
| get_messageA | Get a single message by ID (raw Discord object). For readable history use read_messages. [GET /channels/{channel_id}/messages/{message_id}] |
| crosspost_messageB | Publish a message in an announcement channel to all following servers. [POST /channels/{channel_id}/messages/{message_id}/crosspost] |
| list_reactionsA | List users who reacted to a message with an emoji. [GET /channels/{channel_id}/messages/{message_id}/reactions/{emoji}] |
| add_reactionB | React to a message with an emoji (unicode like 👍 or custom name:id). [PUT /channels/{channel_id}/messages/{message_id}/reactions/{emoji}/@me] |
| remove_own_reactionA | Remove your own reaction from a message. [DELETE /channels/{channel_id}/messages/{message_id}/reactions/{emoji}/{reaction_type}/@me] |
| remove_user_reactionA | Remove another user's reaction (needs Manage Messages). [DELETE /channels/{channel_id}/messages/{message_id}/reactions/{emoji}/{reaction_type}/{user_id}] |
| remove_all_reactions_for_emojiA | Remove all reactions of one emoji from a message (needs Manage Messages). [DELETE /channels/{channel_id}/messages/{message_id}/reactions/{emoji}] |
| remove_all_reactionsA | Remove every reaction from a message (needs Manage Messages). [DELETE /channels/{channel_id}/messages/{message_id}/reactions] |
| edit_messageB | Edit one of your messages (content, flags, attachments to keep). Pass files to add new attachments. [PATCH /channels/{channel_id}/messages/{message_id}] |
| delete_messageA | Delete a message (yours, or anyone's with Manage Messages). [DELETE /channels/{channel_id}/messages/{message_id}] |
| bulk_delete_messagesA | Bulk-delete 2-100 messages younger than 14 days (needs Manage Messages; bots only on most servers). For your own messages use purge_my_messages. [POST /channels/{channel_id}/messages/bulk-delete] |
| list_message_pinsA | List pinned messages in a channel (newest pins first). [GET /channels/{channel_id}/messages/pins] |
| pin_messageB | Pin a message in a channel. [PUT /channels/{channel_id}/messages/pins/{message_id}] |
| unpin_messageC | Unpin a message. [DELETE /channels/{channel_id}/messages/pins/{message_id}] |
| get_channel_media_previewC | Get Channel Media Preview. [GET /channels/{channel_id}/media-post-preview] |
| list_poll_answer_votersB | List users who voted for a poll answer. [GET /channels/{channel_id}/polls/{message_id}/answers/{answer_id}] |
| end_pollA | End a poll early (only the poll creator). [POST /channels/{channel_id}/polls/{message_id}/expire] |
| vote_in_pollA | Vote in a poll: answer_ids are the 1-based answer numbers. An empty list removes your vote. [PUT /channels/{channel_id}/polls/{message_id}/answers/@me] |
| list_notification_center_itemsC | Notification center (activity inbox: friend requests, reminders…). [GET /users/@me/notification-center/items] |
| delete_notification_center_itemC | Delete Notification Center Item. [DELETE /users/@me/notification-center/items/{item_id}] |
| acknowledge_notification_center_itemC | Acknowledge Notification Center Item. [POST /users/@me/notification-center/items/{item_id}/ack] |
| bulk_acknowledge_notification_center_itemsC | Bulk Acknowledge Notification Center Items. [POST /users/@me/notification-center/items/bulk-ack] |
| list_my_game_activity_statsC | List User Application Activity Statistics. [GET /users/@me/activities/statistics/applications] |
| set_headless_activityA | Show a "playing" activity without the gateway (headless session). Returns a token to delete it later. [POST /users/@me/headless-sessions] |
| list_relationshipsA | List all relationships raw (type 1 friend, 2 blocked, 3 incoming request, 4 outgoing request). For a readable list use list_friends. [GET /users/@me/relationships] |
| send_friend_requestA | Send a friend request by username (new usernames: discriminator "0" or omit). [POST /users/@me/relationships] |
| ignore_userA | Ignore a user (hide their messages without blocking). [PUT /users/@me/relationships/{user_id}/ignore] |
| unignore_userA | Stop ignoring a user. [DELETE /users/@me/relationships/{user_id}/ignore] |
| set_friend_nicknameB | Set a private nickname for a friend. [PATCH /users/@me/relationships/{user_id}] |
| remove_relationshipA | Remove a friend, cancel/decline a friend request, or unblock a user. [DELETE /users/@me/relationships/{user_id}] |
| bulk_remove_relationshipsA | Remove many relationships at once (e.g. clear all incoming requests). [DELETE /users/@me/relationships] |
| list_friend_suggestionsC | Friend suggestions. [GET /friend-suggestions] |
| remove_friend_suggestionC | Remove Friend Suggestion. [DELETE /friend-suggestions/{user_id}] |
| get_account_standingA | Your account standing / safety hub status (warnings, violations). [GET /safety-hub/@me] |
| list_default_soundboard_soundsB | List Default Soundboard Sounds. [GET /soundboard-default-sounds] |
| list_guild_soundboard_soundsC | List Guild Soundboard Sounds. [GET /guilds/{guild_id}/soundboard-sounds] |
| get_guild_soundboard_soundC | Get Guild Soundboard Sound. [GET /guilds/{guild_id}/soundboard-sounds/{sound_id}] |
| create_guild_soundboard_soundB | Upload a soundboard sound (mp3/ogg ≤512KB). [POST /guilds/{guild_id}/soundboard-sounds] |
| modify_guild_soundboard_soundC | Edit a soundboard sound. [PATCH /guilds/{guild_id}/soundboard-sounds/{sound_id}] |
| delete_guild_soundboard_soundB | Delete a soundboard sound. [DELETE /guilds/{guild_id}/soundboard-sounds/{sound_id}] |
| get_soundboard_sound_guildC | Get Soundboard Sound Guild. [GET /soundboard-sounds/{sound_id}/guild/{guild_id}] |
| send_soundboard_soundB | Play a soundboard sound in the voice channel you are connected to (join_voice_channel first). [POST /channels/{channel_id}/send-soundboard-sound] |
| create_stage_instanceB | Start a stage (go live) in a stage channel with a topic. [POST /stage-instances] |
| get_stage_instanceC | Get Stage Instance. [GET /stage-instances/{channel_id}] |
| modify_stage_instanceB | Change a live stage's topic. [PATCH /stage-instances/{channel_id}] |
| delete_stage_instanceC | End a live stage. [DELETE /stage-instances/{channel_id}] |
| list_sticker_packsB | List Sticker Packs. [GET /sticker-packs] |
| get_sticker_packC | Get Sticker Pack. [GET /sticker-packs/{pack_id}] |
| get_stickerC | Get Sticker. [GET /stickers/{sticker_id}] |
| get_sticker_guildC | Get Sticker Guild. [GET /stickers/{sticker_id}/guild] |
| list_guild_stickersC | List Guild Stickers. [GET /guilds/{guild_id}/stickers] |
| get_guild_stickerB | Get Guild Sticker. [GET /guilds/{guild_id}/stickers/{sticker_id}] |
| create_guild_stickerA | Upload a sticker (PNG/APNG/GIF/Lottie ≤512KB). Give the image as files: [{path|url}] (first file is used). [POST /guilds/{guild_id}/stickers] |
| modify_guild_stickerB | Edit a sticker's name, description or tags. [PATCH /guilds/{guild_id}/stickers/{sticker_id}] |
| delete_guild_stickerC | Delete a sticker. [DELETE /guilds/{guild_id}/stickers/{sticker_id}] |
| get_user_settingsA | Your client settings (status, theme, locale, guild folders, privacy…). [GET /users/@me/settings] |
| modify_user_settingsA | Change client settings: status, custom_status, theme, locale, developer_mode, guild_folders, friend_source_flags, DM privacy (default_guilds_restricted)… [PATCH /users/@me/settings] |
| get_email_settingsC | Get Email Settings. [GET /users/@me/email-settings] |
| modify_email_settingsC | Modify Email Settings. [PATCH /users/@me/email-settings] |
| modify_notification_settingsC | Desktop/mobile notification flags. [PATCH /users/@me/notification-settings] |
| list_notification_settings_snapshotsB | List Notification Settings Snapshots. [GET /users/@me/notification-settings/snapshots] |
| create_notification_settings_snapshotC | Create Notification Settings Snapshot. [POST /users/@me/notification-settings/snapshots] |
| delete_notification_settings_snapshotC | Delete Notification Settings Snapshot. [DELETE /users/@me/notification-settings/snapshots/{snapshot_id}] |
| modify_user_guild_settingsA | Notification settings for a server (use guild_id "@me" for DMs): mute, suppress @everyone/roles, message_notifications, channel_overrides. [PATCH /users/@me/guilds/{guild_id}/settings] |
| bulk_modify_user_guild_settingsB | Change notification settings for several servers at once. [PATCH /users/@me/guilds/settings] |
| modify_audio_settingsC | Modify Audio Settings. [PATCH /users/@me/audio-settings/{audio_context_type}/{user_id}] |
| get_current_userA | Get your own account (username, email, phone, MFA, Nitro…). [GET /users/@me] |
| modify_current_userB | Edit your account: username (needs password), display name (global_name), avatar, banner, bio, accent colour… [PATCH /users/@me] |
| modify_current_user_accountB | Edit account-level fields (global_name, avatar, bio…). [PATCH /users/@me/account] |
| list_recent_avatarsB | List Recent Avatars. [GET /users/@me/avatars] |
| delete_recent_avatarC | Delete Recent Avatar. [DELETE /users/@me/avatars/{avatar_id}] |
| get_userA | Get a user's basic public info. [GET /users/{user_id}] |
| get_user_profileA | Get a user's full profile: bio, pronouns, badges, connected accounts, mutual servers and friends. [GET /users/{user_id}/profile] |
| modify_user_profileB | Edit your profile: bio, pronouns, banner, accent colour, profile theme colours. [PATCH /users/@me/profile] |
| list_mutual_relationshipsB | List friends you have in common with a user. [GET /users/{user_id}/relationships] |
| list_mentionsB | Your recent mentions inbox (pings across servers). [GET /users/@me/mentions] |
| dismiss_mentionA | Remove a message from your mentions inbox. [DELETE /users/@me/mentions/{message_id}] |
| get_user_notesB | All your private notes on users. [GET /users/@me/notes] |
| get_user_noteA | Your private note on a user. [GET /users/@me/notes/{user_id}] |
| set_user_noteB | Set your private note on a user (only you can see it). [PUT /users/@me/notes/{user_id}] |
| list_user_affinities_v2B | Users you interact with most. [GET /users/@me/affinities/v2/users] |
| list_guild_affinitiesB | Servers you interact with most. [GET /users/@me/affinities/guilds] |
| list_channel_affinitiesB | Channels you interact with most. [GET /users/@me/affinities/channels] |
| join_hypesquad_houseA | Join a HypeSquad house: 1 Bravery, 2 Brilliance, 3 Balance. [POST /hypesquad/online] |
| leave_hypesquad_houseA | Leave your HypeSquad house. [DELETE /hypesquad/online] |
| list_saved_messagesB | List your saved ("bookmarked") messages. [GET /users/@me/saved-messages] |
| save_messageB | Save (bookmark) a message for later. [PUT /users/@me/saved-messages/{channel_id}/{message_id}] |
| unsave_messageA | Remove a message from your saved messages. [DELETE /users/@me/saved-messages/{channel_id}/{message_id}] |
| list_voice_regionsB | Voice regions available for calls/channels. [GET /voice/regions] |
| list_guild_voice_regionsB | List Guild Voice Regions. [GET /guilds/{guild_id}/regions] |
| get_current_user_voice_stateC | Get Current User Voice State. [GET /guilds/{guild_id}/voice-states/@me] |
| get_user_voice_stateC | Get User Voice State. [GET /guilds/{guild_id}/voice-states/{user_id}] |
| modify_current_user_voice_stateA | Your voice state in a stage channel: request to speak, or become speaker/audience. [PATCH /guilds/{guild_id}/voice-states/@me] |
| modify_user_voice_stateB | Invite a user to speak (suppress=false) or move them to the audience in a stage channel. [PATCH /guilds/{guild_id}/voice-states/{user_id}] |
| send_voice_channel_effectB | Send an emoji effect in the voice channel you are in. [POST /channels/{channel_id}/voice-channel-effects] |
| send_custom_call_soundC | Send Custom Call Sound. [POST /channels/{channel_id}/custom-call-sounds] |
| create_webhookB | Create a webhook in a channel (returns its URL token). [POST /channels/{channel_id}/webhooks] |
| list_channel_webhooksC | List Channel Webhooks. [GET /channels/{channel_id}/webhooks] |
| list_guild_webhooksB | List Guild Webhooks. [GET /guilds/{guild_id}/webhooks] |
| get_webhookC | Get Webhook. [GET /webhooks/{webhook_id}] |
| get_webhook_with_tokenC | Get Webhook with Token. [GET /webhooks/{webhook_id}/{webhook_token}] |
| modify_webhookC | Modify Webhook. [PATCH /webhooks/{webhook_id}] |
| modify_webhook_with_tokenC | Modify Webhook with Token. [PATCH /webhooks/{webhook_id}/{webhook_token}] |
| delete_webhookC | Delete Webhook. [DELETE /webhooks/{webhook_id}] |
| delete_webhook_with_tokenB | Delete Webhook with Token. [DELETE /webhooks/{webhook_id}/{webhook_token}] |
| execute_webhookB | Post a message through a webhook (custom username/avatar, embeds and components allowed). [POST /webhooks/{webhook_id}/{webhook_token}] |
| get_webhook_messageB | Get Webhook Message. [GET /webhooks/{webhook_id}/{webhook_token}/messages/{message_id}] |
| edit_webhook_messageC | Edit Webhook Message. [PATCH /webhooks/{webhook_id}/{webhook_token}/messages/{message_id}] |
| delete_webhook_messageB | Delete Webhook Message. [DELETE /webhooks/{webhook_id}/{webhook_token}/messages/{message_id}] |
| get_app_command_indexC | Get Application Command Index. [GET /applications/{application_id}/application-command-index] |
| get_channel_command_indexB | All commands usable in a channel or DM. [GET /channels/{channel_id}/application-command-index] |
| get_guild_command_indexA | All slash/context commands available in a server (with application info). run_slash_command uses this for you. [GET /guilds/{guild_id}/application-command-index] |
| get_user_command_indexC | Commands of user-installed apps. [GET /users/@me/application-command-index] |
| list_global_application_commandsC | List Global Application Commands. [GET /applications/{application_id}/commands] |
| create_global_application_commandC | Create Global Application Command. [POST /applications/{application_id}/commands] |
| get_global_application_commandC | Get Global Application Command. [GET /applications/{application_id}/commands/{command_id}] |
| modify_global_application_commandC | Modify Global Application Command. [PATCH /applications/{application_id}/commands/{command_id}] |
| delete_global_application_commandC | Delete Global Application Command. [DELETE /applications/{application_id}/commands/{command_id}] |
| bulk_modify_global_application_commandsC | Overwrite all global commands of an app you own. [PUT /applications/{application_id}/commands] |
| list_guild_application_commandsC | List Guild Application Commands. [GET /applications/{application_id}/guilds/{guild_id}/commands] |
| create_guild_application_commandC | Create Guild Application Command. [POST /applications/{application_id}/guilds/{guild_id}/commands] |
| get_guild_application_commandC | Get Guild Application Command. [GET /applications/{application_id}/guilds/{guild_id}/commands/{command_id}] |
| modify_guild_application_commandC | Modify Guild Application Command. [PATCH /applications/{application_id}/guilds/{guild_id}/commands/{command_id}] |
| delete_guild_application_commandB | Delete Guild Application Command. [DELETE /applications/{application_id}/guilds/{guild_id}/commands/{command_id}] |
| bulk_modify_guild_application_commandsB | Overwrite all guild commands of an app you own. [PUT /applications/{application_id}/guilds/{guild_id}/commands] |
| list_guild_application_command_permissionsB | List Guild Application Command Permissions. [GET /applications/{application_id}/guilds/{guild_id}/commands/permissions] |
| get_application_command_permissionsC | Get Application Command Permissions. [GET /applications/{application_id}/guilds/{guild_id}/commands/{command_id}/permissions] |
| modify_application_command_permissionsC | Modify Application Command Permissions. [PUT /applications/{application_id}/guilds/{guild_id}/commands/{command_id}/permissions] |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 437 tools
While most tools map to distinct Discord REST endpoints, there is heavy functional overlap across large clusters: send_message/send_dm/reply_to_message/forward_message, join_server/join_guild/accept_invite, and five different member-lookup tools (list_guild_members, search_members, query_guild_members, search_guild_members, find_users). Similarly, set_channel_permission vs modify_channel_permissions, set_member_roles vs add_member_role/remove_member_role, and modify_current_user vs modify_current_user_account give an agent no clear basis to choose. Descriptions do help somewhat, but at 437 tools the boundaries are frequently unclear.
The dominant pattern is consistent verb_noun snake_case (list_, get_, create_, modify_, delete_), which is readable. However, synonym drift breaks predictability: edit/set/modify/change are used interchangeably for the same operation (edit_message vs edit_my_message, set_member_nickname vs set_my_nickname vs modify_guild_member), and a few tools are not verb_noun at all (whoami, react, snowflake_info).
437 tools is an extreme mismatch for any agent-consumable surface, far beyond the 3-15 range that keeps selection tractable. Many tools exist only to expose an obscure endpoint (notification-settings snapshots, affinities, audio settings, directory entries) and would be better served by the included discord_api_request escape hatch.
The surface exhaustively covers the Discord domain: messages, channels, threads, guilds, members, roles, permissions, invites, webhooks, emojis, stickers, soundboards, events, voice, applications, and OAuth. With discord_api_request as a documented fallback, there are essentially no dead ends.