discord-mcp
Provides tools to interact with Discord as a user or bot account, covering messages, DMs, threads, forums, reactions, polls, search, files, voice presence, friends, profile and status, notifications, server administration, apps and slash commands, and interactive components such as buttons and modals.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@discord-mcp What's unread? Summarise my DMs and reply to Alice that I'll be late"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
discord-mcp
An MCP server that lets an AI assistant use Discord as your own account, the way you would in the app. It can also run with a bot token.
437 tools. Messages, files, replies, forwards, polls, reactions, pins, search, threads, forums, DMs and group DMs, calls and voice, friends, profile, status and activity, notifications, unread state, server admin (channels, roles, permissions, members, moderation, AutoMod, audit log, emojis, stickers, soundboard, events, invites, webhooks, onboarding, templates, discovery), apps and slash commands, buttons, select menus and modals. The full list is in TOOLS.md.
Personal accounts work. Log in by scanning a QR code with the Discord phone app. No password is involved, and the token is stored locally in
~/.discord-mcp/account.jsonwith file mode 0600.No Discord library. The server calls the same HTTP API (v9) and gateway that the official web client uses, and sends the client's headers. Its only dependencies are the MCP SDK,
zod,wsandqrcode.Simple to extend. Most tools are one-line route specs in
src/tools/catalog/endpoints.ts. Every endpoint tool also accepts extra Discord API fields that aren't in its schema.discord_api_requestcan call any route.
Warning: automating a user account ("self-bot") is against Discord's Terms of Service and can get the account banned. Use it at your own risk. Keep it on your own machine, and don't spam, mass-DM or mass-friend people. New accounts and unusual actions may be asked for a captcha. When that happens, the tool tells you to do that action once in the official app.
Quick start
Requires Node.js 20 or newer.
git clone https://github.com/zongwei-tang/discord-mcp && cd discord-mcp
npm install && npm run build
node dist/index.js login # shows a QR code: Discord phone app → Settings → Scan QR CodeAdd it to your MCP client, for example Claude Code:
claude mcp add discord -- node /path/to/discord-mcp/dist/index.jsYou can also skip the CLI login. Ask the assistant to "log in to Discord". It calls discord_login, which shows the QR code in the chat.
Other ways to log in:
node dist/index.js login --token <token>Set
DISCORD_TOKENin the MCP config'senv.For a bot, pass
--botwith the--tokenlogin, or setDISCORD_TOKEN_TYPE=bot.
Related MCP server: discord-py-self-mcp
Remote mode (Railway, claude.ai connectors, cloud sessions)
node dist/index.js serve runs a Streamable HTTP endpoint at /mcp. It reads PORT and HOST, and it refuses to start without MCP_AUTH_TOKEN (24+ characters). Generate a random one, for example with openssl rand -hex 32. Clients authenticate in one of two ways:
Authorization: Bearer <MCP_AUTH_TOKEN>withhttps://<app>/mcp. Prefer this whenever the client supports headers.the token in the path,
https://<app>/mcp/<MCP_AUTH_TOKEN>, for clients that only take a URL, such as claude.ai custom connectors
Treat that URL like a password: anyone who has it can use your Discord account. Your host's request logs (for example Railway's HTTP logs) record the full path, so anyone with access to those logs can see it. If it leaks, change MCP_AUTH_TOKEN and update your clients.
To deploy on Railway, point a service at this repo. The included Dockerfile and railway.json set up the build and a /health check. Then set MCP_AUTH_TOKEN, and attach a volume at /data so the login survives redeploys (DISCORD_MCP_HOME=/data is the image default). Then log the server in to your Discord account. QR login usually fails on cloud servers, because Discord asks for a captcha when a datacenter IP exchanges the login ticket. The reliable way:
On your own computer, run
node dist/index.js loginand scan the QR code. This works from a home connection.Run
node dist/index.js token, which prints the saved token.On the server, set
DISCORD_TOKENto that value (for example as a Railway variable) and redeploy. Alternatively, calldiscord_login_tokenfrom any connected client.
A user token gives full access to your account, so keep it private. Using it from a cloud IP may also look more unusual to Discord than using it from home.
What you can ask for
"What's unread? Summarise my DMs." →
list_unread,read_messages"Reply to Alice that I'll be late, and attach ~/notes.pdf." →
send_dmwithfiles"Find the message where someone posted the wifi password in the Study server." →
search_messages"Run /imagine prompt:a red fox in the Midjourney channel and show me the result." →
run_slash_command,view_image"Click the 'Accept' button on that bot message." →
click_button(bots that answer with a form needsubmit_modalnext)"Set me to Do Not Disturb with status 'exams' for 3 hours." →
set_status,set_custom_status"Join the Gaming voice channel muted." →
join_voice_channel. This is presence only: no audio is streamed."Create a #announcements channel that only Mods can write in." →
create_guild_channel,set_channel_permission"Time out the user spamming in #general for 10 minutes." →
timeout_member
Configuration (environment variables)
Variable | Default | Meaning |
| – | Use this token instead of the saved login |
|
|
|
|
|
|
| all | Comma-separated categories to expose. |
| – |
|
| – | Comma-separated tool names to hide |
|
| Where the login, caches and downloads live |
| system | Sent as the client locale and timezone |
If your client struggles with 437 tools, use DISCORD_TOOLSETS=core. Claude Code loads MCP tools on demand, so it handles the full set.
How it works
src/discord/rest.tsis the HTTP client. It handles web-client headers,X-Super-Propertieswith the live build number, per-route rate limits with 429 retries, multipart uploads, data-URI conversion for images and sounds, and readable errors (including captcha and permission hints).src/discord/gateway.tskeeps the live connection open. It identifies like the web client, then caches the READY payload: servers, channels, DMs, roles, read states and voice states. It keeps a buffer of recent events and sends the presence, voice and member-request opcodes. It also computes your permissions so it can hide channels you can't see.src/discord/remote-auth.tshandles the QR login. It is Discord's "remote auth" handshake: an RSA-OAEP key exchange, nonce proof, ticket, then token exchange.src/tools/catalog/endpoints.ts(route specs) andmeta.ts(descriptions and extra parameters) produce the 361 endpoint tools.src/tools/custom/*holds 76 hand-written tools, including chat reading and formatting, unread, slash commands, components and modals, presence and voice, live events, and moderation shortcuts.
Route and parameter research used the community Discord Userdoccers documentation. Other Discord MCP servers were reviewed for comparison: SaseQ/discord-mcp, cappyeo/discord-mcp, Microck/discord.py-self-mcp and olivier-motium/discord-user-mcp. This server is an independent implementation.
Development
npm test # builds, then runs the offline end-to-end suite (fake Discord REST + gateway + QR login)
node dist/index.js tools # list tools
node dist/index.js tools --markdown > TOOLS.mdLicense
MIT
Available Tools
437 toolsaccept_friend_requestC
Accept an incoming friend request (or send one by user ID).
Inputs: user_id (required).
accept_inviteA
Join a server or group DM with an invite code/link. May require a captcha on new accounts. [POST /invites/{invite_code}]
Inputs: invite_code (required), session_id.
accept_message_requestB
Accept a DM message request. [PUT /channels/{channel_id}/recipients/@me]
Inputs: channel_id (required).
acknowledge_guild_featureC
Acknowledge Guild Feature. [POST /guilds/{guild_id}/ack/{read_state_type}/{entity_id}]
Inputs: guild_id (required), entity_id (required), read_state_type (required), token.
acknowledge_guild_join_requestC
Acknowledge Guild Join Request. [POST /guilds/{guild_id}/requests/{request_id}/ack]
Inputs: guild_id (required), request_id (required).
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]
Inputs: channel_id (required), message_id (required), token, manual, +2 more.
acknowledge_notification_center_itemC
Acknowledge Notification Center Item. [POST /users/@me/notification-center/items/{item_id}/ack]
Inputs: item_id (required).
acknowledge_pinned_messagesB
Mark a channel's pins as seen. [POST /channels/{channel_id}/pins/ack]
Inputs: channel_id (required).
acknowledge_user_featureC
Acknowledge User Feature. [POST /users/@me/{read_state_type}/{entity_id}/ack]
Inputs: entity_id (required), read_state_type (required), token.
action_guild_join_requestC
Action Guild Join Request. [PATCH /guilds/{guild_id}/requests/{request_id}]
Inputs: action (required), guild_id (required), request_id (required), reason, +1 more.
add_application_testerC
Add Application Tester. [POST /oauth2/applications/{application_id}/allowlist]
Inputs: username (required), application_id (required).
add_channel_recipientB
Add a user (a friend) to a group DM. [PUT /channels/{channel_id}/recipients/{user_id}]
Inputs: user_id (required), channel_id (required), nick, access_token.
add_friendB
Send a friend request by username (e.g. "jane" or "jane#1234" for old tags).
Inputs: username (required).
add_guild_discovery_subcategoryC
Add Guild Discovery Subcategory. [PUT /guilds/{guild_id}/discovery-categories/{category_id}]
Inputs: guild_id (required), category_id (required), reason.
add_guild_memberA
Add a user to a server with an OAuth2 access token (bot apps only). [PUT /guilds/{guild_id}/members/{user_id}]
Inputs: user_id (required), guild_id (required), access_token (required), deaf, +5 more.
add_guild_role_membersA
Give a role to several members at once (max 30). [PATCH /guilds/{guild_id}/roles/{role_id}/members]
Inputs: role_id (required), guild_id (required), member_ids (required), reason.
add_member_roleC
Give a role to a member. [PUT /guilds/{guild_id}/members/{user_id}/roles/{role_id}]
Inputs: role_id (required), user_id (required), guild_id (required), reason.
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]
Inputs: emoji (required), channel_id (required), message_id (required), type.
add_thread_memberC
Add Thread Member. [PUT /channels/{channel_id}/thread-members/{user_id}]
Inputs: user_id (required), channel_id (required), location.
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]
Inputs: scope (required), client_id (required), state, guild_id, +8 more.
ban_memberADestructive
Ban a user from a server, optionally deleting their recent messages. [PUT /guilds/{guild_id}/bans/{user_id}]
Inputs: user_id (required), guild_id (required), reason, delete_message_seconds.
batch_reject_message_requestsB
Reject several DM message requests. [PUT /channels/recipients/@me/batch-reject]
Inputs: channel_ids (required).
block_userCDestructive
Block a user.
Inputs: user_id (required).
bulk_acknowledge_notification_center_itemsC
Bulk Acknowledge Notification Center Items. [POST /users/@me/notification-center/items/bulk-ack]
Inputs: item_ids.
bulk_action_guild_join_requestsC
Bulk Action Guild Join Requests. [PATCH /guilds/{guild_id}/requests]
Inputs: action (required), guild_id (required), reason.
bulk_ban_membersADestructive
Ban up to 200 users at once. [POST /guilds/{guild_id}/bulk-ban/v2]
Inputs: guild_id (required), user_ids (required), reason, delete_message_seconds.
bulk_delete_messagesADestructive
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]
Inputs: messages (required), channel_id (required), reason.
bulk_leave_group_dmsC
Leave several group DMs at once. [POST /users/@me/channels/bulk-leave]
Inputs: channel_ids (required).
bulk_modify_global_application_commandsC
Overwrite all global commands of an app you own. [PUT /applications/{application_id}/commands]
Inputs: commands (required), application_id (required).
bulk_modify_guild_application_commandsB
Overwrite all guild commands of an app you own. [PUT /applications/{application_id}/guilds/{guild_id}/commands]
Inputs: commands (required), guild_id (required), application_id (required).
bulk_modify_user_guild_settingsB
Change notification settings for several servers at once. [PATCH /users/@me/guilds/settings]
Inputs: guilds (required).
bulk_remove_relationshipsADestructive
Remove many relationships at once (e.g. clear all incoming requests). [DELETE /users/@me/relationships]
Inputs: filters, relationship_type, only_likely_spammers.
bulk_update_read_statesB
Mark many channels read: read_states [{channel_id, message_id}]. [POST /read-states/ack-bulk]
Inputs: read_states (required).
clear_activityA
Remove the activity set with set_activity (keeps your custom status).
Inputs: no named parameters.
clear_mention_raid_incidentC
Clear Mention Raid Incident. [POST /guilds/{guild_id}/auto-moderation/clear-mention-raid]
Inputs: guild_id (required), reason.
click_buttonB
Click a button on a bot message (by label or custom_id). Returns the bot's response or a modal to fill.
Inputs: message (required), label, custom_id, channel_id, +1 more.
create_applicationC
Create Application. [POST /applications]
Inputs: name (required), icon, type, flags, +6 more.
create_application_emojiC
Create Application Emoji. [POST /applications/{application_id}/emojis]
Inputs: name (required), image (required), application_id (required).
create_channel_inviteB
Create an invite link for a channel. Returns the code (https://discord.gg/). [POST /channels/{channel_id}/invites]
Inputs: channel_id (required), flags, reason, unique, +7 more.
create_channel_tagB
Add a tag to a forum/media channel. [POST /channels/{channel_id}/tags]
Inputs: name (required), channel_id (required), moderated, emoji_name.
create_directory_entryC
Create Directory Entry. [POST /channels/{channel_id}/directory-entry/{entity_id}]
Inputs: entity_id (required), channel_id (required), type, description, +1 more.
create_global_application_commandC
Create Global Application Command. [POST /applications/{application_id}/commands]
Inputs: name (required), application_id (required), nsfw, type, +8 more.
create_group_dmB
Create a group DM with friends (up to 9 others).
Inputs: user_ids (required), name.
create_guild_application_commandC
Create Guild Application Command. [POST /applications/{application_id}/guilds/{guild_id}/commands]
Inputs: name (required), guild_id (required), description (required), application_id (required), +6 more.
create_guild_automod_ruleC
Create Guild AutoMod Rule. [POST /guilds/{guild_id}/auto-moderation/rules]
Inputs: name (required), actions (required), guild_id (required), event_type (required), +6 more.
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]
Inputs: name (required), guild_id (required), nsfw, type, +18 more.
create_guild_emojiB
Upload a custom emoji (image ≤256KB: path, URL or data URI). [POST /guilds/{guild_id}/emojis]
Inputs: name (required), image (required), guild_id (required), roles, +1 more.
create_guild_join_requestC
Create Guild Join Request. [PUT /guilds/{guild_id}/requests/@me]
Inputs: version (required), guild_id (required), form_fields (required).
create_guild_onboarding_responsesC
Create Guild Onboarding Responses. [POST /guilds/{guild_id}/onboarding-responses]
Inputs: guild_id (required), onboarding_responses, onboarding_prompts_seen, onboarding_responses_seen.
create_guild_roleC
Create a role. permissions accept names like ["MANAGE_MESSAGES"]. [POST /guilds/{guild_id}/roles]
Inputs: guild_id (required), icon, name, hoist, +6 more.
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]
Inputs: name (required), guild_id (required), entity_type (required), privacy_level (required), +8 more.
create_guild_scheduled_event_exceptionD
Create Guild Scheduled Event Exception. [POST /guilds/{guild_id}/scheduled-events/{event_id}/exceptions]
Inputs: event_id (required), guild_id (required), original_scheduled_start_time (required), reason, +3 more.
create_guild_soundboard_soundB
Upload a soundboard sound (mp3/ogg ≤512KB). [POST /guilds/{guild_id}/soundboard-sounds]
Inputs: name (required), sound (required), guild_id (required), reason, +2 more.
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]
Inputs: name (required), tags (required), guild_id (required), files, +2 more.
create_guild_templateC
Create Guild Template. [POST /guilds/{guild_id}/templates]
Inputs: name (required), guild_id (required), reason, description.
create_inviteB
Create an invite link to a channel (defaults: 24h, unlimited uses).
Inputs: channel_id (required), unique, max_uses, temporary, +1 more.
create_notification_settings_snapshotC
Create Notification Settings Snapshot. [POST /users/@me/notification-settings/snapshots]
Inputs: label.
create_pollC
Post a poll in a channel or DM.
Inputs: answers (required), question (required), content, user_id, +3 more.
create_serverA
Create a new server (you become the owner). Optionally from a template code.
Inputs: name (required), icon, template_code.
create_stage_instanceB
Start a stage (go live) in a stage channel with a topic. [POST /stage-instances]
Inputs: topic (required), channel_id (required), reason, privacy_level, +2 more.
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]
Inputs: name (required), channel_id (required), type, files, +6 more.
create_thread_from_messageB
Start a thread from an existing message. [POST /channels/{channel_id}/messages/{message_id}/threads]
Inputs: name (required), channel_id (required), message_id (required), location, +2 more.
create_user_inviteB
Create a friend invite link (anyone using it becomes your friend). [POST /users/@me/invites]
Inputs: code.
create_webhookB
Create a webhook in a channel (returns its URL token). [POST /channels/{channel_id}/webhooks]
Inputs: name (required), channel_id (required), avatar, reason.
crosspost_messageB
Publish a message in an announcement channel to all following servers. [POST /channels/{channel_id}/messages/{message_id}/crosspost]
Inputs: channel_id (required), message_id (required).
deauthorize_appBDestructive
Revoke an app's access to your account. [DELETE /oauth2/tokens/{token_id}]
Inputs: token_id (required).
delete_application_emojiCDestructive
Delete Application Emoji. [DELETE /applications/{application_id}/emojis/{emoji_id}]
Inputs: emoji_id (required), application_id (required).
delete_channelADestructive
Delete a server channel / category, close a DM, leave a group DM, or delete a thread. [DELETE /channels/{channel_id}]
Inputs: channel_id (required), reason, silent.
delete_channel_integrationCDestructive
Delete Channel Integration. [DELETE /channels/{channel_id}/integrations/{integration_id}]
Inputs: channel_id (required), integration_id (required).
delete_channel_permissionADestructive
Remove a role/member permission overwrite from a channel. [DELETE /channels/{channel_id}/permissions/{overwrite_id}]
Inputs: channel_id (required), overwrite_id (required), reason.
delete_channel_tagBDestructive
Delete a forum tag. [DELETE /channels/{channel_id}/tags/{tag_id}]
Inputs: tag_id (required), channel_id (required).
delete_directory_entryCDestructive
Delete Directory Entry. [DELETE /channels/{channel_id}/directory-entry/{entity_id}]
Inputs: entity_id (required), channel_id (required).
delete_global_application_commandCDestructive
Delete Global Application Command. [DELETE /applications/{application_id}/commands/{command_id}]
Inputs: command_id (required), application_id (required).
delete_guildBDestructive
Permanently delete a server you own. Irreversible. [DELETE /guilds/{guild_id}]
Inputs: guild_id (required), reason.
delete_guild_application_commandBDestructive
Delete Guild Application Command. [DELETE /applications/{application_id}/guilds/{guild_id}/commands/{command_id}]
Inputs: guild_id (required), command_id (required), application_id (required).
delete_guild_automod_ruleBDestructive
Delete Guild AutoMod Rule. [DELETE /guilds/{guild_id}/auto-moderation/rules/{rule_id}]
Inputs: rule_id (required), guild_id (required), reason.
delete_guild_emojiCDestructive
Delete a custom emoji. [DELETE /guilds/{guild_id}/emojis/{emoji_id}]
Inputs: emoji_id (required), guild_id (required), reason.
delete_guild_integrationCDestructive
Delete Guild Integration. [DELETE /guilds/{guild_id}/integrations/{integration_id}]
Inputs: guild_id (required), integration_id (required), reason.
delete_guild_join_requestADestructive
Delete Guild Join Request. [DELETE /guilds/{guild_id}/requests/@me]
Inputs: guild_id (required).
delete_guild_roleBDestructive
Delete a role. [DELETE /guilds/{guild_id}/roles/{role_id}]
Inputs: role_id (required), guild_id (required), reason.
delete_guild_scheduled_eventCDestructive
Delete a scheduled event. [DELETE /guilds/{guild_id}/scheduled-events/{event_id}]
Inputs: event_id (required), guild_id (required), reason.
delete_guild_scheduled_event_exceptionCDestructive
Delete Guild Scheduled Event Exception. [DELETE /guilds/{guild_id}/scheduled-events/{event_id}/exceptions/{exception_id}]
Inputs: event_id (required), guild_id (required), exception_id (required), reason.
delete_guild_soundboard_soundBDestructive
Delete a soundboard sound. [DELETE /guilds/{guild_id}/soundboard-sounds/{sound_id}]
Inputs: guild_id (required), sound_id (required), reason.
delete_guild_stickerCDestructive
Delete a sticker. [DELETE /guilds/{guild_id}/stickers/{sticker_id}]
Inputs: guild_id (required), sticker_id (required), reason.
delete_guild_templateCDestructive
Delete Guild Template. [DELETE /guilds/{guild_id}/templates/{template_code}]
Inputs: guild_id (required), template_code (required), reason.
delete_inviteCDestructive
Revoke an invite. [DELETE /invites/{invite_code}]
Inputs: invite_code (required), reason.
delete_messageADestructive
Delete a message (yours, or anyone's with Manage Messages). [DELETE /channels/{channel_id}/messages/{message_id}]
Inputs: channel_id (required), message_id (required), reason.
delete_notification_center_itemCDestructive
Delete Notification Center Item. [DELETE /users/@me/notification-center/items/{item_id}]
Inputs: item_id (required), item_type.
delete_notification_settings_snapshotCDestructive
Delete Notification Settings Snapshot. [DELETE /users/@me/notification-settings/snapshots/{snapshot_id}]
Inputs: snapshot_id (required).
delete_read_stateBDestructive
Mark a channel as unread (delete its read state). [DELETE /channels/{channel_id}/messages/ack]
Inputs: channel_id (required), version, read_state_type.
delete_recent_avatarCDestructive
Delete Recent Avatar. [DELETE /users/@me/avatars/{avatar_id}]
Inputs: avatar_id (required).
delete_stage_instanceCDestructive
End a live stage. [DELETE /stage-instances/{channel_id}]
Inputs: channel_id (required), reason.
delete_user_connectionCDestructive
Delete User Connection. [DELETE /users/@me/connections/{connection_type}/{connection_id}]
Inputs: connection_id (required), connection_type (required).
delete_webhookCDestructive
Delete Webhook. [DELETE /webhooks/{webhook_id}]
Inputs: webhook_id (required), reason.
delete_webhook_messageBDestructive
Delete Webhook Message. [DELETE /webhooks/{webhook_id}/{webhook_token}/messages/{message_id}]
Inputs: message_id (required), webhook_id (required), webhook_token (required), reason.
delete_webhook_with_tokenBDestructive
Delete Webhook with Token. [DELETE /webhooks/{webhook_id}/{webhook_token}]
Inputs: webhook_id (required), webhook_token (required), reason.
disconnect_member_from_voiceCDestructive
Disconnect a member from voice.
Inputs: user_id (required), guild_id (required), reason.
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.
Inputs: path (required), method (required), body, files, +2 more.
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.
Inputs: no named parameters.
discord_login_statusBRead-only
Check (or wait for) the QR-code login started with discord_login.
Inputs: wait, login_id.
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.
Inputs: token (required), type.
discord_logoutADestructive
Forget the saved login on this machine. With revoke=true also invalidates the token at Discord (logs this session out everywhere it is used).
Inputs: revoke.
dismiss_mentionADestructive
Remove a message from your mentions inbox. [DELETE /users/@me/mentions/{message_id}]
Inputs: message_id (required).
download_attachmentsA
Download a message's attachments (or any CDN URL) to local files and return their paths.
Inputs: dir, url, message, channel_id.
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}]
Inputs: channel_id (required), message_id (required), attachments (required), files, +5 more.
edit_my_messageA
Change the text of one of your messages (message link, or ID + channel_id).
Inputs: content (required), message (required), channel_id.
edit_webhook_messageC
Edit Webhook Message. [PATCH /webhooks/{webhook_id}/{webhook_token}/messages/{message_id}]
Inputs: message_id (required), webhook_id (required), webhook_token (required), tts, +8 more.
end_pollA
End a poll early (only the poll creator). [POST /channels/{channel_id}/polls/{message_id}/expire]
Inputs: channel_id (required), message_id (required).
execute_automod_alert_actionC
Execute AutoMod Alert Action. [POST /guilds/{guild_id}/auto-moderation/alert-action]
Inputs: guild_id (required), channel_id (required), message_id (required), alert_action_type (required), +1 more.
execute_webhookB
Post a message through a webhook (custom username/avatar, embeds and components allowed). [POST /webhooks/{webhook_id}/{webhook_token}]
Inputs: webhook_id (required), webhook_token (required), tts, poll, +14 more.
find_channelsBRead-only
Find channels by name across all your servers (and DMs by person name). Needs the live connection.
Inputs: query (required), limit, guild_id.
find_usersARead-only
Find people by name among your friends, DM contacts and (with guild_id) a server's members.
Inputs: query (required), limit, guild_id.
follow_channelB
Follow an announcement channel into one of your server channels (needs Manage Webhooks there). [POST /channels/{channel_id}/followers]
Inputs: channel_id (required), webhook_channel_id (required).
forward_messageA
Forward a message to another channel or DM (Discord's native forward).
Inputs: message (required), comment, to_user_id, to_channel_id, +1 more.
get_account_standingARead-only
Your account standing / safety hub status (warnings, violations). [GET /safety-hub/@me]
Inputs: no named parameters.
get_app_command_indexCRead-only
Get Application Command Index. [GET /applications/{application_id}/application-command-index]
Inputs: application_id (required).
get_app_directory_appCRead-only
Get Application Directory Application. [GET /application-directory-static/applications/{application_id}]
Inputs: application_id (required), locale, nocache, with_localizations.
get_applicationCRead-only
Get Application. [GET /applications/{application_id}]
Inputs: application_id (required).
get_application_command_permissionsCRead-only
Get Application Command Permissions. [GET /applications/{application_id}/guilds/{guild_id}/commands/{command_id}/permissions]
Inputs: guild_id (required), command_id (required), application_id (required).
get_application_emojiCRead-only
Get Application Emoji. [GET /applications/{application_id}/emojis/{emoji_id}]
Inputs: emoji_id (required), application_id (required).
get_audit_logARead-only
Read the server audit log (needs View Audit Log). Filter by user_id, action_type, before/after. [GET /guilds/{guild_id}/audit-logs]
Inputs: guild_id (required), after, limit, before, +3 more.
get_authorized_appBRead-only
Get OAuth2 Authorization. [GET /oauth2/tokens/{token_id}]
Inputs: token_id (required).
get_call_eligibilityCRead-only
Get Call Eligibility. [GET /channels/{channel_id}/call]
Inputs: channel_id (required).
get_channelBRead-only
Get a channel, thread or DM by ID (raw object). [GET /channels/{channel_id}]
Inputs: channel_id (required).
get_channel_command_indexBRead-only
All commands usable in a channel or DM. [GET /channels/{channel_id}/application-command-index]
Inputs: channel_id (required).
get_channel_infoBRead-only
Readable info about a channel/thread/DM (type, server, topic, recipients, last activity).
Inputs: channel_id (required).
get_channel_media_previewCRead-only
Get Channel Media Preview. [GET /channels/{channel_id}/media-post-preview]
Inputs: channel_id (required).
get_channel_treeARead-only
Show a server's channels as a tree (categories → channels) with types, topics and unread markers; hides channels you cannot see.
Inputs: guild_id (required), include_hidden, include_threads.
get_current_guild_memberARead-only
Get your own member object in a server. [GET /users/@me/guilds/{guild_id}/member]
Inputs: guild_id (required).
get_current_userARead-only
Get your own account (username, email, phone, MFA, Nitro…). [GET /users/@me]
Inputs: with_analytics_token.
get_current_user_guild_join_requestCRead-only
Get Current User Guild Join Request. [GET /guilds/{guild_id}/requests/@me]
Inputs: guild_id (required).
get_current_user_voice_stateCRead-only
Get Current User Voice State. [GET /guilds/{guild_id}/voice-states/@me]
Inputs: guild_id (required).
get_directory_countsCRead-only
Get Directory Counts. [GET /channels/{channel_id}/directory-entries/counts]
Inputs: channel_id (required).
get_directory_entryCRead-only
Get Directory Entry. [GET /channels/{channel_id}/directory-entry/{entity_id}]
Inputs: entity_id (required), channel_id (required).
get_discovery_slugCRead-only
Get Discovery Slug. [GET /discovery/{guild_id}]
Inputs: guild_id (required).
get_dm_channelARead-only
Get the existing DM channel with a user (if any). [GET /users/@me/dms/{user_id}]
Inputs: user_id (required).
get_email_settingsCRead-only
Get Email Settings. [GET /users/@me/email-settings]
Inputs: no named parameters.
get_emoji_guildCRead-only
Get Emoji Guild. [GET /emojis/{emoji_id}/guild]
Inputs: emoji_id (required).
get_emoji_sourceARead-only
Find which server a custom emoji is from (and whether you can join it). [GET /emojis/{emoji_id}/source]
Inputs: emoji_id (required).
get_eventsARead-only
Recent live events received since connecting (new/edited/deleted messages, reactions, friend requests, calls, joins…). Use since_seq to poll for only new ones.
Inputs: limit, types, guild_id, since_seq, +2 more.
get_global_application_commandCRead-only
Get Global Application Command. [GET /applications/{application_id}/commands/{command_id}]
Inputs: command_id (required), application_id (required).
get_guildBRead-only
Get a server's full settings object. [GET /guilds/{guild_id}]
Inputs: guild_id (required), with_counts.
get_guild_application_commandCRead-only
Get Guild Application Command. [GET /applications/{application_id}/guilds/{guild_id}/commands/{command_id}]
Inputs: guild_id (required), command_id (required), application_id (required).
get_guild_automod_ruleBRead-only
Get Guild AutoMod Rule. [GET /guilds/{guild_id}/auto-moderation/rules/{rule_id}]
Inputs: rule_id (required), guild_id (required).
get_guild_banBRead-onlyDestructive
Check whether a user is banned (and why). [GET /guilds/{guild_id}/bans/{user_id}]
Inputs: user_id (required), guild_id (required).
get_guild_command_indexARead-only
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]
Inputs: guild_id (required).
get_guild_discovery_metadataCRead-only
Get Guild Discovery Metadata. [GET /guilds/{guild_id}/discovery-metadata]
Inputs: guild_id (required).
get_guild_discovery_requirementsCRead-only
Get Guild Discovery Requirements. [GET /guilds/{guild_id}/discovery-requirements]
Inputs: guild_id (required).
get_guild_emojiCRead-only
Get Guild Emoji. [GET /guilds/{guild_id}/emojis/{emoji_id}]
Inputs: emoji_id (required), guild_id (required).
get_guild_integration_application_idsCRead-only
Get Guild Integration Application IDs. [GET /users/@me/guilds/integration-application-ids]
Inputs: no named parameters.
get_guild_join_requestCRead-only
Get Guild Join Request. [GET /join-requests/{request_id}]
Inputs: request_id (required).
get_guild_join_request_cooldownCRead-only
Get Guild Join Request Cooldown. [GET /guilds/{guild_id}/requests/@me/cooldown]
Inputs: guild_id (required).
get_guild_memberARead-only
Get one member of a server (roles, nickname, join date, timeout). [GET /guilds/{guild_id}/members/{user_id}]
Inputs: user_id (required), guild_id (required).
get_guild_member_verificationCRead-only
Get Guild Member Verification. [GET /guilds/{guild_id}/member-verification]
Inputs: guild_id (required), with_guild, invite_code.
get_guild_new_member_actionsCRead-only
Get Guild New Member Actions. [GET /guilds/{guild_id}/new-member-actions]
Inputs: guild_id (required).
get_guild_new_member_welcomeCRead-only
Get Guild New Member Welcome. [GET /guilds/{guild_id}/new-member-welcome]
Inputs: guild_id (required).
get_guild_onboardingCRead-only
Get Guild Onboarding. [GET /guilds/{guild_id}/onboarding]
Inputs: guild_id (required).
get_guild_previewARead-only
Preview a server (name, counts, emojis, features) — works for discoverable servers you are not in. [GET /guilds/{guild_id}/preview]
Inputs: guild_id (required).
get_guild_profileCRead-only
Get Guild Profile. [GET /guilds/{guild_id}/profile]
Inputs: guild_id (required).
get_guild_pruneBRead-onlyDestructive
Count members a prune would remove (inactive for N days). [GET /guilds/{guild_id}/prune]
Inputs: guild_id (required), days, include_roles.
get_guild_roleCRead-only
Get Guild Role. [GET /guilds/{guild_id}/roles/{role_id}]
Inputs: role_id (required), guild_id (required).
get_guild_role_member_countsCRead-only
Member count of every role. [GET /guilds/{guild_id}/roles/member-counts]
Inputs: guild_id (required).
get_guild_scheduled_eventCRead-only
Get Guild Scheduled Event. [GET /guilds/{guild_id}/scheduled-events/{event_id}]
Inputs: event_id (required), guild_id (required), with_user_count.
get_guild_scheduled_event_user_countCRead-only
Get Guild Scheduled Event User Count. [GET /guilds/{guild_id}/scheduled-events/{event_id}/users/counts]
Inputs: event_id (required), guild_id (required), guild_scheduled_event_exception_ids.
get_guild_soundboard_soundCRead-only
Get Guild Soundboard Sound. [GET /guilds/{guild_id}/soundboard-sounds/{sound_id}]
Inputs: guild_id (required), sound_id (required).
get_guild_stickerBRead-only
Get Guild Sticker. [GET /guilds/{guild_id}/stickers/{sticker_id}]
Inputs: guild_id (required), sticker_id (required).
get_guild_templateBRead-only
Look up a server template by code. [GET /guilds/templates/{template_code}]
Inputs: template_code (required).
get_guild_vanity_inviteCRead-only
Get Guild Vanity Invite. [GET /guilds/{guild_id}/vanity-url]
Inputs: guild_id (required).
get_guild_welcome_screenCRead-only
Get Guild Welcome Screen. [GET /guilds/{guild_id}/welcome-screen]
Inputs: guild_id (required).
get_guild_widgetCRead-only
Get Guild Widget. [GET /guilds/{guild_id}/widget.json]
Inputs: guild_id (required).
get_guild_widget_settingsCRead-only
Get Guild Widget Settings. [GET /guilds/{guild_id}/widget]
Inputs: guild_id (required).
get_inviteARead-only
Look up an invite (server, channel, inviter, counts) without joining. [GET /invites/{invite_code}]
Inputs: invite_code (required), with_counts, with_expiration, guild_scheduled_event_id.
get_messageARead-only
Get a single message by ID (raw Discord object). For readable history use read_messages. [GET /channels/{channel_id}/messages/{message_id}]
Inputs: channel_id (required), message_id (required).
get_message_request_detailsBRead-only
Get extra details (e.g. mutual servers) for pending message requests. [GET /users/@me/message-requests/supplemental-data]
Inputs: channel_ids.
get_my_app_role_connectionCRead-only
Get User Application Role Connection. [GET /users/@me/applications/{application_id}/role-connection]
Inputs: application_id (required).
get_my_permissionsBRead-only
Your effective permissions in a server, or in a specific channel (computed from roles and overwrites).
Inputs: guild_id (required), channel_id.
get_partial_applicationCRead-only
Get Partial Application. [GET /applications/{application_id}/public]
Inputs: application_id (required), with_guild.
get_role_linked_requirementsBRead-only
Get Guild Role Connection Configuration. [GET /guilds/{guild_id}/roles/{role_id}/connections/configuration]
Inputs: role_id (required), guild_id (required).
get_rpc_applicationCRead-only
Get RPC Application. [GET /applications/{application_id}/rpc]
Inputs: application_id (required).
get_server_insightsBRead-only
Server Insights analytics (Community servers, needs View Server Insights): growth, joins, leavers, retention, engagement, channel stats, audience.
Inputs: report (required), guild_id (required), end, start, +1 more.
get_soundboard_sound_guildCRead-only
Get Soundboard Sound Guild. [GET /soundboard-sounds/{sound_id}/guild/{guild_id}]
Inputs: guild_id (required), sound_id (required).
get_stage_instanceCRead-only
Get Stage Instance. [GET /stage-instances/{channel_id}]
Inputs: channel_id (required).
get_stickerCRead-only
Get Sticker. [GET /stickers/{sticker_id}]
Inputs: sticker_id (required).
get_sticker_guildCRead-only
Get Sticker Guild. [GET /stickers/{sticker_id}/guild]
Inputs: sticker_id (required).
get_sticker_packCRead-only
Get Sticker Pack. [GET /sticker-packs/{pack_id}]
Inputs: pack_id (required).
get_thread_memberCRead-only
Get Thread Member. [GET /channels/{channel_id}/thread-members/{user_id}]
Inputs: user_id (required), channel_id (required), with_member.
get_userARead-only
Get a user's basic public info. [GET /users/{user_id}]
Inputs: user_id (required).
get_user_command_indexCRead-only
Commands of user-installed apps. [GET /users/@me/application-command-index]
Inputs: no named parameters.
get_user_noteARead-only
Your private note on a user. [GET /users/@me/notes/{user_id}]
Inputs: user_id (required).
get_user_notesBRead-only
All your private notes on users. [GET /users/@me/notes]
Inputs: no named parameters.
get_user_profileARead-only
Get a user's full profile: bio, pronouns, badges, connected accounts, mutual servers and friends. [GET /users/{user_id}/profile]
Inputs: user_id (required), guild_id, with_mutual_guilds, with_mutual_friends, +1 more.
get_user_settingsARead-only
Your client settings (status, theme, locale, guild folders, privacy…). [GET /users/@me/settings]
Inputs: no named parameters.
get_user_voice_stateCRead-only
Get User Voice State. [GET /guilds/{guild_id}/voice-states/{user_id}]
Inputs: user_id (required), guild_id (required).
get_webhookCRead-only
Get Webhook. [GET /webhooks/{webhook_id}]
Inputs: webhook_id (required).
get_webhook_messageBRead-only
Get Webhook Message. [GET /webhooks/{webhook_id}/{webhook_token}/messages/{message_id}]
Inputs: message_id (required), webhook_id (required), webhook_token (required).
get_webhook_with_tokenCRead-only
Get Webhook with Token. [GET /webhooks/{webhook_id}/{webhook_token}]
Inputs: webhook_id (required), webhook_token (required).
ignore_userA
Ignore a user (hide their messages without blocking). [PUT /users/@me/relationships/{user_id}/ignore]
Inputs: user_id (required).
join_guildB
Join a discoverable server by ID (or lurk with lurker=true). [PUT /guilds/{guild_id}/members/@me]
Inputs: guild_id (required), lurker, location, session_id.
join_hypesquad_houseA
Join a HypeSquad house: 1 Bravery, 2 Brilliance, 3 Balance. [POST /hypesquad/online]
Inputs: house_id (required).
join_serverA
Join a server with an invite link or code (same as clicking an invite). New accounts may be asked for a captcha.
Inputs: invite (required).
join_threadC
Join a thread. [PUT /channels/{channel_id}/thread-members/@me]
Inputs: channel_id (required), location.
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.
Inputs: channel_id (required), ring, self_deaf, self_mute, +1 more.
kick_memberBDestructive
Kick a member from a server. [DELETE /guilds/{guild_id}/members/{user_id}]
Inputs: user_id (required), guild_id (required), reason.
launch_embedded_activityA
Launch an Activity (game/app) in a voice channel you are in. [POST /activities/{channel_id}/{application_id}]
Inputs: channel_id (required), session_id (required), application_id (required).
leave_guildCDestructive
Leave a server. [DELETE /users/@me/guilds/{guild_id}]
Inputs: guild_id (required), lurking.
leave_hypesquad_houseADestructive
Leave your HypeSquad house. [DELETE /hypesquad/online]
Inputs: no named parameters.
leave_threadBDestructive
Leave a thread. [DELETE /channels/{channel_id}/thread-members/@me]
Inputs: channel_id (required), location.
leave_voice_channelA
Disconnect from voice (in a server: pass guild_id; omit for DM calls).
Inputs: guild_id.
list_app_directory_categoriesCRead-only
List Application Directory Categories. [GET /application-directory-static/categories]
Inputs: locale.
list_app_directory_collectionsCRead-only
List Application Directory Collections. [GET /application-directory-static/collections]
Inputs: cache, locale, surface, platform, +1 more.
list_application_emojisCRead-only
List Application Emojis. [GET /applications/{application_id}/emojis]
Inputs: application_id (required).
list_applicationsCRead-only
Apps you own in the developer portal. [GET /applications]
Inputs: with_team_applications.
list_application_testersCRead-only
List Application Testers. [GET /oauth2/applications/{application_id}/allowlist]
Inputs: application_id (required).
list_authorized_appsBRead-only
Apps you have authorized with your account (Settings → Authorized Apps). [GET /oauth2/tokens]
Inputs: application_ids.
list_channel_affinitiesBRead-only
Channels you interact with most. [GET /users/@me/affinities/channels]
Inputs: no named parameters.
list_channel_integrationsCRead-only
List Channel Integrations. [GET /channels/{channel_id}/integrations]
Inputs: channel_id (required).
list_channel_invitesBRead-only
List invites to a channel. [GET /channels/{channel_id}/invites]
Inputs: channel_id (required).
list_channel_webhooksCRead-only
List Channel Webhooks. [GET /channels/{channel_id}/webhooks]
Inputs: channel_id (required).
list_commandsBRead-only
List slash commands and context-menu commands you can use in a channel/DM (from all bots there and your user-installed apps).
Inputs: channel_id (required), query, application_id.
list_default_soundboard_soundsBRead-only
List Default Soundboard Sounds. [GET /soundboard-default-sounds]
Inputs: no named parameters.
list_directory_entriesCRead-only
List Directory Entries. [GET /channels/{channel_id}/directory-entries]
Inputs: channel_id (required), type, category_id.
list_discoverable_guildsCRead-only
Browse featured public servers. [GET /discoverable-guilds]
Inputs: limit, offset, guild_ids, categories, +1 more.
list_discovery_categoriesCRead-only
List Discovery Categories. [GET /discovery/categories]
Inputs: locale, primary_only.
list_dmsARead-only
List your DMs and group DMs, most recent first, with unread markers.
Inputs: limit, unread_only.
list_embedded_activitiesCRead-only
List Embedded Activities. [GET /activities/shelf]
Inputs: guild_id.
list_friendsARead-only
List friends, blocked users and pending friend requests in readable form.
Inputs: type.
list_friend_suggestionsCRead-only
Friend suggestions. [GET /friend-suggestions]
Inputs: no named parameters.
list_global_application_commandsCRead-only
List Global Application Commands. [GET /applications/{application_id}/commands]
Inputs: application_id (required), with_localizations.
list_guild_active_threadsBRead-only
List all active threads in a server that you can see. [GET /guilds/{guild_id}/threads/active]
Inputs: guild_id (required).
list_guild_affinitiesBRead-only
Servers you interact with most. [GET /users/@me/affinities/guilds]
Inputs: no named parameters.
list_guild_application_command_permissionsBRead-only
List Guild Application Command Permissions. [GET /applications/{application_id}/guilds/{guild_id}/commands/permissions]
Inputs: guild_id (required), application_id (required).
list_guild_application_commandsCRead-only
List Guild Application Commands. [GET /applications/{application_id}/guilds/{guild_id}/commands]
Inputs: guild_id (required), application_id (required), with_localizations.
list_guild_applicationsCRead-only
Bots/apps installed in a server. [GET /guilds/{guild_id}/applications]
Inputs: guild_id (required), type, channel_id, include_team.
list_guild_automod_rulesBRead-only
List Guild AutoMod Rules. [GET /guilds/{guild_id}/auto-moderation/rules]
Inputs: guild_id (required).
list_guild_bansBRead-only
List banned users. [GET /guilds/{guild_id}/bans]
Inputs: guild_id (required), after, limit, before.
list_guild_channelsARead-only
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]
Inputs: guild_id (required), permissions, with_can_link_lobby.
list_guild_emojisBRead-only
List a server's custom emojis. [GET /guilds/{guild_id}/emojis]
Inputs: guild_id (required).
list_guild_integrationsCRead-only
List Guild Integrations. [GET /guilds/{guild_id}/integrations]
Inputs: guild_id (required), has_commands, include_role_connections_metadata.
list_guild_invitesARead-only
List all invites of a server (needs Manage Server). [GET /guilds/{guild_id}/invites]
Inputs: guild_id (required).
list_guild_join_requestsCRead-only
List Guild Join Requests. [GET /guilds/{guild_id}/requests]
Inputs: guild_id (required), after, limit, before, +1 more.
list_guild_membersARead-only
List server members (bots; user accounts usually need Manage Server). For search use search_members. [GET /guilds/{guild_id}/members]
Inputs: guild_id (required), after, limit.
list_guild_onboarding_allowed_applicationsCRead-only
List Guild Onboarding Allowed Applications. [GET /guilds/{guild_id}/onboarding/allowed-applications]
Inputs: guild_id (required).
list_guild_role_membersBRead-only
List member IDs that have a role (up to 100). [GET /guilds/{guild_id}/roles/{role_id}/member-ids]
Inputs: role_id (required), guild_id (required).
list_guild_rolesARead-only
List all roles in a server (with permissions). [GET /guilds/{guild_id}/roles]
Inputs: guild_id (required).
list_guildsARead-only
List the servers you are in (name, id, member counts, owner, unread/mention counts when live).
Inputs: no named parameters.
list_guild_scheduled_event_exception_usersCRead-only
List Guild Scheduled Event Exception Users. [GET /guilds/{guild_id}/scheduled-events/{event_id}/{exception_id}/users]
Inputs: event_id (required), guild_id (required), exception_id (required), after, +3 more.
list_guild_scheduled_eventsCRead-only
List Guild Scheduled Events. [GET /guilds/{guild_id}/scheduled-events]
Inputs: guild_id (required), with_user_count.
list_guild_scheduled_event_usersCRead-only
List Guild Scheduled Event Users. [GET /guilds/{guild_id}/scheduled-events/{event_id}/users]
Inputs: event_id (required), guild_id (required), after, limit, +3 more.
list_guild_soundboard_soundsCRead-only
List Guild Soundboard Sounds. [GET /guilds/{guild_id}/soundboard-sounds]
Inputs: guild_id (required).
list_guild_stickersCRead-only
List Guild Stickers. [GET /guilds/{guild_id}/stickers]
Inputs: guild_id (required).
list_guild_templatesCRead-only
List Guild Templates. [GET /guilds/{guild_id}/templates]
Inputs: guild_id (required).
list_guild_top_emojisCRead-only
List Guild Top Emojis. [GET /guilds/{guild_id}/top-emojis]
Inputs: guild_id (required).
list_guild_voice_regionsBRead-only
List Guild Voice Regions. [GET /guilds/{guild_id}/regions]
Inputs: guild_id (required).
list_guild_webhooksBRead-only
List Guild Webhooks. [GET /guilds/{guild_id}/webhooks]
Inputs: guild_id (required).
list_invite_friend_membersCRead-only
List Invite Friend Members. [GET /invites/{invite_code}/friend-members]
Inputs: invite_code (required).
list_joined_private_archived_threadsCRead-only
List Joined Private Archived Threads. [GET /channels/{channel_id}/users/@me/threads/archived/private]
Inputs: channel_id (required), limit, before.
list_login_sessionsARead-only
Devices logged into your account (Settings → Devices). [GET /auth/sessions]
Inputs: no named parameters.
list_members_with_unusual_dm_activityBRead-only
List members flagged for unusual DM activity (moderators). [GET /guilds/{guild_id}/members/unusual-dm-activity]
Inputs: guild_id (required), after, limit.
list_mentionsBRead-only
Your recent mentions inbox (pings across servers). [GET /users/@me/mentions]
Inputs: limit, roles, before, everyone, +1 more.
list_message_pinsARead-only
List pinned messages in a channel (newest pins first). [GET /channels/{channel_id}/messages/pins]
Inputs: channel_id (required), limit, before.
list_mutual_relationshipsBRead-only
List friends you have in common with a user. [GET /users/{user_id}/relationships]
Inputs: user_id (required).
list_my_app_role_connectionsBRead-only
List User Application Role Connections. [GET /users/@me/applications/role-connections]
Inputs: no named parameters.
list_my_game_activity_statsCRead-only
List User Application Activity Statistics. [GET /users/@me/activities/statistics/applications]
Inputs: no named parameters.
list_notification_center_itemsCRead-only
Notification center (activity inbox: friend requests, reminders…). [GET /users/@me/notification-center/items]
Inputs: after, limit, roles_filter, with_mentions, +1 more.
list_notification_settings_snapshotsBRead-only
List Notification Settings Snapshots. [GET /users/@me/notification-settings/snapshots]
Inputs: no named parameters.
list_partial_directory_entriesCRead-only
List Partial Directory Entries. [GET /channels/{channel_id}/directory-entries/list]
Inputs: channel_id (required), entity_ids.
list_pending_modalsBRead-only
Forms (modals) bots opened for you recently and their input fields.
Inputs: no named parameters.
list_poll_answer_votersBRead-only
List users who voted for a poll answer. [GET /channels/{channel_id}/polls/{message_id}/answers/{answer_id}]
Inputs: answer_id (required), channel_id (required), message_id (required), after, +1 more.
list_private_archived_threadsCRead-only
List Private Archived Threads. [GET /channels/{channel_id}/threads/archived/private]
Inputs: channel_id (required), limit, before.
list_public_archived_threadsCRead-only
List Public Archived Threads. [GET /channels/{channel_id}/threads/archived/public]
Inputs: channel_id (required), limit, before.
list_reactionsARead-only
List users who reacted to a message with an emoji. [GET /channels/{channel_id}/messages/{message_id}/reactions/{emoji}]
Inputs: emoji (required), channel_id (required), message_id (required), type, +2 more.
list_recent_avatarsBRead-only
List Recent Avatars. [GET /users/@me/avatars]
Inputs: no named parameters.
list_relationshipsARead-only
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]
Inputs: no named parameters.
list_saved_messagesBRead-only
List your saved ("bookmarked") messages. [GET /users/@me/saved-messages]
Inputs: no named parameters.
list_similar_directory_appsCRead-only
List Application Directory Similar Applications. [GET /application-directory-static/applications/{application_id}/similar]
Inputs: application_id (required), page, locale, guild_id.
list_sticker_packsBRead-only
List Sticker Packs. [GET /sticker-packs]
Inputs: no named parameters.
list_thread_membersCRead-only
List Thread Members. [GET /channels/{channel_id}/thread-members]
Inputs: channel_id (required), after, limit, with_member.
list_trending_gif_categoriesBRead-only
List Trending GIF Categories. [GET /gifs/trending]
Inputs: locale, provider, media_format.
list_trending_gifsCRead-only
List Trending GIFs. [GET /gifs/trending-gifs]
Inputs: limit, locale, provider, media_format.
list_unreadARead-only
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.
Inputs: all, guild_id.
list_user_affinities_v2BRead-only
Users you interact with most. [GET /users/@me/affinities/v2/users]
Inputs: no named parameters.
list_user_connectionsCRead-only
List User Connections. [GET /users/@me/connections]
Inputs: no named parameters.
list_user_connection_subredditsCRead-only
List User Connection Subreddits. [GET /users/@me/connections/reddit/{connection_id}/subreddits]
Inputs: connection_id (required).
list_user_guild_join_requestsCRead-only
List User Guild Join Requests. [GET /guilds/{guild_id}/requests/users/{user_id}]
Inputs: user_id (required), guild_id (required).
list_user_guild_scheduled_eventsBRead-only
List events you marked as interested in, across servers. [GET /users/@me/scheduled-events]
Inputs: guild_ids.
list_user_invitesARead-only
List your friend invites. [GET /users/@me/invites]
Inputs: no named parameters.
list_user_linked_connectionsBRead-only
List User Linked Connections. [GET /users/@me/linked-connections]
Inputs: no named parameters.
list_voice_membersBRead-only
Who is in voice channels of a server right now (optionally one channel), with mute/deafen/stream flags. Also shows where you are connected.
Inputs: guild_id (required), channel_id.
list_voice_regionsBRead-only
Voice regions available for calls/channels. [GET /voice/regions]
Inputs: no named parameters.
logout_login_sessionsA
Log out other devices by session hash (session_id_hashes from list_login_sessions). [POST /auth/sessions/logout]
Inputs: session_id_hashes (required).
mark_interested_in_eventB
Mark yourself as interested in an event. [PUT /guilds/{guild_id}/scheduled-events/{event_id}/users/@me]
Inputs: event_id (required), guild_id (required).
mark_interested_in_event_occurrenceC
Create Guild Scheduled Event Exception User. [PUT /guilds/{guild_id}/scheduled-events/{event_id}/{exception_id}/users/@me]
Inputs: event_id (required), guild_id (required), response (required), exception_id (required).
mark_readA
Mark as read: one channel/DM (channel_id), a whole server (guild_id), or everything (all=true).
Inputs: all, guild_id, channel_id.
modify_applicationC
Modify Application. [PATCH /applications/{application_id}]
Inputs: application_id (required), role_connections_verification_url (required), icon, name, +28 more.
modify_application_command_permissionsC
Modify Application Command Permissions. [PUT /applications/{application_id}/guilds/{guild_id}/commands/{command_id}/permissions]
Inputs: guild_id (required), command_id (required), permissions (required), application_id (required).
modify_application_emojiC
Modify Application Emoji. [PATCH /applications/{application_id}/emojis/{emoji_id}]
Inputs: emoji_id (required), application_id (required), name.
modify_audio_settingsC
Modify Audio Settings. [PATCH /users/@me/audio-settings/{audio_context_type}/{user_id}]
Inputs: user_id (required), audio_context_type (required), muted, volume, +1 more.
modify_automod_incident_actionsC
Modify AutoMod Incident Actions. [PUT /guilds/{guild_id}/incident-actions]
Inputs: guild_id (required), reason, dms_disabled_until, invites_disabled_until.
modify_callA
Change the voice region of a DM/group call. [PATCH /channels/{channel_id}/call]
Inputs: channel_id (required), region.
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}]
Inputs: channel_id (required), icon, name, nsfw, +24 more.
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}]
Inputs: type (required), channel_id (required), overwrite_id (required), deny, +2 more.
modify_channel_tagC
Edit a forum tag. [PUT /channels/{channel_id}/tags/{tag_id}]
Inputs: name (required), tag_id (required), channel_id (required), moderated, +1 more.
modify_current_guild_memberA
Change your own server nickname / server avatar / banner / bio. [PATCH /guilds/{guild_id}/members/@me]
Inputs: guild_id (required), bio, nick, avatar, +3 more.
modify_current_userB
Edit your account: username (needs password), display name (global_name), avatar, banner, bio, accent colour… [PATCH /users/@me]
Inputs: bio, email, flags, avatar, +16 more.
modify_current_user_accountB
Edit account-level fields (global_name, avatar, bio…). [PATCH /users/@me/account]
Inputs: global_name.
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]
Inputs: guild_id (required), reason, suppress, channel_id, +1 more.
modify_directory_entryB
Modify Directory Entry. [PATCH /channels/{channel_id}/directory-entry/{entity_id}]
Inputs: entity_id (required), channel_id (required), description, primary_category_id.
modify_email_settingsC
Modify Email Settings. [PATCH /users/@me/email-settings]
Inputs: settings (required).
modify_global_application_commandC
Modify Global Application Command. [PATCH /applications/{application_id}/commands/{command_id}]
Inputs: command_id (required), application_id (required), default_member_permissions (required), name, +8 more.
modify_guildB
Edit server settings: name, icon, banner, description, verification level, system/rules/AFK channels, ownership… [PATCH /guilds/{guild_id}]
Inputs: guild_id (required), code, icon, name, +21 more.
modify_guild_application_commandC
Modify Guild Application Command. [PATCH /applications/{application_id}/guilds/{guild_id}/commands/{command_id}]
Inputs: guild_id (required), command_id (required), application_id (required), name, +6 more.
modify_guild_automod_ruleC
Modify Guild AutoMod Rule. [PATCH /guilds/{guild_id}/auto-moderation/rules/{rule_id}]
Inputs: rule_id (required), guild_id (required), name, reason, +6 more.
modify_guild_channel_positionsA
Reorder channels / move them between categories. positions: [{id, position?, parent_id?, lock_permissions?}]. [PATCH /guilds/{guild_id}/channels]
Inputs: guild_id (required), positions (required), reason.
modify_guild_discovery_metadataD
Modify Guild Discovery Metadata. [PATCH /guilds/{guild_id}/discovery-metadata]
Inputs: guild_id (required), about, reason, keywords, +5 more.
modify_guild_emojiB
Rename an emoji or change which roles can use it. [PATCH /guilds/{guild_id}/emojis/{emoji_id}]
Inputs: emoji_id (required), guild_id (required), name, roles, +1 more.
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}]
Inputs: user_id (required), guild_id (required), deaf, mute, +6 more.
modify_guild_member_profileB
Edit your per-server profile (server avatar, banner, bio, pronouns). [PATCH /guilds/{guild_id}/profile/@me]
Inputs: guild_id (required), bio, nick, avatar, +3 more.
modify_guild_member_verificationC
Modify Guild Member Verification. [PATCH /guilds/{guild_id}/member-verification]
Inputs: guild_id (required), reason, enabled, bulk_action, +2 more.
modify_guild_new_member_welcomeC
Modify Guild New Member Welcome. [PUT /guilds/{guild_id}/new-member-welcome]
Inputs: guild_id (required), reason, enabled, welcome_message, +2 more.
modify_guild_onboardingC
Modify Guild Onboarding. [PUT /guilds/{guild_id}/onboarding]
Inputs: guild_id (required), mode, reason, enabled, +2 more.
modify_guild_onboarding_responsesC
Modify Guild Onboarding Responses. [PUT /guilds/{guild_id}/onboarding-responses]
Inputs: guild_id (required), onboarding_responses, onboarding_prompts_seen, onboarding_responses_seen.
modify_guild_profileC
Modify Guild Profile. [PATCH /guilds/{guild_id}/profile]
Inputs: guild_id (required), reason.
modify_guild_roleB
Edit a role: name, colour, permissions, hoist, mentionable, icon. [PATCH /guilds/{guild_id}/roles/{role_id}]
Inputs: role_id (required), guild_id (required), icon, name, +7 more.
modify_guild_role_positionsB
Reorder roles. positions: [{id, position}]. [PATCH /guilds/{guild_id}/roles]
Inputs: guild_id (required), positions (required), reason.
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}]
Inputs: event_id (required), guild_id (required), name, image, +10 more.
modify_guild_scheduled_event_exceptionC
Modify Guild Scheduled Event Exception. [PATCH /guilds/{guild_id}/scheduled-events/{event_id}/exceptions/{exception_id}]
Inputs: event_id (required), guild_id (required), exception_id (required), reason, +3 more.
modify_guild_soundboard_soundC
Edit a soundboard sound. [PATCH /guilds/{guild_id}/soundboard-sounds/{sound_id}]
Inputs: guild_id (required), sound_id (required), name, reason, +2 more.
modify_guild_stickerB
Edit a sticker's name, description or tags. [PATCH /guilds/{guild_id}/stickers/{sticker_id}]
Inputs: guild_id (required), sticker_id (required), name, tags, +2 more.
modify_guild_templateC
Modify Guild Template. [PATCH /guilds/{guild_id}/templates/{template_code}]
Inputs: guild_id (required), template_code (required), name, reason, +1 more.
modify_guild_vanity_inviteC
Modify Guild Vanity Invite. [PATCH /guilds/{guild_id}/vanity-url]
Inputs: code (required), guild_id (required), reason.
modify_guild_welcome_screenC
Modify Guild Welcome Screen. [PATCH /guilds/{guild_id}/welcome-screen]
Inputs: guild_id (required), reason, enabled, description, +1 more.
modify_guild_widgetC
Modify Guild Widget. [PATCH /guilds/{guild_id}/widget]
Inputs: guild_id (required), reason, enabled, channel_id.
modify_notification_settingsC
Desktop/mobile notification flags. [PATCH /users/@me/notification-settings]
Inputs: flags.
modify_stage_instanceB
Change a live stage's topic. [PATCH /stage-instances/{channel_id}]
Inputs: channel_id (required), topic, reason, privacy_level.
modify_thread_settingsB
Change your notification settings for a thread. [PATCH /channels/{channel_id}/thread-members/@me/settings]
Inputs: channel_id (required), flags, muted, mute_config.
modify_user_connectionB
Modify User Connection. [PATCH /users/@me/connections/{connection_type}/{connection_id}]
Inputs: name (required), visibility (required), friend_sync (required), connection_id (required), +3 more.
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]
Inputs: guild_id (required), flags, muted, mobile_push, +8 more.
modify_user_profileB
Edit your profile: bio, pronouns, banner, accent colour, profile theme colours. [PATCH /users/@me/profile]
Inputs: bio, banner, pronouns, accent_color, +2 more.
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]
Inputs: theme, locale, status, afk_timeout, +30 more.
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}]
Inputs: user_id (required), guild_id (required), channel_id (required), reason, +1 more.
modify_webhookC
Modify Webhook. [PATCH /webhooks/{webhook_id}]
Inputs: webhook_id (required), name, avatar, reason, +1 more.
modify_webhook_with_tokenC
Modify Webhook with Token. [PATCH /webhooks/{webhook_id}/{webhook_token}]
Inputs: webhook_id (required), webhook_token (required), name, avatar, +1 more.
move_member_to_voiceA
Move a member to another voice channel (needs Move Members).
Inputs: user_id (required), guild_id (required), channel_id (required), reason.
mute_channelC
Mute a channel or DM (optionally for N minutes).
Inputs: channel_id (required), minutes.
mute_serverB
Mute a server's notifications (optionally for N minutes).
Inputs: guild_id (required), minutes.
open_dmA
Open (or get) the DM channel with a user; returns its channel ID.
Inputs: user_id (required).
open_message_linkARead-only
Open a discord.com/channels/… message link: returns the message plus a few messages of context around it.
Inputs: link (required), context.
pin_messageB
Pin a message in a channel. [PUT /channels/{channel_id}/messages/pins/{message_id}]
Inputs: channel_id (required), message_id (required), reason.
preview_app_authorizationARead-only
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]
Inputs: scope (required), client_id (required), state, permissions, +3 more.
prune_guildBDestructive
Kick members inactive for N days (optionally only those with given roles). [POST /guilds/{guild_id}/prune]
Inputs: guild_id (required), days, reason, include_roles, +1 more.
purge_my_messagesADestructive
Delete your own recent messages in a channel/DM (optionally only those containing some text). Goes slowly to respect rate limits.
Inputs: after, limit, dry_run, user_id, +2 more.
query_guild_membersARead-only
Search server members whose username/nickname starts with a query (REST; bots). User accounts: use search_members. [GET /guilds/{guild_id}/members/search]
Inputs: guild_id (required), limit, query.
reactB
React to a message by link (or channel_id + message_id) with one or more emojis.
Inputs: emojis (required), message (required), super, channel_id.
read_messagesARead-only
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.
Inputs: full, after, limit, since, +5 more.
reconnect_gatewayA
Reconnect the live gateway connection (use if live tools say the gateway is not ready).
Inputs: no named parameters.
refresh_user_connectionC
Refresh User Connection. [POST /users/@me/connections/{connection_type}/{connection_id}/refresh]
Inputs: connection_id (required), connection_type (required).
reject_message_requestBDestructive
Reject (delete) a DM message request. [DELETE /channels/{channel_id}/recipients/@me]
Inputs: channel_id (required).
remove_all_reactionsADestructive
Remove every reaction from a message (needs Manage Messages). [DELETE /channels/{channel_id}/messages/{message_id}/reactions]
Inputs: channel_id (required), message_id (required).
remove_all_reactions_for_emojiADestructive
Remove all reactions of one emoji from a message (needs Manage Messages). [DELETE /channels/{channel_id}/messages/{message_id}/reactions/{emoji}]
Inputs: emoji (required), channel_id (required), message_id (required).
remove_application_testerBDestructive
Remove Application Tester. [DELETE /oauth2/applications/{application_id}/allowlist/{user_id}]
Inputs: user_id (required), application_id (required).
remove_channel_recipientADestructive
Remove a user from a group DM you own. [DELETE /channels/{channel_id}/recipients/{user_id}]
Inputs: user_id (required), channel_id (required).
remove_friendBDestructive
Remove a friend (or cancel/decline a friend request).
Inputs: user_id (required).
remove_friend_suggestionCDestructive
Remove Friend Suggestion. [DELETE /friend-suggestions/{user_id}]
Inputs: user_id (required).
remove_guild_discovery_subcategoryCDestructive
Remove Guild Discovery Subcategory. [DELETE /guilds/{guild_id}/discovery-categories/{category_id}]
Inputs: guild_id (required), category_id (required), reason.
remove_member_roleCDestructive
Take a role away from a member. [DELETE /guilds/{guild_id}/members/{user_id}/roles/{role_id}]
Inputs: role_id (required), user_id (required), guild_id (required), reason.
remove_own_reactionADestructive
Remove your own reaction from a message. [DELETE /channels/{channel_id}/messages/{message_id}/reactions/{emoji}/{reaction_type}/@me]
Inputs: emoji (required), channel_id (required), message_id (required), reaction_type.
remove_relationshipADestructive
Remove a friend, cancel/decline a friend request, or unblock a user. [DELETE /users/@me/relationships/{user_id}]
Inputs: user_id (required).
remove_thread_memberCDestructive
Remove Thread Member. [DELETE /channels/{channel_id}/thread-members/{user_id}]
Inputs: user_id (required), channel_id (required), location.
remove_timeoutC
Remove a member's timeout.
Inputs: user_id (required), guild_id (required), reason.
remove_user_reactionADestructive
Remove another user's reaction (needs Manage Messages). [DELETE /channels/{channel_id}/messages/{message_id}/reactions/{emoji}/{reaction_type}/{user_id}]
Inputs: emoji (required), user_id (required), channel_id (required), message_id (required), +1 more.
reply_to_messageB
Reply to a specific message (give its link, or channel_id + message_id).
Inputs: message (required), tts, poll, files, +9 more.
report_automod_incidentC
Report AutoMod Incident. [POST /guilds/{guild_id}/auto-moderation/report-raid]
Inputs: guild_id (required), reason.
reset_guild_join_requestC
Reset Guild Join Request. [POST /guilds/{guild_id}/requests/@me]
Inputs: guild_id (required).
resolve_automod_incidentC
Resolve AutoMod Incident. [POST /guilds/{guild_id}/auto-moderation/false-alarm]
Inputs: reason (required), guild_id (required), alert_message_id (required).
revoke_user_invitesADestructive
Revoke all your friend invites. [DELETE /users/@me/invites]
Inputs: no named parameters.
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]
Inputs: channel_id (required), recipients.
run_context_commandB
Run an "Apps" right-click command on a user or a message (context-menu command).
Inputs: command (required), target_id (required), channel_id (required), wait_seconds, +1 more.
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).
Inputs: command (required), channel_id (required), files, options, +2 more.
save_messageB
Save (bookmark) a message for later. [PUT /users/@me/saved-messages/{channel_id}/{message_id}]
Inputs: channel_id (required), message_id (required), due_at.
search_app_directoryCRead-only
Search Applications Directory. [GET /application-directory-static/search]
Inputs: page, query, locale, source, +7 more.
search_directory_entriesCRead-only
Search Directory Entries. [GET /channels/{channel_id}/directory-entries/search]
Inputs: channel_id (required), type, query, category_id.
search_discoverable_guildsCRead-only
Search public servers in Server Discovery. [GET /discoverable-guilds/search]
Inputs: query (required), limit, offset, categories.
search_gifsARead-only
Search GIFs (Tenor/Giphy) like the GIF picker. Send the returned url as message content. [GET /gifs/search]
Inputs: q (required), limit, locale, provider, +1 more.
search_guild_bansBRead-only
Search the ban list by username. [GET /guilds/{guild_id}/bans/search]
Inputs: guild_id (required), limit, query, user_ids.
search_guild_membersB
Advanced member search (Manage Server/moderators): filters by roles, join date, join source, safety signals. [POST /guilds/{guild_id}/members-search]
Inputs: guild_id (required), sort, after, limit, +4 more.
search_membersBRead-only
Look up server members by name prefix (or by user_ids) through the live connection — works for normal user accounts.
Inputs: guild_id (required), limit, query, user_ids, +1 more.
search_messagesARead-only
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.
Inputs: has, after, limit, before, +11 more.
search_published_guildsCRead-only
Search Published Guilds. [GET /discovery/search]
Inputs: limit, query, offset.
search_threadsCRead-only
Search Threads. [GET /channels/{channel_id}/threads/search]
Inputs: channel_id (required), tag, name, slop, +8 more.
send_custom_call_soundC
Send Custom Call Sound. [POST /channels/{channel_id}/custom-call-sounds]
Inputs: channel_id (required), animation_id (required), animation_type (required).
send_dmB
Send a direct message to a user by user ID (opens the DM if needed).
Inputs: user_id (required), tts, poll, files, +9 more.
send_friend_requestA
Send a friend request by username (new usernames: discriminator "0" or omit). [POST /users/@me/relationships]
Inputs: username (required), note.
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.
Inputs: tts, poll, files, embeds, +10 more.
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]
Inputs: sound_id (required), channel_id (required), source_guild_id.
send_voice_channel_effectB
Send an emoji effect in the voice channel you are in. [POST /channels/{channel_id}/voice-channel-effects]
Inputs: channel_id (required), emoji_id, emoji_name, animation_type.
server_deafen_memberC
Server-deafen or undeafen a member in voice.
Inputs: deaf (required), user_id (required), guild_id (required), reason.
server_mute_memberC
Server-mute or unmute a member in voice.
Inputs: mute (required), user_id (required), guild_id (required), reason.
set_activityA
Show an activity on your profile: Playing / Listening to / Watching / Competing in / Streaming . Lasts while this MCP is connected.
Inputs: name (required), url, type, state, +3 more.
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).
Inputs: target_id (required), channel_id (required), target_type (required), deny, +2 more.
set_custom_statusA
Set (or clear) your custom status text/emoji, optionally expiring after N minutes.
Inputs: text, emoji, expires_in_minutes.
set_friend_nicknameB
Set a private nickname for a friend. [PATCH /users/@me/relationships/{user_id}]
Inputs: user_id (required), nickname.
set_headless_activityA
Show a "playing" activity without the gateway (headless session). Returns a token to delete it later. [POST /users/@me/headless-sessions]
Inputs: activities (required), token.
set_member_nicknameB
Change a member's server nickname (empty resets). For yourself use set_my_nickname.
Inputs: nick (required), user_id (required), guild_id (required), reason.
set_member_rolesB
Replace a member's whole role list.
Inputs: user_id (required), guild_id (required), role_ids (required), reason.
set_my_app_role_connectionB
Modify User Application Role Connection. [PUT /users/@me/applications/{application_id}/role-connection]
Inputs: application_id (required), metadata, platform_name, platform_username.
set_my_nicknameA
Change your own nickname in a server (empty resets).
Inputs: nick (required), guild_id (required).
set_role_linked_requirementsC
Modify Guild Role Connection Configuration. [PUT /guilds/{guild_id}/roles/{role_id}/connections/configuration]
Inputs: role_id (required), guild_id (required), reason.
set_server_notificationsB
Choose which messages notify you in a server: all, mentions or nothing; optionally suppress @everyone / role pings.
Inputs: level (required), guild_id (required), suppress_roles, suppress_everyone.
set_statusA
Set your online status: online, idle, dnd (Do Not Disturb) or invisible.
Inputs: status (required).
set_user_noteB
Set your private note on a user (only you can see it). [PUT /users/@me/notes/{user_id}]
Inputs: note (required), user_id (required).
set_voice_channel_statusC
Set the status text shown under a voice channel. [PUT /channels/{channel_id}/voice-status]
Inputs: channel_id (required), status.
set_voice_muteA
Mute/deafen/camera yourself in the voice channel you are in.
Inputs: guild_id, self_deaf, self_mute, self_video.
snowflake_infoARead-only
Convert a Discord ID to its creation time, or a time to an ID (for before/after cursors).
Inputs: id, time.
start_typingA
Show "is typing…" in a channel for ~10 seconds. [POST /channels/{channel_id}/typing]
Inputs: channel_id (required).
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]
Inputs: channel_id (required), recipients.
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.
Inputs: values (required), modal_id, wait_seconds.
sync_guild_templateC
Sync Guild Template. [PUT /guilds/{guild_id}/templates/{template_code}]
Inputs: guild_id (required), template_code (required), reason.
timeout_memberBDestructive
Time out a member (they cannot chat or join voice) for N minutes (max 40320 = 28 days).
Inputs: minutes (required), user_id (required), guild_id (required), reason.
unban_memberCDestructive
Unban a user. [DELETE /guilds/{guild_id}/bans/{user_id}]
Inputs: user_id (required), guild_id (required), reason.
unblock_userC
Unblock a user.
Inputs: user_id (required).
unignore_userADestructive
Stop ignoring a user. [DELETE /users/@me/relationships/{user_id}/ignore]
Inputs: user_id (required).
unmark_interested_in_eventADestructive
Remove your interest in an event. [DELETE /guilds/{guild_id}/scheduled-events/{event_id}/users/@me]
Inputs: event_id (required), guild_id (required).
unmark_interested_in_event_occurrenceCDestructive
Delete Guild Scheduled Event Exception User. [DELETE /guilds/{guild_id}/scheduled-events/{event_id}/{exception_id}/users/@me]
Inputs: event_id (required), guild_id (required), exception_id (required).
unmute_channelC
Unmute a channel or DM.
Inputs: channel_id (required).
unmute_serverC
Unmute a server.
Inputs: guild_id (required).
unpin_messageCDestructive
Unpin a message. [DELETE /channels/{channel_id}/messages/pins/{message_id}]
Inputs: channel_id (required), message_id (required), reason.
unsave_messageADestructive
Remove a message from your saved messages. [DELETE /users/@me/saved-messages/{channel_id}/{message_id}]
Inputs: channel_id (required), message_id (required).
use_guild_templateB
Create a new server from a template. [POST /guilds/templates/{template_code}]
Inputs: name (required), template_code (required), icon, reason.
validate_discovery_search_termCRead-only
Validate Discovery Search Term. [GET /discovery/valid-term]
Inputs: term.
validate_guild_automod_ruleC
Validate Guild AutoMod Rule. [POST /guilds/{guild_id}/auto-moderation/rules/validate]
Inputs: guild_id (required), trigger_metadata (required), reason.
view_imageBRead-only
Look at an image: a message attachment (message link/ID + optional index) or any image URL. Returns the image itself.
Inputs: url, index, message, channel_id.
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]
Inputs: answer_ids (required), channel_id (required), message_id (required).
wait_for_eventBRead-only
Wait for any gateway event type (e.g. MESSAGE_REACTION_ADD, RELATIONSHIP_ADD, CALL_CREATE, GUILD_MEMBER_ADD, VOICE_STATE_UPDATE).
Inputs: types (required), user_id, guild_id, channel_id, +1 more.
wait_for_messageBRead-only
Wait for the next incoming message (e.g. a reply) matching filters, up to timeout_seconds.
Inputs: contains, guild_id, author_id, channel_id, +3 more.
whoamiARead-only
Who is logged in, account type (user/bot), and live connection status (gateway, servers, DMs cached). Start here.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Discord MCP server for ChatGPT, Claude and any AI agent: list servers and channels, read channel messages, search messages, send message, reply to message, send DM, read mentions and assign role in your own Discord account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Discord yourself; Cotlet does not store your password and you need no Discord API key. About the official Discord API: Yes, Discord has an official API for bots and OAuth2 apps, but it acts as a bot that a server manager adds, not as you, and Discord has no official MCP server for it (checked 5 Nov 2026). The MCP server on Discord's docs site only searches documentation. Setup and FAQ: https://cotlet.dev/integrations/discord-api-mcp-server
Official AI/ML API server: 10,000+ AI tools and models for chat, image, video, audio, search, data.
Connect a Discord bot (bot token from the developer portal) to read/send messages, list guilds and c
Build and change Discord bots by describing them: slash commands, events, embeds, modals and data.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with the Discord platform through a bot, covering server info and member management, channel, forum, and role administration, message search and editing, reactions, and webhooks. It supports both stdio and streamable HTTP transports with token-based authentication.1,578 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables an AI assistant to drive a personal Discord account as if it were the user: reading and sending messages and DMs, managing servers, channels, roles, permissions, threads, invites and friends, joining voice, and clicking buttons, menus, modals and slash commands. An optional hardened mode runs it as an always-on local service with loopback-only HTTP access, encrypted credentials, an allowlist of reviewed tools, and an AFK session that keeps push notifications flowing.MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with the Discord platform, including listing servers and members, managing channels, categories, forums and roles, sending, searching, editing and deleting messages, handling reactions, permissions and webhooks, and operating through either stdio or streamable HTTP transports.1,578 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with the Discord platform, covering bot login, server and member inspection, channel, category and forum management, message reading, sending, editing and deletion, reactions, roles, and webhooks. Supports both stdio and streamable HTTP transports with token-based configuration.1,578 npmMIT