Для чего этот сервер?

Этот сервер превращает Discord-бота в инструмент управления серверами через ИИ-ассистентов. Вместо ручной настройки прав, каналов или модерации — достаточно сказать что нужно на естественном языке. Подходит для администраторов, которые хотят автоматизировать рутину, не переключаясь между окнами. Работает с любым MCP-клиентом — от Claude до VS Code, и поддерживает несколько серверов одновременно.

Что он умеет?

Сервер управляет Discord-серверами через обычные текстовые запросы: читает, отправляет, редактирует и удаляет сообщения, отправляет эмбеды, закрепляет сообщения, ищет сообщения по ключевым словам. Работает с каналами: создаёт, клонирует, удаляет, блокирует, синхронизирует права. Управляет ролями и правами участников, выдаёт таймауты, кикает, банит, чистит неактивных. Ведёт форумы, вебхуки, запланированные события, инвайты, читает аудит-лог и статистику сервера, работает с DM и мембершип-скринингом.

Каталог MCP
PaSympa/discord-mcp

PaSympa/discord-mcp

от pasympa

MCP сервер для управления Discord сервером через Claude, Cursor или Copilot. Более 95 инструментов: сообщения, каналы, роли, модерация, форумы, вебхуки. Работает с несколькими гильдиями. Легковесный, на TypeScript или Docker.

Github NPM Сайт сервера

README

99 инструментов

Версии

Установить сервер

Discord MCP Server

A lightweight, multi-guild Discord MCP server with 95+ tools

License

Manage your entire Discord server from Claude Desktop, Claude Code, Cursor, VS Code Copilot, or any MCP-compatible client. Messages, channels, roles, permissions, moderation, forums, webhooks, all through natural language.

Why this one?

95+ tools: messages, channels, roles, permissions, moderation, forums, webhooks, scheduled events, invites, DMs, embeds, and more
Multi-guild: works across multiple servers, no GUILD_ID lock-in
Lightweight: TypeScript + Node.js, ~70kB package, ~73MB Docker image (vs 400MB+ for Java alternatives)
Modular: clean architecture, easy to extend with new tools
Two install methods: npm or Docker, your choice

Quick Start

Add this to your MCP client config and replace YOUR_TOKEN_HERE with your bot token:

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@pasympa/discord-mcp"],
      "env": {
        "DISCORD_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Часто задаваемые вопросы

Инструменты были проиндексированы: 21.10.2026

discord_add_reactionидемпотентныйвнешний мир

Добавляет одну реакцию-эмодзи к сообщению от имени бота. Требует разрешений Add Reactions и Read Message History. Используйте discord_remove_reactions, чтобы отменить. Идемпотентно: повторное добавление уже существующей реакции бота не имеет эффекта.

Параметры

channel_idstringобязательный
ID (snowflake) канала или ветки, содержащей сообщение.
emojistringобязательный
Юникод-эмодзи (например, '👍') или пользовательский эмодзи в формате 'имя:ид'.
message_idstringобязательный
ID сообщения, на которое нужно отреагировать.

discord_add_roleидемпотентныйвнешний мир

Назначает существующую роль участнику. Требует разрешения Manage Roles, и роль должна быть ниже самой высокой роли бота. Идемпотентно: назначение роли, которая уже есть у участника, не имеет эффекта. Используйте discord_remove_role для отмены.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
reasonstring
Записывает необязательную причину в журнал аудита сервера.
role_idstringобязательный
ID (snowflake) роли, которую нужно назначить.
user_idstringобязательный
ID пользователя Discord (snowflake), которому нужно выдать роль.

discord_audit_permissionsтолько чтениевнешний мир

Генерирует отчёт о разрешениях на всём сервере: для каждого канала с переопределениями выводит каждую роль/участника и их разрешённые/запрещённые разрешения (имена сущностей разрешены). Только чтение. Возвращает { channels: [...] } с channel, channelId, overwrites. Используйте discord_get_channel_permissions для одного канала.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).

discord_ban_memberидемпотентныйвнешний мир

Запрещает пользователю вход на сервер, блокируя повторное подключение до снятия бана. Опционально массово удаляет его недавние сообщения. Требует разрешения Ban Members, при этом наивысшая роль бота должна быть выше роли цели. Для отмены используйте discord_unban_member или discord_kick_member для временного удаления. Причина записывается в журнал аудита.

Параметры

delete_message_daysinteger
Также удалите сообщения пользователя за последние N дней (0–7). По умолчанию 0 (ничего не удалять).
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
reasonstring
Записывает необязательную причину в журнал аудита сервера.
user_idstringобязательный
ID пользователя Discord (snowflake), которого нужно забанить.

discord_bulk_banвнешний мир

Банит многих пользователей за один вызов, предназначен для защиты от рейдов. БЕЗОПАСНО ПО УМОЛЧАНИЮ: dry_run равно true, если явно не установлено false, поэтому сначала вызовите его, чтобы просмотреть точный список ID пользователей, которые будут забанены, затем вызовите снова с dry_run:false, чтобы реально их забанить. Требует оба разрешения: Ban Members и Manage Server. Возвращает количество забаненных и не забаненных пользователей; Discord отклоняет весь вызов с ошибкой, если не удалось забанить ни одного пользователя. Используйте discord_ban_member для одиночного бана с более точным контролем.

Параметры

delete_message_secondsinteger
Также удаляет сообщения каждого пользователя за последние N секунд (0–604800, т.е. до 7 дней). По умолчанию 0.
dry_runboolean
Если true (по умолчанию), возвращает только ID пользователей, которые были бы забанены, не баня никого. Установите false, чтобы реально забанить.
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
reasonstring
Записывает необязательную причину в журнал аудита сервера.
user_idsstring[]обязательный
Массив идентификаторов пользователей (snowflakes), которых нужно забанить (максимум 200 за вызов, ограничение Discord API).

discord_bulk_delete_messagesвнешний мир

Удаляет несколько последних сообщений навсегда за один вызов. НЕОБРАТИМО. БЕЗОПАСНО ПО УМОЛЧАНИЮ: dry_run имеет значение true, если явно не установлено false, поэтому сначала вызовите его для предпросмотра, затем вызовите снова с dry_run:false для реального удаления. Discord позволяет массово удалять только сообщения младше 14 дней; более старые пропускаются. Требует разрешения Manage Messages. Возвращает количество удалённых.

Параметры

channel_idstringобязательный
ID (snowflake) канала или ветки, из которого нужно удалить сообщения.
countintegerобязательный
Количество последних сообщений для удаления (2–100).
dry_runboolean
Если указано true (по умолчанию), только показывает, сколько будет удалено, без фактического удаления. Установите false, чтобы реально удалить.

discord_clone_channelвнешний мир

Создаёт копию канала, включая его название, тему и переопределения прав доступа (но не сообщения). Требует разрешение Manage Channels. Возвращает имя и ID клонированного канала.

Параметры

channel_idstringобязательный
ID (snowflake) канала для клонирования.
new_namestring
Необязательное имя для клона. По умолчанию используется имя исходного канала.

discord_copy_permissionsидемпотентныйвнешний мир

Заменяет переопределения разрешений целевого канала копией переопределений исходного канала. Существующие переопределения целевого канала перезаписываются. Требует разрешения Manage Roles. Возвращает подтверждение.

Параметры

reasonstring
Записывает необязательную причину в журнал аудита сервера.
source_channel_idstringобязательный
ID (snowflake) канала, из которого копировать перезаписи.
target_channel_idstringобязательный
ID канала, чьи переопределения будут заменены.

discord_create_channelвнешний мир

Создает текстовый канал, голосовой канал или категорию на сервере. Требуется разрешение Manage Channels. Для форумных каналов используйте discord_create_forum_channel. Возвращает имя и ID нового канала.

Параметры

category_idstring
Необязательная категория (snowflake), под которой будет размещён новый канал.
guild_idstringобязательный
ID сервера (гильдии) Discord (snowflake), в котором нужно создать канал.
namestringобязательный
Название нового канала (максимум 100 символов).
topicstring
Тема/описание канала (необязательно). Действует только для текстовых каналов.
typeenum
Тип канала, который нужно создать. По умолчанию: 'text'.

discord_create_event_inviteвнешний мир

Создает доступную для отправки URL-ссылку-приглашение, ведущую на запланированное событие, чтобы получатели попадали на это событие при присоединении. Требует разрешения Create Instant Invite. Возвращает URL приглашения.

