Skip to main content
Glama
discord-mcp

discord-mcp

by zongwei-tang

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.json with 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, ws and qrcode.

  • 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_request can 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 Code

Add it to your MCP client, for example Claude Code:

claude mcp add discord -- node /path/to/discord-mcp/dist/index.js

You 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_TOKEN in the MCP config's env.

  • For a bot, pass --bot with the --token login, or set DISCORD_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> with https://<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:

  1. On your own computer, run node dist/index.js login and scan the QR code. This works from a home connection.

  2. Run node dist/index.js token, which prints the saved token.

  3. On the server, set DISCORD_TOKEN to that value (for example as a Railway variable) and redeploy. Alternatively, call discord_login_token from 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_dm with files

  • "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 need submit_modal next)

  • "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

DISCORD_TOKEN

–

Use this token instead of the saved login

DISCORD_TOKEN_TYPE

user

bot for bot tokens (a Bot prefix also works)

DISCORD_GATEWAY

on

off turns off the live connection. Status, voice, slash commands, events and unread counts need it.

DISCORD_TOOLSETS

all

Comma-separated categories to expose. core gives the 212 everyday tools; see TOOLS.md for category names.

DISCORD_READ_ONLY

–

1 exposes only read-only tools

DISCORD_DISABLED_TOOLS

–

Comma-separated tool names to hide

DISCORD_MCP_HOME

~/.discord-mcp

Where the login, caches and downloads live

DISCORD_LOCALE, DISCORD_TIMEZONE

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.ts is the HTTP client. It handles web-client headers, X-Super-Properties with 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.ts keeps 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.ts handles 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) and meta.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.md

License

MIT

Available Tools

437 tools
accept_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_memberA
Destructive

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_userC
Destructive

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_membersA
Destructive

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_messagesA
Destructive

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_relationshipsA
Destructive

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_appB
Destructive

Revoke an app's access to your account. [DELETE /oauth2/tokens/{token_id}]

Inputs: token_id (required).

delete_application_emojiC
Destructive

Delete Application Emoji. [DELETE /applications/{application_id}/emojis/{emoji_id}]

Inputs: emoji_id (required), application_id (required).

delete_channelA
Destructive

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_integrationC
Destructive

Delete Channel Integration. [DELETE /channels/{channel_id}/integrations/{integration_id}]

Inputs: channel_id (required), integration_id (required).

delete_channel_permissionA
Destructive

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_tagB
Destructive

Delete a forum tag. [DELETE /channels/{channel_id}/tags/{tag_id}]

Inputs: tag_id (required), channel_id (required).

delete_directory_entryC
Destructive

Delete Directory Entry. [DELETE /channels/{channel_id}/directory-entry/{entity_id}]

Inputs: entity_id (required), channel_id (required).

delete_global_application_commandC
Destructive

Delete Global Application Command. [DELETE /applications/{application_id}/commands/{command_id}]

Inputs: command_id (required), application_id (required).

delete_guildB
Destructive

Permanently delete a server you own. Irreversible. [DELETE /guilds/{guild_id}]

Inputs: guild_id (required), reason.

delete_guild_application_commandB
Destructive

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_ruleB
Destructive

Delete Guild AutoMod Rule. [DELETE /guilds/{guild_id}/auto-moderation/rules/{rule_id}]

Inputs: rule_id (required), guild_id (required), reason.

delete_guild_emojiC
Destructive

Delete a custom emoji. [DELETE /guilds/{guild_id}/emojis/{emoji_id}]

Inputs: emoji_id (required), guild_id (required), reason.

delete_guild_integrationC
Destructive

Delete Guild Integration. [DELETE /guilds/{guild_id}/integrations/{integration_id}]

Inputs: guild_id (required), integration_id (required), reason.

delete_guild_join_requestA
Destructive

Delete Guild Join Request. [DELETE /guilds/{guild_id}/requests/@me]

Inputs: guild_id (required).

delete_guild_roleB
Destructive

Delete a role. [DELETE /guilds/{guild_id}/roles/{role_id}]

Inputs: role_id (required), guild_id (required), reason.

delete_guild_scheduled_eventC
Destructive

Delete a scheduled event. [DELETE /guilds/{guild_id}/scheduled-events/{event_id}]

Inputs: event_id (required), guild_id (required), reason.

delete_guild_scheduled_event_exceptionC
Destructive

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_soundB
Destructive

