discord-mcp

Delete DM

discord_delete_dm

Destructive

Toolset
Direct messages dm
Context cost
172 tokens, estimated688 bytes of definition, divided by 4

Permanently delete a DM message previously sent by this bot. IRREVERSIBLE. The bot can only delete its own DM messages, not the recipient's. Returns a confirmation.

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
user_idrequiredstring
pattern ^\d{17,20}$
Discord user ID (snowflake) of the DM recipient.
message_idrequiredstring
pattern ^\d{17,20}$
ID of the target message within the DM conversation.

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 Direct messages

Raw definition (688 bytes)
{
  "name": "discord_delete_dm",
  "description": "Permanently delete a DM message previously sent by this bot. IRREVERSIBLE. The bot can only delete its own DM messages, not the recipient's. Returns a confirmation.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "user_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord user ID (snowflake) of the DM recipient."
      },
      "message_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID of the target message within the DM conversation."
      }
    },
    "required": [
      "user_id",
      "message_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Delete DM",
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": false,
    "openWorldHint": true
  }
}