Параметры

channel_idstring
Канал (snowflake), на который указывает приглашение. По умолчанию используется канал самого события; ОБЯЗАТЕЛЬНО для ВНЕШНИХ событий, у которых его нет.
event_idstringобязательный
ID (snowflake) запланированного события, к которому нужно привязать приглашение.
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
max_ageinteger
Срок действия приглашения в секундах, от 0 до 604800 (7 дней); значение 0 означает, что срок действия не истекает. По умолчанию — 86400 (24 часа).
max_usesinteger
Максимальное количество использований: 0–100; 0 означает без ограничений. По умолчанию 0.

discord_create_forum_channelвнешний мир

Создаёт новый форум-канал на сервере. Форум содержит сообщения (ветки), а не линейную ленту сообщений. Требует разрешения Manage Channels. Используйте discord_create_channel для текстовых/голосовых каналов. Возвращает название и ID нового канала.

Параметры

category_idstring
Необязательная категория (snowflake), в которую вложить форум.
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
namestringобязательный
Название нового канала форума (максимум 100 символов).
topicstring
Правила и текст темы, показываемые вверху форума.

discord_create_forum_postвнешний мир

Создает новый пост (ветку с начальным сообщением) в форумном канале. Требует разрешения Send Messages и Create Public Threads. Чтобы добавить последующие сообщения, используйте discord_reply_to_forum. Возвращает название нового поста и идентификатор ветки.

Параметры

applied_tagsstring[]
Необязательные ID тегов для применения. Получите допустимые ID из discord_get_forum_tags.
contentstringобязательный
Текст начального сообщения поста (максимум 2000 символов).
forum_channel_idstringобязательный
ID (snowflake) форумного канала, куда нужно опубликовать сообщение.
titlestringобязательный
Заголовок поста, используемый как название темы (максимум 100 символов).

discord_create_inviteвнешний мир

Создаёт пригласительную ссылку для канала, опционально ограничивая её срок действия, количество использований и тип участников. SECURITY: любой, у кого есть полученная ссылка, может присоединиться к серверу. Требуется разрешение Create Instant Invite. Возвращает URL приглашения и код.

Параметры

channel_idstringобязательный
ID (snowflake) канала, на который ведёт приглашение.
max_ageinteger
Срок действия приглашения в секундах, от 0 до 604800 (7 дней); значение 0 означает, что срок действия не истекает. По умолчанию — 86400 (24 часа).
max_usesinteger
Максимальное количество использований: 0–100; 0 означает без ограничений. По умолчанию 0.
temporaryboolean
Если включено, участники, присоединившиеся по этому приглашению, удаляются при отключении (если только не получат роль). По умолчанию выключено.
uniqueboolean
Если true, всегда создаётся новое приглашение вместо повторного использования существующего эквивалентного. По умолчанию false.

discord_create_roleвнешний мир

Создаёт новую роль на сервере. Требует разрешения Manage Roles; новая роль помещается ниже самой высокой роли бота. Используйте discord_add_role, чтобы затем назначить её участникам. Возвращает имя и ID новой роли.

Параметры

colorstring
Цвет роли в виде hex-строки, например '#FF5733'.
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
hoistboolean
Если true, показываем участников с этой ролью отдельно в списке участников.
mentionableboolean
Если true, любой может @упомянуть эту роль.
namestringобязательный
Название новой роли (максимум 100 символов).
permissionsstring[] | string
Имена флагов разрешений уровня сервера для выдачи, например ['SendMessages','ViewChannel']. Использует имена флагов из PermissionsBitField Discord.

discord_create_scheduled_eventвнешний мир

Создаёт запланированное событие. Для событий 'VOICE'/'STAGE_INSTANCE' укажите channel_id; для событий 'EXTERNAL' укажите location И scheduled_end_time. Требуется разрешение Manage Events. Возвращает имя и ID нового события.

Параметры

channel_idstring
ID голосового канала или канала сцены (snowflake). Требуется для событий VOICE/STAGE_INSTANCE.
descriptionstring
Необязательное описание события (максимум 1000 символов).
entity_typeenumобязательный
Где происходит событие: 'VOICE' или 'STAGE_INSTANCE' (нужен channel_id), или 'EXTERNAL' (нужны location и scheduled_end_time).
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
imagestring
Необязательный URL обложки.
locationstring
Местоположение в свободной форме (например, URL или место). Обязательно для ВНЕШНИХ событий.
namestringобязательный
Название события (максимум 100 символов).
scheduled_end_timestring
Конец события как дата и время в формате ISO 8601. Требуется для ВНЕШНИХ событий.
scheduled_start_timestringобязательный
Начало события в формате ISO 8601, например, '2026-06-01T20:00:00Z'. Должно быть в будущем.

discord_create_threadвнешний мир

Создает ветку, либо ответвляясь от существующего сообщения (передайте message_id), либо как отдельную ветку в текстовом канале (опустите message_id). Создание отдельной ветки требует родительского текстового канала и завершается ошибкой, если channel_id сам является веткой. Требует разрешения Create Public Threads. Возвращает ID новой ветки.

Параметры

auto_archive_durationenum
Минуты бездействия до автоархивации: 60, 1440, 4320 или 10080. По умолчанию 1440 (24 часа).
channel_idstringобязательный
Указывает идентификатор (snowflake) родительского текстового канала. Если речь идет о ветке обсуждения, это идентификатор канала, в котором находится исходное сообщение.
message_idstring
Необязательно. Сообщение, от которого ответвляется ветка. Если не указано, в канале создается отдельная ветка.
namestringобязательный
Название потока для создания (максимум 100 символов).

discord_create_webhookвнешний мир

Создаёт вебхук на канале и возвращает его ID и токен. БЕЗОПАСНОСТЬ: возвращённый токен даёт любому возможность публиковать от имени этого вебхука без аутентификации; относитесь к нему как к секрету. Требует разрешения Manage Webhooks. Используйте возвращённые id+токен с discord_send_webhook_message.

Параметры

avatarstring
Необязательный URL изображения аватара для вебхука.
channel_idstringобязательный
Определяет канал, к которому нужно прикрепить вебхук.
namestringобязательный
Отображаемое имя для вебхука (не более 80 символов).

discord_crosspost_messageидемпотентныйвнешний мир

Публикует (кросс-постит) сообщение из Announcement channel на каждый сервер, который на него подписан. Работает только в Announcement channel с сообщением, которое ещё не было опубликовано. Требует разрешения Send Messages (и Manage Messages для сообщений, написанных другими пользователями). Возвращает подтверждение.

Параметры

channel_idstringобязательный
ID (snowflake) канала объявлений, содержащего сообщение.
message_idstringобязательный
Идентификатор сообщения для публикации подписчикам.

discord_delete_channelвнешний мир

Удаляет канал и все его сообщения навсегда. НЕОБРАТИМО. БЕЗОПАСНО ПО УМОЛЧАНИЮ: dry_run имеет значение true, если явно не задано false, поэтому сначала вызовите его для предварительного просмотра, затем вызовите снова с dry_run:false для фактического удаления. Требует разрешения Manage Channels. Необязательная причина записывается в журнал аудита.

Параметры

channel_idstringобязательный
ID (snowflake) канала для удаления.
dry_runboolean
Если значение true (по умолчанию), только сообщает, какой канал будет удалён, без фактического удаления. Установите false, чтобы действительно удалить.
reasonstring
Записывает необязательную причину в журнал аудита сервера.

discord_delete_dmвнешний мир

Навсегда удаляет DM-сообщение, ранее отправленное этим ботом. НЕОБРАТИМО. Бот может удалять только свои собственные DM-сообщения, а не сообщения получателя. Возвращает подтверждение.

Параметры

message_idstringобязательный
ID целевого сообщения в рамках DM-переписки.
user_idstringобязательный
ID пользователя Discord (snowflake) получателя DM.

discord_delete_forum_postвнешний мир

Навсегда удаляет сообщение форума (ветку) и все его сообщения. НЕОБРАТИМО. Чтобы просто закрыть его без удаления, используйте discord_update_forum_post с archived:true. Требуется разрешение Manage Threads.

Параметры

thread_idstringобязательный
ID (snowflake) поста (темы) на форуме, который нужно удалить.

discord_delete_inviteвнешний мир

Отзывает приглашение по его коду, чтобы его больше нельзя было использовать. НЕОБРАТИМО (код освобождается). Требует разрешения Manage Channels (или Manage Server). Причина записывается в журнал аудита.

