discord-mcp

Instructions

Implementation Reference

• src/tools/emoji-tools.ts:238-255 (handler)

  The handler function that executes the delete_sticker tool: fetches the Discord guild and sticker, deletes the sticker with optional reason, handles errors with withErrorHandling, and returns JSON-formatted response.

  async ({ guildId, stickerId, reason }) => {
    const result = await withErrorHandling(async () => {
      const client = await getDiscordClient();
      const guild = await client.guilds.fetch(guildId);
      const sticker = await guild.stickers.fetch(stickerId);
      const stickerName = sticker.name;
  
      await sticker.delete(reason);
  
      return { stickerId, stickerName, message: 'Sticker deleted successfully' };
    });
  
    if (!result.success) {
      return { content: [{ type: 'text', text: result.error }], isError: true };
    }
  
    return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] };
  }

• src/tools/emoji-tools.ts:233-237 (schema)

  Zod schema for input parameters: required guildId and stickerId, optional reason.

  {
    guildId: z.string().describe('The ID of the server (guild)'),
    stickerId: z.string().describe('The ID of the sticker to delete'),
    reason: z.string().optional().describe('Reason for deleting the sticker'),
  },

• src/tools/emoji-tools.ts:230-256 (registration)

  Registers the 'delete_sticker' tool on the MCP server, including name, description, input schema, and handler function.

  server.tool(
    'delete_sticker',
    'Delete a custom sticker from a server',
    {
      guildId: z.string().describe('The ID of the server (guild)'),
      stickerId: z.string().describe('The ID of the sticker to delete'),
      reason: z.string().optional().describe('Reason for deleting the sticker'),
    },
    async ({ guildId, stickerId, reason }) => {
      const result = await withErrorHandling(async () => {
        const client = await getDiscordClient();
        const guild = await client.guilds.fetch(guildId);
        const sticker = await guild.stickers.fetch(stickerId);
        const stickerName = sticker.name;
  
        await sticker.delete(reason);
  
        return { stickerId, stickerName, message: 'Sticker deleted successfully' };
      });
  
      if (!result.success) {
        return { content: [{ type: 'text', text: result.error }], isError: true };
      }
  
      return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] };
    }
  );

• src/index.ts:60-60 (registration)

  Calls registerEmojiTools which includes the registration of delete_sticker among other emoji/sticker tools.

  registerEmojiTools(server);