Discord MCP Ultimate
Provides comprehensive administration of a Discord server through natural language, covering messages, channels, roles, permissions, moderation, server settings (name, icon, banner, Community, widget, welcome screen, onboarding), AutoMod, emoji and stickers, bot profile management, Unicode channel/role name styling, structure backup and restore, scheduling and announcements, plus a server architect that plans, diffs, applies and repairs a full server structure from a described plan. Mutating tools preview by default and require explicit confirmation, with permission preflight, role-hierarchy checks, guild allowlisting and an audit trail.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Discord MCP Ultimate create a #welcome channel and a read-only Members role"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Discord MCP Ultimate
A Discord MCP server with 177 tools, plus a 24/7 bot — full server administration, driven by natural language
Manage an entire Discord server from Claude Desktop, Claude Code, Cursor, VS Code Copilot, or any MCP-compatible client. Messages, channels, roles, permissions, moderation, server settings, AutoMod, emoji and stickers, and a server architect that builds a structure from a plan.
The same repository ships a complete bot (npm run bot) that keeps one gateway connection open:
reaction roles, welcome messages, autoroles, levels, logging, moderation with
numbered cases, tickets, giveaways, a starboard, temporary voice channels, an
autoresponder, slash commands, and the MCP tool surface served over authenticated
HTTP so a remote agent can drive it. Everything is configured from Discord with
/config, so no separate service is needed.
See docs/BOT_FEATURES.md and docs/BOT.md.
What this is
A fork of PaSympa/discord-mcp 2.2.0, MIT licensed. The 99 tools from that baseline are preserved unchanged. This fork adds 78 tools, taking the total to 177, and adds a safety layer that the new tools go through.
Baseline 2.2.0 | This fork | |
Tools | 99 | 177 |
Server settings (name, icon, banner, Community, widget, onboarding) | — | 25 tools |
Bot profile management | — | 8 tools |
Unicode name styling | — | 4 tools |
Server architect (plan, compare, apply, repair) | — | 10 tools |
AutoMod | — | 6 tools |
Emoji and stickers | — | 8 tools |
Structure backup and restore | — | 3 tools |
Diagnostics and audit trail | — | 6 tools |
Message scheduling | — | 4 tools |
Reaction-role menus | — | 3 tools |
Scheduling and announcements | — | 4 tools |
Native polls | — | 1 tool |
Reaction-role menus (needs the bot) | — | 3 tools |
24/7 bot: reaction roles, welcome DMs, HTTP MCP | — |
|
Preview-before-apply gating | partial ( | on every added tool |
Full inventory: docs/TOOL_AUDIT.md. What each new tool does: docs/NEW_TOOLS.md.
Related MCP server: discord-provisioner-mcp
Quick start
{
"mcpServers": {
"discord": {
"command": "node",
"args": ["/absolute/path/to/discord-mcp-ultimate/dist/index.js"],
"env": {
"DISCORD_TOKEN": "YOUR_BOT_TOKEN_HERE"
}
}
}
}git clone https://github.com/ferelking242/discord-mcp-ultimate.git
cd discord-mcp-ultimate
npm ci && npm run buildNo bot yet? docs/INSTALLATION.md covers creating the application, the intents, the exact permission list, and the invite URL.
Run it 24/7 as a bot
npm run bot # build, then start the botThe bot keeps one Discord connection and runs every server feature from it: welcome messages, autoroles, levels, logging, moderation, tickets, giveaways, starboard, temporary voice channels, an autoresponder and slash commands.
Add the HTTP plane to expose MCP remotely:
MCP_HTTP_ENABLED=true MCP_HTTP_TOKEN=$(openssl rand -hex 32) npm run bot:startThat exposes /health (no auth), /status and /mcp (bearer token).
Guides: docs/BOT_FEATURES.md for the features and docs/BOT.md for deployment — systemd, Docker, reverse proxy, troubleshooting.
The HTTP plane binds to 127.0.0.1 and stays off unless asked for. It holds the
bot token and the destructive tool surface, so an unauthenticated port would be
remote administration of the server; MCP_HTTP_ENABLED=true without
MCP_HTTP_TOKEN is refused at startup rather than left open.
Once connected, ask it to run discord_verify_setup — it takes no arguments and
tells you whether the token, the intents, the toolsets and the connection are all
in order.
What it can do
Server administration
Full server-level settings, which the baseline did not cover: rename the server, change its icon and banner, set the description, splash, verification level, explicit content filter, notification defaults, locale, AFK channel and timeout, system/rules/public-updates/safety-alerts channels, the system channel notice flags, the premium progress bar, Community, the widget, the welcome screen and onboarding.
Each tool reports what Discord actually returned, and states the limits: a banner needs boost level 2, a description needs a discoverable or Community server, Community needs a rules channel and a public-updates channel.
Bot profile, audited separately
Four things that are easy to conflate, kept apart on purpose:
Field | Scope | Settable? |
Server name / icon | one server | yes, Manage Server |
Bot nickname | one server | yes |
Bot global username / avatar | all servers | yes |
Bot banner, global bio, accent colour | global | no — the bot API does not expose them |
discord_get_bot_profile_limits returns the changeable and non-changeable lists
with reasons, so "can you change my banner?" gets an answer from a documented
list rather than a guess.
Unicode name styling
Twelve decoration styles for categories, channels, roles, forums and announcement channels — minimalist, gaming, cyberpunk, futuristic, luxury, fantasy, anime, elegant, geometric, bordered, emoji-led and fullwidth.
✦・announcements
「📢」・news
╭・community・╮
💬︱general-chat
୨୧・suggestions・୨୧Deterministic (the same input always produces the same output, so re-running a theme converges), collision-checked, 100-character capped, and stripped of zero-width characters.
Stated plainly, in every one of these tool descriptions: Discord has no per-server font setting and no API for one. This decorates text with Unicode characters. It is not a font engine.
Server architect
Describe the server you want and the architect turns it into an ordered plan, diffs it against what exists, and creates only what is missing. It is idempotent and resumable: a run that fails halfway can be repaired by re-running, because every step has a stable key and failures come back with their index.
Ordering is fixed — roles, then categories, then channels — because channel permission overwrites reference role IDs that must already exist.
A bot cannot create a new Discord server. That needs a user OAuth2 token.
discord_architect_explain_limits says so and gives the workflow that does work:
create the server yourself, invite the bot, then apply the plan.
Safety
Every added mutating tool previews by default. confirm: true applies. Bulk
deletion additionally requires the literal string CONFIRM DELETE, enforced by
the tool's JSON Schema so a model sees the requirement in tools/list before it
calls.
Also included: permission preflight with readable errors, role-hierarchy checks,
DISCORD_ALLOWED_GUILDS scoping, duplicate-plan suppression, paced bulk loops,
and an audit trail readable through discord_read_audit_trail.
Honest limits are documented rather than glossed: the audit trail is in-process and capped at 500 entries; a structure backup does not contain messages; deleted entities are not recoverable.
Details: docs/SECURITY.md.
Configuration
Add to claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"discord": {
"command": "node",
"args": ["/absolute/path/to/discord-mcp-ultimate/dist/index.js"],
"env": {
"DISCORD_TOKEN": "YOUR_BOT_TOKEN_HERE",
"DISCORD_GUILD_MEMBERS": "true",
"DISCORD_MESSAGE_CONTENT": "true"
}
}
}
}Restart Claude Desktop after saving.
claude mcp add discord -- node /absolute/path/to/discord-mcp-ultimate/dist/index.jsSet DISCORD_TOKEN in the environment Claude Code runs in.
~/.cursor/mcp.json, same shape as the Claude Desktop config.
.vscode/mcp.json:
{
"inputs": [
{
"type": "promptString",
"id": "discord-token",
"description": "Discord Bot Token",
"password": true
}
],
"servers": {
"discord": {
"type": "stdio",
"command": "node",
"args": ["/absolute/path/to/discord-mcp-ultimate/dist/index.js"],
"env": { "DISCORD_TOKEN": "${input:discord-token}" }
}
}
}docker build -t discord-mcp-ultimate .
docker run --rm -i -e DISCORD_TOKEN discord-mcp-ultimate-e DISCORD_TOKEN with no value passes it through from your environment, so the
token never lands in a config file.
Environment variables
Variable | Default | Purpose |
| (required) | Bot token. Never commit it. |
|
| Request the Server Members intent. Set |
|
| Request the Message Content intent. Set |
| (unset) | Comma-separated guild IDs. When set, calls outside the list are rejected at parse time. |
| (unset) | Comma-separated toolset names to expose. Unset or |
See .env.example.
Toolset names: discovery, messages, channels, permissions, members,
roles, moderation, screening, stats, forums, webhooks,
scheduled_events, invites, dm, guild_settings, bot_profile, style,
architect, automod, expressions, backup, diagnostics, scheduler.
Narrowing the toolset is the most effective way to make a model more reliable. Fewer tools means less to choose between.
Examples
Show me every server the bot is in, with member counts.
Rename the server to Watchtower Community.
Update the server icon with this image: https://example.com/icon.png
Read the full settings of server 123456789012345678.
Generate 5 stylized variants for a channel called "announcements".
Apply a futuristic theme to all channel names, but show me the preview first.
Plan a community server for Watchtower with a welcome area, rules, release
announcements, technical support, general discussion, developer roles and two
voice channels. Use a sober futuristic theme.
Compare that plan against the server and create only the missing pieces.
Check which permissions the bot is missing and tell me which tools are affected.
Diagnose why creating a channel in the announcements category fails.
Back up the roles, categories and permissions, then diff it against the server.
Show me a preview before deleting these channels: 111..., 222...Destructive requests return a preview first, with the exact plan and no change applied. Applying requires a second call with an explicit confirmation.
En français
Discord MCP Ultimate est un serveur MCP pour Discord, avec 177 outils, un bot 24h/24 et un tableau de bord web, pilotable en langage naturel depuis Claude Desktop, Claude Code, Cursor, VS Code Copilot ou tout client compatible MCP.
C'est un fork de PaSympa/discord-mcp version 2.2.0 (licence MIT). Les 99 outils d'origine sont conservés à l'identique. Ce fork en ajoute 78, pour un total de 177.
Ce qui a été ajouté
Domaine | Outils | Ce que ça permet |
Paramètres du serveur | 24 | Nom, icône, bannière, description, niveau de vérification, filtrage de contenu, salon AFK, Community, widget, écran d'accueil, onboarding |
Profil du bot | 8 | Pseudonyme par serveur, avatar global, avatar par serveur, nom global, et l'audit de ce qui n'est pas modifiable |
Styles Unicode | 4 | 12 styles décoratifs pour catégories, salons, rôles et forums, avec aperçu et cohérence de nomenclature |
Architecte de serveur | 10 | Plan détaillé, comparaison avec l'existant, création, réparation, modèles, suppression |
AutoMod | 6 | Règles de modération automatique et jeu de règles de départ |
Emojis et stickers | 8 | Création, modification, suppression |
Sauvegarde et restauration | 3 | Export de la structure, comparaison, restauration additive |
Diagnostic | 6 | Vérification de l'installation, permissions manquantes, journal d'audit |
Planification | 4 | Messages programmés, annonces structurées |
Rôles par réaction | 3 | Menus d'auto-attribution : l'IA crée le menu, le bot distribue les rôles |
Le dépôt contient aussi un bot complet et un tableau de bord web, qui ne sont pas des outils MCP mais des processus : voir la section suivante.
Le bot 24h/24
npm run bot démarre un processus qui garde une seule connexion Discord et
fait tourner tout le serveur : accueil, rôles automatiques, niveaux, journaux,
modération avec dossiers numérotés, tickets, concours, starboard, salons vocaux
temporaires, répondeur, commandes slash, rôles par réaction et MCP en HTTP.
npm run bot # construit puis démarreLe MCP est alors joignable sur /mcp, avec un jeton Bearer obligatoire.
/health répond sans authentification pour une sonde de supervision. Le port
n'est pas ouvert par défaut : MCP_HTTP_ENABLED=true et MCP_HTTP_TOKEN
sont tous les deux requis, sinon le processus refuse de démarrer.
Un menu de rôles créé par l'IA est pris en compte par le bot en moins de deux secondes, sans redémarrage : les deux processus se rejoignent sur un fichier JSON que le bot surveille. Il en va de même pour toute la configuration.
Commandes disponibles (25) : /ping, /rank, /leaderboard, /serverinfo,
/userinfo, /avatar, /poll, /remind, /afk, /afk-list, /permissions,
puis la modération — /warn, /ban, /kick, /timeout, /untimeout, /note,
/cases, /purge, /slowmode, /lock, /unlock — puis /giveaway,
/ticket-panel et /config.
Chaque action de modération écrit un cas numéroté avant d'appeler Discord : la trace existe même si l'appel échoue ensuite. La hiérarchie est vérifiée avant l'appel, donc l'erreur dit la vraie raison (la cible est au-dessus du bot) au lieu d'un « permissions manquantes » trompeur.
Configuration
Tout se règle depuis Discord, avec /config : aucun service supplémentaire, aucun
tableau de bord, aucune base de données. /config show affiche la configuration
complète (en fichier JSON), et /config set, /config channel, /config text,
/config number, /config role, /config import et /config reset la
modifient. Chaque valeur passe par le même schéma Zod que le bot lit, donc une
valeur refusée est rejetée au moment où vous la tapez. Voir
docs/BOT_FEATURES.md.
Guides complets : docs/BOT_FEATURES.md pour les fonctionnalités et docs/BOT.md pour le déploiement — systemd, Docker, reverse proxy, dépannage.
Points importants, énoncés franchement
Un bot ne peut pas créer un nouveau serveur Discord. L'API exige un jeton OAuth2 d'utilisateur. Créez le serveur vous-même, invitez le bot, puis laissez l'architecte construire la structure.
Discord n'a aucune police personnalisée. Le générateur de styles décore du texte avec des caractères Unicode. Ce n'est pas un moteur de polices, et les outils le disent.
La bannière, le splash et l'URL personnalisée sont réservés aux serveurs de niveau 2 de boost.
Une sauvegarde ne contient pas les messages. Discord n'expose pas d'export global.
Les suppressions sont irréversibles. Discord n'a pas d'annulation, et le serveur ne prétend pas le contraire.
Un serveur MCP en stdio n'a pas d'écouteur permanent. Entre deux appels d'outil, rien ne reçoit les événements Discord. C'est pour cela que les rôles par réaction passent par le bot : lui reste éveillé.
Le jeton Bearer circule en clair sur
http://. En local, sans importance. À distance, mettez un reverse proxy TLS devant.Deux processus avec le même jeton se disputent la session Discord. N'en lancez qu'un.
Sécurité
Tout outil qui modifie quelque chose fait un aperçu par défaut. Il faut
rappeler l'outil avec une confirmation explicite pour appliquer. Les suppressions
en masse exigent en plus la chaîne littérale CONFIRM DELETE, vérifiée par le
schéma JSON de l'outil — le modèle la voit donc dans tools/list avant d'appeler.
S'y ajoutent : la vérification des permissions avant chaque action, le contrôle
de la hiérarchie des rôles, la limitation à certains serveurs via
DISCORD_ALLOWED_GUILDS, la protection contre les boucles, et un journal
d'audit.
Détails complets : docs/SECURITY.md.
Installation
git clone https://github.com/ferelking242/discord-mcp-ultimate.git
cd discord-mcp-ultimate
npm ci && npm run buildPuis, dans la configuration de votre client MCP :
{
"mcpServers": {
"discord": {
"command": "node",
"args": ["/chemin/absolu/vers/discord-mcp-ultimate/dist/index.js"],
"env": { "DISCORD_TOKEN": "VOTRE_JETON_ICI" }
}
}
}Les intents, la liste exacte des permissions à cocher et l'URL d'invitation sont dans docs/INSTALLATION.md.
Exemples de demandes
Renomme le serveur en Watchtower Community.
Mets à jour son icône avec cette image : https://exemple.fr/icone.png
Lis tous les paramètres du serveur 123456789012345678.
Génère 5 variantes stylisées pour un salon nommé « annonces ».
Applique un thème futuriste à tous les noms de salons, mais montre-moi l'aperçu
avant.
Prépare un serveur communautaire pour Watchtower avec accueil, règles, annonces
de versions, support technique, discussions, rôles de développeurs et salons
vocaux. Utilise un thème futuriste sobre.
Compare ce plan au serveur et ne crée que ce qui manque.
Vérifie les permissions manquantes du bot et dis-moi quels outils sont touchés.
Montre-moi un aperçu avant de supprimer ces salons : 111..., 222...Tests
npm test282 tests, exécutés sans jeton Discord et sans serveur réel, grâce à des mocks et
un transport MCP en mémoire. test/serverHandshake.test.ts effectue une vraie
poignée de main MCP et vérifie la liste d'outils annoncée.
Documentation
Document | Contents |
All 177 tools: parameters, permissions checked, hints, output schemas, and the Discord limitations that apply | |
The 78 added tools, module by module, with the design decisions | |
Every bot feature: welcome, autoroles, levels, logging, moderation, tickets, giveaways, starboard, voice, autoresponder | |
The open-source bots studied while designing the bot layer | |
Bot creation, intents, the full permission list, every client config, verification | |
Credential handling, preview/confirm gates, permission preflight, prompt-injection boundaries | |
Version history |
Limitations
Discord platform limits, stated rather than hidden. Each is also in the description of the tool it affects.
A bot cannot create a new server. Requires a user OAuth2 token.
No custom fonts. Unicode decoration only; Discord has no font API.
Server banner, splash and vanity URL are gated behind boost level 2 and specific server features.
No message history in a backup. No bulk export endpoint exists.
Bulk delete cannot remove messages older than 14 days.
Bot banner, global bio and accent colour are not settable by a bot.
The audit trail is in-process, capped at 500 entries, lost on restart.
Deleted entities are gone. Discord has no undo.
Scheduled tasks live in the server process and do not survive a restart. Use an external scheduler for durable timing.
A bot cannot create a new server, so the bot configures servers you have already created and invited the bot to.
Giveaway draws are polled every 20 seconds, not scheduled, so a draw can happen up to 20 seconds after the deadline. That is deliberate: a timer would not survive a restart, and a giveaway that ends while the bot is down would never be drawn.
Configuration is Discord-only. The bot has no web panel; it is built for a self-hosted bot with one operator.
The bearer token crosses the network in clear over
http. Locally that is fine; expose the port only behind TLS.Logging cannot name the actor without View Audit Log. The event is still logged, just without the moderator's name.
Development
npm ci
npm run build # tsc
npm run lint # eslint
npm test # node:test, 282 tests
npm run format # prettierThe test suite runs entirely against mocks and in-memory MCP transports — no
Discord token and no live server are needed. test/serverHandshake.test.ts
performs a real MCP handshake and asserts the advertised tool list.
Credits and licence
MIT. See LICENSE.
This is a fork of PaSymPa/discord-mcp by Léandre Moreau. The 99 tools in the imported baseline are that project's work, preserved unchanged, including their original copyright notice — see NOTICE. The 78 added tools, the bot, the safety layer and the documentation are new in this fork.
docs/CREDITS.md records the other open-source bots studied while designing the bot layer, and states plainly that no code was copied from any of them.
Available Tools
177 toolsdiscord_add_reactionAIdempotent
Add a single emoji reaction to a message as the bot. Requires the Add Reactions and Read Message History permissions. Use discord_remove_reactions to undo. Idempotent: re-adding the bot's existing reaction has no effect.
Inputs: emoji (required), channel_id (required), message_id (required).
discord_add_roleAIdempotent
Assign an existing role to a member. Requires the Manage Roles permission, and the role must be below the bot's highest role. Idempotent: assigning a role the member already has has no effect. Use discord_remove_role to undo.
Inputs: role_id (required), user_id (required), guild_id (required), reason.
discord_apply_automod_baselineAIdempotent
Create a sensible baseline of AutoMod rules for a community server in one call: block Discord invite links, block common scam/phishing keywords, block mention spam, and time out repeat offenders. PREVIEWS BY DEFAULT: returns the rules that would be created without creating them; re-call with confirm:true to apply. Rules that already exist by name are skipped, so re-running is safe. Requires Manage Server and the AutoModeration feature (Community).
Inputs: guild_id (required), confirm, alert_channel_id. Returns: mode, failed, created, planned, +1 more
discord_apply_name_themeAIdempotent
Rename existing channels, categories and roles in a server to a Unicode-styled theme. PREVIEWS BY DEFAULT: returns the exact rename list without changing anything. Re-call with confirm:true to apply. Renames are applied one at a time and a failure on one entity does not stop the rest; per-entity results are returned. Requires Manage Channels (and Manage Roles for roles). This changes name text only: Discord cannot apply a custom font. Renaming a channel does not change its ID, so existing links keep working.
Inputs: theme (required), guild_id (required), confirm, include, +1 more. Returns: mode, error, applied, planned, +4 more
discord_architect_applyAIdempotent
Build a plan against the live server. PREVIEWS BY DEFAULT: returns the step list without changing anything; re-call with confirm:true to apply. Idempotent by name: a role, category or channel that already exists with the planned name is skipped rather than duplicated, so a re-run after a failure repairs the server instead of doubling it. Steps run in order (roles, then categories, then channels) and one failing step does not stop the rest: per-step results are returned so the build can be resumed. Requires Manage Channels and Manage Roles. A duplicate-suppression window rejects an identical plan re-submitted within 60 seconds. This creates structure inside an existing server; it cannot create a new Discord server (see discord_architect_explain_limits).
Inputs: plan (required), guild_id (required), reason, confirm. Returns: mode, failed, applied, created, +2 more
discord_architect_compareARead-only
Diff a plan against the live server: which roles, categories and channels are missing (would be created), which already exist, and which exist on the server but are absent from the plan (candidates for removal, never removed automatically). Read-only. Use this to answer 'what would change?' or to detect drift before repairing a half-finished build.
Inputs: plan (required), guild_id (required). Returns: summary, guild_id, to_create, only_on_server, +1 more
discord_architect_create_templateA
Create a Discord guild template from the current server, capturing its channels, roles and permissions as a shareable code. Requires Manage Server. IMPORTANT: the code can only be used to create a new guild by a human in the Discord client; a bot cannot apply a template to create a guild. Returns the template code and shareable URL.
Inputs: name (required), guild_id (required), description. Returns: url, code, name
discord_architect_delete_structureADestructive
Delete channels, categories and roles from a server, driven by a plan (everything in the plan is removed) or by explicit IDs. IRREVERSIBLE: deleted channels lose their message history permanently, and deleted roles are removed from every member. REQUIRES the literal confirmation string "CONFIRM DELETE"; without it the tool returns a preview and deletes nothing. Deletes are performed one at a time and per-entity failures are reported. Requires Manage Channels and Manage Roles.
Inputs: guild_id (required), role_ids, channel_ids, confirmation. Returns: mode, failed, applied, deleted_roles, +3 more
discord_architect_delete_templateADestructiveIdempotent
Delete a guild template by its code. Requires Manage Server. Not reversible: the template code stops working immediately for anyone who has it. Returns a confirmation.
Inputs: code (required), guild_id (required). Returns: deleted
discord_architect_explain_limitsARead-only
Explain what this server can and cannot do about creating Discord servers, with the API reason. Read-only. Use this when asked to 'create a new server': a bot token cannot create a guild. GET /users/@me/guilds and POST /guilds are restricted, so the documented path is: create the server manually (or from a template), invite the bot, then build the structure inside it with discord_architect_apply.
Inputs: no named parameters. Returns: can_do, cannot_do, recommended_workflow
discord_architect_list_templatesARead-only
List the guild templates this server has created, with their codes, sync status and update times. Read-only.
Inputs: guild_id (required). Returns: templates
discord_architect_planARead-only
Validate and normalise a server-structure plan without touching Discord. Takes a declarative plan (roles, categories, channels, permission intents) and returns the exact ordered steps that discord_architect_apply would execute, plus any problem in the plan (duplicate names, unknown role keys, unsupported field combinations). Read-only. This is the tool to call first for any 'build me a server' request: it is the cheapest way to show the user what would happen. The plan is declarative, not a script: re-applying it converges on the described state instead of duplicating entities.
Inputs: plan (required). Returns: steps, problems, step_count
discord_architect_read_structureARead-only
Read the live server structure in the same shape a plan uses: categories with their channels, uncategorised channels, and roles. Use this to see what exists before building, or to hand the result back to a model that will propose a plan. Read-only.
Inputs: guild_id (required). Returns: roles, guild_id, categories, guild_name, +1 more
discord_architect_repairAIdempotent
Resume an interrupted build: compares a plan against the live server and reports exactly which steps are still missing, then optionally applies just those. Use this after discord_architect_apply reports failures, or when a build was interrupted. PREVIEWS BY DEFAULT; confirm:true applies the missing steps only. Read-only when confirm is false.
Inputs: plan (required), guild_id (required), confirm. Returns: mode, failed, created, missing
discord_audit_permissionsARead-only
Generate a server-wide permission report: for every channel that has overwrites, lists each role/member and their allowed/denied permissions (entity names resolved). Read-only. Returns { channels: [...] } with channel, channelId, overwrites. Use discord_get_channel_permissions for a single channel.
Inputs: guild_id (required). Returns: channels
discord_ban_memberADestructiveIdempotent
Ban a user from the server, blocking re-entry until unbanned. Optionally bulk-deletes their recent messages. Requires the Ban Members permission, and the bot's top role must outrank the target's. Use discord_unban_member to reverse, or discord_kick_member for a non-permanent removal. The reason is recorded in the audit log.
Inputs: user_id (required), guild_id (required), reason, delete_message_days.
discord_bulk_banADestructive
Ban many users in a single call, intended for raid mitigation. SAFE BY DEFAULT: dry_run is true unless explicitly set to false, so call it first to preview the exact list of user IDs that would be banned, then re-call with dry_run:false to actually ban them. Requires both the Ban Members and Manage Server permissions. Returns counts of banned vs failed users; Discord rejects the whole call with an error if no user could be banned. Use discord_ban_member for a single ban with finer control.
Inputs: guild_id (required), user_ids (required), reason, dry_run, +1 more.
discord_bulk_delete_messagesADestructive
Permanently delete multiple recent messages in one call. IRREVERSIBLE. SAFE BY DEFAULT: dry_run is true unless explicitly set to false, so call it first to preview, then re-call with dry_run:false to actually delete. Discord only allows bulk-deleting messages younger than 14 days; older ones are skipped. Requires the Manage Messages permission. Returns the number deleted.
Inputs: count (required), channel_id (required), dry_run.
discord_cancel_scheduled_taskAIdempotent
Cancel a scheduled message by its task ID. The message will not be sent again. Returns whether the task existed. Only affects tasks created in this server process; a durable external scheduler is not reachable from here.
Inputs: task_id (required). Returns: task_id, cancelled
discord_check_tool_permissionsARead-only
Given a guild and a list of tool names, report for each whether the bot currently holds the permissions that tool needs, and whether the target channel is visible to it. Read-only. Use this before a multi-step operation to fail early with an actionable message instead of partway through.
Inputs: tools (required), guild_id (required), channel_id. Returns: results, summary, guild_id, channel_visible
discord_clone_channelA
Create a copy of a channel, including its name, topic, and permission overwrites (but not its messages). Requires the Manage Channels permission. Returns the cloned channel's name and ID.
Inputs: channel_id (required), new_name.
discord_compare_structureARead-only
Diff a structure backup against the live server and report what changed: channels and categories present in one but not the other, roles added or removed, and permission overwrites that differ. Read-only. Use this to answer 'what changed since the backup?' or to check drift before restoring.
Inputs: backup (required), guild_id (required). Returns: summary, roles_only_in_backup, roles_only_on_server, permission_differences, +4…
discord_copy_permissionsADestructiveIdempotent
Replace the target channel's permission overwrites with a copy of the source channel's. The target's existing overwrites are overwritten. Requires the Manage Roles permission. Returns a confirmation.
Inputs: source_channel_id (required), target_channel_id (required), reason.
discord_create_automod_ruleA
Create an AutoMod rule. Requires Manage Server (Discord gates AutoMod on it) and the server to have the AutoModeration feature, which arrives with Community. Trigger types: 'keyword' (keyword_filter + optional regex_patterns), 'keyword_preset' (Discord's built-in profanity/sexual_content/slurs lists), 'spam', 'mention_spam' (mention_total_limit), 'member_profile' (blocks suspicious profile text). Actions: block_message, send_alert_message (needs channel_id), timeout (needs duration_seconds), block_member_interaction. Returns the created rule.
Inputs: name (required), actions (required), guild_id (required), trigger_type (required), +11 more. Returns: id, name, actions, enabled, +11 more
discord_create_channelA
Create a text channel, voice channel, or category in a server. Requires the Manage Channels permission. For forum channels use discord_create_forum_channel instead. Returns the new channel's name and ID.
Inputs: name (required), guild_id (required), type, topic, +1 more.
discord_create_emojiA
Upload a new custom emoji to the server. The name must be 2–32 characters using only letters, digits and underscores (Discord's rule). Accepts an https URL, data: URI or base64 image: PNG, JPEG, GIF or WebP, up to 256 KB for emojis. Requires Manage Expressions. Discord also caps the total number of emojis by boost tier, and rejects the upload with a clear error once the cap is reached. Returns the created emoji.
Inputs: name (required), image (required), guild_id (required), reason, +1 more. Returns: id, url, name, managed, +4 more
discord_create_event_inviteA
Create a shareable invite URL that points to a scheduled event, so recipients land on the event when joining. Requires the Create Instant Invite permission. Returns the invite URL.
Inputs: event_id (required), guild_id (required), max_age, max_uses, +1 more.
discord_create_forum_channelA
Create a new forum channel in a server. A forum holds posts (threads) rather than a linear message feed. Requires the Manage Channels permission. Use discord_create_channel for text/voice channels instead. Returns the new channel's name and ID.
Inputs: name (required), guild_id (required), topic, category_id.
discord_create_forum_postA
Create a new post (a thread with a starter message) in a forum channel. Requires the Send Messages and Create Public Threads permissions. Use discord_reply_to_forum to add follow-up messages. Returns the new post's name and thread ID.
Inputs: title (required), content (required), forum_channel_id (required), applied_tags.
discord_create_inviteA
Create an invite link for a channel, optionally limiting its lifetime, uses, and membership type. SECURITY: anyone with the returned link can join the server. Requires the Create Instant Invite permission. Returns the invite URL and code.
Inputs: channel_id (required), unique, max_age, max_uses, +1 more.
discord_create_roleA
Create a new role in a server. Requires the Manage Roles permission; the new role is placed below the bot's highest role. Use discord_add_role to then assign it to members. Returns the new role's name and ID.
Inputs: name (required), guild_id (required), color, hoist, +2 more.
discord_create_scheduled_eventA
Create a scheduled event. For 'VOICE'/'STAGE_INSTANCE' events provide channel_id; for 'EXTERNAL' events provide location AND scheduled_end_time. Requires the Manage Events permission. Returns the new event's name and ID.
Inputs: name (required), guild_id (required), entity_type (required), scheduled_start_time (required), +5 more.
discord_create_stickerA
Upload a custom sticker to the server. Discord accepts PNG, APNG and Lottie (JSON) stickers here; GIF stickers are not accepted at upload. The name is 2–30 characters and the tags string is a comma-separated list used for search. Requires Manage Expressions, and Discord caps the sticker count by boost tier. Returns the created sticker.
Inputs: name (required), tags (required), image (required), guild_id (required), +2 more. Returns: id, url, name, tags, +3 more
discord_create_threadA
Create a thread, either branching from an existing message (pass message_id) or as a standalone thread in a text channel (omit message_id). Standalone creation requires a parent text channel and fails if channel_id is itself a thread. Requires the Create Public Threads permission. Returns the new thread's ID.
Inputs: name (required), channel_id (required), message_id, auto_archive_duration.
discord_create_webhookA
Create a webhook on a channel and return its ID and token. SECURITY: the returned token grants anyone the ability to post as this webhook without authentication; treat it as a secret. Requires the Manage Webhooks permission. Use the returned id+token with discord_send_webhook_message.
Inputs: name (required), channel_id (required), avatar.
discord_crosspost_messageAIdempotent
Publish (crosspost) a message from an Announcement channel to every server that follows it. Only works in announcement channels on a message that has not already been published. Requires the Send Messages permission (and Manage Messages for messages authored by others). Returns a confirmation.
Inputs: channel_id (required), message_id (required).
discord_delete_automod_ruleADestructive
Delete an AutoMod rule. IRREVERSIBLE: the rule and its configuration are gone. Requires Manage Server. There is no preview: deleting an AutoMod rule cannot lose member data, and Discord does not offer an undo, so the tool reports exactly which rule was removed.
Inputs: rule_id (required), guild_id (required), reason. Returns: name, deleted
discord_delete_channelADestructive
Permanently delete a channel and all of its messages. IRREVERSIBLE. SAFE BY DEFAULT: dry_run is true unless explicitly set to false, so call it first to preview, then re-call with dry_run:false to actually delete. Requires the Manage Channels permission. An optional reason is recorded in the audit log.
Inputs: channel_id (required), reason, dry_run.
discord_delete_dmADestructive
Permanently delete a DM message previously sent by this bot. IRREVERSIBLE. The bot can only delete its own DM messages, not the recipient's. Returns a confirmation.
Inputs: user_id (required), message_id (required).
discord_delete_emojiADestructive
Delete a custom emoji. IRREVERSIBLE: the image is gone and every message that used :name: shows as an unknown emoji from then on. Requires Manage Expressions. Managed emojis (created by an integration) cannot be deleted by a bot and Discord will reject the call. Returns the deleted emoji's name.
Inputs: emoji_id (required), guild_id (required), reason. Returns: name, deleted
discord_delete_forum_postADestructive
Permanently delete a forum post (thread) and all its messages. IRREVERSIBLE. To merely close it without deleting, use discord_update_forum_post with archived:true. Requires the Manage Threads permission.
Inputs: thread_id (required).
discord_delete_inviteADestructive
Revoke an invite by its code so it can no longer be used. IRREVERSIBLE (the code is freed). Requires the Manage Channels permission (or Manage Server). The reason is recorded in the audit log.
Inputs: invite_code (required), reason.
discord_delete_messageADestructive
Permanently delete one specific message. IRREVERSIBLE. The bot can always delete its own messages; deleting another user's message requires the Manage Messages permission. Use discord_bulk_delete_messages to remove many at once. An optional reason is recorded in the audit log.
Inputs: channel_id (required), message_id (required), reason.
discord_delete_roleADestructive
Permanently delete a role from the server; it is automatically removed from every member who held it. IRREVERSIBLE. Requires the Manage Roles permission, and the role must be below the bot's highest role.
Inputs: role_id (required), guild_id (required), reason.
discord_delete_scheduled_eventADestructive
Permanently delete a scheduled event. IRREVERSIBLE. To cancel an event while keeping a record, use discord_edit_scheduled_event with status:'CANCELED' instead. Requires the Manage Events permission.
Inputs: event_id (required), guild_id (required).
discord_delete_stickerADestructive
Delete a custom sticker from the server. IRREVERSIBLE: the artwork is gone and messages that used it lose the image. Requires Manage Expressions. Standard (Discord-provided) stickers cannot be deleted; this tool only removes guild stickers. Returns the deleted sticker's name.
Inputs: guild_id (required), sticker_id (required), reason. Returns: name, deleted
discord_delete_webhookADestructive
Permanently delete a webhook by its ID, invalidating its token. IRREVERSIBLE: any integrations using the old token will stop working. Requires the Manage Webhooks permission.
Inputs: webhook_id (required).
discord_delete_webhook_messageADestructive
Permanently delete a message that was sent through a webhook, using the webhook's ID and token. IRREVERSIBLE. Requires the original webhook token.
Inputs: message_id (required), webhook_id (required), webhook_token (required).
discord_diagnose_configurationARead-only
Diagnose the server's configuration end to end: the bot's permission baseline, Community prerequisites, the AFK/system/rules channel slots, per-channel bot visibility, role hierarchy, AutoMod presence, intents, and the env flags in effect. Each finding carries a concrete fix. Read-only. Run this first when something behaves unexpectedly.
Inputs: guild_id (required). Returns: healthy, findings, guild_id, checks_run, +1 more
discord_edit_automod_ruleAIdempotent
Update an AutoMod rule: rename it, enable or disable it, replace its trigger metadata or actions, or change its exemptions. Only provided fields change; trigger_type cannot be changed after creation (Discord does not allow it), so delete and recreate to switch trigger type. Requires Manage Server. Returns the updated rule.
Inputs: rule_id (required), guild_id (required), name, reason, +10 more. Returns: id, name, actions, enabled, +11 more
discord_edit_channelAIdempotent
Update a channel's name, topic, slowmode, or NSFW flag. Only provided fields change; topic and slowmode apply to text channels only. Requires the Manage Channels permission. Returns a confirmation.
Inputs: channel_id (required), name, nsfw, topic, +1 more.
discord_edit_dmAIdempotent
Edit the text content of a DM message previously sent by this bot. Only the bot's own DM messages can be edited. Use discord_edit_dm_embed for embed messages. Returns a confirmation.
Inputs: content (required), user_id (required), message_id (required).
discord_edit_dm_embedAIdempotent
Replace the embed on a DM message previously sent by this bot. Only the bot's own messages can be edited. Full replace, not merge: provided fields are applied and omitted fields are dropped. Returns a confirmation.
Inputs: user_id (required), message_id (required), url, color, +9 more.
discord_edit_embedAIdempotent
Replace the embed on a message previously sent by this bot. Only this bot's messages can be edited. This is a full replace, not a merge: provided fields are applied and omitted fields are dropped from the embed. Returns a confirmation.
Inputs: channel_id (required), message_id (required), url, color, +8 more.
discord_edit_emojiAIdempotent
Rename a custom emoji or change which roles may use it. Only provided fields change. Requires Manage Expressions. Passing role_ids replaces the whole restriction list; pass an empty array to open the emoji to everyone. Returns the updated emoji.
Inputs: emoji_id (required), guild_id (required), name, reason, +1 more. Returns: id, url, name, managed, +4 more
discord_edit_messageAIdempotent
Edit the text content of a message previously sent by this bot. Discord forbids editing other users' messages, so this fails for non-bot messages. Use discord_edit_embed for embed messages. Works in text channels and threads. Returns the edited message ID.
Inputs: content (required), channel_id (required), message_id (required).
discord_edit_roleAIdempotent
Update an existing role's name, color, permissions, hoist, or mentionable flag. Only provided fields change; passing permissions REPLACES the role's full permission set. Requires the Manage Roles permission, and the role must be below the bot's highest role.
Inputs: role_id (required), guild_id (required), name, color, +3 more.
discord_edit_scheduled_eventAIdempotent
Update a scheduled event; only provided fields change. Use the status field to start ('ACTIVE'), end ('COMPLETED'), or cancel ('CANCELED') an event; Discord only allows certain status transitions. Requires the Manage Events permission.
Inputs: event_id (required), guild_id (required), name, image, +6 more.
discord_edit_stickerAIdempotent
Update a custom sticker's name, description or tags. Only provided fields change. Requires Manage Expressions. The image itself cannot be changed: Discord has no endpoint for it, so delete and re-upload to replace the artwork. Returns the updated sticker.
Inputs: guild_id (required), sticker_id (required), name, tags, +2 more. Returns: id, url, name, tags, +3 more
discord_edit_webhookAIdempotent
Update a webhook's name, avatar, or the channel it posts to. Only provided fields change. Requires the Manage Webhooks permission. Returns a confirmation.
Inputs: webhook_id (required), name, avatar, channel_id.
discord_edit_webhook_messageAIdempotent
Edit a message previously sent through a webhook, using the webhook's ID and token. Replaces the provided fields. Requires the original webhook token. Returns a confirmation.
Inputs: message_id (required), webhook_id (required), webhook_token (required), embeds, +1 more.
discord_enable_communityAIdempotent
Turn the Community feature on or off for the server. COMMUNITY is the prerequisite for rules and public-updates channels, membership screening, the welcome screen, onboarding and AutoMod. LIMITATION: Discord requires the server to already have a rules channel and a public-updates channel before Community can be enabled, so create those first (discord_create_channel, then discord_set_guild_channels). Requires Manage Server. Returns the resulting feature list.
Inputs: enabled (required), guild_id (required), reason, rules_channel_id, +1 more. Returns: id, features, community_enabled, missing_prerequisites, +1 more
discord_explain_permissionsARead-only
Explain a member's effective permissions in a channel, using Discord's own resolution (base role permissions, then category and channel overwrites, in Discord's order). Reports the resulting allow set, which flags came from overwrites, and any permission that is denied. Read-only. This is the tool to use when someone 'cannot see' or 'cannot post' and the cause is not obvious.
Inputs: user_id (required), guild_id (required), channel_id. Returns: notes, granted, user_id, guild_id, +4 more
discord_export_structureARead-only
Export the server's structure as a portable JSON backup: every category and channel with its type, position, topic, slowmode and permission overwrites, plus every role with its permissions. LIMITATION, stated plainly: this backs up structure and permissions, NOT messages. Discord's API cannot enumerate a channel's full history in one call, and this server does not pretend otherwise. The output is a plain JSON document the caller can store; nothing is written to disk by the server. Requires no special permission beyond being able to read the guild. Read-only.
Inputs: guild_id (required). Returns: backup, summary
discord_fetch_pinned_messagesARead-only
List all pinned messages in a channel. Returns { messages: [...] } with id, author, content, timestamp, pinnedAt. Read-only. Use discord_pin_message to change which messages are pinned.
Inputs: channel_id (required). Returns: messages
discord_fetch_webhook_messageARead-only
Fetch a single message sent through a webhook (id, content, embed count, timestamp), using the webhook's ID and token. Read-only. Requires the original webhook token.
Inputs: message_id (required), webhook_id (required), webhook_token (required). Returns: id, embeds, content, timestamp
discord_find_channel_by_nameARead-only
Find channels whose name contains a substring (case-insensitive). Returns matching channels (id, name, type) as a JSON array. Read-only. Useful for resolving a channel_id when you only know the channel's name.
Inputs: name (required), guild_id (required). Returns: matches
discord_find_permission_problemsARead-only
Scan a server for permission problems and return each with a fix: channels the bot cannot see, channels where @everyone was denied ViewChannel but the bot has no compensating allow (a classic lockout), overwrites that deny Send Messages to @everyone in channels that look public, roles with Administrator that are not the bot's own, and members whose highest role is above the bot's. Read-only.
Inputs: guild_id (required). Returns: ok, guild_id, problems
discord_follow_announcement_channelA
Subscribe a target channel to an announcement (news) channel, so the source's published messages are reposted into the target. The source must be an announcement channel. Requires the Manage Webhooks permission in the target. Returns a confirmation.
Inputs: source_channel_id (required), target_channel_id (required).
discord_forward_messageA
Forward an existing message to another channel using Discord's native forward, which preserves the original attribution. Works across text channels and threads. Use discord_send_message to compose new content instead. Requires the Send Messages permission in the target channel. Returns a confirmation.
Inputs: channel_id (required), message_id (required), target_channel_id (required).
discord_get_audit_logARead-only
Fetch the server's audit log, the record of administrative actions (bans, kicks, role/channel changes, etc.) with who performed them and when. Requires the View Audit Log permission. Returns { entries: [...] } with id, action, executor, target, reason, createdAt. Read-only.
Inputs: guild_id (required), limit, action_type. Returns: entries
discord_get_automod_ruleARead-only
Fetch one AutoMod rule by ID with its full trigger configuration and actions. Requires Manage Server. Read-only.
Inputs: rule_id (required), guild_id (required). Returns: id, name, actions, enabled, +11 more
discord_get_bot_identityARead-only
Report the bot's own identity, distinguishing the things that are commonly confused: its global username and avatar (which apply in every server), its per-server nickname and per-server avatar in this guild, and the owning application's name and ID. Read-only. Use this before changing anything so you know which of the four you actually mean.
Inputs: guild_id (required). Returns: notes, guild_id, guild_name, bot_user_id, +11 more
discord_get_bot_permissionsARead-only
Report what this bot can and cannot do in a server: its server-wide permissions, its role position versus the server owner, and whether it holds each permission the other tools in this server depend on. Read-only. Call this when a tool fails with 'Missing permissions' to find out which permission to grant.
Inputs: guild_id (required). Returns: bot_id, guild_id, is_owner, guild_name, +4 more
discord_get_bot_profile_limitsARead-only
Explain, from the live client state, exactly which parts of the bot's profile this server can and cannot change, and why. Read-only. Use this when asked to change the bot's banner, its 'about me', or anything else Discord does not expose to bot accounts: the answer is a documented limitation, not a missing tool.
Inputs: no named parameters. Returns: changeable, not_changeable
discord_get_channel_permissionsARead-only
List every permission overwrite on a channel, per role and per member, with the allowed and denied permission flags for each. Read-only. Use discord_audit_permissions for a server-wide report across all channels.
Inputs: channel_id (required). Returns: overwrites
discord_get_event_subscribersARead-only
List the users who marked themselves 'Interested' in a scheduled event. Returns { subscribers: [...], nextCursor }. A page holds up to 100 users; if nextCursor is non-null, pass it back as after to fetch the next page. Read-only.
Inputs: event_id (required), guild_id (required), after, limit. Returns: nextCursor, subscribers
discord_get_forum_channelsARead-only
List the forum channels in a server (id, name, topic, parent category). Read-only. Use discord_get_forum_tags to see a forum's available tags, or discord_list_forum_threads for its posts.
Inputs: guild_id (required). Returns: channels
discord_get_forum_postARead-only
Get a forum post's details (title, archived/locked state, applied tags, message count) plus its recent messages, oldest-to-newest. Read-only. Pass the post's thread_id. Returns a JSON object.
Inputs: thread_id (required), limit. Returns: id, name, locked, archived, +4 more
discord_get_forum_tagsARead-only
List the tags available on a forum channel (id, name, emoji, moderated flag). Read-only. Use these IDs with discord_create_forum_post or discord_update_forum_post; manage the tag set with discord_set_forum_tags.
Inputs: forum_channel_id (required). Returns: tags
discord_get_guild_featuresARead-only
List the server's feature flags with a plain-language explanation of the ones that gate this server's tools (COMMUNITY, DISCOVERABLE, BANNER, INVITE_SPLASH, VANITY_URL, ANIMATED_ICON, ANIMATED_BANNER, ROLE_ICONS, NEWS, FORUM_CHANNEL_ENABLED, MEMBER_VERIFICATION_GATE_ENABLED, AUTO_MODERATION) and which are currently active. Also reports which settings are therefore editable. Read-only. Use this before attempting a setting that may be feature-gated.
Inputs: guild_id (required). Returns: id, features, capabilities
discord_get_guild_infoARead-only
Get details about one server: name, description, member/channel/role counts, boost tier, owner, and creation date. Read-only. Use discord_get_server_stats for a finer breakdown (humans vs bots, channel types).
Inputs: guild_id (required). Returns: id, name, owner, createdAt, +6 more
discord_get_guild_previewARead-only
Fetch the public preview of a server: approximate member and online counts, description, icon, splash, emojis, stickers and features. Works without being a member, but Discord only serves a rich preview for servers that are discoverable or have Community enabled. Read-only.
Inputs: guild_id (required). Returns: id, icon, name, splash, +6 more
discord_get_guild_settingsARead-only
Read every server-level setting in one call: name, description, icon/banner/splash URLs, owner, preferred locale, verification level, explicit content filter, default notification level, MFA requirement, NSFW level, boost tier, system/rules/public-updates/safety-alerts/AFK channel slots, AFK timeout, the full feature list, whether Community is enabled, and the vanity URL code. Read-only. Use this before any change so you know the current values, and use the targeted discord_set_* tools to change them.
Inputs: guild_id (required). Returns: id, icon, name, banner, +24 more
discord_get_guild_vanity_urlARead-only
Read the server's vanity invite URL, the custom discord.gg link. Requires the VANITY_URL feature. Read-only. Use discord_get_guild_features to check whether the feature is active first.
Inputs: guild_id (required). Returns: url, code
discord_get_guild_widgetARead-only
Read the server's widget settings and, when the widget is enabled, the public widget.json and widget image URLs. The JSON endpoint is readable by anyone who has the URL, so this tool reports exactly what it exposes. Read-only.
Inputs: guild_id (required). Returns: enabled, channel_id, widget_json_url, widget_image_url
discord_get_inviteARead-only
Look up a single invite by its code: target server and channel, inviter, and expiry. Works for any public invite, but this endpoint never returns usage counters (uses/max_uses/max_age read 0); use discord_list_invites or discord_list_channel_invites for real counters. Read-only. Returns a JSON object.
Inputs: invite_code (required). Returns: url, code, uses, inviter, +9 more
discord_get_member_infoARead-only
Get full details for one server member: roles, effective permissions, account/join dates, bot flag, and current timeout status. Read-only. Returns a JSON object.
Inputs: user_id (required), guild_id (required). Returns: id, bot, roles, joinedAt, +5 more
discord_get_membership_screeningARead-only
Fetch the server's membership screening form, the rules/questions new members must accept before gaining access. Requires the server to have the Community feature enabled. Read-only. Returns the form as JSON, including its version.
Inputs: guild_id (required). Returns: version, description, form_fields
discord_get_message_attachmentsARead-only
List the file attachments of a message. Returns { attachments: [...] } with id, filename, title (the original name when Discord strips non-ASCII from filename), url, proxyUrl, contentType, size in bytes, width, height, alt-text description, voice-message duration and waveform, spoiler flag. Discord signs CDN urls with a 24-hour expiry and does not re-sign on every fetch; re-call this tool if a stored url has expired. Requires the View Channel and Read Message History permissions. Read-only. Use discord_read_messages to find messages with attachments.
Inputs: channel_id (required), message_id (required). Returns: attachments
discord_get_onboardingARead-only
Read the server's onboarding configuration: whether it is enabled, its mode (default or advanced), the default channels new members land in, and every onboarding prompt with its options, each option's channels and roles. Requires the COMMUNITY feature. Read-only. Use discord_set_onboarding to change it.
Inputs: guild_id (required). Returns: mode, enabled, prompts, default_channel_ids
discord_get_reactionsARead-only
List the users who reacted to a message with a specific emoji. Returns { reactions: [...] } with id, username, bot flag. Read-only.
Inputs: emoji (required), channel_id (required), message_id (required), limit. Returns: reactions
discord_get_role_membersARead-only
List members who currently hold a specific role, scanning up to 20,000 members. Returns { members: [...], truncated }; check truncated on very large servers. Read-only. Use discord_list_roles to discover role IDs first.
Inputs: role_id (required), guild_id (required). Returns: note, members, truncated
discord_get_scheduled_eventARead-only
Get full details for one scheduled event: name, description, status, type, channel/location, start/end times, creator, and interested-user count. Read-only. Returns a JSON object.
Inputs: event_id (required), guild_id (required). Returns: id, name, image, status, +8 more
discord_get_server_statsARead-only
Get a snapshot of server metrics: total members (humans vs cached bots), channel breakdown (text/voice/category), role count, boost tier and count, and creation date. Read-only. Returns a JSON object. Note: bots are counted from the member cache only, so botsInCache is a lower bound and humans (total minus cached bots) an upper bound.
Inputs: guild_id (required). Returns: name, roles, humans, channels, +5 more
discord_get_welcome_screenARead-only
Read the server's welcome screen: whether it is enabled, its description, and the channels it recommends with their emoji and descriptions. Requires the COMMUNITY feature. Read-only. Use discord_set_welcome_screen to change it.
Inputs: guild_id (required). Returns: enabled, description, welcome_channels
discord_kick_memberADestructive
Remove a member from the server. They can rejoin with a new invite (unlike a ban). Requires the Kick Members permission, and the bot's top role must be higher than the target's. Use discord_ban_member to block re-entry. The reason is recorded in the audit log.
Inputs: user_id (required), guild_id (required), reason.
discord_list_automod_rulesARead-only
List every AutoMod rule in a server: its name, enabled state, trigger type and event type, the keyword/regex/preset lists, the allow list, mention limits, exempt roles and channels, and the configured actions. Requires the Manage Server permission (Discord gates the AutoMod endpoints on it). Read-only. Use discord_get_automod_rule for one rule.
Inputs: guild_id (required). Returns: rules
discord_list_bansARead-only
List the users banned from the server, with their ban reasons. Returns { bans: [...], nextCursor }. A page holds up to 1000 bans; if nextCursor is non-null, pass it back as after to fetch the next page. Requires the Ban Members permission. Read-only.
Inputs: guild_id (required), after, limit. Returns: bans, nextCursor
discord_list_channel_invitesARead-only
List the active invites that point to one specific channel. Unlike discord_list_invites (server-wide), this scopes results to a single channel. Requires the Manage Channels permission. Read-only.
Inputs: channel_id (required). Returns: invites
discord_list_channelsARead-only
List all channels in a server, grouped by their parent category and ordered by position. Returns a JSON object keyed by category name. Read-only. Use discord_find_channel_by_name to locate a specific channel.
Inputs: guild_id (required). Returns: object
discord_list_emojisARead-only
List every custom emoji in a server with its ID, name, whether it is animated, its image URL, and the roles it is restricted to (empty means usable by everyone). Read-only.
Inputs: guild_id (required). Returns: emojis
discord_list_forum_threadsARead-only
List posts in a forum channel. Returns { threads: [...], hasMore, nextBefore }. The first call (no before) includes all active posts plus the first page of archived posts; archived posts are paginated, so if hasMore is true pass nextBefore back as before to fetch older archived posts. Read-only. Use discord_get_forum_post to read one post's messages.
Inputs: forum_channel_id (required), limit, before. Returns: hasMore, threads, nextBefore
discord_list_guildsARead-only
List every Discord server (guild) the bot is a member of (id, name, member count, icon). Takes no arguments. Read-only. Start here to discover the guild_id needed by most other tools.
Inputs: no named parameters. Returns: guilds
discord_list_invitesARead-only
List all active invites across a server (code, url, channel, inviter, uses, expiry). Requires the Manage Server permission. Read-only. Use discord_list_channel_invites to scope to one channel.
Inputs: guild_id (required). Returns: invites
discord_list_membersARead-only
List members of a server with their roles, ordered by user ID. Returns { members: [...], nextCursor }. A page holds up to 1000 members; if nextCursor is non-null, pass it back as after to fetch the next page. Use discord_search_members to find specific members by name, or discord_get_member_info for one member's full details. Read-only.
Inputs: guild_id (required), after, limit. Returns: members, nextCursor
discord_list_name_stylesARead-only
List the available Unicode name styles (minimal, gaming, cyberpunk, futuristic, luxury, fantasy, anime, elegant, geometric, bordered, emoji_lead, fullwidth) with a description of each. Read-only, no arguments. Note: these styles decorate text with Unicode characters; Discord does not support applying a custom font to channel, category or role names. Use discord_style_name to preview the result for a specific name.
Inputs: no named parameters. Returns: styles
discord_list_rolesARead-only
List all roles in a server (excluding @everyone), highest-first, with color, position, member count, and permissions. Read-only. Returns { roles: [...] }. Use discord_get_role_members to see who holds a given role.
Inputs: guild_id (required). Returns: roles
discord_list_scheduled_eventsARead-only
List all scheduled events in a server (id, name, status, type, time, location, interested count). Read-only. Use discord_get_scheduled_event for one event's full details.
Inputs: guild_id (required). Returns: events
discord_list_scheduled_tasksARead-only
List the messages currently scheduled in this MCP server process, with their channel, next run time, run count and last error. Read-only. Because these timers are in-process, the list is empty after a restart.
Inputs: no named parameters. Returns: note, tasks
discord_list_stickersARead-only
List the server's custom stickers with their ID, name, description, tags, format and image URL. Read-only.
Inputs: guild_id (required). Returns: stickers
discord_list_webhooksARead-only
List the webhooks in a single channel or across a whole server (id, name, channel, token when visible, creator). Provide exactly one of channel_id or guild_id. Requires the Manage Webhooks permission. Read-only.
Inputs: guild_id, channel_id. Returns: webhooks
discord_lock_channel_permissionsAIdempotent
Reset a channel's permission overwrites to exactly match its parent category (Discord's 'sync permissions'). The channel must be inside a category. Requires the Manage Roles permission. Returns a confirmation.
Inputs: channel_id (required).
discord_move_channelAIdempotent
Move a channel into a category, or remove it from its category when category_id is omitted. Requires the Manage Channels permission. Use discord_set_channel_position to reorder within a category. Returns a confirmation.
Inputs: channel_id (required), category_id.
discord_pin_messageAIdempotent
Pin or unpin a message in a channel, controlled by the pin flag. Requires the Pin Messages permission (a dedicated permission since early 2026, separate from Manage Messages). A channel holds at most 50 pins. Idempotent: pinning an already-pinned message (or unpinning an unpinned one) has no additional effect.
Inputs: pin (required), channel_id (required), message_id (required).
discord_prune_membersADestructive
Remove members who have been inactive (no roles, not seen) for a number of days. SAFE BY DEFAULT: dry_run is true unless explicitly set to false, so call it first to preview the count, then re-call with dry_run:false to actually remove them. Removal is irreversible (members must rejoin). Requires the Kick Members permission.
Inputs: days (required), guild_id (required), roles, reason, +1 more.
discord_publish_announcementA
Publish a structured announcement to a channel in one call: a title, a body, optional fields, a colour, and an optional ping target. Builds the embed for you so the layout is consistent, and lets you choose the mention policy explicitly instead of relying on the default. SAFE BY DEFAULT for mentions: no mention is parsed unless you pass ping (so '@everyone' inside the body never actually pings). If the channel is an announcement channel and crosspost is true, the message is also published to followers. Requires Send Messages (and Manage Messages to crosspost others' messages).
Inputs: body (required), title (required), channel_id (required), ping, +5 more. Returns: pinged, channel_id, message_id, crossposted
discord_read_audit_trailARead-only
Read this MCP server's own record of what it changed: every mutating tool call, when it ran, which guild it targeted, whether it was applied or only previewed, and whether it failed. This is NOT Discord's audit log (use discord_get_audit_log for that); it is the server's in-memory trail, capped at the 500 most recent entries and lost when the process restarts. Read-only. Use it to answer 'what did the bot just do?'.
Inputs: limit. Returns: note, entries
discord_read_dmsARead-only
Read the most recent messages from the bot's DM conversation with a user, oldest-to-newest. Returns { messages: [...] } with id, author, content, embed count, timestamp. Read-only.
Inputs: user_id (required), limit. Returns: messages
discord_read_messagesARead-only
Read messages from a text channel or thread, oldest-to-newest. Page backwards by re-calling with before set to the id of the oldest message you received, which walks a channel past the 100-message per-call cap. Requires the View Channel and Read Message History permissions. Returns { messages: [...] } with id, author, content, timestamp, attachment count, pinned flag. Use discord_search_messages to filter by keyword, or discord_fetch_pinned_messages for pinned messages only.
Inputs: channel_id (required), after, limit, since, +2 more. Returns: messages
discord_remove_guild_bannerADestructiveIdempotent
Remove the server's banner. Requires Manage Server and the BANNER feature (boost level 2+). Not reversible. Returns the guild ID.
Inputs: guild_id (required), reason. Returns: id, banner
discord_remove_guild_iconADestructiveIdempotent
Remove the server's icon, reverting to Discord's generated default. Requires Manage Server. This is not reversible: the previous image is gone. Returns the guild ID.
Inputs: guild_id (required), reason. Returns: id, icon
discord_remove_reactionsADestructiveIdempotent
Remove reactions from a message. With no emoji: removes ALL reactions. With emoji only: removes every reaction of that emoji. With emoji and user_id: removes that one user's reaction. Removing all reactions or another user's reaction requires the Manage Messages permission. Use discord_add_reaction to add.
Inputs: channel_id (required), message_id (required), emoji, user_id.
discord_remove_roleAIdempotent
Remove a role from a member. Requires the Manage Roles permission, and the role must be below the bot's highest role. Idempotent: removing a role the member doesn't have has no effect. Reverses discord_add_role.
Inputs: role_id (required), user_id (required), guild_id (required), reason.
discord_reply_dmA
Reply to a specific message in a DM, attaching a quoted reply reference. Unlike the edit/delete DM tools, this works on any message in the conversation (the bot's or the user's). Use discord_send_dm for a standalone DM with no reference. Returns the new reply's message ID.
Inputs: content (required), user_id (required), message_id (required).
discord_reply_messageA
Reply to a specific message, attaching a reply reference so clients show it as a threaded reply. Use discord_send_message for a standalone message with no reference. Requires the Send Messages permission. Returns the new reply's message ID.
Inputs: content (required), channel_id (required), message_id (required).
discord_reply_to_forumA
Post a follow-up message inside an existing forum post (thread). Requires the Send Messages in Threads permission (shown as 'Send Messages in Posts' for forums). Use discord_create_forum_post to start a new post instead. Returns the new message ID.
Inputs: content (required), thread_id (required).
discord_reset_channel_permissionsADestructiveIdempotent
Remove ALL permission overwrites on a channel, so only role/server-level permissions apply. Does NOT re-sync with the category; use discord_lock_channel_permissions for that. IRREVERSIBLE: the cleared overwrites cannot be recovered. Requires the Manage Roles permission.
Inputs: channel_id (required), reason.
discord_restore_structureAIdempotent
Restore a structure backup into a server. PREVIEWS BY DEFAULT: returns exactly what would be created; re-call with confirm:true to apply. ADDITIVE ONLY: it creates roles, categories and channels that are missing and never deletes or renames anything, because a restore that removes entities turns a stale backup into a wipe. Permission overwrites are re-applied by matching role NAMES from the backup to the live server's roles; member-specific overwrites are skipped, since user IDs differ across servers. Requires Manage Channels and Manage Roles.
Inputs: backup (required), guild_id (required), confirm, include_roles. Returns: mode, notes, failed, applied, +3 more
discord_schedule_messageA
Schedule a message to be sent to a channel after a delay, optionally repeating. IMPORTANT LIMITATION: the timer runs inside this MCP server process, so it fires only while the server is running and is lost when it stops. For a post that must survive a restart, use a durable scheduler (cron, a CI workflow, or an OpenHands automation) that calls discord_send_message instead. Returns the task ID and the time of the next run.
Inputs: channel_id (required), delay_seconds (required), url, color, +11 more. Returns: repeats, task_id, warning, next_run_at
discord_search_guild_messagesARead-only
Search for messages across all channels in a guild using Discord's native search API. Returns messages matching the query with channel context. Requires READ_MESSAGE_HISTORY permission. Use discord_search_messages for channel-specific search.
Inputs: query (required), guild_id (required), limit, author_id, +1 more. Returns: matches
discord_search_membersARead-only
Find server members whose username or nickname starts with a query string (prefix match). Returns { members: [...] } with id, username, nickname, roles. Use discord_list_members to page through everyone. Read-only.
Inputs: query (required), guild_id (required), limit. Returns: members
discord_search_messagesARead-only
Keyword search over a channel's recent messages using case-insensitive substring matching. Scans only up to the last 100 messages; it does not search full history. Returns { matches: [...] } with id, author, content, timestamp. Use discord_read_messages to fetch recent messages without filtering.
Inputs: keyword (required), channel_id (required), limit. Returns: matches
discord_send_dmA
Send a private direct message to a user by their user ID. Use discord_send_message to post in a server channel instead. Requires the bot to share at least one server with the user, and the user must allow DMs from server members (otherwise Discord rejects the send). Returns the new message ID.
Inputs: content (required), user_id (required).
discord_send_dm_embedA
Send a rich embed as a private direct message to a user. Use discord_send_dm for plain text, or discord_send_embed to post an embed in a channel. Requires the bot to share a server with the user, and the user must allow DMs from server members. Returns the new message ID.
Inputs: user_id (required), url, color, title, +8 more.
discord_send_embedA
Send a single rich embed (title, description, color, fields, author, footer, images, timestamp). Use discord_send_message for plain text, or discord_send_multiple_embeds to send several embeds at once. Requires the Send Messages and Embed Links permissions. Returns the new message ID.
Inputs: channel_id (required), url, color, title, +7 more.
discord_send_messageA
Send a plain-text message to a channel or thread. For rich content (title, color, fields, images) use discord_send_embed; to attach a reply reference to an existing message use discord_reply_message. Requires the bot to have the Send Messages permission. Returns the new message ID.
Inputs: content (required), channel_id (required).
discord_send_multiple_embedsA
Send up to 10 embeds in a single message, with optional text above them. Use discord_send_embed for a single embed. Requires the Send Messages and Embed Links permissions. Returns the new message ID.
Inputs: embeds (required), channel_id (required), content.
discord_send_pollA
Send a native Discord poll to a channel. Discord renders it with its own vote UI and tallies the results, so no third-party poll bot is needed. Requires the Send Polls permission. Returns the poll message ID and its answer labels.
Inputs: answers (required), question (required), channel_id (required), duration_hours, +1 more.
discord_send_webhook_messageA
Send a message through a webhook using its ID and token (no bot permissions needed; the token authorizes the send). Supports per-message username/avatar overrides and up to 10 embeds. At least one of content or embeds is required. Returns the new message ID.
Inputs: webhook_id (required), webhook_token (required), embeds, content, +2 more.
discord_set_application_descriptionAIdempotent
Change the owning application's description, shown on the OAuth2 authorization screen and in the developer portal. This is not the server's description (discord_set_guild_description). Requires the application to be owned by the token's owner. Returns the new description.
Inputs: description (required). Returns: description, application_id
discord_set_application_iconAIdempotent
Change the owning application's icon, which is what Discord shows in the OAuth2 authorization screen and in the developer portal. This is a different image from the bot's avatar and from the server icon. Requires the application to be owned by the token's owner. Accepts an https URL, data: URI or base64. Returns the new icon URL.
Inputs: image (required). Returns: icon, application_id
discord_set_bot_avatarAIdempotent
Change the bot's global avatar. This applies in every server and in DMs, and is not the same as the server's icon (discord_set_guild_icon) or the bot's per-server avatar (discord_set_bot_guild_avatar). Accepts an https URL, data: URI or base64; PNG, JPEG, GIF or WebP up to 10 MB. Returns the new avatar URL. WARNING: Discord rate-limits this endpoint; repeated calls will be throttled.
Inputs: image (required). Returns: avatar
discord_set_bot_guild_avatarAIdempotent
Set the bot's per-server avatar, which overrides the global avatar in that one server. Requires the server to have the BANNER or ROLE_ICONS-adjacent boost feature set that Discord requires for per-guild member avatars; on a server without it Discord rejects the call. Accepts an https URL, data: URI or base64. Pass null to clear it and fall back to the global avatar. Returns the resulting per-server avatar URL.
Inputs: image (required), guild_id (required), reason. Returns: guild_id, guild_avatar
discord_set_bot_nicknameAIdempotent
Change the bot's own nickname in one server. This is per-server: it does not affect the bot's name in other servers, nor its global username. Pass null to clear the nickname and fall back to the global username. Requires the Change Nickname permission for the bot itself, or Manage Nicknames if changing on its own behalf is restricted. Returns the previous and new nickname.
Inputs: guild_id (required), nickname (required), reason. Returns: guild_id, nickname, previous_nickname
discord_set_bot_usernameAIdempotent
Change the bot's global username. WARNING: this is the most rate-limited endpoint Discord offers (roughly two changes per hour), it applies in every server, and Discord may reject names that are taken or reserved. If the call is throttled it will fail with a 429 and you must wait. This does not change the server name or the bot's nickname. Returns the new username.
Inputs: username (required). Returns: username, previous_username
discord_set_channel_positionAIdempotent
Set a channel's display order within its category. Use discord_move_channel to change which category it belongs to. Requires the Manage Channels permission. Returns a confirmation.
Inputs: position (required), channel_id (required).
discord_set_forum_tagsADestructiveIdempotent
Replace the full set of available tags on a forum channel with the provided list. This overwrites existing tags, so include every tag you want to keep. Requires the Manage Channels permission. Returns a confirmation.
Inputs: tags (required), forum_channel_id (required).
discord_set_guild_bannerAIdempotent
Set or replace the server's banner, the wide image shown at the top of the server's landing page. IMPORTANT LIMITATION: Discord only renders a guild banner when the server has the BANNER feature (boost level 2+). Without it, Discord rejects the call with an error rather than accepting and hiding it. Requires Manage Server. Returns the new banner URL.
Inputs: image (required), guild_id (required), reason. Returns: id, banner
discord_set_guild_channelsAIdempotent
Point the server's special channel slots at specific channels: the AFK channel and timeout, the system channel (where join/boost notices post), the rules channel, the public updates channel, and the safety alerts channel. Only provided slots change. The rules, public-updates and safety-alerts slots require the COMMUNITY feature; Discord rejects them otherwise. AFK must be a voice channel. Requires Manage Server. Returns the resulting slot IDs.
Inputs: guild_id (required), reason, afk_timeout, afk_channel_id, +4 more. Returns: id, afk_timeout, afk_channel_id, rules_channel_id, +3 more
discord_set_guild_descriptionAIdempotent
Set or clear the server's description (the blurb shown on the server's landing page and in discovery). IMPORTANT LIMITATION: Discord only accepts a guild description when the server has the COMMUNITY feature. On a server without it, the call is rejected: call discord_enable_community first, or accept that this field cannot be set. Requires Manage Server. Pass null to clear it.
Inputs: guild_id (required), description (required), reason. Returns: id, description
discord_set_guild_iconAIdempotent
Replace the server's icon (the square image shown next to the server name). This is the guild icon; the bot's own avatar is changed with discord_set_bot_avatar. Accepts an https URL, a data: URI or base64. Requires Manage Server. Discord rejects images that are not PNG, JPEG, GIF or WebP or that exceed 10 MB. Returns the new icon URL.
Inputs: image (required), guild_id (required), reason. Returns: id, icon
discord_set_guild_localeAIdempotent
Set the server's preferred language, which controls the language of Discord's own system messages and the default for members who have not chosen one. Requires Manage Server. Returns the previous and new locale.
Inputs: locale (required), guild_id (required), reason. Returns: id, locale, previous_locale
discord_set_guild_nameAIdempotent
Change the server's name. This is the guild name shown at the top of the server list, not the bot's own name and not the bot's nickname in this server (use discord_set_bot_nickname for that). Requires Manage Server. Returns the previous and new name.
Inputs: name (required), guild_id (required), reason. Returns: id, name, previous_name
discord_set_guild_safetyAIdempotent
Update the server's safety and moderation settings in one call: verification level, explicit content filter, default notification level, and the age-restricted (NSFW) content gate. Only provided fields change. Setting verification_level to high or very_high requires the server to be verified or partnered, otherwise Discord rejects it. Requires Manage Server. Returns the applied values.
Inputs: guild_id (required), nsfw, reason, verification_level, +2 more. Returns: id, verification_level, explicit_content_filter, default_message_notifications
discord_set_guild_splashAIdempotent
Set or remove the server's invite splash, the background shown on the invite page. Requires the INVITE_SPLASH feature (boost level 1+) and Manage Server. Pass null to remove it. Returns the new splash URL.
Inputs: image (required), guild_id (required), reason. Returns: id, splash
discord_set_guild_widgetAIdempotent
Configure the server's embeddable widget: whether it is enabled and which channel it exposes. Enabling the widget publishes a live member list and online count to anyone with the widget URL, so treat it as a privacy decision. Requires Manage Server. Returns the resulting settings. Use discord_get_guild_widget to read the current state and the public URLs.
Inputs: enabled (required), guild_id (required), reason, channel_id. Returns: id, enabled, channel_id
discord_set_member_permissionAIdempotent
Add or update a per-channel permission overwrite for a single member, allowing and/or denying specific permissions. Merges with the member's existing overwrite. Requires the Manage Roles permission. Use discord_set_role_permission to target a whole role instead.
Inputs: user_id (required), channel_id (required), deny, allow, +1 more.
discord_set_membership_gateAIdempotent
Turn the membership screening gate on or off by adding or removing the MEMBER_VERIFICATION_GATE_ENABLED feature. LIMITATION, verified against a live server: Discord returns HTTP 200 but silently ignores an API request to ADD this feature, so enabling it from here does not work. It must be turned on once by hand in the Discord client (Server Settings > Safety Setup > Membership Screening). Disabling it through this tool does work. The returned 'enabled' field always reflects the real state after the call, so treat enabled:false as Discord having refused. Requires the COMMUNITY feature and Manage Server.
Inputs: enabled (required), guild_id (required), reason. Returns: id, enabled, features
discord_set_nicknameAIdempotent
Set or clear a member's server nickname. Pass null (or the string 'null') to clear it. Requires the Manage Nicknames permission (or Change Nickname for the bot itself). The reason is recorded in the audit log.
Inputs: user_id (required), guild_id (required), nickname (required), reason.
discord_set_onboardingAIdempotent
Configure the server's onboarding flow: enable or disable it, pick the default channels new members see, and define the prompts with their options (each option can grant roles and point at channels). Requires the COMMUNITY feature and Manage Server. LIMITATION: Discord requires at least seven default channels and one prompt with at least one option for advanced mode; an incomplete configuration is rejected. Replaces the prompt list wholesale when provided. Returns the resulting configuration.
Inputs: guild_id (required), mode, reason, enabled, +2 more. Returns: mode, enabled, prompt_count, default_channel_ids
discord_set_role_iconAIdempotent
Set or clear a role's icon, either a custom image or a unicode emoji. Requires the server to be Boost Level 2+ (the ROLE_ICONS feature) and the Manage Roles permission. Pass null to either field to remove that icon. Returns a confirmation.
Inputs: role_id (required), guild_id (required), icon, unicode_emoji.
discord_set_role_permissionAIdempotent
Add or update a per-channel permission overwrite for a role, allowing and/or denying specific permissions. Merges with the role's existing overwrite (does not reset it). Denying View Channel to @everyone also locks the bot out unless it holds an allow overwrite of its own; grant that with discord_set_member_permission before the deny. Requires the Manage Roles permission. Use discord_set_member_permission to target a single member instead.
Inputs: role_id (required), channel_id (required), deny, allow, +1 more.
discord_set_role_positionAIdempotent
Move a role up or down in the server's role hierarchy, which determines permission precedence and member-list ordering. Higher position = higher in the list. Requires the Manage Roles permission, and the target position must be below the bot's highest role.
Inputs: role_id (required), guild_id (required), position (required).
discord_set_system_channel_noticesAIdempotent
Toggle which automatic notices the system channel posts: join notifications, join-notification replies, boost/boost-tier messages, the 'server setup tips' reminder, and role-subscription purchase messages. Only provided flags change. Requires Manage Server. Returns the resulting flag set.
Inputs: guild_id (required), reason, join_notifications, premium_subscriptions, +4 more. Returns: id, enabled_notices
discord_set_welcome_screenAIdempotent
Configure the server's welcome screen: enable or disable it, set the headline description, and list the recommended channels with a one-line blurb each. Requires the COMMUNITY feature and Manage Server. LIMITATION: Discord requires the description to be non-empty and at least one recommended channel when the screen is enabled. Replaces the channel list wholesale when provided. Returns the resulting screen.
Inputs: guild_id (required), enabled, description, welcome_channels. Returns: enabled, description, welcome_channels
discord_style_nameARead-only
Generate styled variants of one name for a Discord channel, category, forum, or role. Returns one variant per requested style (or every style when none is given). Uses Unicode decorative characters only: this decorates the text, it does not change the font Discord renders, because Discord has no per-server font setting. Empty or punctuation-only input falls back to a readable default name. Use discord_style_preview to plan a whole server at once.
Inputs: name (required), emoji, styles, max_length. Returns: input, variants
discord_style_previewARead-only
Build a coherent naming plan for a whole server: a shared theme plus per-entity names for categories, text/voice/forum/announcement/rules/support/community channels, and roles. Returns the exact names that would be used, any duplicate names (Discord allows them, but they become indistinguishable in the channel list), and any truncation or fallback that occurred. Read-only: nothing is created or renamed. Use discord_apply_name_theme to actually rename existing entities. These names are decorated text, not a font.
Inputs: items (required), theme (required), prefix, overrides. Returns: items, theme, warnings, collisions
discord_timeout_memberAIdempotent
Mute a member for a set duration (Discord 'timeout'): they cannot send messages, react, or speak until it expires. Pass duration_minutes = 0 to remove an active timeout early. Max 28 days (40320 minutes). Requires the Moderate Members permission.
Inputs: user_id (required), guild_id (required), duration_minutes (required), reason.
discord_unban_memberAIdempotent
Lift a ban so the user may rejoin via a new invite. Requires the Ban Members permission. Reverses discord_ban_member. The reason is recorded in the audit log.
Inputs: user_id (required), guild_id (required), reason.
discord_update_forum_postAIdempotent
Update a forum post's title, archived/locked state, or applied tags. Only provided fields change; passing applied_tags replaces the post's tags. Set archived:true to close a post without deleting it. Requires the Manage Threads permission.
Inputs: thread_id (required), title, locked, archived, +1 more.
discord_update_membership_screeningAIdempotent
Update the server's membership screening form: set the welcome description and the rules new members must agree to. Only provided fields change. Requires the Community feature and the Manage Server permission. Returns the updated form.
Inputs: guild_id (required), description, form_fields.
discord_verify_setupARead-only
Check that the MCP server itself is correctly installed and connected: whether DISCORD_TOKEN is set (reported as a boolean, never echoed), which gateway intents are requested, which toolsets are exposed and how many tools that yields, whether the Discord client reached READY, and the gateway ping. Read-only, takes no arguments. Run this first when the MCP server appears not to work at all.
Inputs: no named parameters. Returns: bot_tag, ping_ms, problems, next_steps, +8 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 177 tools
Most tools carry explicit disambiguation hints ('use X instead of Y'), which rescues an otherwise extremely crowded surface. However there are many genuinely near-neighbour clusters — get_guild_info / get_server_stats / get_guild_settings / get_guild_preview / get_guild_features, and read_messages / search_messages / search_guild_messages / fetch_pinned_messages, and send_message / send_embed / send_multiple_embeds / reply_message / send_webhook_message / publish_announcement — that an agent must read carefully to pick correctly. Boundaries are documented but not self-evident from names alone.
Uniform discord_ prefix plus snake_case resource_action throughout, including a coherent discord_architect_* sub-namespace. The only wobble is verb drift for reads (list_ vs get_ vs fetch_ vs read_ vs explain_ vs verify_) and a few nouns that encode sub-resources (send_dm vs send_message, edit_dm_embed vs edit_embed), but the pattern is highly readable and predictable.
177 tools for one server is an extreme mismatch: no agent can reliably select from this surface, and much of it is long-tail (stickers, per-server bot avatars, application icon, reaction-role menus, styled Unicode names). The domain is genuinely large, but this should be split into toolsets (channels, members, permissions, guild settings, automod, build/architect) rather than a single flat list.
Coverage is unusually thorough — CRUD for channels, messages, threads/forums, members, roles, invites, webhooks, scheduled events, AutoMod, emoji/sticker, guild settings, onboarding, plus diagnostics, structure backup/restore and a declarative build pipeline. Remaining gaps are interactions/message components, slash-command registration, and voice/stage moderation, plus explicitly documented platform limits (no guild creation, no message-history export).
Related MCP Connectors
- Discortics - Discord BotDeprecatedcom.discortics
Set up and manage your Discord server from MCP: channels, roles, verification, tickets and security.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server for generating rough-draft project plans from natural-language prompts.
Capability registry for the agentic economy. Semantic search over verified MCP server listings.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceComprehensive Discord server management through MCP, enabling channel, role, permission, message, moderation, and automation tasks via natural language.4-
- AlicenseAqualityDmaintenanceAn MCP server that lets AI assistants provision Discord servers (guilds, categories, channels, roles, permissions) from declarative blueprints via the Discord REST API, with idempotent diff-based planning and no deletions.15MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that exposes Discord API as tools, enabling users to manage servers, channels, messages, and roles through natural language.-
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients such as Claude, Cursor, or Codex to build and manage Discord servers end to end — creating channels, roles, permission overwrites, threads, webhooks, events, and messages, plus whole-server blueprints applied idempotently. Includes guard rails like read-only and safe modes, per-server allowlists, and permission explanations.141 npmMIT