Параметры

invite_codestringобязательный
Код приглашения для отзыва. Полный URL вида discord.gg/<code> также принимается.
reasonstring
Записывает необязательную причину в журнал аудита сервера.

discord_delete_messageвнешний мир

Окончательно удаляет одно конкретное сообщение. НЕОБРАТИМО. Бот всегда может удалять свои собственные сообщения; для удаления сообщения другого пользователя требуется разрешение Manage Messages. Используйте discord_bulk_delete_messages, чтобы удалить много сообщений сразу. Необязательная причина записывается в журнал аудита.

Параметры

channel_idstringобязательный
ID (snowflake) канала или ветки, содержащей сообщение.
message_idstringобязательный
ID удаляемого сообщения.
reasonstring
Записывает необязательную причину в журнал аудита сервера.

discord_delete_roleвнешний мир

Удаляет роль с сервера навсегда; она автоматически удаляется у всех участников, которые её имели. НЕОБРАТИМО. Требует разрешения Manage Roles, и роль должна быть ниже высшей роли бота.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
reasonstring
Записывает необязательную причину в журнал аудита сервера.
role_idstringобязательный
ID (snowflake) роли, которую нужно удалить.

discord_delete_scheduled_eventвнешний мир

Окончательно удаляет запланированное событие. НЕОБРАТИМО. Чтобы отменить событие, сохранив запись, используйте discord_edit_scheduled_event со статусом 'CANCELED'. Требуется разрешение Manage Events.

Параметры

event_idstringобязательный
ID (snowflake) события, которое нужно удалить.
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).

discord_delete_webhookвнешний мир

Окончательно удаляет вебхук по его ID, аннулируя его токен. НЕОБРАТИМО: любые интеграции, использующие старый токен, перестанут работать. Требует разрешения Manage Webhooks.

Параметры

webhook_idstringобязательный
ID (snowflake) вебхука для удаления.

discord_delete_webhook_messageвнешний мир

Навсегда удаляет сообщение, отправленное через вебхук, используя ID и токен вебхука. НЕОБРАТИМО. Требует исходный токен вебхука.

Параметры

message_idstringобязательный
Идентификатор сообщения вебхука, которое нужно удалить.
webhook_idstringобязательный
ID (снежинка) вебхука, который отправил сообщение.
webhook_tokenstringобязательный
Секретный токен вебхука.

discord_edit_channelидемпотентныйвнешний мир

Обновляет имя, тему, медленный режим или NSFW флаг канала. Изменяются только указанные поля; тема и медленный режим применяются только к текстовым каналам. Требует разрешения Manage Channels. Возвращает подтверждение.

Параметры

channel_idstringобязательный
ID (snowflake) канала для редактирования.
namestring
Название нового канала (максимум 100 символов).
nsfwboolean
Отмечает (true) или снимает отметку (false) с канала как ограниченного по возрасту (NSFW).
slowmodeinteger
Задержка сообщений для каждого пользователя в секундах, от 0 до 21600. Значение 0 отключает медленный режим.
topicstring
Новая тема/описание (только текстовые каналы).

discord_edit_dmидемпотентныйвнешний мир

Редактирует текстовое содержимое DM-сообщения, ранее отправленного этим ботом. Редактировать можно только собственные DM-сообщения бота. Используйте discord_edit_dm_embed для embed-сообщений. Возвращает подтверждение.

Параметры

contentstringобязательный
Новый текстовый контент, который полностью заменяет существующее сообщение (не более 2000 символов).
message_idstringобязательный
ID целевого сообщения в рамках DM-переписки.
user_idstringобязательный
ID пользователя Discord (snowflake) получателя DM.

discord_edit_dm_embedидемпотентныйвнешний мир

Заменяет встроенный элемент (embed) в личном сообщении, ранее отправленном этим ботом. Редактировать можно только собственные сообщения бота. Полная замена, не слияние: указанные поля применяются, пропущенные поля отбрасываются. Возвращает подтверждение.

Параметры

authorobject
Блок автора, отображаемый в верхней части встраиваемого элемента.
colorstring
Цвет боковой панели в виде шестнадцатеричной строки, например '#5865F2'.
contentstring
Необязательный новый обычный текст, отображаемый над встроенным элементом.
descriptionstring
Основной текст встраиваемого элемента (поддерживает Markdown).
fieldsobject[]
До 25 блоков полей «имя/значение». Установите inline:true для поля, чтобы отобразить его рядом с соседними инлайн-полями (до 3 в ряд).
footerstring
Текст внизу встраиваемого элемента.
image_urlstring
Крупное изображение показано ниже тела встраиваемого элемента.
message_idstringобязательный
ID целевого сообщения в рамках DM-переписки.
thumbnail_urlstring
Небольшое изображение в правом верхнем углу.
timestampboolean
Если это верно, добавьте в embed текущее время.
titlestring
Вверху вставьте заголовок, выделенный жирным шрифтом.
urlstring
URL, который делает заголовок кликабельным.
user_idstringобязательный
ID пользователя Discord (snowflake) получателя DM.

discord_edit_embedидемпотентныйвнешний мир

Заменяет embed в сообщении, ранее отправленном этим ботом. Редактировать можно только сообщения этого бота. Это полная замена, а не слияние: переданные поля применяются, а опущенные поля удаляются из embed. Возвращает подтверждение.

Параметры

authorobject
Блок автора, отображаемый в верхней части встраиваемого элемента.
channel_idstringобязательный
ID (snowflake) канала или ветки, содержащей сообщение.
colorstring
Цвет боковой панели в виде шестнадцатеричной строки, например '#5865F2'.
descriptionstring
Основной текст встраиваемого элемента (поддерживает Markdown).
fieldsobject[]
До 25 блоков полей «имя/значение». Установите inline:true для поля, чтобы отобразить его рядом с соседними инлайн-полями (до 3 в ряд).
footerstring
Текст внизу встраиваемого элемента.
image_urlstring
Крупное изображение показано ниже тела встраиваемого элемента.
message_idstringобязательный
ID сообщения, которое нужно отредактировать. Это должно быть сообщение, которое написал этот бот (если встроенного сообщения нет, оно будет добавлено).
thumbnail_urlstring
Небольшое изображение в правом верхнем углу.
timestampboolean
Если это верно, добавьте в embed текущее время.
titlestring
Вверху вставьте заголовок, выделенный жирным шрифтом.
urlstring
URL, который делает заголовок кликабельным.

discord_edit_messageидемпотентныйвнешний мир

Редактирует текстовое содержимое сообщения, ранее отправленного этим ботом. Discord запрещает редактирование сообщений других пользователей, поэтому для не-ботовских сообщений это не работает. Используйте discord_edit_embed для embed-сообщений. Работает в текстовых каналах и ветках. Возвращает ID отредактированного сообщения.

Параметры

channel_idstringобязательный
ID (snowflake) канала или ветки, содержащей сообщение.
contentstringобязательный
Новое содержимое в виде обычного текста, которое полностью заменяет существующее содержимое (не более 2000 символов).
message_idstringобязательный
ID сообщения, которое нужно отредактировать. Это должно быть сообщение, которое создал этот бот.

discord_edit_roleидемпотентныйвнешний мир

Обновляет имя, цвет, права, hoist или флаг mentionable существующей роли. Изменяются только указанные поля; передача permissions ЗАМЕНЯЕТ весь набор прав роли. Требует права Manage Roles, и роль должна находиться ниже самой высокой роли бота.

Параметры

colorstring
Новый цвет роли в виде hex-строки, например '#FF5733'.
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
hoistboolean
Если true, показываем участников с этой ролью отдельно в списке участников.
mentionableboolean
Если true, любой может @упомянуть эту роль.
namestring
Название роли (не более 100 символов).
permissionsstring[] | string
Названия флагов разрешений. Указание этого ЗАМЕНЯЕТ весь набор прав роли. Использует имена флагов из Discord PermissionsBitField.
role_idstringобязательный
ID (snowflake) роли, которую нужно редактировать.

discord_edit_scheduled_eventидемпотентныйвнешний мир

Обновляет запланированное событие; изменяются только указанные поля. Использует поле статуса, чтобы запустить ('ACTIVE'), завершить ('COMPLETED') или отменить ('CANCELED') событие; Discord допускает только определенные переходы между статусами. Требует разрешения Manage Events.

Параметры

