discord-mcp

Remove reactions

discord_remove_reactions

Destructive

Toolset
Messages messages
Discord permission
Manage Messages when removing all reactions, every reaction of one emoji, or another user's reaction
Context cost
309 tokens, estimated1,235 bytes of definition, divided by 4

Remove reactions from a message. With no emoji: removes ALL reactions. With emoji only: removes every reaction of that emoji. With emoji and user_id: removes that one user's reaction. user_id without emoji is rejected. Removing all reactions, every reaction of one emoji, or another user's reaction requires the Manage Messages permission. Use discord_add_reaction to add.

Risk and annotations

Read-onlyreadOnlyHintnoCan modify your server.
DestructivedestructiveHintyesMay perform destructive updates, so clients can ask before running it.
IdempotentidempotentHintyesRepeating the call with the same arguments has no 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 containing the message.
message_idrequiredstring
pattern ^\d{17,20}$
ID of the message to remove reactions from.
emojioptionalstring
at least 1 characters
Unicode emoji or custom emoji 'name:id'. Omit to remove ALL reactions on the message.
user_idoptionalstring
pattern ^\d{17,20}$
Remove only this user's reaction for the given emoji. Requires emoji: the call is rejected without it.

Output

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

Related tools

Named in its description

Also in Messages

Raw definition (1,235 bytes)
{
  "name": "discord_remove_reactions",
  "description": "Remove reactions from a message. With no emoji: removes ALL reactions. With emoji only: removes every reaction of that emoji. With emoji and user_id: removes that one user's reaction. user_id without emoji is rejected. Removing all reactions, every reaction of one emoji, or another user's reaction requires the Manage Messages permission. Use discord_add_reaction to add.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "channel_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID (snowflake) of the channel or thread containing the message."
      },
      "message_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID of the message to remove reactions from."
      },
      "emoji": {
        "description": "Unicode emoji or custom emoji 'name:id'. Omit to remove ALL reactions on the message.",
        "type": "string",
        "minLength": 1
      },
      "user_id": {
        "description": "Remove only this user's reaction for the given emoji. Requires emoji: the call is rejected without it.",
        "type": "string",
        "pattern": "^\\d{17,20}$"
      }
    },
    "required": [
      "channel_id",
      "message_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Remove reactions",
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": true
  }
}