Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

Discord MCP

NPM · @ORYGN/DISCORD-MCP

Discord server management MCP for AI agents: chat, moderation, admin, and full server building.

Available components

+4 this week 84 Trust /100

Last scanned (22 hours ago)

Scores higher than 75% of npm servers

Category Communication

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security100
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • No install/post-install scripts declared.Pass
  • 0 of 19 dependencies flagged as unhealthy. View diagnostics → Pass
Provenance & Transparency100
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Cryptographically verified build provenance (signed, bound to OrygnsCode/discord-mcp). View diagnostics → Pass
  • Clear OSI-approved license (Apache-2.0).Pass
  • Actively maintained (last published 0 days ago).Pass
  • Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability67
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 22611 tokens (~137/item across 164 items; 164 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management30
  • Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage92
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 77% of tool parameters carry a description.Partial
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • All 29 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
  • An AI judge read all 165 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a current MCP spec version (2026-07-28).Pass
What we tested

Checks we ran (16)

  • Malware scan
  • Known CVEs
  • Install scripts
  • Dependency health
  • Source repository
  • Provenance
  • License
  • Maintenance
  • Security disclosure
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Does not apply to this package (2)

  • Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
  • Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 21 Nov 26 +1
    • Package version: 2.1.0 → 2.1.1 functional
  • 19 Nov 26 +1
    • Stability: 0.20 → unverified ▼ security
    • Tool safety: pass → unverified ▼ security
    • Capabilities: pass → unverified ▼ functional
    • Tool coverage: 100 → unverified ▼ functional
    • First check of Schema quality: unverified functional
    • Package version: 2.0.0 → 2.1.0 functional
  • 17 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

  • 15 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

  • 14 Nov 26 +1
    • Stability: unverified → 0.07 ▲ functional
  • 13 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 12 Nov 26 64

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Nov 2026 · Analysed npm/@orygn/discord-mcp@2.1.1

Provenance Verified

A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.

Result Verified
Ecosystem npm
Reason Verified
Discovered via Registry attestation endpoint
Source repo OrygnsCode/discord-mcp
Certificate issuer https://token.actions.githubusercontent.com
Certificate SAN https://github.com/OrygnsCode/discord-mcp/.github/workflows/release.yml@refs/tags/v2.1.1
Rekor log index 4030686623
Predicate type SLSA build provenance https://slsa.dev/provenance/v1
Subject digest sha512:f6bcfbf400c3a89a174edd387335c704423f8036557bb85f35ea5d8a6e9f6bd9c736ac0e6d7d6d4f810c6cdf04e7d82d5073a841a620000dc7171a937

Background: How many MCP packages publish verified provenance →

Dependencies 19 packages
Packages resolved 19
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 164 exposed · ~22,249 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
list_roles ~65

All roles in a server, highest first, with how many members hold each, color (and gradient), icon, position, and a plain-language digest of their key permissions.

NameTypeReqDescription
guildstring–Guild (server) name or ID. Omit to use the default guild.

No output schema declared.

No examples provided.

list_scheduled_messages ~59

Pending timed messages waiting to send, soonest first. These are messages queued with schedule_message, not Discord community events (list_events).

NameTypeReqDescription
guildstring–Guild (server) name or ID. Omit to use the default guild.

No output schema declared.

No examples provided.

list_server_templates ~38

Discord templates created from this server.

NameTypeReqDescription
guildstring–Guild (server) name or ID. Omit to use the default guild.

No output schema declared.

No examples provided.

list_servers ~67

Every server your bots are in, each labeled with which bot reaches it, with approximate member counts. A server more than one of your bots is in appears once per bot, with handles_server marking the one that tools run as there. Use get_server_overview for one server's full detail.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_soundboard_sounds ~41

Custom soundboard sounds in the server.

NameTypeReqDescription
guildstring–Guild (server) name or ID. Omit to use the default guild.

No output schema declared.

No examples provided.

list_stages ~41

Stage channels that currently have a live stage running.

NameTypeReqDescription
guildstring–Guild (server) name or ID. Omit to use the default guild.

No output schema declared.

No examples provided.

list_stickers ~37

Custom stickers in the server.

NameTypeReqDescription
guildstring–Guild (server) name or ID. Omit to use the default guild.

No output schema declared.

No examples provided.

list_thread_members ~48

Who is in a thread.

NameTypeReqDescription
guildstring–Guild (server) name or ID. Omit to use the default guild.
threadstringyesThread name or ID.

No output schema declared.

No examples provided.

list_threads ~80

Active threads across the server or one channel. Archived threads come from a specific channel with include_archived.

NameTypeReqDescription
channelstring–Limit to threads under this channel.
guildstring–Guild (server) name or ID. Omit to use the default guild.
include_archivedboolean–Also list archived threads; needs channel.

No output schema declared.

No examples provided.

list_voice_members ~83

Who is currently in a voice or stage channel, with their mute and deafen state. This reads the live voice presence the gateway tracks, so it reflects the time since this server connected.

NameTypeReqDescription
channelstringyesVoice or stage channel name or ID.
guildstring–Guild (server) name or ID. Omit to use the default guild.

No output schema declared.

No examples provided.

list_webhooks ~52

Webhooks in the server or one channel. Tokens are never included.

NameTypeReqDescription
channelstring––
guildstring–Guild (server) name or ID. Omit to use the default guild.

No output schema declared.

No examples provided.

lock_channel ~106

Lock a channel by denying everyone the ability to send messages and start threads. Roles and members with their own permission to post on the channel keep it, so moderators set up that way keep access; the result names them. Reverse with unlock_channel, which puts back exactly what the lock changed.

NameTypeReqDescription
channelstringyesChannel name or ID.
guildstring–Guild (server) name or ID. Omit to use the default guild.
reasonstring––

No output schema declared.

No examples provided.

pin_message ~94

Pin a message in a channel. Needs the Pin Messages permission (split from Manage Messages in 2026). Channels hold at most 250 pins.

NameTypeReqDescription
channelstringyesChannel name or ID.
guildstring–Guild (server) name or ID. Omit to use the default guild.
message_idstringyesMessage ID, or the message's link.
reasonstring––

No output schema declared.

No examples provided.

plan_server_build ~311

Validate a blueprint against the live server and stage an ordered build plan. Checks Discord limits, name collisions, role references, feature requirements, and the bot's permissions, and reports every problem at once. Changes nothing on Discord. Use it for any multi-step structure, even a small one: the plan shows the user every step before anything happens. By default existing channels and roles with matching names are reused as they are. With update_existing, existing items are changed to match the blueprint too: renames (items carrying an id from export_server_blueprint), permissions, colors, topics, slowmode, category moves, and who can see or post. An item changes only the settings it lists; list one empty to clear it. To delete roles, categories, or channels, list them in remove; leaving something out of a blueprint never deletes it. Each change shows before and after, each deletion what it loses, with risks flagged. A plan that changes or deletes runs only by its plan_id, exactly as shown, or not at all.

NameTypeReqDescription
blueprintobjectyesThe desired structure: roles, categories, channels.
guildstring–Guild (server) name or ID. Omit to use the default guild.
removeobject–Items to delete, by name or id. Deletions run last. The blueprint may be empty when only deleting.
update_existingboolean–Also change existing items to match the blueprint. Default false: reuse them as they are.

No output schema declared.

No examples provided.

prune_members ~163

Remove members inactive for a number of days who hold no roles. Needs Kick Members and Manage Server, or Administrator where the owner has made pruning admin-only. Safe to call directly: the first call counts who would go using Discord's own preview and returns a confirm_token; repeating the call with the token prunes for real.

NameTypeReqDescription
confirm_tokenstring–The token from this exact action's preview. Where the app can show a confirmation dialog, calling with it asks the user there, and it happens only if they agree.
daysintegeryesInactivity threshold in days.
dry_runboolean––
guildstring–Guild (server) name or ID. Omit to use the default guild.
reasonstring––

No output schema declared.

No examples provided.

read_messages ~128

Recent messages from a channel as a digest: author, time, content, attachments, reactions, and resolved reply references. Returns oldest first. Use next_before to page further back. To look at a message's pictures, use get_message with include_images.

NameTypeReqDescription
beforestring–Message ID cursor: only messages older than this.
channelstringyesChannel name or ID.
guildstring–Guild (server) name or ID. Omit to use the default guild.
limitinteger–How many messages, 1 to 100. Default 25.

No output schema declared.

No examples provided.

register_app_command ~175

Register a slash command, or update it in place if the name is already taken. Pass a guild while iterating: guild commands appear immediately, while global commands can take up to an hour to show up everywhere and are rate limited per day. Subcommands and subcommand groups are not supported here.

NameTypeReqDescription
botstring–Which bot to act as, by name, when more than one is configured. Omit to use the default bot, or with a server, the bot that handles it.
descriptionstringyesShown to users in the command picker.
guildstring–Guild (server) name or ID. Omit to use the default guild.
namestringyesCommand name without the slash, lowercase, no spaces.
optionsarray–Arguments the command takes.

No output schema declared.

No examples provided.

remove_reaction ~104

Remove a reaction: the bot's own by default, or another user's (which needs Manage Messages).

NameTypeReqDescription
channelstringyesChannel name or ID.
emojistringyes–
guildstring–Guild (server) name or ID. Omit to use the default guild.
message_idstringyesMessage ID, or the message's link.
userstring–Whose reaction to remove; omit for the bot's own.

No output schema declared.

No examples provided.

remove_role ~202

Take a role away from a member. Preflights the bot's role hierarchy so a failure is an explanation, not a 403. Usually done at once. A role can also hold someone back (one that hides channels from whoever has it, such as a quarantine role); taking that away lets them in, so it needs confirming: the first call changes nothing and returns a preview and a confirm_token, and repeating the call with the token makes the change.

NameTypeReqDescription
confirm_tokenstring–The token from this exact action's preview. Where the app can show a confirmation dialog, calling with it asks the user there, and it happens only if they agree.
dry_runboolean––
guildstring–Guild (server) name or ID. Omit to use the default guild.
memberstringyesMember name or user ID.
reasonstring––
rolestringyesRole name or ID.

No output schema declared.

No examples provided.

remove_thread_member ~65

Remove a member from a thread. Needs Manage Threads.

NameTypeReqDescription
guildstring–Guild (server) name or ID. Omit to use the default guild.
memberstringyesMember name or user ID.
threadstringyesThread name or ID.

No output schema declared.

No examples provided.

remove_timeout ~157

Lift an active timeout from a member early. It puts someone a moderator silenced back in the conversation, so it needs confirming: the first call changes nothing and returns a preview and a confirm_token, and repeating the call with the token makes the change. A member who is not timed out is left alone, with nothing to confirm.

NameTypeReqDescription
confirm_tokenstring–The token from this exact action's preview. Where the app can show a confirmation dialog, calling with it asks the user there, and it happens only if they agree.
guildstring–Guild (server) name or ID. Omit to use the default guild.
memberstringyesMember name or user ID.
reasonstring––

No output schema declared.

No examples provided.

reorder_channels ~54

Move channels to new positions, and optionally into a different category, in one call.

NameTypeReqDescription
guildstring–Guild (server) name or ID. Omit to use the default guild.
movesarrayyes–

No output schema declared.

No examples provided.

reorder_roles ~167

Move roles to new hierarchy positions in one call. Higher positions sit higher in the list and outrank lower ones. Moving a role that can ban, kick, time out, rename, or change roles above a role it was below lets its holders do that to the people with the other role, so that needs confirming: the first call changes nothing and returns a preview and a confirm_token, and repeating the call with the token makes the change.

NameTypeReqDescription
confirm_tokenstring–The token from this exact action's preview. Where the app can show a confirmation dialog, calling with it asks the user there, and it happens only if they agree.
guildstring–Guild (server) name or ID. Omit to use the default guild.
movesarrayyes–

No output schema declared.

No examples provided.

reply_to_forum_post ~128

Add a reply inside a forum post: text, embeds, or both.

NameTypeReqDescription
contentstring–Reply text. May be left out when embeds carry the reply.
embedsarray–Up to 10 embeds. Each needs a title, a description, an author, fields, a footer, or a picture. Discord allows 6,000 characters of text across all of one message's embeds.
guildstring–Guild (server) name or ID. Omit to use the default guild.
poststringyesPost title or thread ID.

No output schema declared.

No examples provided.

run_setup_check ~158

End-to-end health check of the discord-mcp setup: token presence and validity, privileged gateway intent toggles, Discord's growth thresholds (App Verification by servers, intent review by users), default guild membership, whether this install runs from npm's temporary npx cache, how destructive actions get confirmed in this app, and leftovers from before the 2.0 rename. Every failed check comes with instructions for fixing it. With more than one bot configured, pass bot to check a specific one. Run this first when anything misbehaves.

NameTypeReqDescription
botstring–Which bot to act as, by name, when more than one is configured. Omit to use the default bot, or with a server, the bot that handles it.

No output schema declared.

No examples provided.

save_blueprint ~61

Save a blueprint to the local store for reuse: apply it to other servers with execute_build_plan or track drift with diff_blueprint. Names are unique.

NameTypeReqDescription
blueprintobjectyes–
descriptionstring––
namestringyes–

No output schema declared.

No examples provided.

schedule_message ~184

Post a text message to a channel at a later time, once or on a daily or weekly repeat. This sends an ordinary message; for a community event members can RSVP to, use create_event. This server sends it when the time comes. One limit worth knowing: delivery needs this server to be running at that moment, so always-on scheduling needs a machine or container that stays up rather than a laptop that sleeps. A message that came due during downtime is sent at the next start.

NameTypeReqDescription
channelstringyesChannel name or ID.
contentstringyes–
guildstring–Guild (server) name or ID. Omit to use the default guild.
repeatstring–Default none.
send_atstringyesWhen to send, ISO time like 2026-07-01T17:00:00Z.

No output schema declared.

No examples provided.

search_members ~143

Find specific members by a name fragment, or list those holding a given role. For the whole roster use list_members; for one member's full profile use get_member; to turn a fuzzy name into an id use find. Name search uses Discord's member search; role filtering walks the member list and reports if it hit the paging cap.

NameTypeReqDescription
guildstring–Guild (server) name or ID. Omit to use the default guild.
limitinteger–Max results. Default 25.
querystring–Name prefix to search for (username or nickname).
rolestring–Role name or ID; returns members holding it.

No output schema declared.

No examples provided.

search_messages ~291

Search the server's message history through Discord's native search index. Covers every channel the bot can read, or one channel if you name it, and looks inside embeds and polls, not just plain text. Matching is whole-word full text, not substring, so search for words rather than fragments. Filter by author, by what a message carries (image, link, file, and so on), or by pinned state, and order by newest first or by relevance.

NameTypeReqDescription
authorstring–Only messages from this member (name or ID).
channelstring–Limit to one channel by name or ID. Default: the whole server.
guildstring–Guild (server) name or ID. Omit to use the default guild.
hasstring–Only messages that carry this kind of content.
limitinteger–Max results to return, 1 to 25. Default 10.
offsetinteger–Skip this many results, for paging. Default 0.
pinnedboolean–Only pinned (true) or only unpinned (false) messages.
querystring–Words to look for. Whole-word full text match, not substring. Optional if you filter by author, has, or pinned instead.
sortstring–Order by newest first (recent, the default) or best match (relevant).

No output schema declared.

No examples provided.

send_dm ~90

Send a direct message from the bot to a member who shares a server with it. Fails gracefully when the recipient has DMs closed. The message comes from the bot, never from a user account.

NameTypeReqDescription
contentstringyes–
guildstring–Guild (server) name or ID. Omit to use the default guild.
userstringyesMember name or user ID.

No output schema declared.

No examples provided.

send_message ~390

Send a message to a channel, optionally as a reply, with embeds, or as a Components V2 layout of text, sections, image galleries, separators and link buttons inside colored containers, and with up to 10 files fetched from public URLs. Components replace content and embeds rather than joining them, and the choice is permanent for that message; in a layout, a file shows only where a gallery or thumbnail points at it as attachment://<filename>. For a private message to one person use send_dm; to post under a custom name and avatar use send_webhook_message; to send later use schedule_message. Mentions are suppressed by default; raise the mentions mode only deliberately. Supports dry_run.

NameTypeReqDescription
channelstringyesChannel name or ID.
componentsarray–Rich layout, in place of content and embeds. Sending this sets the Components V2 flag, which is permanent for that message: it can never show plain content or embeds afterward, so the two cannot be c…
contentstring–Message text. May be left out when embeds, files, or components carry the message.
dry_runboolean–Preview without sending.
embedsarray–Up to 10 embeds. Each needs a title, a description, an author, fields, a footer, or a picture. Discord allows 6,000 characters of text across all of one message's embeds.
filesarray–Up to 10 files to attach, each fetched from a public URL (20 MiB each). Needs the Attach Files permission.
guildstring–Guild (server) name or ID. Omit to use the default guild.
mentionsstring–Which mention types may ping. Default none.
reply_tostring–Message to reply to: its ID or link.
silentboolean–Send without triggering notifications.

No output schema declared.

No examples provided.

send_webhook_message ~178

Post through a webhook with an optional display name and avatar override, and up to 10 files fetched from public URLs. Mentions are suppressed.

NameTypeReqDescription
avatar_url_overridestring––
contentstring––
embedsarray–Up to 10 embeds. Each needs a title, a description, an author, fields, a footer, or a picture. Discord allows 6,000 characters of text across all of one message's embeds.
filesarray–Up to 10 files to attach, each fetched from a public URL (20 MiB each). Needs the Attach Files permission.
guildstring–Guild (server) name or ID. Omit to use the default guild.
username_overridestring––
webhookstringyesWebhook name or ID.

No output schema declared.

No examples provided.

set_bot_presence ~54

Change the bot's status dot and custom status text. Needs the gateway connection this server keeps by default.

NameTypeReqDescription
activity_textstring–Custom status text shown under the bot's name.
statusstringyes–

No output schema declared.

No examples provided.

set_channel_permissions ~327

Set a permission overwrite on a channel for one role or member: which permissions are explicitly allowed and which are denied. It replaces that role's or member's whole overwrite on the channel, so list every permission it should keep, not only the new one; get_channel_permissions shows the current one. Permission names like manage_messages or send_messages. On a category, Discord also makes the same change in every channel inside whose permissions match the category's exactly (synced), as the Discord app does; the result names them. To keep such a channel as it is, change that channel first, which stops it matching. get_channel_permissions says whether a channel is synced. A change that would let someone see a channel they cannot see now, or give them moderator or admin powers (such as banning, kicking, or timing out members, deleting other people's messages, or managing the server, roles, or channels) there, needs confirming: the first call changes nothing and returns a preview and a confirm_token, and repeating the call with the token makes the change.