Delete a soundboard sound. [DELETE /guilds/{guild_id}/soundboard-sounds/{sound_id}]

Inputs: guild_id (required), sound_id (required), reason.

delete_guild_stickerC
Destructive

Delete a sticker. [DELETE /guilds/{guild_id}/stickers/{sticker_id}]

Inputs: guild_id (required), sticker_id (required), reason.

delete_guild_templateC
Destructive

Delete Guild Template. [DELETE /guilds/{guild_id}/templates/{template_code}]

Inputs: guild_id (required), template_code (required), reason.

delete_inviteC
Destructive

Revoke an invite. [DELETE /invites/{invite_code}]

Inputs: invite_code (required), reason.

delete_messageA
Destructive

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_itemC
Destructive

Delete Notification Center Item. [DELETE /users/@me/notification-center/items/{item_id}]

Inputs: item_id (required), item_type.

delete_notification_settings_snapshotC
Destructive

Delete Notification Settings Snapshot. [DELETE /users/@me/notification-settings/snapshots/{snapshot_id}]

Inputs: snapshot_id (required).

delete_read_stateB
Destructive

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_avatarC
Destructive

Delete Recent Avatar. [DELETE /users/@me/avatars/{avatar_id}]

Inputs: avatar_id (required).

delete_stage_instanceC
Destructive

End a live stage. [DELETE /stage-instances/{channel_id}]

Inputs: channel_id (required), reason.

delete_user_connectionC
Destructive

Delete User Connection. [DELETE /users/@me/connections/{connection_type}/{connection_id}]

Inputs: connection_id (required), connection_type (required).

delete_webhookC
Destructive

Delete Webhook. [DELETE /webhooks/{webhook_id}]

Inputs: webhook_id (required), reason.

delete_webhook_messageB
Destructive

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_tokenB
Destructive

Delete Webhook with Token. [DELETE /webhooks/{webhook_id}/{webhook_token}]

Inputs: webhook_id (required), webhook_token (required), reason.

disconnect_member_from_voiceC
Destructive

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_statusB
Read-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_logoutA
Destructive

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_mentionA
Destructive

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_channelsB
Read-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_usersA
Read-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_standingA
Read-only

Your account standing / safety hub status (warnings, violations). [GET /safety-hub/@me]

Inputs: no named parameters.

get_app_command_indexC
Read-only

Get Application Command Index. [GET /applications/{application_id}/application-command-index]

Inputs: application_id (required).

get_app_directory_appC
Read-only

Get Application Directory Application. [GET /application-directory-static/applications/{application_id}]

Inputs: application_id (required), locale, nocache, with_localizations.

get_applicationC
Read-only

Get Application. [GET /applications/{application_id}]

Inputs: application_id (required).

get_application_command_permissionsC
Read-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_emojiC
Read-only

Get Application Emoji. [GET /applications/{application_id}/emojis/{emoji_id}]

Inputs: emoji_id (required), application_id (required).

get_audit_logA
Read-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_appB
Read-only

Get OAuth2 Authorization. [GET /oauth2/tokens/{token_id}]

Inputs: token_id (required).

get_call_eligibilityC
Read-only

Get Call Eligibility. [GET /channels/{channel_id}/call]

Inputs: channel_id (required).

get_channelB
Read-only

Get a channel, thread or DM by ID (raw object). [GET /channels/{channel_id}]

Inputs: channel_id (required).

get_channel_command_indexB
Read-only

All commands usable in a channel or DM. [GET /channels/{channel_id}/application-command-index]

Inputs: channel_id (required).

get_channel_infoB
Read-only

Readable info about a channel/thread/DM (type, server, topic, recipients, last activity).

Inputs: channel_id (required).

get_channel_media_previewC
Read-only

Get Channel Media Preview. [GET /channels/{channel_id}/media-post-preview]

Inputs: channel_id (required).

get_channel_treeA
Read-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_memberA
Read-only

Get your own member object in a server. [GET /users/@me/guilds/{guild_id}/member]

Inputs: guild_id (required).

get_current_userA
Read-only

Get your own account (username, email, phone, MFA, Nitro…). [GET /users/@me]

Inputs: with_analytics_token.

get_current_user_guild_join_requestC
Read-only

Get Current User Guild Join Request. [GET /guilds/{guild_id}/requests/@me]

Inputs: guild_id (required).

