MCP-Discord

Instructions

Implementation Reference

• src/tools/reactions.ts:171-213 (handler)

  The main handler function for the discord_delete_message tool. It validates arguments using DeleteMessageSchema, checks client readiness, fetches the channel and message, deletes the message, and returns success or error response.

  export async function deleteMessageHandler(
    args: unknown, 
    context: ToolContext
  ): Promise<ToolResponse> {
    const { channelId, messageId, reason } = DeleteMessageSchema.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 || !channel.isTextBased() || !('messages' in channel)) {
        return {
          content: [{ type: "text", text: `Cannot find text channel with ID: ${channelId}` }],
          isError: true
        };
      }
  
      // Fetch the message
      const message = await channel.messages.fetch(messageId);
      if (!message) {
        return {
          content: [{ type: "text", text: `Cannot find message with ID: ${messageId}` }],
          isError: true
        };
      }
  
      // Delete the message
      await message.delete();
  
      return {
        content: [{ 
          type: "text", 
          text: `Successfully deleted message with ID: ${messageId} from channel: ${channelId}` 
        }]
      };
    } catch (error) {
      return handleDiscordError(error);
    }
  } 

• src/schemas.ts:98-102 (schema)

  Zod schema for input validation used within the deleteMessageHandler.

  export const DeleteMessageSchema = z.object({
      channelId: z.string(),
      messageId: z.string(),
      reason: z.string().optional()
  });

• src/toolList.ts:225-237 (schema)

  JSON Schema definition for the tool's input parameters, used in the MCP listTools response.

  {
    name: "discord_delete_message",
    description: "Deletes a specific message from a Discord text channel",
    inputSchema: {
      type: "object",
      properties: {
        channelId: { type: "string" },
        messageId: { type: "string" },
        reason: { type: "string" }
      },
      required: ["channelId", "messageId"]
    }
  },

• src/server.ts:158-161 (registration)

  Registration and dispatching logic in the MCP server's CallToolRequest handler switch statement.

  case "discord_delete_message":
    this.logClientState("before discord_delete_message handler");
    toolResponse = await deleteMessageHandler(args, this.toolContext);
    return toolResponse;