NameTypeReqDescription
allowarray–Permissions to allow.
channelstringyesChannel name or ID.
confirm_tokenstring–The token from this exact action's preview. Where the app can show a confirmation dialog, calling with it asks the user there, and it happens only if they agree.
denyarray–Permissions to deny.
guildstring–Guild (server) name or ID. Omit to use the default guild.
targetstringyesRole or member name or ID.

No output schema declared.

No examples provided.

set_incident_actions ~284

Discord's raid-defense security actions for the whole server. Pause new invites, and pause DMs between members who are not friends, each for up to 24 hours, to lock the server down during a raid. Give a number of hours to pause, 0 to lift a pause, or omit a field to leave it unchanged. Called with neither field, it reports the current state, including any raid or DM spam Discord detected on its own. Pausing, or pausing for longer, happens at once. Lifting a pause that is running, or ending it sooner, needs confirming: the first call changes nothing and returns a preview and a confirm_token, and repeating the call with the token makes the change.

NameTypeReqDescription
confirm_tokenstring–The token from this exact action's preview. Where the app can show a confirmation dialog, calling with it asks the user there, and it happens only if they agree.
dmsnumber–Hours to pause DMs between non-friend members, up to 24. Use 0 to resume, or omit to leave them unchanged.
guildstring–Guild (server) name or ID. Omit to use the default guild.
invitesnumber–Hours to pause new invites, up to 24. Use 0 to resume invites, or omit to leave them unchanged.

