add-emoji-reaction
Add emoji reactions to Zulip messages using emoji names or codes to express responses and engage with content in conversations.
Instructions
Add an emoji reaction to a message.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message_id | Yes | ID of the message to react to | |
| emoji_name | Yes | Emoji name (e.g., 'thumbs_up', 'heart', 'rocket') or custom emoji name | |
| emoji_code | No | Unicode code point for the emoji | |
| reaction_type | No | Type of emoji reaction |
Implementation Reference
- src/server.ts:533-544 (handler)The main handler function for the 'add-emoji-reaction' tool. It destructures input parameters, calls the ZulipClient.addReaction method, and returns success or error response in MCP format.
async ({ message_id, emoji_name, emoji_code, reaction_type }) => { try { await zulipClient.addReaction(message_id, { emoji_name, emoji_code, reaction_type }); return createSuccessResponse(`Reaction ${emoji_name} added to message ${message_id}!`); } catch (error) { return createErrorResponse(`Error adding reaction: ${error instanceof Error ? error.message : 'Unknown error'}`); } } - src/server.ts:529-545 (registration)Registers the 'add-emoji-reaction' tool with the MCP server, specifying name, description, input schema, and handler function.
server.tool( "add-emoji-reaction", "Add an emoji reaction to a message.", AddReactionSchema.shape, async ({ message_id, emoji_name, emoji_code, reaction_type }) => { try { await zulipClient.addReaction(message_id, { emoji_name, emoji_code, reaction_type }); return createSuccessResponse(`Reaction ${emoji_name} added to message ${message_id}!`); } catch (error) { return createErrorResponse(`Error adding reaction: ${error instanceof Error ? error.message : 'Unknown error'}`); } } ); - src/types.ts:140-145 (schema)Zod schema defining the input parameters and validation for the add-emoji-reaction tool.
export const AddReactionSchema = z.object({ message_id: z.number().describe("ID of the message to react to"), emoji_name: z.string().describe("Emoji name (e.g., 'thumbs_up', 'heart', 'rocket') or custom emoji name"), 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/zulip/client.ts:199-212 (helper)ZulipClient helper method that performs the actual API call to add an emoji reaction to a Zulip message.
async addReaction(messageId: number, params: { emoji_name: string; emoji_code?: string; reaction_type?: string; }): Promise<void> { const payload: any = { emoji_name: params.emoji_name, reaction_type: params.reaction_type || 'unicode_emoji' }; if (params.emoji_code !== undefined) { payload.emoji_code = params.emoji_code; } await this.client.post(`/messages/${messageId}/reactions`, payload); }