discord_remove_reaction
Remove an emoji reaction from a Discord message by specifying the channel, message ID, and emoji to manage reactions in Discord servers.
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/index.ts:1075-1139 (handler)Handler function that fetches the channel and message, locates the specific reaction by emoji, and removes it either for a specified userId or the bot's own reaction. Returns success or error messages.
case "discord_remove_reaction": { const { channelId, messageId, emoji, userId } = RemoveReactionSchema.parse(args); try { if (!client.isReady()) { return { content: [{ type: "text", text: "Discord client not logged in. Please use discord_login tool first." }], isError: true }; } const channel = await client.channels.fetch(channelId); if (!channel || !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}` }] }; } else { // Remove bot's reaction await reaction.users.remove(client.user.id); return { content: [{ type: "text", text: `Successfully removed bot's reaction ${emoji} from message ID: ${messageId}` }] }; } } catch (error) { return { content: [{ type: "text", text: `Failed to remove reaction: ${error}` }], isError: true }; } } - src/index.ts:103-108 (schema)Zod schema defining input parameters for the discord_remove_reaction tool: channelId, messageId, emoji (required), userId (optional). Used for validation in the handler.
const RemoveReactionSchema = z.object({ channelId: z.string(), messageId: z.string(), emoji: z.string(), userId: z.string().optional() }); - src/index.ts:360-372 (registration)Tool registration in the MCP server's listTools handler, providing name, description, and JSON inputSchema for client-side validation.
{ 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"] }