No output schema declared.

No examples provided.

set_voice_channel_status ~118

Set the short status line shown on a voice channel, a note about what is happening in it right now, up to 500 characters. Pass an empty status to clear it. This is the live status, not the topic. Needs Set Voice Channel Status, Manage Channels, and Connect in that channel.

NameTypeReqDescription
channelstringyesVoice channel name or ID.
guildstring–Guild (server) name or ID. Omit to use the default guild.
statusstringyesStatus text. Empty clears it.

No output schema declared.

No examples provided.

start_stage ~86

Open a live stage on a stage channel with a topic. Members can then be invited to speak.

NameTypeReqDescription
channelstringyesStage channel name or ID.
guildstring–Guild (server) name or ID. Omit to use the default guild.
notifyboolean–Notify members that the stage started. Needs Mention Everyone.
topicstringyes–

No output schema declared.

No examples provided.

subscribe_events ~212

Watch one server live: start recording real-time activity as it happens (messages, joins and leaves, reactions, channel and role changes, bans, voice movement) into a buffer you then read with get_recent_events. Only the named server's events are recorded (the default server when none is named). Use this to observe what is going on now. It is not for scheduled community events (create_event) or timed messages (schedule_message). Available types: message_created, message_deleted, member_joined, member_left, reaction_added, reaction_removed, channel_created, channel_deleted, role_created, role_updated, role_deleted, ban_added, ban_removed, voice_state_changed.

