discord-mcp

Delete channel

discord_delete_channel

DestructiveDry run by default

Toolset
Channels channels
Discord permission
Manage Channels
Context cost
280 tokens, estimated1,119 bytes of definition, divided by 4

Permanently delete a channel and all of its messages. IRREVERSIBLE. SAFE BY DEFAULT: dry_run is true unless explicitly set to false, so call it first to preview, then re-call with dry_run:false to actually delete. Deleting a category keeps its channels, which leave the category. A DM channel ID only closes the DM, which is reversible. Requires the Manage Channels permission, or Manage Threads for a thread. An optional reason is recorded in the audit log.

Risk and annotations

Read-onlyreadOnlyHintnoCan modify your server.
DestructivedestructiveHintyesMay perform destructive updates, so clients can ask before running it.
IdempotentidempotentHintnoRepeating the call can have an additional effect.
Open worldopenWorldHintyesInteracts with an external system: Discord.

Annotations are hints the server declares. Clients use them to decide when to ask you before a call.

Parameters

ParameterTypeRulesDescription
channel_idrequiredstring
pattern ^\d{17,20}$
ID (snowflake) of the channel to delete.
reasonoptionalstring
none
Optional reason recorded in the server audit log.
dry_runoptionalboolean
default true
If true (default), only reports which channel would be deleted without deleting it. Set false to actually delete.

Output

This tool declares no output schema. Its description says what it returns; this page shows no example rather than invent one.

Related tools

Also in Channels

Raw definition (1,119 bytes)
{
  "name": "discord_delete_channel",
  "description": "Permanently delete a channel and all of its messages. IRREVERSIBLE. SAFE BY DEFAULT: dry_run is true unless explicitly set to false, so call it first to preview, then re-call with dry_run:false to actually delete. Deleting a category keeps its channels, which leave the category. A DM channel ID only closes the DM, which is reversible. Requires the Manage Channels permission, or Manage Threads for a thread. An optional reason is recorded in the audit log.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "channel_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID (snowflake) of the channel to delete."
      },
      "reason": {
        "description": "Optional reason recorded in the server audit log.",
        "type": "string"
      },
      "dry_run": {
        "default": true,
        "description": "If true (default), only reports which channel would be deleted without deleting it. Set false to actually delete.",
        "type": "boolean"
      }
    },
    "required": [
      "channel_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Delete channel",
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": false,
    "openWorldHint": true
  }
}