channel_idstring
Новый ID голосового/сценарного канала (snowflake) для событий VOICE/STAGE_INSTANCE.
descriptionstring
Новое описание события (максимум 1000 символов).
event_idstringобязательный
ID (snowflake) события для редактирования.
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
imagestring
Новый URL обложки.
locationstring
Новое поле свободного текста для ВНЕШНИХ событий.
namestring
Название нового события (максимум 100 символов).
scheduled_end_timestring
Новое время окончания в формате ISO 8601 (дата и время).
scheduled_start_timestring
Новое время начала в формате ISO 8601 (дата и время).
statusenum
Изменяет статус события. Допустимы только переходы: SCHEDULED→ACTIVE→COMPLETED, или SCHEDULED→CANCELED (обратного перехода в SCHEDULED не существует).

discord_edit_webhookидемпотентныйвнешний мир

Обновляет имя, аватар или канал, в который публикует вебхук. Изменяет только указанные поля. Требует разрешения Manage Webhooks. Возвращает подтверждение.

Параметры

avatarstring
Новый URL изображения аватара для вебхука.
channel_idstring
ID (snowflake) канала, в который нужно переместить вебхук.
namestring
Новое отображаемое имя для вебхука (максимум 80 символов).
webhook_idstringобязательный
ID (snowflake) вебхука для редактирования.

discord_edit_webhook_messageидемпотентныйвнешний мир

Редактирует сообщение, ранее отправленное через webhook, используя ID и токен webhook. Заменяет предоставленные поля. Требует оригинальный токен webhook. Возвращает подтверждение.

Параметры

contentstring
Новое текстовое содержимое для сообщения (максимум 2000 символов).
embedsobject[]
До 10 встраиваемых объектов для прикрепления к сообщению вебхука.
message_idstringобязательный
ID сообщения вебхука для редактирования.
webhook_idstringобязательный
ID (снежинка) вебхука, который отправил сообщение.
webhook_tokenstringобязательный
Секретный токен вебхука.

discord_fetch_pinned_messagesтолько чтениевнешний мир

Перечисляет все закрепленные сообщения в канале. Возвращает { messages: [...] } с id, author, content, timestamp, pinnedAt. Только для чтения. Используйте discord_pin_message, чтобы изменить, какие сообщения закреплены.

Параметры

channel_idstringобязательный
ID (snowflake) канала или ветки, из которых нужно получить список закреплённых сообщений.

discord_fetch_webhook_messageтолько чтениевнешний мир

Получает одно сообщение, отправленное через webhook (id, содержимое, количество вложений, временная метка), используя ID и токен webhook. Только чтение. Требуется исходный токен webhook.

Параметры

message_idstringобязательный
ID сообщения вебхука, которое нужно получить.
webhook_idstringобязательный
ID (снежинка) вебхука, который отправил сообщение.
webhook_tokenstringобязательный
Секретный токен вебхука.

discord_find_channel_by_nameтолько чтениевнешний мир

Находит каналы, имя которых содержит подстроку (без учёта регистра). Возвращает подходящие каналы (id, name, type) в виде JSON-массива. Только для чтения. Полезно для получения channel_id, если известно только имя канала.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
namestringобязательный
Подстрока без учета регистра для сопоставления с именами каналов.

discord_follow_announcement_channelвнешний мир

Подписывает целевой канал на канал объявлений (новостей), чтобы опубликованные сообщения источника пересылались в целевой канал. Источником должен быть канал объявлений. Требует разрешения Manage Webhooks в целевом канале. Возвращает подтверждение.

Параметры

source_channel_idstringобязательный
ID (snowflake) канала для анонсов, который нужно отслеживать.
target_channel_idstringобязательный
ID (snowflake) канала, который будет получать опубликованные сообщения.

discord_forward_messageвнешний мир

Пересылает существующее сообщение в другой канал с помощью встроенной функции пересылки Discord, которая сохраняет исходную атрибуцию. Работает в текстовых каналах и ветках. Вместо этого используйте discord_send_message для создания нового содержимого. Требует разрешения Send Messages в целевом канале. Возвращает подтверждение.

Параметры

channel_idstringобязательный
ID (snowflake) канала или треда, в котором находится исходное сообщение.
message_idstringобязательный
ID сообщения для пересылки.
target_channel_idstringобязательный
ID (snowflake) канала или ветки назначения.

discord_get_audit_logтолько чтениевнешний мир

Получает журнал аудита сервера, запись административных действий (баны, кики, изменения ролей/каналов и т.д.) с указанием, кто их выполнил и когда. Требует разрешения View Audit Log. Возвращает { entries: [...] } с id, action, executor, target, reason, createdAt. Только чтение.

Параметры

action_typeenum | integer
Необязательный числовой ID события Discord AuditLogEvent для фильтрации (например, 22 = MemberBanAdd). Принимает ID событий новее встроенного перечисления. Опустите для всех типов действий.
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
limitinteger
Сколько последних записей получить (1–100). По умолчанию 25.

discord_get_channel_permissionsтолько чтениевнешний мир

Перечисляет все переопределения разрешений на канале для каждой роли и каждого участника, с указанием разрешенных и запрещенных флагов разрешений для каждого. Только чтение. Используйте discord_audit_permissions для получения отчета по всему серверу по всем каналам.

Параметры

channel_idstringобязательный
ID (snowflake) канала для проверки.

discord_get_event_subscribersтолько чтениевнешний мир

Перечисляет пользователей, которые отметили себя 'Interested' в запланированном мероприятии. Возвращает { subscribers: [...], nextCursor }. На одной странице помещается до 100 пользователей; если nextCursor не равен null, передайте его обратно как after, чтобы получить следующую страницу. Только для чтения.

Параметры

afterstring
Курсор пагинации: ID пользователя (snowflake). Передайте nextCursor из предыдущего ответа, чтобы получить следующую страницу.
event_idstringобязательный
ID (snowflake) запланированного события.
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
limitinteger
Максимум подписчиков на страницу (1–100). По умолчанию 25.

discord_get_forum_channelsтолько чтениевнешний мир

Перечисляет форумные каналы на сервере (id, name, topic, parent category). Только для чтения. Используйте discord_get_forum_tags, чтобы просмотреть доступные теги форума, или discord_list_forum_threads для его сообщений.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).

discord_get_forum_postтолько чтениевнешний мир

Получает детали поста на форуме (название, статус архивирован/заблокирован, применённые теги, количество сообщений) и его последние сообщения от старых к новым. Только чтение. Передайте thread_id поста. Возвращает объект JSON.

Параметры

limitinteger
Сколько последних сообщений включить (1–100). По умолчанию 20.
thread_idstringобязательный
ID (snowflake) поста на форуме (темы).

discord_get_forum_tagsтолько чтениевнешний мир

Перечисляет теги, доступные на канале-форуме (id, имя, эмодзи, флаг модерации). Только для чтения. Используйте эти ID с discord_create_forum_post или discord_update_forum_post; управляйте набором тегов с помощью discord_set_forum_tags.

Параметры

forum_channel_idstringобязательный
ID (snowflake) форумного канала, из которого нужно читать теги.

discord_get_guild_infoтолько чтениевнешний мир

Получает сведения о сервере: название, описание, количество участников/каналов/ролей, уровень буста, владельца и дату создания. Только для чтения. Используйте discord_get_server_stats для более детальной разбивки (люди и боты, типы каналов).

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).

discord_get_inviteтолько чтениевнешний мир

Находит приглашение по его коду: целевой сервер и канал, пригласивший и срок действия. Работает для любого публичного приглашения, но этот endpoint никогда не возвращает счётчики использования (uses/max_age читаются как 0); используйте discord_list_invites или discord_list_channel_invites для реальных счётчиков. Только чтение. Возвращает JSON-объект.

Параметры

invite_codestringобязательный
Код приглашения, например 'abc123'. Полный URL вида discord.gg/abc123 также принимается, и из него извлекается код.

discord_get_member_infoтолько чтениевнешний мир

Получает полные данные одного участника сервера: роли, действующие разрешения, даты регистрации/вступления, флаг бота и текущий статус тайм-аута. Только чтение. Возвращает объект JSON.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
user_idstringобязательный
ID пользователя Discord (snowflake) участника.

discord_get_membership_screeningтолько чтениевнешний мир

Получает форму проверки участников сервера, правила/вопросы, которые новые участники должны принять перед получением доступа. Требует, чтобы на сервере была включена функция Community. Только для чтения. Возвращает форму в виде JSON, включая её версию.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).