NameTypeReqDescription
channelstring–Only record events from this channel.
guildstring–Guild (server) name or ID. Omit to use the default guild.
include_botsboolean–Also record events caused by bots, including this one. Default false.
typesarrayyesWhich event types to record.

No output schema declared.

No examples provided.

sync_server_template ~61

Update a template to match the server's current structure.

NameTypeReqDescription
codestringyesTemplate code from list_server_templates, or its discord.new link.
guildstring–Guild (server) name or ID. Omit to use the default guild.

No output schema declared.

No examples provided.

timeout_member ~188

Time a member out so they cannot talk, react, or join voice, for up to 28 days. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token applies the timeout. Relay the preview for the user's go-ahead. The reason lands in the audit log.

NameTypeReqDescription
confirm_tokenstring–The token from this exact action's preview. Where the app can show a confirmation dialog, calling with it asks the user there, and it happens only if they agree.
dry_runboolean––
duration_minutesintegeryesTimeout length in minutes, up to 40320 (28 days).
guildstring–Guild (server) name or ID. Omit to use the default guild.
memberstringyesMember name or user ID.
reasonstring––

No output schema declared.

No examples provided.

unban_member ~138

Lift a ban so the user can rejoin with an invite. The first call changes nothing and returns a preview (who it is and why they were banned) and a confirm_token; repeating the call with the token lifts the ban.