get_current_user_voice_stateC
Read-only

Get Current User Voice State. [GET /guilds/{guild_id}/voice-states/@me]

Inputs: guild_id (required).

get_directory_countsC
Read-only

Get Directory Counts. [GET /channels/{channel_id}/directory-entries/counts]

Inputs: channel_id (required).

get_directory_entryC
Read-only

Get Directory Entry. [GET /channels/{channel_id}/directory-entry/{entity_id}]

Inputs: entity_id (required), channel_id (required).

get_discovery_slugC
Read-only

Get Discovery Slug. [GET /discovery/{guild_id}]

Inputs: guild_id (required).

get_dm_channelA
Read-only

Get the existing DM channel with a user (if any). [GET /users/@me/dms/{user_id}]

Inputs: user_id (required).

get_email_settingsC
Read-only

Get Email Settings. [GET /users/@me/email-settings]

Inputs: no named parameters.

get_emoji_guildC
Read-only

Get Emoji Guild. [GET /emojis/{emoji_id}/guild]

Inputs: emoji_id (required).

get_emoji_sourceA
Read-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_eventsA
Read-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_commandC
Read-only

Get Global Application Command. [GET /applications/{application_id}/commands/{command_id}]

Inputs: command_id (required), application_id (required).

get_guildB
Read-only

Get a server's full settings object. [GET /guilds/{guild_id}]

Inputs: guild_id (required), with_counts.

get_guild_application_commandC
Read-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_ruleB
Read-only

Get Guild AutoMod Rule. [GET /guilds/{guild_id}/auto-moderation/rules/{rule_id}]

Inputs: rule_id (required), guild_id (required).

get_guild_banB
Read-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_indexA
Read-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_metadataC
Read-only

Get Guild Discovery Metadata. [GET /guilds/{guild_id}/discovery-metadata]

Inputs: guild_id (required).

get_guild_discovery_requirementsC
Read-only

Get Guild Discovery Requirements. [GET /guilds/{guild_id}/discovery-requirements]

Inputs: guild_id (required).

get_guild_emojiC
Read-only

Get Guild Emoji. [GET /guilds/{guild_id}/emojis/{emoji_id}]

Inputs: emoji_id (required), guild_id (required).

get_guild_integration_application_idsC
Read-only

Get Guild Integration Application IDs. [GET /users/@me/guilds/integration-application-ids]

Inputs: no named parameters.

get_guild_join_requestC
Read-only

Get Guild Join Request. [GET /join-requests/{request_id}]

Inputs: request_id (required).

get_guild_join_request_cooldownC
Read-only

Get Guild Join Request Cooldown. [GET /guilds/{guild_id}/requests/@me/cooldown]

Inputs: guild_id (required).

get_guild_memberA
Read-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_verificationC
Read-only

Get Guild Member Verification. [GET /guilds/{guild_id}/member-verification]

Inputs: guild_id (required), with_guild, invite_code.

get_guild_new_member_actionsC
Read-only

Get Guild New Member Actions. [GET /guilds/{guild_id}/new-member-actions]

Inputs: guild_id (required).

get_guild_new_member_welcomeC
Read-only

Get Guild New Member Welcome. [GET /guilds/{guild_id}/new-member-welcome]

Inputs: guild_id (required).

get_guild_onboardingC
Read-only

Get Guild Onboarding. [GET /guilds/{guild_id}/onboarding]

Inputs: guild_id (required).

get_guild_previewA
Read-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_profileC
Read-only

Get Guild Profile. [GET /guilds/{guild_id}/profile]

Inputs: guild_id (required).

get_guild_pruneB
Read-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_roleC
Read-only

Get Guild Role. [GET /guilds/{guild_id}/roles/{role_id}]

Inputs: role_id (required), guild_id (required).

get_guild_role_member_countsC
Read-only

Member count of every role. [GET /guilds/{guild_id}/roles/member-counts]

Inputs: guild_id (required).

get_guild_scheduled_eventC
Read-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_countC
Read-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_soundC
Read-only

Get Guild Soundboard Sound. [GET /guilds/{guild_id}/soundboard-sounds/{sound_id}]

Inputs: guild_id (required), sound_id (required).

get_guild_stickerB
Read-only

Get Guild Sticker. [GET /guilds/{guild_id}/stickers/{sticker_id}]

Inputs: guild_id (required), sticker_id (required).