discord_get_message_attachmentsтолько чтениевнешний мир

Перечисляет файловые вложения в сообщении. Возвращает { attachments: [...] } с полями: id, filename, title (оригинальное название, когда Discord убирает не-ASCII символы из имени файла), url, proxyUrl, contentType, size в байтах, width, height, alt-text описание, длительность и waveform для голосовых сообщений, spoiler flag. Discord подписывает CDN-ссылки сроком действия 24 часа и не обновляет подпись при каждом запросе; вызывайте этот инструмент повторно, если сохранённая ссылка истекла. Требуются разрешения View Channel и Read Message History. Только чтение. Используйте discord_read_messages, чтобы найти сообщения с вложениями.

Параметры

channel_idstringобязательный
ID (snowflake) канала или ветки, содержащей сообщение.
message_idstringобязательный
ID сообщения, вложения которого нужно вывести списком.

discord_get_reactionsтолько чтениевнешний мир

Перечисляет пользователей, которые отреагировали на сообщение определённым эмодзи. Возвращает { reactions: [...] } с id, username, bot flag. Только для чтения.

Параметры

channel_idstringобязательный
ID (snowflake) канала или ветки, содержащей сообщение.
emojistringобязательный
Юникод-эмодзи или кастомный эмодзи в формате 'name:id', для которого нужно получить список отреагировавших.
limitinteger
Максимум пользователей для возврата (1–100). По умолчанию 25.
message_idstringобязательный
ID сообщения для просмотра.

discord_get_role_membersтолько чтениевнешний мир

Перечисляет участников, у которых есть определённая роль, сканируя до 20 000 участников. Возвращает { members: [...], truncated }; проверяйте truncated на очень больших серверах. Только чтение. Сначала используйте discord_list_roles, чтобы узнать ID ролей.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
role_idstringобязательный
ID (snowflake) роли, для которой нужно получить список держателей.

discord_get_scheduled_eventтолько чтениевнешний мир

Получает полные сведения об одном запланированном событии: название, описание, статус, тип, канал/местоположение, время начала/окончания, создатель и количество заинтересованных пользователей. Только для чтения. Возвращает JSON-объект.

Параметры

event_idstringобязательный
ID (snowflake) запланированного события.
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).

discord_get_server_statsтолько чтениевнешний мир

Получает снимок метрик сервера: общее количество участников (люди и кэшированные боты), разбивку по каналам (текстовые/голосовые/категории), количество ролей, уровень и количество бустов, а также дату создания. Только для чтения. Возвращает JSON-объект. Примечание: боты считаются только из кэша участников, поэтому botsInCache — это нижняя граница, а люди (всего минус кэшированные боты) — верхняя граница.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).

discord_kick_memberвнешний мир

Удаляет участника с сервера. Он может вернуться по новому приглашению (в отличие от бана). Требуется разрешение Kick Members, и высшая роль бота должна быть выше цели. Используйте discord_ban_member, чтобы заблокировать повторный вход. Причина записывается в журнал аудита.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
reasonstring
Записывает необязательную причину в журнал аудита сервера.
user_idstringобязательный
ID пользователя Discord (snowflake) участника, которого нужно исключить.

discord_list_bansтолько чтениевнешний мир

Перечисляет пользователей, забаненных на сервере, с указанием причин бана. Возвращает { bans: [...], nextCursor }. Одна страница содержит до 1000 банов; если nextCursor не равен null, передайте его как after, чтобы получить следующую страницу. Требует разрешения Ban Members. Только для чтения.

Параметры

afterstring
Курсор пагинации: ID пользователя (snowflake). Передайте nextCursor из предыдущего ответа, чтобы получить следующую страницу.
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
limitinteger
Максимум банов на страницу (1–1000). По умолчанию — 1000.

discord_list_channel_invitesтолько чтениевнешний мир

Перечисляет активные приглашения, указывающие на один конкретный канал. В отличие от discord_list_invites (на уровне сервера), этот инструмент ограничивает результаты одним каналом. Требует разрешения Manage Channels. Только для чтения.

Параметры

channel_idstringобязательный
ID (snowflake) канала, для которого нужно перечислить приглашения.

discord_list_channelsтолько чтениевнешний мир

Перечисляет все каналы на сервере, сгруппированные по родительской категории и отсортированные по позиции. Возвращает JSON-объект, ключами которого служат названия категорий. Только чтение. Используйте discord_find_channel_by_name для поиска конкретного канала.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).

discord_list_forum_threadsтолько чтениевнешний мир

Выводит список постов в форумном канале. Возвращает { threads: [...], hasMore, nextBefore }. Первый вызов (без before) включает все активные посты и первую страницу архивных постов; архивные посты разбиты на страницы, поэтому если hasMore равен true, передайте nextBefore обратно как before, чтобы получить более старые архивные посты. Только для чтения. Чтобы прочитать сообщения одного поста, используйте discord_get_forum_post.

Параметры

beforestring
Курсор пагинации: метка времени ISO. Передайте nextBefore из предыдущего ответа, чтобы получить более старые архивные посты. Если этот параметр задан, активные посты не включаются в выдачу.
forum_channel_idstringобязательный
ID (snowflake) форумного канала, из которого нужно получить список сообщений.
limitinteger
Максимум архивных постов на странице (1–100). По умолчанию 100.

discord_list_guildsтолько чтениевнешний мир

Перечисляет все серверы Discord (гильдии), в которых состоит бот (идентификатор, название, количество участников, иконка). Не принимает аргументов. Только чтение. Начните здесь, чтобы узнать guild_id, необходимый для большинства других инструментов.

Параметры

Без параметров.

discord_list_invitesтолько чтениевнешний мир

Перечисляет все активные приглашения на сервере (код, ссылка, канал, пригласивший, использовано, срок действия). Требует разрешения Manage Server. Только для чтения. Используйте discord_list_channel_invites, чтобы ограничить одним каналом.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).

discord_list_membersтолько чтениевнешний мир

Перечисляет участников сервера с их ролями, упорядоченных по ID пользователя. Возвращает { members: [...], nextCursor }. Страница содержит до 1000 участников; если nextCursor не равен null, передайте его обратно как after, чтобы получить следующую страницу. Использует discord_search_members для поиска конкретных участников по имени, или discord_get_member_info для получения полной информации об одном участнике. Только для чтения.

Параметры

afterstring
Курсор пагинации: ID пользователя (snowflake). Передайте nextCursor из предыдущего ответа, чтобы получить следующую страницу.
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
limitinteger
Сколько участников на странице (1–1000). По умолчанию 50.

discord_list_rolesтолько чтениевнешний мир

Перечисляет все роли на сервере (кроме @everyone), сначала самые высокие, с цветом, позицией, количеством участников и правами. Только для чтения. Возвращает { roles: [...] }. Используйте discord_get_role_members, чтобы увидеть, кто занимает данную роль.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).

discord_list_scheduled_eventsтолько чтениевнешний мир

Перечисляет все запланированные события на сервере (id, name, status, type, time, location, interested count). Только для чтения. Используйте discord_get_scheduled_event для получения полной информации об одном событии.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).

discord_list_webhooksтолько чтениевнешний мир

Перечисляет webhooks в одном канале или на всём сервере (id, name, channel, token при наличии, creator). Укажите ровно один из параметров channel_id или guild_id. Требует разрешения Manage Webhooks. Только чтение.

Параметры

channel_idstring
ID (snowflake) канала, для которого нужно получить список вебхуков. Не может использоваться вместе с guild_id.
guild_idstring
ID сервера Discord (гильдии) (снежинка) для перечисления всех вебхуков. Взаимоисключающий с channel_id.

discord_lock_channel_permissionsидемпотентныйвнешний мир