NameTypeReqDescription
confirm_tokenstring–The token from this exact action's preview. Where the app can show a confirmation dialog, calling with it asks the user there, and it happens only if they agree.
guildstring–Guild (server) name or ID. Omit to use the default guild.
reasonstring––
user_idstringyesThe banned user's ID.

No output schema declared.

No examples provided.

undo_change ~337

Undo changes made through discord-mcp, from their records: builds, and any single create, edit, or delete of a channel or role, permission edit, role given or taken, server settings edit. Use this rather than redoing things by hand: it has an exact copy of what was there. It deletes what a change created, puts back what it changed, and recreates what it deleted. A setting goes back only if it still holds the value the change set; anything changed since stays and is reported. Recreated items get new ids, and a deleted channel's messages cannot come back. Pass change_id for one change, since (a time) to undo every change made from then on, such as everything today, or change_ids for several; they are undone newest first. With none, the latest change not yet undone. The first call changes nothing and returns every step plus a confirm_token; repeat with the token to run it. If a step fails (a rate limit, say), calling it again finishes the rest.

NameTypeReqDescription
change_idstring–One change, from list_changes or the tool that made it.
change_idsarray–Several changes.
confirm_tokenstring–The token from this exact action's preview. Where the app can show a confirmation dialog, calling with it asks the user there, and it happens only if they agree.
dry_runboolean––
guildstring–Guild (server) name or ID. Omit to use the default guild.
sincestring–ISO date-time: undo every change made at or after it.