get_guild_templateB
Read-only

Look up a server template by code. [GET /guilds/templates/{template_code}]

Inputs: template_code (required).

get_guild_vanity_inviteC
Read-only

Get Guild Vanity Invite. [GET /guilds/{guild_id}/vanity-url]

Inputs: guild_id (required).

get_guild_welcome_screenC
Read-only

Get Guild Welcome Screen. [GET /guilds/{guild_id}/welcome-screen]

Inputs: guild_id (required).

get_guild_widgetC
Read-only

Get Guild Widget. [GET /guilds/{guild_id}/widget.json]

Inputs: guild_id (required).

get_guild_widget_settingsC
Read-only

Get Guild Widget Settings. [GET /guilds/{guild_id}/widget]

Inputs: guild_id (required).

get_inviteA
Read-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_messageA
Read-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_detailsB
Read-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_connectionC
Read-only

Get User Application Role Connection. [GET /users/@me/applications/{application_id}/role-connection]

Inputs: application_id (required).

get_my_permissionsB
Read-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_applicationC
Read-only

Get Partial Application. [GET /applications/{application_id}/public]

Inputs: application_id (required), with_guild.

get_role_linked_requirementsB
Read-only

Get Guild Role Connection Configuration. [GET /guilds/{guild_id}/roles/{role_id}/connections/configuration]

Inputs: role_id (required), guild_id (required).

get_rpc_applicationC
Read-only

Get RPC Application. [GET /applications/{application_id}/rpc]

Inputs: application_id (required).

get_server_insightsB
Read-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_guildC
Read-only

Get Soundboard Sound Guild. [GET /soundboard-sounds/{sound_id}/guild/{guild_id}]

Inputs: guild_id (required), sound_id (required).

get_stage_instanceC
Read-only

Get Stage Instance. [GET /stage-instances/{channel_id}]

Inputs: channel_id (required).

get_stickerC
Read-only

Get Sticker. [GET /stickers/{sticker_id}]

Inputs: sticker_id (required).

get_sticker_guildC
Read-only

Get Sticker Guild. [GET /stickers/{sticker_id}/guild]

Inputs: sticker_id (required).

get_sticker_packC
Read-only

Get Sticker Pack. [GET /sticker-packs/{pack_id}]

Inputs: pack_id (required).

get_thread_memberC
Read-only

Get Thread Member. [GET /channels/{channel_id}/thread-members/{user_id}]

Inputs: user_id (required), channel_id (required), with_member.

get_userA
Read-only

Get a user's basic public info. [GET /users/{user_id}]

Inputs: user_id (required).

get_user_command_indexC
Read-only

Commands of user-installed apps. [GET /users/@me/application-command-index]

Inputs: no named parameters.

get_user_noteA
Read-only

Your private note on a user. [GET /users/@me/notes/{user_id}]

Inputs: user_id (required).

get_user_notesB
Read-only

All your private notes on users. [GET /users/@me/notes]

Inputs: no named parameters.

get_user_profileA
Read-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_settingsA
Read-only

Your client settings (status, theme, locale, guild folders, privacy…). [GET /users/@me/settings]

Inputs: no named parameters.

get_user_voice_stateC
Read-only

Get User Voice State. [GET /guilds/{guild_id}/voice-states/{user_id}]

Inputs: user_id (required), guild_id (required).

get_webhookC
Read-only

Get Webhook. [GET /webhooks/{webhook_id}]

Inputs: webhook_id (required).

get_webhook_messageB
Read-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_tokenC
Read-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_memberB
Destructive

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_guildC
Destructive

Leave a server. [DELETE /users/@me/guilds/{guild_id}]

Inputs: guild_id (required), lurking.

leave_hypesquad_houseA
Destructive

Leave your HypeSquad house. [DELETE /hypesquad/online]

Inputs: no named parameters.

leave_threadB
Destructive

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_categoriesC
Read-only

List Application Directory Categories. [GET /application-directory-static/categories]

Inputs: locale.

list_app_directory_collectionsC
Read-only

List Application Directory Collections. [GET /application-directory-static/collections]

Inputs: cache, locale, surface, platform, +1 more.

list_application_emojisC
Read-only

List Application Emojis. [GET /applications/{application_id}/emojis]

Inputs: application_id (required).

list_applicationsC
Read-only

Apps you own in the developer portal. [GET /applications]