Сбрасывает переопределения разрешений канала, чтобы они точно соответствовали его родительской категории (Discord's 'sync permissions'). Канал должен находиться внутри категории. Требует разрешения Manage Roles. Возвращает подтверждение.

Параметры

channel_idstringобязательный
ID (snowflake) канала для синхронизации с родительской категорией.

discord_move_channelидемпотентныйвнешний мир

Перемещает канал в категорию или удаляет его из категории, если category_id опущен. Требует разрешения Manage Channels. Используйте discord_set_channel_position для изменения порядка внутри категории. Возвращает подтверждение.

Параметры

category_idstring
Целевая категория (snowflake). Если не указано, канал будет перемещён из любой категории.
channel_idstringобязательный
ID (snowflake) канала для перемещения.

discord_pin_messageидемпотентныйвнешний мир

Закрепляет или открепляет сообщение в канале, управляется флагом pin. Требует разрешения Pin Messages (отдельное разрешение с начала 2026 года, не входящее в Manage Messages). В канале может быть не более 50 закреплённых сообщений. Идемпотентно: закрепление уже закреплённого сообщения (или открепление уже откреплённого) не имеет дополнительного эффекта.

Параметры

channel_idstringобязательный
ID (snowflake) канала или ветки, содержащей сообщение.
message_idstringобязательный
ID сообщения для закрепления или открепления.
pinbooleanобязательный
true означает закрепить сообщение, false - открепить его.

discord_prune_membersвнешний мир

Удаляет участников, которые не проявляли активности (не имеют ролей, не были замечены) в течение нескольких дней. БЕЗОПАСНО ПО УМОЛЧАНИЮ: dry_run имеет значение true, если явно не указано false, поэтому сначала вызовите его, чтобы просмотреть количество, затем повторно вызовите с dry_run:false, чтобы фактически удалить их. Удаление необратимо (участники должны присоединиться заново). Требует разрешения Kick Members.

Параметры

daysintegerобязательный
Порог неактивности в днях (1–30).
dry_runboolean
Если true (по умолчанию), возвращает только количество элементов, которые были бы удалены, ничего не удаляя. Задайте false, чтобы выполнить удаление.
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
reasonstring
Записывает необязательную причину в журнал аудита сервера.
rolesstring[]
Необязательные ID ролей (snowflake) для включения; по умолчанию учитываются только участники без ролей.

discord_read_dmsтолько чтениевнешний мир

Читает самые последние сообщения из DM-беседы бота с пользователем, от старых к новым. Возвращает { messages: [...] } с id, author, content, embed count, timestamp. Только для чтения.

Параметры

limitinteger
Сколько последних сообщений получить (1–100). По умолчанию 20.
user_idstringобязательный
ID пользователя Discord (snowflake) получателя DM.

discord_read_messagesтолько чтениевнешний мир

Читает сообщения из текстового канала или ветки, от старых к новым. Листает назад повторным вызовом с параметром before, установленным на id самого старого полученного сообщения, что позволяет пройти канал дальше лимита в 100 сообщений за вызов. Требует разрешений View Channel и Read Message History. Возвращает { messages: [...] } с id, автором, содержимым, временной меткой, количеством вложений, флагом закрепления. Используйте discord_search_messages для фильтрации по ключевому слову или discord_fetch_pinned_messages для получения только закрепленных сообщений.

Параметры

afterstring
Возвращает только сообщения новее этого ID сообщения (snowflake). Чтобы листать вперёд, передавайте ID самого нового сообщения из предыдущего вызова.
aroundstring
Возвращает сообщения, центрированные вокруг этого ID сообщения (snowflake): Discord распределяет limit по обе стороны от него, а при чётном limit дополнительное сообщение попадает на более новую сторону. Используйте его, чтобы читать сообщения в обе стороны от известного сообщения, например, найденного с помощью discord_search_guild_messages.
beforestring
Возвращает только сообщения, которые старше этого ID сообщения (snowflake). Листайте историю назад, передавая ID самого старого сообщения из предыдущего вызова.
channel_idstringобязательный
ID (snowflake) канала или ветки, из которого нужно читать.
limitinteger
Сколько сообщений получать за один вызов (1–100). По умолчанию 20.
sincestring
Возвращает только сообщения, опубликованные после этого момента, указанного в виде даты ISO 8601 или даты-времени с явным смещением (например, "2026-08-01" или "2026-08-01T09:00:00Z"). Удобная форма after: вызов возвращает limit самых старых сообщений после этого момента, поэтому листайте вперёд, устанавливая after на новейший полученный id.

discord_remove_reactionsидемпотентныйвнешний мир

Удаляет реакции из сообщения. Без эмодзи: удаляет ВСЕ реакции. Только с эмодзи: удаляет каждую реакцию этого эмодзи. С эмодзи и user_id: удаляет реакцию этого пользователя. Удаление всех реакций или реакции другого пользователя требует разрешения Manage Messages. Используйте discord_add_reaction для добавления.

Параметры

channel_idstringобязательный
ID (snowflake) канала или ветки, содержащей сообщение.
emojistring
Юникод-эмодзи или кастомное эмодзи в формате 'name:id'. Если опустить этот параметр, будут удалены ВСЕ реакции на сообщении.
message_idstringобязательный
ID сообщения, из которого удаляются реакции.
user_idstring
Удаляет реакцию только этого пользователя для указанного эмодзи. Требует, чтобы эмодзи было установлено.

discord_remove_roleидемпотентныйвнешний мир

Удаляет роль у участника. Требует разрешения Manage Roles, причём роль должна находиться ниже самой высокой роли бота. Идемпотентно: удаление роли, которой у участника нет, не даёт эффекта. Отменяет действие discord_add_role.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
reasonstring
Записывает необязательную причину в журнал аудита сервера.
role_idstringобязательный
ID (snowflake) роли для удаления.
user_idstringобязательный
Discord user ID (snowflake) участника, у которого нужно удалить роль.

discord_reply_dmвнешний мир

Отвечает на конкретное сообщение в личном сообщении (DM), добавляя цитируемую ссылку на ответ. В отличие от инструментов редактирования/удаления DM, это работает с любым сообщением в беседе (ботом или пользователем). Используйте discord_send_dm для отдельного DM без ссылки. Возвращает ID сообщения нового ответа.

Параметры

contentstringобязательный
Текст ответа в обычном формате (не более 2000 символов).
message_idstringобязательный
ID целевого сообщения в рамках DM-переписки.
user_idstringобязательный
ID пользователя Discord (snowflake) получателя DM.

discord_reply_messageвнешний мир

Отвечает на конкретное сообщение, прикрепляя ссылку на ответ, чтобы клиенты отображали его как ответ в ветке. Используйте discord_send_message для отдельного сообщения без ссылки. Требует разрешения Send Messages. Возвращает идентификатор нового сообщения-ответа.

Параметры

channel_idstringобязательный
ID (snowflake) канала или ветки, содержащей сообщение.
contentstringобязательный
Текст ответа в обычном формате (не более 2000 символов).
message_idstringобязательный
Идентификатор сообщения, на которое нужно ответить.

discord_reply_to_forumвнешний мир

Отправляет ответное сообщение внутри существующего форумного поста (ветки). Требует разрешения Send Messages in Threads (отображается как 'Send Messages in Posts' для форумов). Для создания нового поста вместо этого используйте discord_create_forum_post. Возвращает ID нового сообщения.

Параметры

contentstringобязательный
Текст ответа в обычном формате (не более 2000 символов).
thread_idstringобязательный
ID (snowflake) форумного поста (темы), в который нужно ответить.

discord_reset_channel_permissionsидемпотентныйвнешний мир

Удаляет ВСЕ переопределения разрешений на канале, так что применяются только разрешения уровня роли/сервера. НЕ синхронизирует заново с категорией; для этого следует использовать discord_lock_channel_permissions. НЕОБРАТИМО: очищенные переопределения невозможно восстановить. Требует разрешения Manage Roles.

Параметры

channel_idstringобязательный
ID (snowflake) канала, чьи переопределения будут очищены.
reasonstring
Записывает необязательную причину в журнал аудита сервера.

discord_search_guild_messagesтолько чтениевнешний мир

Ищет сообщения во всех каналах гильдии через нативный поисковый API Discord. Возвращает сообщения, соответствующие запросу, с контекстом канала. Требует разрешения READ_MESSAGE_HISTORY. Используйте discord_search_messages для поиска по конкретному каналу.

Параметры

author_idstring
Необязательно. Показывает только сообщения от этого ID пользователя.
channel_idstring
Необязательно. Ограничивает поиск этим идентификатором канала.
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
limitinteger
Максимум возвращаемых сообщений (1-10, по умолчанию 10)
querystringобязательный
Поисковый запрос (без учёта регистра).

discord_search_membersтолько чтениевнешний мир

Находит участников сервера, чьё имя пользователя или никнейм начинается с заданной строки (поиск по префиксу). Возвращает { members: [...] } с id, username, nickname, roles. Используйте discord_list_members для постраничного перебора всех участников. Только для чтения.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
limitinteger
Максимум участников для возврата (1–100). По умолчанию 25.
querystringобязательный
Префикс для сопоставления с именами пользователей и никнеймами.

discord_search_messagesтолько чтениевнешний мир

Поиск по ключевым словам в последних сообщениях канала с сопоставлением подстрок без учёта регистра. Сканирует только последние 100 сообщений; полную историю не ищет. Возвращает { matches: [...] } с id, author, content, timestamp. Используйте discord_read_messages, чтобы получить последние сообщения без фильтрации.

Параметры

channel_idstringобязательный
ID (snowflake) канала или ветки для поиска.
keywordstringобязательный
Подстрока для сопоставления без учета регистра в содержимом сообщения.
limitinteger
Максимальное количество последних сообщений для сканирования (1–100). По умолчанию 100.

discord_send_dmвнешний мир

Отправляет личное сообщение пользователю по его user ID. Для публикации в канале сервера используйте discord_send_message. Требует, чтобы бот состоял хотя бы на одном общем сервере с пользователем, и пользователь должен разрешить личные сообщения от участников сервера (иначе Discord отклонит отправку). Возвращает новый message ID.

Параметры

contentstringобязательный
Тело сообщения в виде обычного текста (не более 2000 символов).
user_idstringобязательный
ID пользователя Discord (snowflake) получателя DM.

discord_send_dm_embedвнешний мир

Отправляет богатое вложение как личное сообщение пользователю. Для обычного текста используйте discord_send_dm, а для публикации вложения в канале — discord_send_embed. Требуется, чтобы бот состоял на одном сервере с пользователем, и пользователь должен разрешить личные сообщения от участников сервера. Возвращает ID нового сообщения.

Параметры

authorobject
Блок автора, отображаемый в верхней части встраиваемого элемента.
colorstring
Цвет боковой панели в виде шестнадцатеричной строки, например '#5865F2'.
contentstring
Необязательный простой текст, отображаемый над встроенным элементом.
descriptionstring
Основной текст встраиваемого элемента (поддерживает Markdown).
fieldsobject[]
До 25 блоков полей «имя/значение». Установите inline:true для поля, чтобы отобразить его рядом с соседними инлайн-полями (до 3 в ряд).
footerstring
Текст внизу встраиваемого элемента.
image_urlstring
Крупное изображение показано ниже тела встраиваемого элемента.
thumbnail_urlstring
Небольшое изображение в правом верхнем углу.
timestampboolean
Если это верно, добавьте в embed текущее время.
titlestring
Вверху вставьте заголовок, выделенный жирным шрифтом.
urlstring
URL, который делает заголовок кликабельным.
user_idstringобязательный
ID пользователя Discord (snowflake) получателя DM.

discord_send_embedвнешний мир

Отправляет одно богатое встроенное сообщение (заголовок, описание, цвет, поля, автор, подвал, изображения, временная метка). Используйте discord_send_message для обычного текста или discord_send_multiple_embeds для отправки нескольких встроенных сообщений сразу. Требует разрешений Send Messages и Embed Links. Возвращает ID нового сообщения.

Параметры

authorobject
Блок автора, отображаемый в верхней части встраиваемого элемента.
channel_idstringобязательный
ID (snowflake) целевого канала или треда.
colorstring
Цвет боковой панели в виде шестнадцатеричной строки, например '#5865F2'.
descriptionstring
Основной текст встраиваемого элемента (поддерживает Markdown).
fieldsobject[]
До 25 блоков полей «имя/значение». Установите inline:true для поля, чтобы отобразить его рядом с соседними инлайн-полями (до 3 в ряд).
footerstring
Текст внизу встраиваемого элемента.
image_urlstring
Крупное изображение показано ниже тела встраиваемого элемента.
thumbnail_urlstring
Небольшое изображение в правом верхнем углу.
timestampboolean
Если это верно, добавьте в embed текущее время.
titlestring
Вверху вставьте заголовок, выделенный жирным шрифтом.
urlstring
URL, который делает заголовок кликабельным.

discord_send_messageвнешний мир

Отправляет простое текстовое сообщение в канал или тред. Для насыщенного контента (заголовок, цвет, поля, изображения) используйте discord_send_embed; чтобы прикрепить ссылку на ответ к существующему сообщению, используйте discord_reply_message. Требует наличия у бота разрешения Send Messages. Возвращает ID нового сообщения.

Параметры

channel_idstringобязательный
ID (snowflake) целевого канала или треда.
contentstringобязательный
Тело сообщения в виде простого текста (не более 2000 символов).

discord_send_multiple_embedsвнешний мир

Отправляет до 10 вложений в одном сообщении, с необязательным текстом над ними. Использует discord_send_embed для одного вложения. Требует разрешения Send Messages и Embed Links. Возвращает ID нового сообщения.

Параметры

channel_idstringобязательный
ID (snowflake) целевого канала или треда.
contentstring
Необязательный обычный текст, отображаемый над вложениями.
embedsobject[]обязательный
Массив embed-объектов для отправки (не более 10).

discord_send_webhook_messageвнешний мир

Отправляет сообщение через вебхук, используя его ID и токен (права бота не требуются; токен авторизует отправку). Поддерживает переопределение имени пользователя/аватара для каждого сообщения и до 10 встроенных сообщений. Требуется хотя бы одно из: содержимое или встроенные сообщения. Возвращает ID нового сообщения.

Параметры

avatar_urlstring
Переопределить аватар вебхука по умолчанию для этого сообщения.
contentstring
Тело сообщения в виде обычного текста (не более 2000 символов). Необязательно при наличии вложений.
embedsobject[]
До 10 встраиваемых объектов для прикрепления к сообщению вебхука.
usernamestring
Переопределяет стандартное отображаемое имя вебхука для этого сообщения.
webhook_idstringобязательный
ID (snowflake) вебхука, через который нужно отправить сообщение.
webhook_tokenstringобязательный
Секретный токен вебхука (из discord_create_webhook или discord_list_webhooks).

discord_set_channel_positionидемпотентныйвнешний мир

Устанавливает порядок отображения канала внутри его категории. Использует discord_move_channel, чтобы изменить категорию, к которой он принадлежит. Требует разрешения Manage Channels. Возвращает подтверждение.

Параметры

channel_idstringобязательный
ID (snowflake) канала для перемещения.
positionintegerобязательный
Позиция с отсчётом от нуля внутри категории (0 = верх).

discord_set_forum_tagsидемпотентныйвнешний мир

Заменяет полный набор доступных тегов на форумном канале на указанный список. Это перезаписывает существующие теги, поэтому включите каждый тег, который хотите сохранить. Требует разрешение Manage Channels. Возвращает подтверждение.

Параметры

forum_channel_idstringобязательный
ID (snowflake) канала форума для установки тегов.
tagsobject[]обязательный
Полный список тегов для установки (заменяет все существующие теги).

discord_set_member_permissionидемпотентныйвнешний мир

Добавляет или обновляет переопределение разрешений для одного участника на канал, разрешая и/или запрещая определённые разрешения. Объединяется с существующим переопределением участника. Требует разрешение Manage Roles. Используйте discord_set_role_permission, чтобы вместо этого применить изменения ко всей роли.

Параметры

allowstring[] | string
Имена флагов разрешений для разрешения, например ['ViewChannel'] (или тот же массив, закодированный в JSON как строка). Использует имена флагов Discord PermissionsBitField.
channel_idstringобязательный
ID (snowflake) канала, для которого устанавливается перезапись.
denystring[] | string
Имена флагов разрешений, которые нужно запретить (массив или JSON-закодированная строка массива).
reasonstring
Записывает необязательную причину в журнал аудита сервера.
user_idstringобязательный
ID (snowflake) участника, которому нужно выдать или запретить разрешения.

discord_set_nicknameидемпотентныйвнешний мир

Устанавливает или сбрасывает никнейм участника на сервере. Передайте null (или строку 'null'), чтобы сбросить его. Требуется разрешение Manage Nicknames (или Change Nickname для самого бота). Причина записывается в журнал аудита.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
nicknamestring | nullобязательный
Новый ник (максимум 32 символа) или null, чтобы очистить.
reasonstring
Записывает необязательную причину в журнал аудита сервера.
user_idstringобязательный
ID пользователя Discord (snowflake) участника.

discord_set_role_iconидемпотентныйвнешний мир

Устанавливает или убирает иконку роли: пользовательское изображение или юникод-эмодзи. Требует Boost Level 2+ на сервере (функция ROLE_ICONS) и разрешения Manage Roles. Передает null в любое из полей, чтобы убрать эту иконку. Возвращает подтверждение.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
iconstring | null
URL изображения для иконки роли, или null, чтобы удалить её.
role_idstringобязательный
ID (snowflake) роли, на которую нужно установить иконку.
unicode_emojistring | null
Unicode-эмодзи для использования в качестве иконки роли, или null для её удаления.

discord_set_role_permissionидемпотентныйвнешний мир

Добавляет или обновляет переопределение разрешений для канала для роли, разрешая и/или запрещая конкретные разрешения. Объединяется с существующим переопределением роли (не сбрасывает его). Запрет «Просмотр канала» для @everyone также блокирует бота, если у него нет собственного разрешающего переопределения; выдайте его с помощью discord_set_member_permission перед запретом. Требуется разрешение «Управление разрешениями». Вместо этого используйте discord_set_member_permission, чтобы нацелиться на отдельного участника.

Параметры

allowstring[] | string
Имена флагов разрешений для разрешения, например ['SendMessages','ViewChannel'] (или тот же массив, закодированный в JSON как строка). Использует имена флагов Discord PermissionsBitField.
channel_idstringобязательный
ID (snowflake) канала, для которого устанавливается перезапись.
denystring[] | string
Имена флагов разрешений для запрета, например ['SendMessages'] (или тот же массив, закодированный в JSON как строка).
reasonstring
Записывает необязательную причину в журнал аудита сервера.
role_idstringобязательный
ID (snowflake) роли, для которой нужно предоставить или запретить разрешения.

discord_set_role_positionидемпотентныйвнешний мир

Перемещает роль вверх или вниз по иерархии ролей сервера, которая определяет приоритет разрешений и порядок участников в списке. Более высокая позиция = выше в списке. Требуется разрешение Manage Roles, и целевая позиция должна быть ниже самой высокой роли бота.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
positionintegerобязательный
Новая позиция в иерархии (1 — самая низкая, сразу над @everyone, который находится на 0). Чем больше число, тем выше позиция.
role_idstringобязательный
ID (snowflake) роли для изменения позиции.

discord_timeout_memberидемпотентныйвнешний мир

Глушит участника на заданную длительность (Discord 'timeout'): он не может отправлять сообщения, реагировать или говорить, пока не истечёт срок. Передаёт duration_minutes = 0, чтобы досрочно снять активный тайм-аут. Максимум 28 дней (40320 минут). Требует разрешения Moderate Members.

Параметры

duration_minutesintegerобязательный
Длительность таймаута в минутах (0–40320, то есть до 28 дней). Используйте 0, чтобы очистить существующий таймаут.
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
reasonstring
Записывает необязательную причину в журнал аудита сервера.
user_idstringобязательный
ID пользователя Discord (snowflake) участника, которому нужно выдать тайм-аут.

discord_unban_memberидемпотентныйвнешний мир

Снимает блокировку, чтобы пользователь мог присоединиться заново по новому приглашению. Требует разрешение Ban Members. Отменяет действие discord_ban_member. Причина записывается в журнал аудита.

Параметры

guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).
reasonstring
Записывает необязательную причину в журнал аудита сервера.
user_idstringобязательный
Идентификатор (snowflake) пользователя Discord, которого нужно разбанить.