No output schema declared.

No examples provided.

unlock_channel ~187

Reverse lock_channel: lift the denials the lock added and put back what it took off, leaving alone anything that was denied before the lock. A channel that was read-only before it was locked stays read-only. On a channel no lock is on record for, it would remove everyone's denial on sending, which may be there on purpose, so that needs confirming: the first call changes nothing and returns a preview and a confirm_token, and repeating the call with the token makes the change.

NameTypeReqDescription
channelstringyesChannel name or ID.
confirm_tokenstring–The token from this exact action's preview. Where the app can show a confirmation dialog, calling with it asks the user there, and it happens only if they agree.
guildstring–Guild (server) name or ID. Omit to use the default guild.
reasonstring––

No output schema declared.

No examples provided.

unpin_message ~76

Unpin a message. The message itself is untouched.

NameTypeReqDescription
channelstringyesChannel name or ID.
guildstring–Guild (server) name or ID. Omit to use the default guild.
message_idstringyesMessage ID, or the message's link.
reasonstring––

No output schema declared.

No examples provided.

unsubscribe_events ~25

Stop recording and discard a subscription's buffer.

NameTypeReqDescription
subscription_idstringyes–

No output schema declared.

No examples provided.

update_app_command ~143

Change a registered command's description or options. Anything not passed is left as it is. Replacing options replaces the whole list, so send every option you want to keep.