Inputs: with_team_applications.

list_application_testersC
Read-only

List Application Testers. [GET /oauth2/applications/{application_id}/allowlist]

Inputs: application_id (required).

list_authorized_appsB
Read-only

Apps you have authorized with your account (Settings → Authorized Apps). [GET /oauth2/tokens]

Inputs: application_ids.

list_channel_affinitiesB
Read-only

Channels you interact with most. [GET /users/@me/affinities/channels]

Inputs: no named parameters.

list_channel_integrationsC
Read-only

List Channel Integrations. [GET /channels/{channel_id}/integrations]

Inputs: channel_id (required).

list_channel_invitesB
Read-only

List invites to a channel. [GET /channels/{channel_id}/invites]

Inputs: channel_id (required).

list_channel_webhooksC
Read-only

List Channel Webhooks. [GET /channels/{channel_id}/webhooks]

Inputs: channel_id (required).

list_commandsB
Read-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_soundsB
Read-only

List Default Soundboard Sounds. [GET /soundboard-default-sounds]

Inputs: no named parameters.

list_directory_entriesC
Read-only

List Directory Entries. [GET /channels/{channel_id}/directory-entries]

Inputs: channel_id (required), type, category_id.

list_discoverable_guildsC
Read-only

Browse featured public servers. [GET /discoverable-guilds]

Inputs: limit, offset, guild_ids, categories, +1 more.

list_discovery_categoriesC
Read-only

List Discovery Categories. [GET /discovery/categories]

Inputs: locale, primary_only.

list_dmsA
Read-only

List your DMs and group DMs, most recent first, with unread markers.

Inputs: limit, unread_only.

list_embedded_activitiesC
Read-only

List Embedded Activities. [GET /activities/shelf]

Inputs: guild_id.

list_friendsA
Read-only

List friends, blocked users and pending friend requests in readable form.

Inputs: type.

list_friend_suggestionsC
Read-only

Friend suggestions. [GET /friend-suggestions]

Inputs: no named parameters.

list_global_application_commandsC
Read-only

List Global Application Commands. [GET /applications/{application_id}/commands]

Inputs: application_id (required), with_localizations.

list_guild_active_threadsB
Read-only

List all active threads in a server that you can see. [GET /guilds/{guild_id}/threads/active]

Inputs: guild_id (required).

list_guild_affinitiesB
Read-only

Servers you interact with most. [GET /users/@me/affinities/guilds]

Inputs: no named parameters.

list_guild_application_command_permissionsB
Read-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_commandsC
Read-only

List Guild Application Commands. [GET /applications/{application_id}/guilds/{guild_id}/commands]

Inputs: guild_id (required), application_id (required), with_localizations.

list_guild_applicationsC
Read-only

Bots/apps installed in a server. [GET /guilds/{guild_id}/applications]

Inputs: guild_id (required), type, channel_id, include_team.

list_guild_automod_rulesB
Read-only

List Guild AutoMod Rules. [GET /guilds/{guild_id}/auto-moderation/rules]

Inputs: guild_id (required).

list_guild_bansB
Read-only

List banned users. [GET /guilds/{guild_id}/bans]

Inputs: guild_id (required), after, limit, before.

list_guild_channelsA
Read-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_emojisB
Read-only

List a server's custom emojis. [GET /guilds/{guild_id}/emojis]

Inputs: guild_id (required).

list_guild_integrationsC
Read-only

List Guild Integrations. [GET /guilds/{guild_id}/integrations]

Inputs: guild_id (required), has_commands, include_role_connections_metadata.

list_guild_invitesA
Read-only

List all invites of a server (needs Manage Server). [GET /guilds/{guild_id}/invites]

Inputs: guild_id (required).

list_guild_join_requestsC
Read-only

List Guild Join Requests. [GET /guilds/{guild_id}/requests]

Inputs: guild_id (required), after, limit, before, +1 more.

list_guild_membersA
Read-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_applicationsC
Read-only

List Guild Onboarding Allowed Applications. [GET /guilds/{guild_id}/onboarding/allowed-applications]

Inputs: guild_id (required).

list_guild_role_membersB
Read-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_rolesA
Read-only

List all roles in a server (with permissions). [GET /guilds/{guild_id}/roles]

Inputs: guild_id (required).

list_guildsA
Read-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_usersC
Read-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_eventsC
Read-only

