discord-mcp

Bulk delete messages

discord_bulk_delete_messages

DestructiveDry run by default

Toolset
Messages messages
Discord permission
Manage Messages
Context cost
286 tokens, estimated1,143 bytes of definition, divided by 4

Permanently delete multiple recent messages in one call. IRREVERSIBLE. SAFE BY DEFAULT: dry_run is true unless explicitly set to false, so call it first to preview, then re-call with dry_run:false to actually delete. Discord only allows bulk-deleting messages younger than 14 days; older ones are skipped. Requires the Manage Messages permission, and refuses to run without Read Message History. Returns the number deleted.

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 or thread to delete messages from.
countrequiredinteger
2 to 100
Number of recent messages to delete (2–100).
dry_runoptionalboolean
default true
If true (default), only reports how many would be deleted without deleting. 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 Messages

Raw definition (1,143 bytes)
{
  "name": "discord_bulk_delete_messages",
  "description": "Permanently delete multiple recent messages in one call. IRREVERSIBLE. SAFE BY DEFAULT: dry_run is true unless explicitly set to false, so call it first to preview, then re-call with dry_run:false to actually delete. Discord only allows bulk-deleting messages younger than 14 days; older ones are skipped. Requires the Manage Messages permission, and refuses to run without Read Message History. Returns the number deleted.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "channel_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID (snowflake) of the channel or thread to delete messages from."
      },
      "count": {
        "type": "integer",
        "minimum": 2,
        "maximum": 100,
        "description": "Number of recent messages to delete (2–100)."
      },
      "dry_run": {
        "default": true,
        "description": "If true (default), only reports how many would be deleted without deleting. Set false to actually delete.",
        "type": "boolean"
      }
    },
    "required": [
      "channel_id",
      "count"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Bulk delete messages",
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": false,
    "openWorldHint": true
  }
}