discord_remove_reaction

Remove a specific emoji reaction from a Discord message by providing the channel ID, message ID, and emoji identifier. This tool helps manage reactions in Discord conversations.

Instructions

Removes a specific emoji reaction from a Discord message

Input Schema

TableJSON Schema

Name	Required	Description	Default
`channelId`	Yes
`messageId`	Yes
`emoji`	Yes
`userId`	No

Implementation Reference

src/tools/reactions.ts:129-211 (handler)

The main execution handler for the 'discord_remove_reaction' tool. Parses input arguments using RemoveReactionSchema, fetches the channel and message, locates the specific reaction, and removes it either for a specified user or the bot itself. Handles errors with handleDiscordError.

export async function removeReactionHandler(
  args: unknown,
  context: ToolContext
): Promise<ToolResponse> {
  const { channelId, messageId, emoji, userId } =
    RemoveReactionSchema.parse(args);
  try {
    if (!context.client.isReady()) {
      return {
        content: [{ type: 'text', text: 'Discord client not logged in.' }],
        isError: true,
      };
    }

    const channel = await context.client.channels.fetch(channelId);
    if (!(channel?.isTextBased() && 'messages' in channel)) {
      return {
        content: [
          {
            type: 'text',
            text: `Cannot find text channel with ID: ${channelId}`,
          },
        ],
        isError: true,
      };
    }

    const message = await channel.messages.fetch(messageId);
    if (!message) {
      return {
        content: [
          { type: 'text', text: `Cannot find message with ID: ${messageId}` },
        ],
        isError: true,
      };
    }

    // Get the reactions
    const reactions = message.reactions.cache;

    // Find the specific reaction
    const reaction = reactions.find(
      (r) => r.emoji.toString() === emoji || r.emoji.name === emoji
    );

    if (!reaction) {
      return {
        content: [
          {
            type: 'text',
            text: `Reaction ${emoji} not found on message ID: ${messageId}`,
          },
        ],
        isError: true,
      };
    }

    if (userId) {
      // Remove a specific user's reaction
      await reaction.users.remove(userId);
      return {
        content: [
          {
            type: 'text',
            text: `Successfully removed reaction ${emoji} from user ID: ${userId} on message ID: ${messageId}`,
          },
        ],
      };
    }
    // Remove bot's reaction
    await reaction.users.remove(context.client.user.id);
    return {
      content: [
        {
          type: 'text',
          text: `Successfully removed bot's reaction ${emoji} from message ID: ${messageId}`,
        },
      ],
    };
  } catch (error) {
    return handleDiscordError(error);
  }
}

src/tool-list.ts:203-216 (schema)

MCP tool definition including name, description, and input schema for 'discord_remove_reaction'.

{
  name: 'discord_remove_reaction',
  description: 'Removes a specific emoji reaction from a Discord message',
  inputSchema: {
    type: 'object',
    properties: {
      channelId: { type: 'string' },
      messageId: { type: 'string' },
      emoji: { type: 'string' },
      userId: { type: 'string' },
    },
    required: ['channelId', 'messageId', 'emoji'],
  },
},

src/server.ts:176-179 (registration)

Registers and dispatches to the removeReactionHandler in the MCP server's CallToolRequest handler switch statement.

case 'discord_remove_reaction':
  this.logClientState('before discord_remove_reaction handler');
  toolResponse = await removeReactionHandler(args, this.toolContext);
  return toolResponse;

src/schemas.ts:85-90 (schema)

Zod schema for runtime input validation used by the removeReactionHandler.

export const RemoveReactionSchema = z.object({
  channelId: z.string(),
  messageId: z.string(),
  emoji: z.string(),
  userId: z.string().optional(),
});

src/tools/tools.ts:22-22 (registration)
Re-exports the removeReactionHandler from reactions.ts for convenient import in server.ts.
```
removeReactionHandler,
```

MCP-Discord