NameTypeReqDescription
botstring–Which bot to act as, by name, when more than one is configured. Omit to use the default bot, or with a server, the bot that handles it.
commandstringyesCommand name or ID.
descriptionstring–New description.
guildstring–Guild (server) name or ID. Omit to use the default guild.
optionsarray–Replacement option list, replacing the existing one entirely.

No output schema declared.

No examples provided.

update_automod_rule ~199

Rename a rule, enable or disable it, or replace its keyword list. Turning a rule off, or a new list that leaves out keywords the rule has now, stops it catching what it caught, so that needs confirming: the first call changes nothing and returns a preview and a confirm_token, and repeating the call with the token makes the change. Renaming, turning a rule on, and adding keywords happen at once.

NameTypeReqDescription
confirm_tokenstring–The token from this exact action's preview. Where the app can show a confirmation dialog, calling with it asks the user there, and it happens only if they agree.
enabledboolean––
guildstring–Guild (server) name or ID. Omit to use the default guild.
keywordsarray–Replaces the keyword list on keyword rules.
namestring––
rulestringyesRule name or ID.

No output schema declared.

No examples provided.

update_bot_profile ~329

Change how the bot looks. In one server (the default): its nickname, avatar, banner, and bio there, shown only in that server, so one bot can look different in each community. Everywhere (scope everywhere): its username, avatar, and banner, for every server it is in. Images come from public URLs; none removes a server-only one, so the global one shows again. A replaced avatar or banner is saved to the data folder first, since Discord does not keep it. Discord limits username changes to about two an hour.