discord_update_forum_postидемпотентныйвнешний мир

Обновляет заголовок сообщения форума, статус архивации/блокировки или применённые теги. Изменяются только указанные поля; передача applied_tags заменяет теги сообщения. Установите archived:true, чтобы закрыть сообщение без удаления. Требуется разрешение Manage Threads.

Параметры

applied_tagsstring[]
ID тегов для применения; заменяет текущие теги сообщения. Получите допустимые ID из discord_get_forum_tags.
archivedboolean
Истина для архивации (закрытия) поста, ложь для его повторного открытия.
lockedboolean
true для блокировки записи, чтобы только модераторы могли отвечать.
thread_idstringобязательный
ID (snowflake) поста (темы) на форуме для обновления.
titlestring
Новое название/имя темы (максимум 100 символов).

discord_update_membership_screeningидемпотентныйвнешний мир

Обновляет форму проверки новых участников на сервере: задаёт приветственное описание и правила, с которыми должны согласиться новые участники. Изменяются только указанные поля. Требует функции Сообщество и разрешения Manage Server. Возвращает обновлённую форму.

Параметры

descriptionstring
Приветственное сообщение, которое показывается вверху формы скрининга.
form_fieldsobject[]
Блоки правил/соглашений, которые новые участники должны принять. Заменяет существующие поля при их предоставлении.
guild_idstringобязательный
ID сервера Discord (гильдии) (snowflake).