List Guild Scheduled Events. [GET /guilds/{guild_id}/scheduled-events]

Inputs: guild_id (required), with_user_count.

list_guild_scheduled_event_usersC
Read-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_soundsC
Read-only

List Guild Soundboard Sounds. [GET /guilds/{guild_id}/soundboard-sounds]

Inputs: guild_id (required).

list_guild_stickersC
Read-only

List Guild Stickers. [GET /guilds/{guild_id}/stickers]

Inputs: guild_id (required).

list_guild_templatesC
Read-only

List Guild Templates. [GET /guilds/{guild_id}/templates]

Inputs: guild_id (required).

list_guild_top_emojisC
Read-only

List Guild Top Emojis. [GET /guilds/{guild_id}/top-emojis]

Inputs: guild_id (required).

list_guild_voice_regionsB
Read-only

List Guild Voice Regions. [GET /guilds/{guild_id}/regions]

Inputs: guild_id (required).

list_guild_webhooksB
Read-only

List Guild Webhooks. [GET /guilds/{guild_id}/webhooks]

Inputs: guild_id (required).

list_invite_friend_membersC
Read-only

List Invite Friend Members. [GET /invites/{invite_code}/friend-members]

Inputs: invite_code (required).

list_joined_private_archived_threadsC
Read-only

List Joined Private Archived Threads. [GET /channels/{channel_id}/users/@me/threads/archived/private]

Inputs: channel_id (required), limit, before.

list_login_sessionsA
Read-only

Devices logged into your account (Settings → Devices). [GET /auth/sessions]

Inputs: no named parameters.

list_members_with_unusual_dm_activityB
Read-only

List members flagged for unusual DM activity (moderators). [GET /guilds/{guild_id}/members/unusual-dm-activity]

Inputs: guild_id (required), after, limit.

list_mentionsB
Read-only

Your recent mentions inbox (pings across servers). [GET /users/@me/mentions]

Inputs: limit, roles, before, everyone, +1 more.

list_message_pinsA
Read-only

List pinned messages in a channel (newest pins first). [GET /channels/{channel_id}/messages/pins]

Inputs: channel_id (required), limit, before.

list_mutual_relationshipsB
Read-only

List friends you have in common with a user. [GET /users/{user_id}/relationships]

Inputs: user_id (required).

list_my_app_role_connectionsB
Read-only

List User Application Role Connections. [GET /users/@me/applications/role-connections]

Inputs: no named parameters.

list_my_game_activity_statsC
Read-only

List User Application Activity Statistics. [GET /users/@me/activities/statistics/applications]

Inputs: no named parameters.

list_notification_center_itemsC
Read-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_snapshotsB
Read-only

List Notification Settings Snapshots. [GET /users/@me/notification-settings/snapshots]

Inputs: no named parameters.

list_partial_directory_entriesC
Read-only

List Partial Directory Entries. [GET /channels/{channel_id}/directory-entries/list]

Inputs: channel_id (required), entity_ids.

list_pending_modalsB
Read-only

Forms (modals) bots opened for you recently and their input fields.

Inputs: no named parameters.

list_poll_answer_votersB
Read-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_premium_guild_subscriptionsB
Read-only

List Premium Guild Subscriptions. [GET /guilds/{guild_id}/premium/subscriptions]

Inputs: guild_id (required), include_ended.

list_private_archived_threadsC
Read-only

List Private Archived Threads. [GET /channels/{channel_id}/threads/archived/private]

Inputs: channel_id (required), limit, before.

list_public_archived_threadsC
Read-only

List Public Archived Threads. [GET /channels/{channel_id}/threads/archived/public]

Inputs: channel_id (required), limit, before.

list_reactionsA
Read-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_avatarsB
Read-only

List Recent Avatars. [GET /users/@me/avatars]

Inputs: no named parameters.

list_relationshipsA
Read-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_messagesB
Read-only

List your saved ("bookmarked") messages. [GET /users/@me/saved-messages]

Inputs: no named parameters.

list_similar_directory_appsC
Read-only

List Application Directory Similar Applications. [GET /application-directory-static/applications/{application_id}/similar]

Inputs: application_id (required), page, locale, guild_id.

list_sticker_packsB
Read-only

List Sticker Packs. [GET /sticker-packs]

Inputs: no named parameters.

list_thread_membersC
Read-only

