Zulip MCP Server

Instructions

Implementation Reference

• src/server.ts:916-932 (handler)

  MCP tool handler function that executes the remove-emoji-reaction logic by calling the Zulip client's removeReaction method and handling responses/errors.

  server.tool(
    "remove-emoji-reaction",
    "Remove an emoji reaction from a message.",
    RemoveReactionSchema.shape,
    async ({ message_id, emoji_name, emoji_code, reaction_type }) => {
      try {
        await zulipClient.removeReaction(message_id, {
          emoji_name,
          emoji_code,
          reaction_type
        });
        return createSuccessResponse(`Reaction ${emoji_name} removed from message ${message_id}!`);
      } catch (error) {
        return createErrorResponse(`Error removing reaction: ${error instanceof Error ? error.message : 'Unknown error'}`);
      }
    }
  );

• src/types.ts:205-210 (schema)

  Zod schema defining input parameters for the remove-emoji-reaction tool, used for validation.

  export const RemoveReactionSchema = z.object({
    message_id: z.number().describe("ID of the message to remove reaction from"),
    emoji_name: z.string().describe("Emoji name to remove (e.g., 'thumbs_up', 'heart')"),
    emoji_code: z.string().optional().describe("Unicode code point for the emoji"),
    reaction_type: z.enum(["unicode_emoji", "realm_emoji", "zulip_extra_emoji"]).optional().describe("Type of emoji reaction")
  });

• src/server.ts:916-932 (registration)

  Registration of the remove-emoji-reaction tool in the MCP server using server.tool().

  server.tool(
    "remove-emoji-reaction",
    "Remove an emoji reaction from a message.",
    RemoveReactionSchema.shape,
    async ({ message_id, emoji_name, emoji_code, reaction_type }) => {
      try {
        await zulipClient.removeReaction(message_id, {
          emoji_name,
          emoji_code,
          reaction_type
        });
        return createSuccessResponse(`Reaction ${emoji_name} removed from message ${message_id}!`);
      } catch (error) {
        return createErrorResponse(`Error removing reaction: ${error instanceof Error ? error.message : 'Unknown error'}`);
      }
    }
  );

• src/zulip/client.ts:214-225 (helper)

  ZulipClient helper method that performs the actual API DELETE request to remove the emoji reaction from Zulip.

  async removeReaction(messageId: number, params: {
    emoji_name: string;
    emoji_code?: string;
    reaction_type?: string;
  }): Promise<void> {
    const queryParams = new URLSearchParams();
    queryParams.append('emoji_name', params.emoji_name);
    if (params.emoji_code) {queryParams.append('emoji_code', params.emoji_code);}
    if (params.reaction_type) {queryParams.append('reaction_type', params.reaction_type);}
    
    await this.client.delete(`/messages/${messageId}/reactions?${queryParams.toString()}`);
  }