`2.2.0`основная	03.09.2026
`2.1.1`	04.08.2026
`2.1.0`	13.07.2026
`2.0.0`	21.06.2026
`1.7.3`	11.06.2026
`1.7.2`	10.06.2026
`1.7.1`	10.06.2026
`1.7.0`	29.05.2026
`1.6.2`	29.05.2026
`1.6.1`	29.05.2026
`1.6.0`	28.05.2026
`1.5.1`	28.05.2026
`1.5.0`	04.05.2026
`1.4.1`	25.03.2026
`1.4.0`	25.03.2026
`1.3.0`	25.03.2026
`1.2.0`	21.03.2026
`1.1.0`	20.03.2026

Выберите клиент, чтобы установить PaSympa/discord-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "pasympa-discord-mcp-ztogu335em": {
      "command": "npx",
      "args": [
        "-y",
        "@pasympa/discord-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "pasympa-discord-mcp-ztogu335em": {
      "command": "npx",
      "args": [
        "-y",
        "@pasympa/discord-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "pasympa-discord-mcp-ztogu335em": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@pasympa/discord-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"pasympa-discord-mcp-ztogu335em\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@pasympa/discord-mcp\"],\"env\":{\"DISCORD_TOKEN\":\"YOUR_TOKEN_HERE\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "pasympa-discord-mcp-ztogu335em": {
      "command": "npx",
      "args": [
        "-y",
        "@pasympa/discord-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add pasympa-discord-mcp-ztogu335em --env DISCORD_TOKEN=YOUR_TOKEN_HERE -- npx -y @pasympa/discord-mcp

Либо через JSON-конфиг:

claude mcp add-json pasympa-discord-mcp-ztogu335em "{\"command\":\"npx\",\"args\":[\"-y\",\"@pasympa/discord-mcp\"],\"env\":{\"DISCORD_TOKEN\":\"YOUR_TOKEN_HERE\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add pasympa-discord-mcp-ztogu335em --env DISCORD_TOKEN=YOUR_TOKEN_HERE -- npx -y @pasympa/discord-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.pasympa-discord-mcp-ztogu335em]
command = "npx"
args = ["-y", "@pasympa/discord-mcp"]

[mcp_servers.pasympa-discord-mcp-ztogu335em.env]
DISCORD_TOKEN = "YOUR_TOKEN_HERE"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите PaSympa/discord-mcp, а в поле команды запуска — строку ниже:

npx -y @pasympa/discord-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "pasympa-discord-mcp-ztogu335em": {
      "command": "npx",
      "args": [
        "-y",
        "@pasympa/discord-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "pasympa-discord-mcp-ztogu335em": {
      "command": "npx",
      "args": [
        "-y",
        "@pasympa/discord-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR_TOKEN_HERE"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например pasympa-discord-mcp-ztogu335em.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: pasympa-discord-mcp-ztogu335em
    command: npx
    args:
      - "-y"
      - "@pasympa/discord-mcp"
    env:
      DISCORD_TOKEN: YOUR_TOKEN_HERE

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "pasympa-discord-mcp-ztogu335em": {
      "command": "npx",
      "args": [
        "-y",
        "@pasympa/discord-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@pasympa/discord-mcp"
  ],
  "env": {
    "DISCORD_TOKEN": "YOUR_TOKEN_HERE"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #195
Звезд на Github: 28
Форков на Github: 17
Загрузок: 13 570
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 21.10 в 06:13
Идентификатор: xV74OHF_Po_7vAsx
Категории: Автоматизация приложений, Коммуникации

PaSympa/discord-mcp

Discord MCP Server

Why this one?

Quick Start

Часто задаваемые вопросы

Похожие MCP-сервера

iprashantraj/mcp-discord-bridge

saseq/discord-mcp

chaindead/telegram-mcp

overpod/mcp-telegram

chigwell/telegram-mcp

PhononX/cv-mcp-server