List Thread Members. [GET /channels/{channel_id}/thread-members]

Inputs: channel_id (required), after, limit, with_member.

list_unreadA
Read-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_v2B
Read-only

Users you interact with most. [GET /users/@me/affinities/v2/users]

Inputs: no named parameters.

list_user_connectionsC
Read-only

List User Connections. [GET /users/@me/connections]

Inputs: no named parameters.

list_user_connection_subredditsC
Read-only

List User Connection Subreddits. [GET /users/@me/connections/reddit/{connection_id}/subreddits]

Inputs: connection_id (required).

list_user_guild_join_requestsC
Read-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_eventsB
Read-only

List events you marked as interested in, across servers. [GET /users/@me/scheduled-events]

Inputs: guild_ids.

list_user_invitesA
Read-only

List your friend invites. [GET /users/@me/invites]

Inputs: no named parameters.

list_user_linked_connectionsB
Read-only

List User Linked Connections. [GET /users/@me/linked-connections]

Inputs: no named parameters.

list_voice_membersB
Read-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_regionsB
Read-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).

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_authorizationA
Read-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_guildB
Destructive

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_messagesA
Destructive

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_membersA
Read-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_messagesA
Read-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_requestB
Destructive

Reject (delete) a DM message request. [DELETE /channels/{channel_id}/recipients/@me]

Inputs: channel_id (required).

remove_all_reactionsA
Destructive

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_emojiA
Destructive

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_testerB
Destructive

Remove Application Tester. [DELETE /oauth2/applications/{application_id}/allowlist/{user_id}]

Inputs: user_id (required), application_id (required).

remove_channel_recipientA
Destructive

Remove a user from a group DM you own. [DELETE /channels/{channel_id}/recipients/{user_id}]

Inputs: user_id (required), channel_id (required).

remove_friendB
Destructive

Remove a friend (or cancel/decline a friend request).

Inputs: user_id (required).

remove_friend_suggestionC
Destructive

Remove Friend Suggestion. [DELETE /friend-suggestions/{user_id}]

Inputs: user_id (required).

remove_guild_discovery_subcategoryC
Destructive

Remove Guild Discovery Subcategory. [DELETE /guilds/{guild_id}/discovery-categories/{category_id}]

Inputs: guild_id (required), category_id (required), reason.

remove_member_roleC
Destructive

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_reactionA
Destructive

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_relationshipA
Destructive

Remove a friend, cancel/decline a friend request, or unblock a user. [DELETE /users/@me/relationships/{user_id}]

Inputs: user_id (required).

remove_thread_memberC
Destructive

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_reactionA
Destructive

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_invitesA
Destructive

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_directoryC
Read-only

Search Applications Directory. [GET /application-directory-static/search]

Inputs: page, query, locale, source, +7 more.

search_directory_entriesC
Read-only

Search Directory Entries. [GET /channels/{channel_id}/directory-entries/search]

Inputs: channel_id (required), type, query, category_id.

search_discoverable_guildsC
Read-only

Search public servers in Server Discovery. [GET /discoverable-guilds/search]

Inputs: query (required), limit, offset, categories.

search_gifsA
Read-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_bansB
Read-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_membersB
Read-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_messagesA
Read-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_guildsC
Read-only

Search Published Guilds. [GET /discovery/search]

Inputs: limit, query, offset.

search_threadsC
Read-only

Search Threads. [GET /channels/{channel_id}/threads/search]

Inputs: channel_id (required), tag, name, slop, +8 more.

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).

Inputs: values (required), message (required), custom_id, channel_id, +1 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_infoA
Read-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_memberB
Destructive

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_memberC
Destructive

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_userA
Destructive

Stop ignoring a user. [DELETE /users/@me/relationships/{user_id}/ignore]

Inputs: user_id (required).

unmark_interested_in_eventA
Destructive

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_occurrenceC
Destructive

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_messageC
Destructive

Unpin a message. [DELETE /channels/{channel_id}/messages/pins/{message_id}]

Inputs: channel_id (required), message_id (required), reason.

unsave_messageA
Destructive

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_termC
Read-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_imageB
Read-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_eventB
Read-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_messageB
Read-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.

whoamiA
Read-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

    C2.7/5.0

    Scored across 437 tools

    Disambiguation2/5

    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.

    Naming Consistency3/5

    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).

    Tool Count1/5

    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.

    Completeness5/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      MIT