# Discord MCP (npm · @orygn/discord-mcp)

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

- Trust score: 84/100 (high trust)
- Change this week: +4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- npm · `@orygn/discord-mcp`: 84/100 (this document), [markdown](https://verifymcp.io/servers/orygnscode-discord-mcp/orygn-discord-mcp.md), [page](https://verifymcp.io/servers/orygnscode-discord-mcp/orygn-discord-mcp)

## Channel facts

- Registry: `npm`
- Package: `@orygn/discord-mcp`
- Version: `2.1.1`
- Transport: `stdio`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 0 of 19 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 100/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to OrygnsCode/discord-mcp).
  - Clear OSI-approved license (Apache-2.0).
  - Actively maintained (last published 0 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 67/100
  - AI-judged instruction clarity (good).
  - 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.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 30/100
  - Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 92/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 77% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 29 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 165 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

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

### Claude

```bash
claude mcp add orygnscode-discord-mcp -- npx -y @orygn/discord-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "orygnscode-discord-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@orygn/discord-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "orygnscode-discord-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@orygn/discord-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add orygnscode-discord-mcp -- npx -y @orygn/discord-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "orygnscode-discord-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@orygn/discord-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add orygnscode-discord-mcp --command npx --arg -y --arg @orygn/discord-mcp
```

### Hermes

```yaml
mcp_servers:
  orygnscode-discord-mcp:
    command: "npx"
    args: ["-y", "@orygn/discord-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "orygnscode-discord-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "@orygn/discord-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add orygnscode-discord-mcp -t stdio -c npx -a -y @orygn/discord-mcp
```

### Other

```json
{
  "mcpServers": {
    "orygnscode-discord-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@orygn/discord-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 84, +1)

- [functional] Package version: 2.1.0 → 2.1.1

### 2026-11-19 (score 83, +1)

- [security regression] Stability: 0.20 → unverified
- [security regression] Tool safety: pass → unverified
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified
- [functional] Package version: 2.0.0 → 2.1.0

### 2026-11-17 (score 82, +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.

### 2026-11-15 (score 81, +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.

### 2026-11-14 (score 80, +1)

- [functional improvement] Stability: unverified → 0.07

### 2026-11-13 (score 79, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-11-12 (score 64)

First indexed and scored.

## MCP tools (164)

### `get_rate_limit_status` (~64 tokens)

Get rate limit status

How rate limiting has been going: how many times Discord asked this server to slow down (the request layer waits automatically), and the invalid-request counter that matters because Discord temporarily bans an IP after 10,000 invalid responses in ten minutes. Useful when calls feel slow.

### `get_bot_info` (~109 tokens)

Get bot info

Identity and status of a connected Discord bot: bot user, application, guild count, enabled gateway intents, and the server version. With more than one bot configured, pass bot to pick which (list_servers shows the configured bots). Use run_setup_check for a full health check with fix instructions.

Input parameters:

- `bot` (string): 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.

### `run_setup_check` (~158 tokens)

Run setup check

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.

Input parameters:

- `bot` (string): 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.

### `get_server_overview` (~101 tokens)

Get server overview

Structured snapshot of a server: identity, member counts, boost status, channel outline grouped by category, and role count. The natural first call when starting work on a server. The outline holds only channels the bot can see; hidden_from_bot says how many others exist when any do. A running pause on invites or DMs is reported too.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `list_channels` (~101 tokens)

List channels

The channels in a server the bot can see, grouped by category, with type and topic. Filter by type: text, voice, forum, stage, announcement, category. Channels the bot lacks View Channel on are left out by Discord; hidden_from_bot says how many when any are.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `type` (string): Only return channels of this type.

### `list_roles` (~65 tokens)

List roles

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.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `read_messages` (~128 tokens)

Read messages

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.

Input parameters:

- `before` (string): Message ID cursor: only messages older than this.
- `channel` (string, required): Channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `limit` (integer): How many messages, 1 to 100. Default 25.

### `search_messages` (~291 tokens)

Search messages

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.

Input parameters:

- `author` (string): Only messages from this member (name or ID).
- `channel` (string): Limit to one channel by name or ID. Default: the whole server.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `has` (string): Only messages that carry this kind of content.
- `limit` (integer): Max results to return, 1 to 25. Default 10.
- `offset` (integer): Skip this many results, for paging. Default 0.
- `pinned` (boolean): Only pinned (true) or only unpinned (false) messages.
- `query` (string): Words to look for. Whole-word full text match, not substring. Optional if you filter by author, has, or pinned instead.
- `sort` (string): Order by newest first (recent, the default) or best match (relevant).

### `search_members` (~143 tokens)

Search members

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.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `limit` (integer): Max results. Default 25.
- `query` (string): Name prefix to search for (username or nickname).
- `role` (string): Role name or ID; returns members holding it.

### `get_member` (~71 tokens)

Get member

One member in detail: identity, nickname, roles by name, join date, and timeout state. Accepts a user ID or a name.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `user` (string, required): Member name or user ID.

### `find` (~101 tokens)

Find anything

Universal name resolver. Give it a name fragment and get ranked candidates across channels, roles, and members with their IDs. Use this when unsure what an entity is called or to grab an ID once and reuse it.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `query` (string, required): Name or fragment to look up.
- `types` (array): Restrict the search. Default: all three.

### `send_message` (~390 tokens)

Send message

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.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `components` (array): 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…
- `content` (string): Message text. May be left out when embeds, files, or components carry the message.
- `dry_run` (boolean): Preview without sending.
- `embeds` (array): 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.
- `files` (array): Up to 10 files to attach, each fetched from a public URL (20 MiB each). Needs the Attach Files permission.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `mentions` (string): Which mention types may ping. Default none.
- `reply_to` (string): Message to reply to: its ID or link.
- `silent` (boolean): Send without triggering notifications.

### `forward_message` (~159 tokens)

Forward message

Forward a message from one channel into another, the way the Discord client's forward does: the original travels along as a quoted snapshot. Works across channels in the server. An optional note is posted as its own message just before the forward, since Discord does not allow text on the forward itself.

Input parameters:

- `channel` (string, required): Channel to forward the message into (name or ID).
- `content` (string): Optional note, posted as a separate message just before the forward.
- `from_channel` (string, required): Channel the message is currently in (name or ID).
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `message_id` (string, required): The message to forward: its ID or link.

### `create_channel` (~559 tokens)

Create channel

Create a text, voice, forum, stage, announcement, or category channel, optionally inside a category, and optionally private or read-only from the start. private_to, read_only and posting_roles compile to permission overwrites and are applied in the same call, so a private channel is one request rather than a create followed by set_channel_permissions. Use set_channel_permissions for anything finer. Voice and forum settings (bitrate, user limit, region, default reaction, sort, layout, required tags) can be set at creation too. Supports dry_run.

Input parameters:

- `bitrate_kbps` (integer): Voice and stage audio quality in kbps. Up to 96 without boosts, 128, 256, and 384 at boost levels 1 to 3.
- `category` (string): Category name or ID to place the channel under.
- `default_layout` (string): Forum: list or gallery view.
- `default_reaction` (string): Forum: the emoji offered on every post, as a character or a custom emoji name; none to remove.
- `default_sort` (string): Forum: how posts are ordered.
- `dry_run` (boolean): Preview without creating.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `name` (string, required): Channel name.
- `nsfw` (boolean)
- `post_slowmode_seconds` (integer): Forum: the slowmode each new post starts with.
- `posting_roles` (array): Role names that may still post and start threads when read_only is set. Has no effect on its own.
- `private_to` (array): Role names that can see the channel. Everyone else is denied View Channel, and Connect too on voice, stage and category. Do not list @everyone.
- `read_only` (boolean): Deny sending to everyone, for rules and announcement channels.
- `region` (string): Voice region id such as us-east or rotterdam, or automatic.
- `require_tag` (boolean): Forum: posts must carry at least one tag.
- `slowmode_seconds` (integer): Per-user message cooldown.
- `thread_archive_minutes` (number): How long new threads stay open without activity: 60, 1440 (a day), 4320, or 10080 (a week).
- `topic` (string): Channel topic, for text-like channels.
- `type` (string): Channel type. Default text.
- `user_limit` (integer): Most people at once, 0 for no limit. Up to 99 in voice, 10000 in stage.
- `video_quality` (string): Camera quality in voice channels: auto, or full (720p).

### `create_role` (~329 tokens)

Create role

Create a role from a vetted preset (none, member, moderator, admin) and/or an explicit list of permission names. Administrator is never granted by a preset; it must be spelled out explicitly. Can start with a gradient or holographic color and an icon where the server has those features. Supports dry_run.

Input parameters:

- `color` (string): Hex color like #00b0f4.
- `dry_run` (boolean): Preview without creating.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `hoist` (boolean): Show members separately in the sidebar.
- `holographic` (boolean): Discord's holographic style, which uses its own three colors; false for a solid color. Needs the Enhanced Role Colors server feature.
- `icon_emoji` (string): A standard emoji shown beside members' names instead of an image, or none to remove. Needs boost level 2.
- `icon_url` (string): Public URL of a small image (png, jpeg, webp; 256 KB) shown beside members' names, or none to remove. Needs boost level 2.
- `mentionable` (boolean)
- `name` (string, required): Role name.
- `permissions` (array): Extra permission names, like manage_messages or ban_members.
- `preset` (string): Vetted permission bundle. Default none.
- `secondary_color` (string): A second hex color, so the role name shows a gradient from color to this one; none for a solid color. Needs the Enhanced Role Colors server feature.

### `assign_role` (~229 tokens)

Assign role

Give a member a role. Preflights the bot's role hierarchy so the failure mode is an explanation, not a 403. Supports dry_run. A role that would give the member moderator or admin powers (such as banning, kicking, or timing out members, deleting other people's messages, or managing the server, roles, or channels), or let them see channels hidden from them now, 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. Other roles are given at once.

Input parameters:

- `confirm_token` (string): 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_run` (boolean): Preview without assigning.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `member` (string, required): Member name or user ID.
- `reason` (string): Audit log reason.
- `role` (string, required): Role name or ID.

### `delete_message` (~183 tokens)

Delete message

Delete one message. Safe to call directly: the first call deletes nothing and returns a preview plus a confirm_token, and the deletion only happens when the call is repeated with that token. Use this two-step flow to let the user approve through the conversation rather than telling them to delete things by hand in Discord. Supports dry_run.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `message_id` (string, required): The message to delete: its ID or link.
- `reason` (string): Audit log reason.

### `list_reference_layouts` (~50 tokens)

List reference layouts

Curated server blueprints to start from: vetted structures for common server kinds. Fetch one with get_reference_layout, adapt names and channels to the user's theme, then stage it with plan_server_build.

### `get_reference_layout` (~56 tokens)

Get reference layout

One reference layout in full: the blueprint plus the reasoning behind its structure. Adapt it rather than applying it verbatim; the user's theme and wording should win.

Input parameters:

- `layout_id` (string, required): Layout ID from list_reference_layouts.

### `plan_server_build` (~311 tokens)

Plan server build

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.

Input parameters:

- `blueprint` (object, required): The desired structure: roles, categories, channels.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `remove` (object): Items to delete, by name or id. Deletions run last. The blueprint may be empty when only deleting.
- `update_existing` (boolean): Also change existing items to match the blueprint. Default false: reuse them as they are.

### `execute_build_plan` (~229 tokens)

Execute build plan

Execute a staged plan by plan_id, or pass a blueprint directly to build it additively. A plan that changes existing items runs exactly as staged or not at all: it is checked against the server again and refused if anything it would touch has changed since. Building goes in dependency order: roles, then categories, then channels, creating before changing. If a step fails, the run stops and the report says exactly what was created, changed, failed, and never attempted; plan again to finish. Afterwards the server is compared with the blueprint and anything that did not take effect is reported. A build that changes anything returns a change_id that undo_change reverses.

Input parameters:

- `blueprint` (object): Build this blueprint directly, skipping the staging step. Only adds; never changes existing items. Refused when the blueprint gives @everyone or an existing role powers in a new channel: stage that w…
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `plan_id` (string): A plan staged by plan_server_build.

### `update_channel` (~432 tokens)

Update channel

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.

Input parameters:

- `bitrate_kbps` (integer): Voice and stage audio quality in kbps. Up to 96 without boosts, 128, 256, and 384 at boost levels 1 to 3.
- `category` (string): Category name or ID, or "none" to remove.
- `channel` (string, required): Channel name or ID.
- `default_layout` (string): Forum: list or gallery view.
- `default_reaction` (string): Forum: the emoji offered on every post, as a character or a custom emoji name; none to remove.
- `default_sort` (string): Forum: how posts are ordered.
- `dry_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `name` (string)
- `nsfw` (boolean)
- `post_slowmode_seconds` (integer): Forum: the slowmode each new post starts with.
- `region` (string): Voice region id such as us-east or rotterdam, or automatic.
- `require_tag` (boolean): Forum: posts must carry at least one tag.
- `slowmode_seconds` (integer)
- `thread_archive_minutes` (number): How long new threads stay open without activity: 60, 1440 (a day), 4320, or 10080 (a week).
- `topic` (string)
- `user_limit` (integer): Most people at once, 0 for no limit. Up to 99 in voice, 10000 in stage.
- `video_quality` (string): Camera quality in voice channels: auto, or full (720p).

### `delete_channel` (~195 tokens)

Delete channel

Delete a channel or category. Safe to call directly: the first call deletes nothing and returns a preview plus a confirm_token, and the deletion only happens when the call is repeated with that token. When the user asks to delete something, call this and relay the preview for their go-ahead instead of sending them to do it manually in Discord; the gate exists exactly so deletion can be approved through the conversation. Deleting a category leaves its channels in place, uncategorized.

Input parameters:

- `channel` (string, required): Channel or category name or ID.
- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `reason` (string)

### `update_role` (~423 tokens)

Update role

Edit a role's name, color (solid, gradient, or holographic), icon, hoist, mentionable flag, or permissions. Passing preset and/or permissions replaces the role's permission set with the named bundle plus listed names. Only passed fields change. Supports dry_run. A permission change that would give the role moderator or admin powers (such as banning, kicking, or timing out members, deleting other people's messages, or managing the server, roles, or channels), or let it see channels it cannot see now, 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.

Input parameters:

- `color` (string): Hex color like #00b0f4.
- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `hoist` (boolean)
- `holographic` (boolean): Discord's holographic style, which uses its own three colors; false for a solid color. Needs the Enhanced Role Colors server feature.
- `icon_emoji` (string): A standard emoji shown beside members' names instead of an image, or none to remove. Needs boost level 2.
- `icon_url` (string): Public URL of a small image (png, jpeg, webp; 256 KB) shown beside members' names, or none to remove. Needs boost level 2.
- `mentionable` (boolean)
- `name` (string)
- `permissions` (array)
- `preset` (string)
- `role` (string, required): Role name or ID.
- `secondary_color` (string): A second hex color, so the role name shows a gradient from color to this one; none for a solid color. Needs the Enhanced Role Colors server feature.

### `delete_role` (~159 tokens)

Delete role

Delete a role. Members holding it simply lose it; nothing else changes. Safe to call directly: the first call deletes nothing and returns a preview plus a confirm_token, and the deletion only happens when the call is repeated with that token. Prefer this gated flow over telling the user to delete the role manually.

Input parameters:

- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `reason` (string)
- `role` (string, required): Role name or ID.

### `edit_message` (~226 tokens)

Edit message

Edit a message the bot itself sent, or one posted through one of the server's webhooks (that needs Manage Webhooks). Discord does not allow editing anyone else's messages, no matter the permission level. A message sent as a Components V2 layout stays one: edit it with components, never with content or embeds.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `components` (array): 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…
- `content` (string)
- `embeds` (array): 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.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `message_id` (string, required): Message ID, or the message's link.

### `pin_message` (~94 tokens)

Pin message

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

Input parameters:

- `channel` (string, required): Channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `message_id` (string, required): Message ID, or the message's link.
- `reason` (string)

### `unpin_message` (~76 tokens)

Unpin message

Unpin a message. The message itself is untouched.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `message_id` (string, required): Message ID, or the message's link.
- `reason` (string)

### `list_pinned_messages` (~54 tokens)

List pinned messages

Pinned messages in a channel, newest pin first.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `set_voice_channel_status` (~118 tokens)

Set voice channel status

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.

Input parameters:

- `channel` (string, required): Voice channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `status` (string, required): Status text. Empty clears it.

### `timeout_member` (~188 tokens)

Timeout member

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.

Input parameters:

- `confirm_token` (string): 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_run` (boolean)
- `duration_minutes` (integer, required): Timeout length in minutes, up to 40320 (28 days).
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `member` (string, required): Member name or user ID.
- `reason` (string)

### `remove_timeout` (~157 tokens)

Remove timeout

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.

Input parameters:

- `confirm_token` (string): 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.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `member` (string, required): Member name or user ID.
- `reason` (string)

### `kick_member` (~157 tokens)

Kick member

Remove a member from the server. They can rejoin with a new invite. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token performs the kick. Relay the preview for the user's go-ahead instead of doing nothing.

Input parameters:

- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `member` (string, required): Member name or user ID.
- `reason` (string)

### `ban_member` (~197 tokens)

Ban member

Ban a user from the server, optionally deleting their recent messages. Works on users who already left (pass their user ID). Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token performs the ban. Relay the preview for the user's go-ahead.

Input parameters:

- `confirm_token` (string): 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.
- `delete_message_seconds` (integer): Also delete their messages from the last N seconds, up to 604800 (7 days).
- `dry_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `reason` (string)
- `user` (string, required): Member name, or a user ID for someone not in the server.

### `unban_member` (~138 tokens)

Unban member

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.

Input parameters:

- `confirm_token` (string): 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.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `reason` (string)
- `user_id` (string, required): The banned user's ID.

### `bulk_ban` (~160 tokens)

Bulk ban

Ban up to 200 users at once by ID, for raid cleanup. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token performs the bans. Reports which bans succeeded and which failed.

Input parameters:

- `confirm_token` (string): 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.
- `delete_message_seconds` (integer)
- `dry_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `reason` (string)
- `user_ids` (array, required): User IDs to ban.

### `list_bans` (~64 tokens)

List bans

Current bans with reasons, paged.

Input parameters:

- `after` (string): User ID cursor for paging.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `limit` (integer): Max entries. Default 50.

### `get_audit_log` (~173 tokens)

Get audit log

Discord's historical record of administrative actions: who did what, to what, when, and why. Use this to investigate what already happened; for activity as it happens use subscribe_events. Filter by action name (like channel_create, member_ban_add, message_delete) or by the acting user. Discord merges some actions repeated in quick succession (message deletes, member moves and disconnects, channel and role reordering) into one entry that keeps only the first reason.

Input parameters:

- `action` (string): Action name filter, like channel_delete or member_kick.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `limit` (integer): Max entries. Default 25.
- `user` (string): Only entries by this user (name or ID).

### `set_incident_actions` (~284 tokens)

Pause invites and DMs

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.

Input parameters:

- `confirm_token` (string): 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.
- `dms` (number): Hours to pause DMs between non-friend members, up to 24. Use 0 to resume, or omit to leave them unchanged.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `invites` (number): Hours to pause new invites, up to 24. Use 0 to resume invites, or omit to leave them unchanged.

### `add_reactions` (~101 tokens)

Add reactions

Add one or more reactions to a message in a single call. Takes unicode emoji directly or custom emoji by name.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `emojis` (array, required): Emoji to add, like a pasted emoji or a custom emoji name.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `message_id` (string, required): Message ID, or the message's link.

### `remove_reaction` (~104 tokens)

Remove reaction

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

Input parameters:

- `channel` (string, required): Channel name or ID.
- `emoji` (string, required)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `message_id` (string, required): Message ID, or the message's link.
- `user` (string): Whose reaction to remove; omit for the bot's own.

### `clear_reactions` (~173 tokens)

Clear reactions

Clear all reactions from a message, or all of one emoji. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token executes. Relay the preview for the user's go-ahead.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `confirm_token` (string): 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_run` (boolean)
- `emoji` (string): Only clear this emoji; omit to clear everything.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `message_id` (string, required): Message ID, or the message's link.

### `get_reactions` (~88 tokens)

Get reactions

Who reacted to a message with a given emoji.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `emoji` (string, required)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `limit` (integer): Max users. Default 25.
- `message_id` (string, required): Message ID, or the message's link.

### `create_poll` (~121 tokens)

Create poll

Post a native Discord poll: a question, two to ten answers, and a duration of up to 32 days.

Input parameters:

- `answers` (array, required)
- `channel` (string, required): Channel name or ID.
- `content` (string): Optional message text above the poll.
- `duration_hours` (integer): How long the poll runs. Default 24.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `multi_select` (boolean): Allow choosing several answers.
- `question` (string, required)

### `get_poll_results` (~121 tokens)

Get poll results

Current tallies for a poll message. With include_voters, also who voted for each answer.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `include_voters` (boolean): Also list the people who chose each answer.
- `message_id` (string, required): Message ID, or the message's link.
- `voters_per_answer` (integer): How many voters to list per answer when include_voters is on. Default 100.

### `end_poll` (~171 tokens)

End poll

Close one of the bot's own polls early and finalize the results. Voting stops for good, since a poll cannot be reopened. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token ends the poll. A poll that has already closed is left alone.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `message_id` (string, required): Message ID, or the message's link.

### `create_invite` (~332 tokens)

Create invite

Create an invite link for a channel. Defaults are deliberate: expires in 24 hours, unlimited uses. A never-expiring invite must be asked for explicitly with max_age_seconds 0. roles gives roles to whoever joins with it, and for_users limits it to particular people. An invite whose roles would give moderator or admin powers (such as banning, kicking, or timing out members, deleting other people's messages, or managing the server, roles, or channels), or open channels, 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.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `confirm_token` (string): 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_run` (boolean)
- `for_users` (array): User IDs of the only people who can use it (up to 1000). They need not be in the server yet.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `max_age_seconds` (integer): Lifetime in seconds, 0 for never. Default 86400 (24h).
- `max_uses` (integer): Use limit, 0 for unlimited. Default 0.
- `roles` (array): Role names or IDs given to everyone who joins with this invite. Needs Manage Roles.
- `temporary` (boolean): Members who join leave again when they disconnect.

### `list_invites` (~51 tokens)

List invites

Active invites for the server or one channel.

Input parameters:

- `channel` (string): Limit to one channel.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `get_invite` (~53 tokens)

Get invite

Inspect an invite code: where it leads, how used it is, the roles it gives, and whether it is limited to particular people.

Input parameters:

- `code` (string, required): The invite code, with or without discord.gg/.

### `delete_invite` (~134 tokens)

Delete invite

Revoke an invite link. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token revokes it.

Input parameters:

- `code` (string, required): The invite code to revoke.
- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `reason` (string)

### `list_webhooks` (~52 tokens)

List webhooks

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

Input parameters:

- `channel` (string)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `create_webhook` (~99 tokens)

Create webhook

Create an incoming webhook on a channel. Webhooks post with any display name and avatar, which is how messages 'as someone' work legitimately.

Input parameters:

- `avatar_url` (string): Image for the webhook's default avatar, up to 1 MB.
- `channel` (string, required): Channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `name` (string, required)

### `update_webhook` (~86 tokens)

Update webhook

Rename a webhook, change its avatar, or move it to another channel.

Input parameters:

- `avatar_url` (string)
- `channel` (string): Move the webhook to this channel.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `name` (string)
- `webhook` (string, required): Webhook name or ID.

### `delete_webhook` (~139 tokens)

Delete webhook

Delete a webhook. Anything still posting through it stops working. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token deletes it.

Input parameters:

- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `reason` (string)
- `webhook` (string, required): Webhook name or ID.

### `send_webhook_message` (~178 tokens)

Send webhook message

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

Input parameters:

- `avatar_url_override` (string)
- `content` (string)
- `embeds` (array): 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.
- `files` (array): Up to 10 files to attach, each fetched from a public URL (20 MiB each). Needs the Attach Files permission.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `username_override` (string)
- `webhook` (string, required): Webhook name or ID.

### `list_emojis` (~41 tokens)

List emojis

Custom emojis in the server, with usage syntax.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `create_emoji` (~77 tokens)

Create emoji

Upload a custom emoji from an image URL. Discord's limit for emoji files is 256 KB; png, jpeg, gif, and webp work.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `image_url` (string, required)
- `name` (string, required)

### `update_emoji` (~55 tokens)

Update emoji

Rename a custom emoji.

Input parameters:

- `emoji` (string, required): Current emoji name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `name` (string, required)

### `delete_emoji` (~124 tokens)

Delete emoji

Delete a custom emoji. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token deletes it.

Input parameters:

- `confirm_token` (string): 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_run` (boolean)
- `emoji` (string, required): Emoji name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `list_events` (~71 tokens)

List events

Scheduled community events (the kind members RSVP to), with type, time, status, and interest counts. For pending scheduled messages see list_scheduled_messages; for live event subscriptions see list_event_subscriptions.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `get_event` (~47 tokens)

Get event

One scheduled event in detail.

Input parameters:

- `event` (string, required): Event name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `create_event` (~226 tokens)

Create event

Create a Discord scheduled community event that members see on the events list and can mark interest in: a voice, stage, or external (in-person or off-platform) event. This is not for sending a message later (use schedule_message) or watching live activity (use subscribe_events). Voice and stage events need a channel; external events need a location and an end time.

Input parameters:

- `channel` (string): Voice or stage channel, for those event types.
- `description` (string)
- `end_time` (string): Required for external events.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `location` (string): Where an external event happens.
- `name` (string, required)
- `repeat` (string): Repeat the event. weekly and biweekly recur on the start's weekday; monthly recurs on the same weekday and week of the month.
- `start_time` (string, required): ISO time, like 2026-07-01T19:00:00Z.
- `type` (string, required)

### `update_event` (~196 tokens)

Update event

Edit a scheduled event's details, or move it through its lifecycle: status start makes it live, status end completes it. An ended event cannot be started again, so ending one 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. Everything else happens at once.

Input parameters:

- `confirm_token` (string): 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.
- `description` (string)
- `end_time` (string)
- `event` (string, required): Event name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `location` (string)
- `name` (string)
- `start_time` (string)
- `status` (string)

### `cancel_event` (~132 tokens)

Cancel event

Cancel and remove a scheduled event. Interested members lose the listing. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token cancels it.

Input parameters:

- `confirm_token` (string): 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_run` (boolean)
- `event` (string, required): Event name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `get_event_attendees` (~65 tokens)

Get event attendees

Members who marked themselves interested in an event.

Input parameters:

- `event` (string, required): Event name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `limit` (integer): Max entries. Default 25.

### `subscribe_events` (~212 tokens)

Subscribe to events

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.

Input parameters:

- `channel` (string): Only record events from this channel.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `include_bots` (boolean): Also record events caused by bots, including this one. Default false.
- `types` (array, required): Which event types to record.

### `get_recent_events` (~44 tokens)

Get recent events

Read and clear buffered events from a subscription, oldest first.

Input parameters:

- `limit` (integer): Max events to return. Default 25.
- `subscription_id` (string, required)

### `list_event_subscriptions` (~18 tokens)

List event subscriptions

Active event subscriptions and their buffer sizes.

### `unsubscribe_events` (~25 tokens)

Unsubscribe from events

Stop recording and discard a subscription's buffer.

Input parameters:

- `subscription_id` (string, required)

### `create_thread` (~171 tokens)

Create thread

Start a thread in a text or announcement channel: standalone, branched from a message when message_id is given, or private (invite-only) when asked. For a post in a forum channel, use create_forum_post instead.

Input parameters:

- `auto_archive_minutes` (number): Inactivity timeout: 60, 1440, 4320, or 10080. Default 1440.
- `channel` (string, required): Parent channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `message_id` (string): Branch the thread from this message (its ID or link).
- `name` (string, required)
- `private` (boolean): Invite-only thread; only works standalone.
- `slowmode_seconds` (integer)

### `list_threads` (~80 tokens)

List threads

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

Input parameters:

- `channel` (string): Limit to threads under this channel.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `include_archived` (boolean): Also list archived threads; needs channel.

### `get_thread` (~51 tokens)

Get thread

One thread's settings, state, and counts.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `thread` (string, required): Thread name or ID.

### `update_thread` (~106 tokens)

Update thread

Rename a thread, archive or unarchive it, lock or unlock it, or change its slowmode and auto-archive window.

Input parameters:

- `archived` (boolean)
- `auto_archive_minutes` (number)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `locked` (boolean)
- `name` (string)
- `slowmode_seconds` (integer)
- `thread` (string, required): Thread name or ID.

### `delete_thread` (~139 tokens)

Delete thread

Delete a thread and its messages. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token deletes it. Archiving is the reversible alternative.

Input parameters:

- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `reason` (string)
- `thread` (string, required): Thread name or ID.

### `list_thread_members` (~48 tokens)

List thread members

Who is in a thread.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `thread` (string, required): Thread name or ID.

### `add_thread_member` (~152 tokens)

Add thread member

Pull a member into a thread. Adding someone to a private thread they cannot see now lets them read all of it, earlier messages included, so that needs confirming: the first call changes nothing and returns a preview and a confirm_token, and repeating the call with the token adds them.

Input parameters:

- `confirm_token` (string): 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.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `member` (string, required): Member name or user ID.
- `thread` (string, required): Thread name or ID.

### `remove_thread_member` (~65 tokens)

Remove thread member

Remove a member from a thread. Needs Manage Threads.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `member` (string, required): Member name or user ID.
- `thread` (string, required): Thread name or ID.

### `create_forum_post` (~136 tokens)

Create forum post

Start a post in a forum channel: a title, the opening message, optional tags from the forum's tag list, and up to 10 files fetched from public URLs.

Input parameters:

- `content` (string, required)
- `files` (array): Up to 10 files to attach, each fetched from a public URL (20 MiB each). Needs the Attach Files permission.
- `forum` (string, required): Forum channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `tags` (array): Tag names to apply.
- `title` (string, required)

### `list_forum_posts` (~79 tokens)

List forum posts

Posts in a forum, filterable by tag, optionally archived too.

Input parameters:

- `forum` (string, required): Forum channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `include_archived` (boolean)
- `tag` (string): Only posts carrying this tag.

### `reply_to_forum_post` (~128 tokens)

Reply to forum post

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

Input parameters:

- `content` (string): Reply text. May be left out when embeds carry the reply.
- `embeds` (array): 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.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `post` (string, required): Post title or thread ID.

### `update_forum_post` (~111 tokens)

Update forum post

Edit a post's title or tags, pin or unpin it within the forum, lock or unlock replies, or archive it.

Input parameters:

- `archived` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `locked` (boolean)
- `pinned` (boolean)
- `post` (string, required): Post title or thread ID.
- `tags` (array): Replace the applied tags with these.
- `title` (string)

### `delete_forum_post` (~138 tokens)

Delete forum post

Delete a forum post and every reply in it. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token deletes it.

Input parameters:

- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `post` (string, required): Post title or thread ID.
- `reason` (string)

### `create_forum_tag` (~81 tokens)

Create forum tag

Add a tag to a forum's tag list. Moderated tags can only be applied by people with Manage Threads.

Input parameters:

- `forum` (string, required): Forum channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `moderated` (boolean)
- `name` (string, required)

### `update_forum_tag` (~78 tokens)

Update forum tag

Rename a forum tag or change its moderated flag.

Input parameters:

- `forum` (string, required): Forum channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `moderated` (boolean)
- `name` (string)
- `tag` (string, required): Current tag name.

### `delete_forum_tag` (~146 tokens)

Delete forum tag

Remove a tag from a forum; posts carrying it simply lose it. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token removes it.

Input parameters:

- `confirm_token` (string): 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_run` (boolean)
- `forum` (string, required): Forum channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `tag` (string, required): Tag name to remove.

### `list_automod_rules` (~43 tokens)

List AutoMod rules

Server-side automatic moderation rules and what they do.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `create_automod_rule` (~338 tokens)

Create AutoMod rule

Create a server-side moderation rule that runs on Discord's own infrastructure: Discord-maintained preset word lists (slurs, profanity, sexual content), custom keyword filters (with optional regex), spam detection, mention-flood limits, or member_profile checks on usernames, nicknames, and bios (Community servers only). For slur or hate-speech filtering prefer trigger keyword_preset with the slurs preset: Discord maintains the word list, so none needs to be written. Actions: block the message, alert a channel, and/or time the sender out (timeout is not available on spam, keyword_preset, or member_profile rules). On member_profile rules block quarantines the member until they fix their profile.

Input parameters:

- `actions` (array, required): What happens on a match.
- `alert_channel` (string): Where alert actions post.
- `allow_list` (array): Words exempt from keyword and keyword_preset rules.
- `enabled` (boolean): Default true.
- `exempt_channels` (array)
- `exempt_roles` (array)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `keywords` (array): For keyword rules. Wildcards: word* matches prefixes.
- `mention_limit` (integer): For mention_spam rules: max unique mentions per message.
- `name` (string, required)
- `presets` (array): For keyword_preset rules: Discord-maintained lists.
- `regex_patterns` (array): For keyword rules; Rust-flavored regex.
- `timeout_minutes` (integer): How long timeout actions last.
- `trigger` (string, required)

### `update_automod_rule` (~199 tokens)

Update AutoMod rule

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.

Input parameters:

- `confirm_token` (string): 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.
- `enabled` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `keywords` (array): Replaces the keyword list on keyword rules.
- `name` (string)
- `rule` (string, required): Rule name or ID.

### `delete_automod_rule` (~146 tokens)

Delete AutoMod rule

Delete an AutoMod rule; its protection stops immediately. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token deletes it. Turning it off with update_automod_rule is the reversible alternative.

Input parameters:

- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `rule` (string, required): Rule name or ID.

### `update_server` (~485 tokens)

Update server

Edit server settings: name, description, icon, banner, invite background, AFK behavior, system and rules channels, verification level, explicit media filter, and default notifications. Images come from public URLs. Only passed fields change. Descriptions need a Community server; the banner and invite background need boosts. A lower verification level, a weaker media filter, or turning Community off lowers the server's protection, 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. Raising them, and every other setting, happens at once.

Input parameters:

- `afk_channel` (string): Voice channel name or ID, or none to clear.
- `afk_timeout_seconds` (number)
- `banner_url` (string): Public URL of the banner shown at the top of the channel list, or none. Needs boost level 2.
- `community` (boolean): Enable or disable the Community feature. Enabling needs rules_channel and public_updates_channel.
- `confirm_token` (string): 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.
- `default_notifications` (string): What new members are notified of by default.
- `description` (string)
- `discovery_background_url` (string): Public URL of the Server Discovery background, or none. Needs a discoverable server.
- `dry_run` (boolean)
- `explicit_media_filter` (string): Which members' images Discord scans for explicit content.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `icon_url` (string): Public URL of the new server icon (png, jpeg, gif, webp), or none to remove it. A gif needs the animated icon feature.
- `invite_background_url` (string): Public URL of the invite page background (the splash), or none. Needs boost level 1.
- `name` (string)
- `public_updates_channel` (string): Text channel for Discord's mod updates, when enabling Community.
- `rules_channel` (string): Text channel for the rules, when enabling Community.
- `system_channel` (string): Channel for join notices, or none to clear.
- `verification_level` (string)

### `get_server_preview` (~61 tokens)

Get server preview

A server's preview: name, description, and approximate member counts. Works for servers the bot is in; other servers need to be discoverable.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `get_server_widget` (~40 tokens)

Get server widget

Widget settings: enabled state and invite channel.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `update_server_widget` (~197 tokens)

Update server widget

Enable or disable the widget, or point its invite channel. An enabled widget shows the server's name, who is online, and its voice channels to anyone on the web, and with an invite channel it lets anyone join. So turning it on, or pointing it at an invite channel while it is on, 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. Turning it off or clearing the channel happens at once.

Input parameters:

- `channel` (string): Invite channel name or ID, or none to clear.
- `confirm_token` (string): 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.
- `enabled` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `get_welcome_screen` (~43 tokens)

Get welcome screen

The Community welcome screen, when the server has one.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `update_welcome_screen` (~68 tokens)

Update welcome screen

Edit the Community welcome screen: the description and up to five channel cards.

Input parameters:

- `channels` (array)
- `description` (string)
- `enabled` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `get_onboarding` (~40 tokens)

Get onboarding

The new-member onboarding flow, when configured.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `update_onboarding` (~232 tokens)

Update onboarding

Configure the new-member onboarding flow on a Community server: prompts with options that grant channels and roles, the default channels every member sees, and the enabled state. Discord's app asks for at least seven default channels when configuring this by hand; the API has been observed to accept fewer. Members pick these options themselves, so offering a role that gives moderator or admin powers, or opens channels hidden from everyone, needs confirming: the first call changes nothing and returns a preview and a confirm_token, and repeating the call with the token saves it.

Input parameters:

- `confirm_token` (string): 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.
- `default_channels` (array): Channel names or IDs every new member gets.
- `enabled` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `mode` (string): default counts only default channels toward the constraints; advanced counts prompt option channels too.
- `prompts` (array)

### `list_integrations` (~42 tokens)

List integrations

Installed integrations: bots, Twitch and YouTube links.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `delete_integration` (~136 tokens)

Delete integration

Remove an integration from the server. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token removes it.

Input parameters:

- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `integration_id` (string, required): Integration ID from list_integrations.
- `reason` (string)

### `list_server_templates` (~38 tokens)

List server templates

Discord templates created from this server.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `create_server_template` (~65 tokens)

Create server template

Snapshot this server's structure as a Discord template others can create servers from. One template per server.

Input parameters:

- `description` (string)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `name` (string, required)

### `sync_server_template` (~61 tokens)

Sync server template

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

Input parameters:

- `code` (string, required): Template code from list_server_templates, or its discord.new link.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `delete_server_template` (~134 tokens)

Delete server template

Delete a server template; its share link stops working. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token deletes it.

Input parameters:

- `code` (string, required): Template code, or its discord.new link.
- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `prune_members` (~163 tokens)

Prune members

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.

Input parameters:

- `confirm_token` (string): 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.
- `days` (integer, required): Inactivity threshold in days.
- `dry_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `reason` (string)

### `set_bot_presence` (~54 tokens)

Set bot presence

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

Input parameters:

- `activity_text` (string): Custom status text shown under the bot's name.
- `status` (string, required)

### `list_stickers` (~37 tokens)

List stickers

Custom stickers in the server.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `create_sticker` (~120 tokens)

Create sticker

Upload a custom sticker from an image URL. Discord requires png, apng, or gif at 320x320 pixels and up to 512 KB. Servers start with five sticker slots; boosts add more.

Input parameters:

- `description` (string): Empty or 2-100 characters.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `image_url` (string, required)
- `name` (string, required)
- `tags` (string, required): Comma separated keywords, or one emoji name for autocomplete.

### `update_sticker` (~73 tokens)

Update sticker

Rename a sticker or change its description and tags.

Input parameters:

- `description` (string)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `name` (string)
- `sticker` (string, required): Sticker name or ID.
- `tags` (string)

### `delete_sticker` (~124 tokens)

Delete sticker

Delete a custom sticker. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token deletes it.

Input parameters:

- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `sticker` (string, required): Sticker name or ID.

### `list_soundboard_sounds` (~41 tokens)

List soundboard sounds

Custom soundboard sounds in the server.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `create_soundboard_sound` (~113 tokens)

Create soundboard sound

Upload a soundboard sound from an audio URL: mp3 or ogg, up to 512 KB and 5.2 seconds. Servers start with eight sound slots; boosts add more.

Input parameters:

- `emoji` (string): An emoji to show with the sound.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `name` (string, required)
- `sound_url` (string, required)
- `volume` (number): Playback volume. Default 1.

### `update_soundboard_sound` (~67 tokens)

Update soundboard sound

Rename a soundboard sound or change its volume.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `name` (string)
- `sound` (string, required): Sound name or ID.
- `volume` (number)

### `delete_soundboard_sound` (~126 tokens)

Delete soundboard sound

Delete a soundboard sound. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token deletes it.

Input parameters:

- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `sound` (string, required): Sound name or ID.

### `save_blueprint` (~61 tokens)

Save blueprint

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.

Input parameters:

- `blueprint` (object, required)
- `description` (string)
- `name` (string, required)

### `list_blueprints` (~17 tokens)

List blueprints

Saved blueprints in the local store.

### `get_blueprint` (~31 tokens)

Get blueprint

One saved blueprint in full, by name or ID.

Input parameters:

- `blueprint` (string, required): Blueprint name or ID.

### `delete_blueprint` (~113 tokens)

Delete blueprint

Delete a saved blueprint from the local store. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token deletes it. Servers built from it are untouched.

Input parameters:

- `blueprint` (string, required): Blueprint name or ID.
- `confirm_token` (string): 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_run` (boolean)

### `export_server_blueprint` (~146 tokens)

Export server blueprint

Snapshot a live server's structure into a blueprint: roles, categories, channels, and their visibility, with permission overwrites decompiled back into private_to and read_only where they fit and warnings where they do not. Each item carries its id, so editing the export and planning it with update_existing renames and changes those exact items. Optionally save the result straight to the store with save_as.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `include_ids` (boolean): Default true. False for a design meant for other servers.
- `save_as` (string): Save the export under this blueprint name.

### `import_server_template` (~133 tokens)

Import server template

Turn a Discord server template link (discord.new/CODE or discord.com/template/CODE) into a blueprint: its roles, categories, channels, and who can see and post where. Nothing is built; plan the result with plan_server_build to build it on a server, after editing it if wanted. Optionally save it with save_as. The template's server settings (verification level, media filter, notifications) are listed for update_server, since blueprints do not carry them.

Input parameters:

- `save_as` (string): Save the blueprint under this name.
- `template` (string, required): The template link or its code.

### `diff_blueprint` (~141 tokens)

Diff blueprint

Compare a blueprint against the live server: what the blueprint expects but the server lacks (missing), what exists but differs (changed, with the fields), and what the server has that the blueprint never mentioned (extra, informational). Reads the blueprint as the whole truth, so a setting it leaves out counts as its default. The drift detector for config-as-code workflows. To act on it, plan_server_build applies changes with update_existing and deletes extras listed in remove.

Input parameters:

- `blueprint` (required): A saved blueprint's name or ID, or a blueprint itself.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `list_changes` (~102 tokens)

List changes

Recent changes made through discord-mcp on a server, newest first: builds, and single creates, edits, and deletes of channels and roles, permission edits, roles given or taken, server settings edits. Each says what it did and whether it has been undone. The change_id is what undo_change takes.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `limit` (integer): Default 10.

### `undo_change` (~337 tokens)

Undo change

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.

Input parameters:

- `change_id` (string): One change, from list_changes or the tool that made it.
- `change_ids` (array): Several changes.
- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `since` (string): ISO date-time: undo every change made at or after it.

### `get_message` (~194 tokens)

Get message

Fetch one message in full: author, content, timestamps, attachments, embeds, reactions, and any reply reference. With include_images, also returns the message's pictures so you can look at them: attachments, embed images, layout media, and what a forwarded message carries.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `include_flagged` (boolean): Also return images Discord's scanning marked as explicit, gore, or self-harm. Off by default; turn on only when the user asks to review them.
- `include_images` (boolean): Return the message's images as images you can see. Off by default.
- `max_images` (integer): How many images to return with include_images. Default 4.
- `message_id` (string, required): Message ID, or the message's link.

### `send_dm` (~90 tokens)

Send direct message

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.

Input parameters:

- `content` (string, required)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `user` (string, required): Member name or user ID.

### `bulk_delete_messages` (~227 tokens)

Bulk delete messages

Delete many recent messages at once (2 to 100), optionally filtered by author or text. Discord cannot bulk delete messages older than 14 days. Safe to call directly: the first call returns how many it would remove, with a sample of them, plus a confirm_token; repeating the call with the token deletes those same messages. Messages posted after the preview are left alone, so it works in a busy channel, such as during a raid.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `confirm_token` (string): 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.
- `contains` (string): Only delete messages containing this text.
- `count` (integer): How many recent messages to scan. Default 50.
- `dry_run` (boolean)
- `from_author` (string): Only delete messages whose author name matches this.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `crosspost_message` (~74 tokens)

Crosspost message

Publish a message in an announcement channel out to every server that follows it.

Input parameters:

- `channel` (string, required): Announcement channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `message_id` (string, required): Message ID, or the message's link.

### `schedule_message` (~184 tokens)

Schedule message

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.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `content` (string, required)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `repeat` (string): Default none.
- `send_at` (string, required): When to send, ISO time like 2026-07-01T17:00:00Z.

### `list_scheduled_messages` (~59 tokens)

List scheduled messages

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

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `cancel_scheduled_message` (~133 tokens)

Cancel scheduled message

Cancel a pending scheduled message by its id. The queued text is gone for good, and a repeat stops, so the first call returns a preview and a confirm_token; repeating the call with the token cancels it.

Input parameters:

- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `schedule_id` (string, required)

### `update_member` (~262 tokens)

Update member

Edit a member's nickname or voice state. Voice changes (server mute, server deafen, move to another voice channel) only apply while the member is connected to voice. Role changes go through assign_role and remove_role. Moving someone into a voice channel they cannot join themselves lets them hear it, and lifting a server mute or deafen undoes what a moderator did, so those need confirming: the first call changes nothing and returns a preview and a confirm_token, and repeating the call with the token makes the change. Everything else, muting and deafening included, happens at once.

Input parameters:

- `confirm_token` (string): 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.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `member` (string, required): Member name or user ID.
- `move_to_voice` (string): Voice channel name or ID to move the member into.
- `nickname` (string): New nickname, or empty string to clear it.
- `reason` (string)
- `server_deafen` (boolean)
- `server_mute` (boolean)

### `disconnect_member` (~72 tokens)

Disconnect member from voice

Remove a member from whatever voice channel they are in. They stay in the server; only the voice connection ends.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `member` (string, required): Member name or user ID.
- `reason` (string)

### `list_voice_members` (~83 tokens)

List voice members

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.

Input parameters:

- `channel` (string, required): Voice or stage channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `remove_role` (~202 tokens)

Remove role

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.

Input parameters:

- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `member` (string, required): Member name or user ID.
- `reason` (string)
- `role` (string, required): Role name or ID.

### `get_member_permissions` (~106 tokens)

Get member permissions

The effective permissions a member has, server-wide or in a specific channel once role and overwrite resolution is applied, in plain language. Uses Discord's own permission check when Discord gives one, which includes its implicit rules; source says which.

Input parameters:

- `channel` (string): Resolve permissions in this channel instead of server-wide.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `member` (string, required): Member name or user ID.

### `get_channel_permissions` (~59 tokens)

Get channel permissions

The permission overwrites on a channel, resolved into plain language per role and member.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `set_channel_permissions` (~327 tokens)

Set channel permissions

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.

Input parameters:

- `allow` (array): Permissions to allow.
- `channel` (string, required): Channel name or ID.
- `confirm_token` (string): 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.
- `deny` (array): Permissions to deny.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `target` (string, required): Role or member name or ID.

### `clear_channel_permissions` (~271 tokens)

Clear channel permissions

Remove a role's or member's permission overwrite from a channel, so their permissions there come from their roles and the other overwrites. 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. Removing one that keeps someone out (a private channel's denial for @everyone, say) needs confirming, as does one whose removal gives moderator or admin powers (such as banning, kicking, or timing out members, deleting other people's messages, or managing the server, roles, or channels): the first call changes nothing and returns a preview and a confirm_token, and repeating the call with the token makes the change.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `confirm_token` (string): 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.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `target` (string, required): Role or member name or ID.

### `lock_channel` (~106 tokens)

Lock channel

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.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `reason` (string)

### `unlock_channel` (~187 tokens)

Unlock channel

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.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `confirm_token` (string): 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.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `reason` (string)

### `explain_permissions` (~140 tokens)

Explain permissions

Answer whether an actor (the bot, or a member) has a given permission, server-wide or in a channel, and explain the result through the role and overwrite chain. The answer is Discord's own permission check when Discord gives one, so it includes the implicit rules (a missing View Channel cancels what depends on it).

Input parameters:

- `actor` (string, required): A member name or ID, or "bot".
- `channel` (string): Check in this channel instead of server-wide.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `permission` (string, required): Permission name, like manage_messages.

### `get_channel` (~69 tokens)

Get channel

Full detail for one channel: type, topic, category, slowmode, NSFW flag, and a count of its permission overwrites.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `clone_channel` (~81 tokens)

Clone channel

Copy a channel's settings and permission overwrites into a new channel in the same category.

Input parameters:

- `channel` (string, required): Channel name or ID to copy.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `new_name` (string): Name for the copy. Defaults to the original plus -copy.

### `clone_role` (~66 tokens)

Clone role

Copy a role's permissions, color, and settings into a new role.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `new_name` (string)
- `role` (string, required): Role name or ID to copy.

### `reorder_channels` (~54 tokens)

Reorder channels

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

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `moves` (array, required)

### `reorder_roles` (~167 tokens)

Reorder roles

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.

Input parameters:

- `confirm_token` (string): 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.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `moves` (array, required)

### `follow_announcement_channel` (~79 tokens)

Follow announcement channel

Subscribe a channel to an announcement channel, so crossposted messages from the source appear in the target.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `source` (string, required): Announcement channel name or ID to follow.
- `target` (string, required): Channel where its posts should appear.

### `bulk_update_roles` (~160 tokens)

Bulk update roles

Add or remove a role across every member matching a filter. Safe to call directly: the first call returns the affected count and a confirm_token; repeating the call with the token applies the change. Walks up to 3000 members and reports if it hits the cap.

Input parameters:

- `action` (string, required)
- `confirm_token` (string): 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_run` (boolean)
- `filter` (object)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `role` (string, required): Role name or ID.

### `list_stages` (~41 tokens)

List live stages

Stage channels that currently have a live stage running.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `start_stage` (~86 tokens)

Start stage

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

Input parameters:

- `channel` (string, required): Stage channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `notify` (boolean): Notify members that the stage started. Needs Mention Everyone.
- `topic` (string, required)

### `update_stage` (~57 tokens)

Update stage

Change the topic of a live stage.

Input parameters:

- `channel` (string, required): Stage channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `topic` (string, required)

### `end_stage` (~127 tokens)

End stage

End the live stage on a stage channel. It ends for everyone listening, so the first call returns a preview and a confirm_token; repeating the call with the token ends it.

Input parameters:

- `channel` (string, required): Stage channel name or ID.
- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `list_servers` (~67 tokens)

List servers

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.

### `list_members` (~89 tokens)

List members

A paged roster of server members. Pass after with the last id to continue. For finding specific people, search_members is better.

Input parameters:

- `after` (string): User id cursor to page past.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `limit` (integer): How many, up to 1000. Default 100.

### `get_role_members` (~64 tokens)

Get role members

The members who currently hold a given role.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `limit` (integer): Max results. Default 50.
- `role` (string, required): Role name or ID.

### `list_app_commands` (~116 tokens)

List app commands

The slash commands this bot's application has registered. Omit guild for the global set, or pass a guild for that server's set. Guild commands and global commands are separate lists; a name can exist in both.

Input parameters:

- `bot` (string): 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.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `register_app_command` (~175 tokens)

Register app command

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.

Input parameters:

- `bot` (string): 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.
- `description` (string, required): Shown to users in the command picker.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `name` (string, required): Command name without the slash, lowercase, no spaces.
- `options` (array): Arguments the command takes.

### `update_app_command` (~143 tokens)

Update app command

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.

Input parameters:

- `bot` (string): 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.
- `command` (string, required): Command name or ID.
- `description` (string): New description.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `options` (array): Replacement option list, replacing the existing one entirely.

### `delete_app_command` (~173 tokens)

Delete app command

Unregister a slash command so it no longer appears for users. Safe to call directly: the first call changes nothing and returns a preview plus a confirm_token; repeating the call with the token removes it.

Input parameters:

- `bot` (string): 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.
- `command` (string, required): Command name or ID.
- `confirm_token` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `update_bot_profile` (~329 tokens)

Update bot profile

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.

Input parameters:

- `avatar_url` (string): Public URL of the avatar image (png, jpeg, gif, webp), or none.
- `banner_url` (string): Public URL of the profile banner image, or none.
- `bio` (string): Server only: the About Me shown in that server, or none. The bot's own About Me is set in the Developer Portal.
- `bot` (string): 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_run` (boolean)
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `nickname` (string): Server only: the name shown in that server, or none to show the username.
- `scope` (string): server (default) changes it in one server only; everywhere changes the bot's own profile.
- `username` (string): Everywhere only: the bot's username.

### `leave_server` (~172 tokens)

Leave server

Make the bot leave a server. It can only come back through a new invite from someone with Manage Server, and its own role there is deleted. Always previews first and asks for confirmation. The server must be named: this never falls back to the default one. When two of your bots are in the server, bot says which one leaves.

Input parameters:

- `bot` (string): 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.
- `confirm_token` (string): 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.
- `guild` (string, required): Server name or ID to leave.

### `audit_server_security` (~122 tokens)

Audit server security

Review a server's security the way an attacker would look at it, and list findings from high to low with a fix for each: powers held by everyone or by everyday roles, roles that can raise their own power through Manage Roles, bots with Administrator, powerful roles offered in onboarding or handed out by invites, 2FA for moderators, verification, the media filter, AutoMod, webhooks, and permanent invites. Read only; it changes nothing.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.

### `get_channel_access` (~140 tokens)

Get channel access

Who can see and use a channel: @everyone, each role that can see it (with how many members hold it, whether they can post or join, and any powers there), members with their own overwrite, and the owner. With include_members, also checks every member one by one, which is exact where roles combine. Read only.

Input parameters:

- `channel` (string, required): Channel name or ID.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `include_members` (boolean): Check each member and list who can see it (up to 100 names). Needs the Server Members intent.

### `get_member_access` (~105 tokens)

Get member access

What one member can reach across the server: their server-wide powers, every channel they can see (and whether they can post or join there), channels where they hold extra powers, and how many channels are closed to them. Read only. For why one permission is or is not there, use explain_permissions.

Input parameters:

- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `member` (string, required): Member name or user ID.

### `catch_up` (~257 tokens)

Catch up

What happened in a server recently, in one call: every channel and thread with new messages since a time (default the last 24 hours), busiest first, with who talked, the messages themselves (trimmed), @everyone pings, and, with mentions_of, the messages that mention a member. Quiet channels are skipped without being read. Read only. For one channel's full history use read_messages.

Input parameters:

- `channels` (array): Only these channels (names or IDs); a category means the channels in it. Default: every channel the bot can read.
- `guild` (string): Guild (server) name or ID. Omit to use the default guild.
- `hours` (number): How far back to look, in hours. Default 24, at most 14 days.
- `max_channels` (integer): Most channels and threads read, taking the most recently active. Default 12.
- `mentions_of` (string): A member name or ID; messages that mention them are listed on their own.
- `per_channel` (integer): Most messages read per channel. Default 30.
- `since` (string): Or an exact start time in ISO 8601, such as when the user was last here.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/orygnscode-discord-mcp/orygn-discord-mcp#diagnostics

## Score history

- 2026-11-21: 84
- 2026-11-20: 83
- 2026-11-19: 83
- 2026-11-18: 82
- 2026-11-17: 82
- 2026-11-16: 81
- 2026-11-15: 81
- 2026-11-14: 80
- 2026-11-13: 79
- 2026-11-12: 64

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

## Links

- npm package: https://www.npmjs.com/package/@orygn/discord-mcp
- Socket report: https://socket.dev/npm/package/@orygn/discord-mcp
- Repository: https://github.com/OrygnsCode/discord-mcp
- Changelog RSS feed: https://verifymcp.io/servers/orygnscode-discord-mcp/orygn-discord-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/orygnscode-discord-mcp/orygn-discord-mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/orygnscode-discord-mcp/orygn-discord-mcp.json
- HTML version of this page: https://verifymcp.io/servers/orygnscode-discord-mcp/orygn-discord-mcp