NameTypeReqDescription
avatar_urlstring–Public URL of the avatar image (png, jpeg, gif, webp), or none.
banner_urlstring–Public URL of the profile banner image, or none.
biostring–Server only: the About Me shown in that server, or none. The bot's own About Me is set in the Developer Portal.
botstring–Which bot to act as, by name, when more than one is configured. Omit to use the default bot, or with a server, the bot that handles it.
dry_runboolean––
guildstring–Guild (server) name or ID. Omit to use the default guild.
nicknamestring–Server only: the name shown in that server, or none to show the username.
scopestring–server (default) changes it in one server only; everywhere changes the bot's own profile.
usernamestring–Everywhere only: the bot's username.

No output schema declared.

No examples provided.

update_channel ~432

Edit a channel's name, topic, slowmode, NSFW flag, or category, a voice channel's bitrate, user limit, region, and video quality, how long its threads stay open, and a forum's default reaction, sort, layout, post slowmode, and whether posts need a tag. Only passed fields change. Pass category "none" to move a channel out of its category. Supports dry_run.

NameTypeReqDescription
bitrate_kbpsinteger–Voice and stage audio quality in kbps. Up to 96 without boosts, 128, 256, and 384 at boost levels 1 to 3.
categorystring–Category name or ID, or "none" to remove.
channelstringyesChannel name or ID.
default_layoutstring–Forum: list or gallery view.
default_reactionstring–Forum: the emoji offered on every post, as a character or a custom emoji name; none to remove.
default_sortstring–Forum: how posts are ordered.
dry_runboolean––
guildstring–Guild (server) name or ID. Omit to use the default guild.
namestring––
nsfwboolean––
post_slowmode_secondsinteger–Forum: the slowmode each new post starts with.
regionstring–Voice region id such as us-east or rotterdam, or automatic.
require_tagboolean–Forum: posts must carry at least one tag.
slowmode_secondsinteger––
thread_archive_minutesnumber–How long new threads stay open without activity: 60, 1440 (a day), 4320, or 10080 (a week).
topicstring––
user_limitinteger–Most people at once, 0 for no limit. Up to 99 in voice, 10000 in stage.
video_qualitystring–Camera quality in voice channels: auto, or full (720p).

No output schema declared.

No examples provided.

update_emoji ~55

Rename a custom emoji.

NameTypeReqDescription
emojistringyesCurrent emoji name or ID.
guildstring–Guild (server) name or ID. Omit to use the default guild.
namestringyes–

No output schema declared.

No examples provided.

Install

How do I install the Discord MCP server?

Discord MCP runs locally as an npm package, launched with npx -y @orygn/discord-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

npm · @orygn/discord-mcp

# add to Claude Code
claude mcp add orygnscode-discord-mcp -- npx -y @orygn/discord-mcp
Common questions

What is the Discord MCP server?

Discord MCP is listed in the public MCP registry as io.github.OrygnsCode/discord-mcp. Discord server management MCP for AI agents: chat, moderation, admin, and full server building. This page covers its npm package (@orygn/discord-mcp).

Is the Discord MCP server safe to use?

Discord MCP scores 84 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the Discord MCP server expose?

Discord MCP exposes 164 tools: get_rate_limit_status, get_bot_info, run_setup_check, get_server_overview, list_channels, and 159 more. Their descriptions and schemas cost roughly 22,249 tokens of context every time the server is loaded.

Is the Discord MCP server still maintained?

Discord MCP is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the Discord MCP server under?

Discord MCP declares the Apache-2.0 licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

What did VerifyMCP test on the Discord MCP server?

VerifyMCP ran 16 checks on Discord MCP, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.