discord_remove_reaction

Instructions

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,