@vitalyostanin/youtrack-mcp 0.7.4 → 0.8.0

package/README-ru.md

@@ -45,6 +45,7 @@ MCP сервер для полноценной интеграции с YouTrack
     - [Трудозатраты](#трудозатраты)
     - [Пользователи и проекты](#пользователи-и-проекты)
     - [Статьи](#статьи)
+    - [Лента активности](#лента-активности)
     - [Вложения](#вложения)
 
 ## Требования
@@ -294,7 +295,6 @@ YOUTRACK_TOKEN = "perm:your-token-here"
 | `issue_comment_update` | Обновление существующего комментария. **Использование:** Редактирование текста комментария, изменение режима форматирования, исправление опечаток. Поддерживает Markdown. **Возвращает:** поля комментария - id, text, textPreview, usesMarkdown, author, created, updated, commentUrl | `issueId` — ID или код задачи, `commentId` — ID комментария, опционально `text`, `usesMarkdown`, `muteUpdateNotifications` |
 | `issue_activities` | Получение истории изменений задачи (активности). **Использование:** Просмотр полной истории задачи, отслеживание изменений полей во времени, мониторинг кто и когда что изменил, анализ эволюции задачи, аудит модификаций. **Возвращает:** Элементы активности с временными метками (ISO datetime), авторами, категориями, типами изменений и деталями изменений (добавленные/удалённые значения). Поддерживает фильтрацию по автору, диапазону дат и категориям активности. **Примечание:** Возвращает предопределённые поля - id, timestamp, author (id, login, name), category (id), target (text), добавленные значения, удалённые значения, тип активности. Полезно для понимания жизненного цикла задачи, отслеживания модификаций полей, просмотра истории комментариев и анализа паттернов совместной работы. | `issueId` — код задачи, опционально `author` (логин пользователя), `startDate` (формат YYYY-MM-DD, timestamp или Date), `endDate`, `categories` (через запятую: `CustomFieldCategory` для изменений полей, `CommentsCategory` для комментариев, `AttachmentsCategory` для вложений, `LinksCategory` для связей, `VcsChangeActivityCategory` для VCS изменений, `WorkItemsActivityCategory` для трудозатрат), `limit` (макс 200), `skip` для пагинации |
 | `issue_change_state` | Изменение состояния/статуса задачи через переходы workflow. **Использование:** Перемещение задач через состояния рабочего процесса (например, 'Открыта' → 'В работе'). Автоматически определяет доступные переходы и валидирует запрошенное изменение состояния. Регистронезависимое сопоставление имён состояний. **Возвращает:** информацию о предыдущем состоянии, новом состоянии и использованном переходе | `issueId` — код задачи, `stateName` — имя целевого состояния (например, 'В работе', 'Открыта', 'Исправлена', 'Проверена'). Регистронезависимое |
-| `issue_search_by_user_activity` | Поиск задач по активности пользователей в заданный период. **Использование:** Поиск задач, где пользователи обновляли, были упомянуты, создавали, были назначены или комментировали. Поддерживает два режима фильтрации: `issue_updated` (по умолчанию, быстрый) использует поле issue.updated, `user_activity` (медленный, точный) проверяет фактические даты активности пользователя, включая комментарии, упоминания и историю изменений полей. **Когда использовать точный режим:** когда нужна точная дата участия пользователя (например, когда пользователь был исполнителем, но позже был изменён). **Возвращает:** краткую информацию о задачах (id, idReadable, summary, project, parent, assignee) без description для уменьшения размера ответа. В режиме `user_activity` включает поле `lastActivityDate` с точной датой последней активности пользователя. Результаты отсортированы по времени активности (новые первыми). Поддерживает пагинацию. **Ограничение:** по умолчанию 100 задач, макс 200 | `userLogins[]` — массив логинов пользователей для поиска активности (updater, mentions, reporter, assignee, commenter), опционально `startDate` (формат YYYY-MM-DD или timestamp), `endDate`, `dateFilterMode` (`issue_updated` или `user_activity`), `limit` (по умолчанию 100, макс 200), `skip` для пагинации |
 
 ### Связи задач
 
@@ -367,6 +367,12 @@ YOUTRACK_TOKEN = "perm:your-token-here"
 | `issues_list` | Список задач по фильтрам с поддержкой сортировки. **Использование:** Дашборды, аудит командной загрузки, подготовка батч-операций. Поддерживает фильтрацию по проектам, датам создания/обновления, статусам, типам, исполнителю. **Возвращает:** краткие или полные данные задачи в зависимости от `briefOutput`, а также информацию о сортировке и пагинации. | Фильтры: `projectIds`, `createdAfter/Before`, `updatedAfter/Before`, `statuses`, `assigneeLogin`, `types`; сортировка: `sortField` (`created`/`updated`), `sortDirection` (`asc`/`desc`); пагинация: `limit`, `skip`; формат: `briefOutput` |
 | `issues_count` | Подсчёт задач с теми же фильтрами, что у `issues_list`, с разбивкой по проектам. **Использование:** Быстрая оценка объёмов работ перед загрузкой полного списка, подготовка аналитических отчётов. При запросе одного проекта обращается к `/api/issuesGetter/count`, иначе считает постранично. | Те же фильтры, что и `issues_list`; опциональный `top` ограничивает объём ручной агрегации (при необходимости частичной выборки) |
 
+### Лента активности
+
+| Tool | Описание | Основные параметры |
+| --- | --- | --- |
+| `users_activity` | Авторо-центричная лента активности на базе `/api/activities`. **Использование:** аудит обновлений коллеги, накопление комментариев/смен состояний по множеству задач, проверка таймлайна выката. Возвращает нормализованные записи с ISO-временем, ссылками на задачи и полями `added`/`removed`. После анализа обязательно повторно запросите затронутые задачи или рабочие элементы, чтобы убедиться в актуальном состоянии. Поддерживаемые категории: `CustomFieldCategory` (изменения полей), `CommentsCategory` (комментарии), `AttachmentsCategory` (файлы), `LinksCategory` (ссылки), `VcsChangeActivityCategory` (VCS изменения), `WorkItemsActivityCategory` (трудозатраты). | `author` *(обязательный)* — логин пользователя (например, `vyt`); `categories` *(обязательный)* — список категорий через запятую из перечня выше; опционально `start` / `end` (ISO-строка, timestamp в мс или `Date`) для ограничения диапазона, `reverse` (boolean) для прямого хронометража, `limit` (по умолчанию 100, макс 200), `skip` (смещение пагинации), `fields` (расширенный перегруз возвращаемых полей). |
+
 ### Вложения
 
 | Tool | Описание | Основные параметры |

package/README.md

@@ -48,6 +48,7 @@ MCP server for comprehensive YouTrack integration with the following capabilitie
     - [Users and Projects](#users-and-projects)
     - [Articles](#articles)
     - [Search](#search)
+    - [Activity Feed](#activity-feed)
   - [Important Notes](#important-notes)
     - [Destructive Operations](#destructive-operations)
 
@@ -298,7 +299,6 @@ Tools return either `structuredContent` (default) or a text `content` item, depe
 | `issue_comment_update` | Update existing comment | `issueId`, `commentId`, optionally `text`, `usesMarkdown`, `muteUpdateNotifications` |
 | `issue_activities` | Get issue change history | `issueId` — issue code, optionally `author` (login), `startDate` (YYYY-MM-DD, timestamp, or Date), `endDate`, `categories` (comma-separated: `CustomFieldCategory` for field changes, `CommentsCategory` for comments, `AttachmentsCategory` for attachments, `LinksCategory` for links, `VcsChangeActivityCategory` for VCS changes, `WorkItemsActivityCategory` for work items), `limit` (max 200), `skip` for pagination. Returns activity items with timestamps (ISO datetime), authors, categories, and change details (added/removed values). Useful for tracking field modifications, reviewing comment history, and analyzing collaboration patterns |
 | `issue_change_state` | Change issue state/status through workflow transitions | `issueId` — issue code, `stateName` — target state name (e.g., 'In Progress', 'Open', 'Fixed', 'Verified'). Case-insensitive. Automatically discovers available transitions and validates requested state change. Returns information about previous state, new state, and transition used. Use for moving issues through workflow states |
-| `issue_search_by_user_activity` | Search issues with user activity | `userLogins[]` — array of user logins, optionally `startDate`, `endDate`, `dateFilterMode` (`issue_updated` fast mode or `user_activity` precise mode), `limit` (default 100, max 200). Finds issues where users updated, mentioned, reported, assigned, or commented. Fast mode filters by issue.updated field; precise mode checks actual user activity dates including comments, mentions, and field changes history (e.g., when user was assignee but later changed). In precise mode, returns `lastActivityDate` field. Sorted by activity time (newest first) |
 | `issue_attachments_list` | Get list of attachments | `issueId` — issue code |
 | `issue_attachment_get` | Get attachment info | `issueId`, `attachmentId` |
 | `issue_attachment_download` | Get download URL for attachment | `issueId`, `attachmentId` — returns signed URL |
@@ -370,6 +370,12 @@ Tools return either `structuredContent` (default) or a text `content` item, depe
 | --- | --- | --- |
 | `articles_search` | Full-text search across YouTrack knowledge base articles by title and content. Returns `webUrl` for direct access | `query` (min 2 chars), `limit` (default 50, max 200), `skip`, optionally `projectId`, `parentArticleId` |
 | `issues_search` | Full-text search across YouTrack issues by summary, description, and comments. If `query` is not provided or empty, all issues will be returned. Supports filtering by projects, assignee, reporter, state, and type | `query` (optional), `limit` (default 50, max 200), `skip`, `countOnly` (optional), `projects` (optional), `assignee` (optional), `reporter` (optional), `state` (optional), `type` (optional) |
+
+### Activity Feed
+
+| Tool | Description | Main Parameters |
+| --- | --- | --- |
+| `users_activity` | Author-centric activity feed backed by `/api/activities`. **Use for:** auditing a teammate's updates, gathering comment/state changes across many issues, and reviewing deployment timelines. Returns normalized entries with ISO timestamps, optional issue references, and `added`/`removed` payloads. Always follow up by re-fetching the affected issue or work-item to confirm the latest state. Supported categories: `CustomFieldCategory` (field changes), `CommentsCategory` (comments), `AttachmentsCategory` (file events), `LinksCategory` (issue links), `VcsChangeActivityCategory` (VCS changes), `WorkItemsActivityCategory` (work items). | `author` *(required)* — login such as `vyt`; `categories` *(required)* — comma-separated list built from the supported categories above; optional `start` / `end` (ISO string, timestamp in ms, or `Date`) to bound the range, `reverse` (boolean) to switch to chronological order, `limit` (default 100, max 200), `skip` (pagination offset), `fields` (advanced override of response fields). |
 | `issues_list` | List issues across projects with filtering and sorting | Filters: `projectIds`, `createdAfter/Before`, `updatedAfter/Before`, `statuses`, `assigneeLogin`, `types`; Sorting: `sortField`, `sortDirection`; Pagination: `limit`, `skip`; Output mode: `briefOutput` |
 | `issues_count` | Count issues using same filters as `issues_list`, returns per-project breakdown | Same filters as above, optional `top` to cap manual aggregation when many projects are involved |
 

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@vitalyostanin/youtrack-mcp",
-    "version": "0.7.4",
+    "version": "0.8.0",
     "scripts": {
         "build": "tsc -p tsconfig.json",
         "postbuild": "chmod +x dist/index.js",

package/dist/src/server.js

@@ -12,6 +12,7 @@ import { registerProjectTools } from "./tools/project-tools.js";
 import { registerAttachmentTools } from "./tools/attachment-tools.js";
 import { registerIssueStarTools } from "./tools/issue-star-tools.js";
 import { registerIssueLinkTools } from "./tools/issue-link-tools.js";
+import { usersActivityArgs, usersActivityHandler } from "./tools/users-activity-tools.js";
 import { YoutrackClient } from "./youtrack-client.js";
 import { loadConfig } from "./config.js";
 import { initializeTimezone } from "./utils/date.js";
@@ -46,6 +47,7 @@ export class YoutrackServer {
         registerArticleTools(this.server, this.client);
         // Removed redundant registerArticleSearchTools call (articles_search tool registered manually above)
         registerUserTools(this.server, this.client);
+        this.server.tool("users_activity", "Author-centric activity feed backed by /api/activities. Use for: auditing a teammate's updates, gathering comment/state changes across many issues, and reviewing deployment timelines. Always re-fetch affected entities to confirm final state.", usersActivityArgs, async (args) => usersActivityHandler(this.client, args));
         registerProjectTools(this.server, this.client);
         registerAttachmentTools(this.server, this.client);
         registerIssueStarTools(this.server, this.client);

package/dist/src/tools/users-activity-tools.d.ts

@@ -0,0 +1,115 @@
+import { z } from "zod";
+import type { YoutrackClient } from "../youtrack-client.js";
+export declare const usersActivityArgs: {
+    author: z.ZodString;
+    start: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodDate]>>;
+    end: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodDate]>>;
+    categories: z.ZodString;
+    reverse: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    skip: z.ZodDefault<z.ZodNumber>;
+    fields: z.ZodOptional<z.ZodString>;
+};
+export declare const usersActivitySchema: z.ZodObject<{
+    author: z.ZodString;
+    start: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodDate]>>;
+    end: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodDate]>>;
+    categories: z.ZodString;
+    reverse: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    skip: z.ZodDefault<z.ZodNumber>;
+    fields: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    author: string;
+    skip: number;
+    categories: string;
+    limit: number;
+    reverse?: boolean | undefined;
+    fields?: string | undefined;
+    start?: string | number | Date | undefined;
+    end?: string | number | Date | undefined;
+}, {
+    author: string;
+    categories: string;
+    reverse?: boolean | undefined;
+    skip?: number | undefined;
+    fields?: string | undefined;
+    start?: string | number | Date | undefined;
+    end?: string | number | Date | undefined;
+    limit?: number | undefined;
+}>;
+export declare function usersActivityHandler(client: YoutrackClient, rawInput: unknown): Promise<{
+    [x: string]: unknown;
+    content: ({
+        [x: string]: unknown;
+        text: string;
+        type: "text";
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        [x: string]: unknown;
+        type: "image";
+        data: string;
+        mimeType: string;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        [x: string]: unknown;
+        type: "audio";
+        data: string;
+        mimeType: string;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        [x: string]: unknown;
+        name: string;
+        type: "resource_link";
+        uri: string;
+        description?: string | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        mimeType?: string | undefined;
+        title?: string | undefined;
+        icons?: {
+            [x: string]: unknown;
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
+    } | {
+        [x: string]: unknown;
+        type: "resource";
+        resource: {
+            [x: string]: unknown;
+            text: string;
+            uri: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+        } | {
+            [x: string]: unknown;
+            uri: string;
+            blob: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+        };
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    })[];
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    structuredContent?: {
+        [x: string]: unknown;
+    } | undefined;
+    isError?: boolean | undefined;
+}>;
+//# sourceMappingURL=users-activity-tools.d.ts.map

package/dist/src/tools/users-activity-tools.js

@@ -0,0 +1,84 @@
+import { z } from "zod";
+import { parseDateInput, toIsoDateString, unixMsToDate, getCurrentDate } from "../utils/date.js";
+import { mapActivityItems } from "../utils/mappers.js";
+import { toolSuccess, toolError } from "../utils/tool-response.js";
+export const usersActivityArgs = {
+    author: z
+        .string()
+        .min(1)
+        .describe("Filter by author login (required, e.g., 'vyt'). Matches activities created by this user."),
+    start: z
+        .union([z.string(), z.number(), z.date()])
+        .optional()
+        .describe("Inclusive start of the interval. Accepts ISO string, unix timestamp (ms), or Date object. Converted to unix ms for /api/activities (default: no lower bound)."),
+    end: z
+        .union([z.string(), z.number(), z.date()])
+        .optional()
+        .describe("Inclusive end of the interval. Accepts ISO string, unix timestamp (ms), or Date object. Converted to unix ms for /api/activities (default: now)."),
+    categories: z
+        .string()
+        .describe("Comma-separated list of activity categories. Supported values: 'CustomFieldCategory', 'CommentsCategory', 'AttachmentsCategory', 'LinksCategory', 'VcsChangeActivityCategory', 'WorkItemsActivityCategory'."),
+    reverse: z
+        .boolean()
+        .optional()
+        .describe("When true, return activities in ascending order (oldest first). Default is false (newest first)."),
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .max(200)
+        .default(100)
+        .describe("Maximum number of activities to return (default 100, max 200)."),
+    skip: z
+        .number()
+        .int()
+        .nonnegative()
+        .default(0)
+        .describe("Number of activities to skip for pagination (default 0)."),
+    fields: z
+        .string()
+        .optional()
+        .describe("Override fields parameter passed to /api/activities (advanced). Defaults to issue idReadable, author, added/removed, category, timestamps."),
+};
+export const usersActivitySchema = z.object(usersActivityArgs);
+export async function usersActivityHandler(client, rawInput) {
+    try {
+        const input = usersActivitySchema.parse(rawInput);
+        const startMs = parseDateInput(input.start ?? unixMsToDate(0));
+        const endMs = parseDateInput(input.end ?? getCurrentDate());
+        if (startMs > endMs) {
+            throw new Error("'start' must be earlier than or equal to 'end'.");
+        }
+        const activities = await client.listActivities({
+            author: input.author,
+            categories: input.categories,
+            start: startMs,
+            end: endMs,
+            limit: input.limit,
+            skip: input.skip,
+            fields: input.fields,
+            reverse: input.reverse,
+        });
+        const mappedActivities = mapActivityItems(activities);
+        const payload = {
+            activities: mappedActivities,
+            filters: {
+                author: input.author,
+                start: toIsoDateString(input.start ?? unixMsToDate(startMs)),
+                end: toIsoDateString(input.end ?? unixMsToDate(endMs)),
+                categories: input.categories,
+                reverse: input.reverse,
+            },
+            pagination: {
+                returned: mappedActivities.length,
+                limit: input.limit,
+                skip: input.skip,
+            },
+        };
+        return toolSuccess(payload);
+    }
+    catch (error) {
+        return toolError(error);
+    }
+}
+//# sourceMappingURL=users-activity-tools.js.map

package/dist/src/utils/date.d.ts

@@ -1,3 +1,4 @@
+import { DateTime } from "luxon";
 export declare function initializeTimezone(timezone: string): void;
 export declare function getTimezone(): string;
 export declare function parseDateInput(value: string | number | Date): number;
@@ -31,4 +32,5 @@ export declare function filterWorkingDates(dates: Date[], excludeWeekends?: bool
 export declare function isSameDay(left: string | number | Date, right: string | number | Date): boolean;
 export declare function getCurrentTimestamp(): number;
 export declare function getCurrentDate(timezone?: string): Date;
+export declare function getCurrentDateTime(timezone?: string): DateTime;
 //# sourceMappingURL=date.d.ts.map

package/dist/src/utils/date.js

@@ -144,4 +144,7 @@ export function getCurrentTimestamp() {
 export function getCurrentDate(timezone = currentTimezone) {
     return DateTime.now().setZone(timezone).toJSDate();
 }
+export function getCurrentDateTime(timezone = currentTimezone) {
+    return DateTime.now().setZone(timezone);
+}
 //# sourceMappingURL=date.js.map

package/dist/src/utils/mappers.d.ts

@@ -48,7 +48,6 @@ export declare function mapIssue(issue: YoutrackIssue): MappedYoutrackIssue;
 export declare function mapIssueDetails(issue: YoutrackIssueDetails): MappedYoutrackIssueDetails;
 /**
  * Map YoutrackIssue to brief version (without description fields)
- * Used for reducing payload size in issue_search_by_user_activity tool
  */
 export declare function mapIssueBrief(issue: YoutrackIssue): MappedYoutrackIssue;
 /**

package/dist/src/utils/mappers.js

@@ -50,7 +50,6 @@ export function mapIssueDetails(issue) {
 }
 /**
  * Map YoutrackIssue to brief version (without description fields)
- * Used for reducing payload size in issue_search_by_user_activity tool
  */
 export function mapIssueBrief(issue) {
     // eslint-disable-next-line @typescript-eslint/no-unused-vars

package/dist/src/youtrack-client.d.ts

@@ -53,6 +53,16 @@ export declare class YoutrackClient {
         startDate?: number;
         endDate?: number;
     }): Promise<YoutrackActivityItem[]>;
+    listActivities({ author, categories, start, end, limit, skip, fields, reverse, }: {
+        author: string;
+        categories?: string;
+        start?: number;
+        end?: number;
+        limit?: number;
+        skip?: number;
+        fields?: string;
+        reverse?: boolean;
+    }): Promise<YoutrackActivityItem[]>;
     createIssue(input: YoutrackIssueCreateInput): Promise<IssueLookupPayload>;
     updateIssue(input: YoutrackIssueUpdateInput): Promise<IssueLookupPayload>;
     assignIssue(input: YoutrackIssueAssignInput): Promise<IssueLookupPayload>;

package/dist/src/youtrack-client.js

@@ -1,8 +1,9 @@
 import axios from "axios";
 import FormData from "form-data";
 import fs from "fs";
+import { DateTime } from "luxon";
 import { MutexPool } from "@vitalyostanin/mutex-pool";
-import { calculateTotalMinutes, enumerateDateRange, filterWorkingDays, getDayBounds, groupWorkItemsByDate, isWeekend, minutesToHours, parseDateInput, toIsoDateString, validateDateRange, } from "./utils/date.js";
+import { calculateTotalMinutes, enumerateDateRange, filterWorkingDays, getCurrentDateTime, getCurrentTimestamp, getDayBounds, groupWorkItemsByDate, isWeekend, minutesToHours, parseDateInput, toIsoDateString, validateDateRange, } from "./utils/date.js";
 import { mapAttachment, mapAttachments, mapComment, mapComments, mapIssue, mapIssueBrief, mapIssueDetails, mapWorkItem, mapWorkItems, } from "./utils/mappers.js";
 import { buildIssueQuery } from "./utils/issue-query.js";
 const DEFAULT_PAGE_SIZE = 200;
@@ -120,13 +121,15 @@ export class YoutrackClient {
             Object.prototype.hasOwnProperty.call(params, "skip");
         // First attempt: prefer $top/$skip
         const dollarParams = { ...params };
-        if (Object.prototype.hasOwnProperty.call(dollarParams, "top") && !Object.prototype.hasOwnProperty.call(dollarParams, "$top")) {
-            (dollarParams).$top = (dollarParams).top;
-            delete (dollarParams).top;
+        if (Object.prototype.hasOwnProperty.call(dollarParams, "top") &&
+            !Object.prototype.hasOwnProperty.call(dollarParams, "$top")) {
+            dollarParams.$top = dollarParams.top;
+            delete dollarParams.top;
         }
-        if (Object.prototype.hasOwnProperty.call(dollarParams, "skip") && !Object.prototype.hasOwnProperty.call(dollarParams, "$skip")) {
-            (dollarParams).$skip = (dollarParams).skip;
-            delete (dollarParams).skip;
+        if (Object.prototype.hasOwnProperty.call(dollarParams, "skip") &&
+            !Object.prototype.hasOwnProperty.call(dollarParams, "$skip")) {
+            dollarParams.$skip = dollarParams.skip;
+            delete dollarParams.skip;
         }
         try {
             const res = await this.http.get(url, { params: dollarParams });
@@ -137,12 +140,12 @@ export class YoutrackClient {
                 // Retry with plain top/skip
                 const plainParams = { ...params };
                 if (Object.prototype.hasOwnProperty.call(plainParams, "$top")) {
-                    (plainParams).top = (plainParams).$top;
-                    delete (plainParams).$top;
+                    plainParams.top = plainParams.$top;
+                    delete plainParams.$top;
                 }
                 if (Object.prototype.hasOwnProperty.call(plainParams, "$skip")) {
-                    (plainParams).skip = (plainParams).$skip;
-                    delete (plainParams).$skip;
+                    plainParams.skip = plainParams.$skip;
+                    delete plainParams.$skip;
                 }
                 const res2 = await this.http.get(url, { params: plainParams });
                 return res2.data;
@@ -608,6 +611,34 @@ export class YoutrackClient {
             throw this.normalizeError(error);
         }
     }
+    async listActivities({ author, categories, start, end, limit, skip, fields, reverse, }) {
+        const params = {
+            author,
+            fields: fields ??
+                "id,timestamp,author(id,login,name),category(id),target(issue(idReadable,summary),text),added(name,id,login),removed(name,id,login),$type",
+        };
+        if (categories) {
+            params.categories = categories;
+        }
+        if (typeof start === "number") {
+            params.start = start;
+        }
+        if (typeof end === "number") {
+            params.end = end;
+        }
+        params.$top = Math.min(limit ?? DEFAULT_PAGE_SIZE, DEFAULT_PAGE_SIZE);
+        params.$skip = skip ?? 0;
+        if (reverse !== undefined) {
+            params.reverse = reverse;
+        }
+        try {
+            const response = await this.http.get("/api/activities", { params });
+            return response.data;
+        }
+        catch (error) {
+            throw this.normalizeError(error);
+        }
+    }
     async createIssue(input) {
         const projectIdentifier = input.projectId ?? this.defaultProject;
         if (!projectIdentifier) {
@@ -909,7 +940,7 @@ export class YoutrackClient {
         // Add date range filter if provided
         if (input.startDate || input.endDate) {
             const startDateStr = input.startDate ? toIsoDateString(input.startDate) : "1970-01-01";
-            const endDateStr = input.endDate ? toIsoDateString(input.endDate) : toIsoDateString(new Date());
+            const endDateStr = input.endDate ? toIsoDateString(input.endDate) : getCurrentDateTime().toISO();
             filters.push(`updated: ${startDateStr} .. ${endDateStr}`);
         }
         // Add sorting by updated time descending
@@ -952,7 +983,7 @@ export class YoutrackClient {
         // and to reduce candidate set before precise post-filtering.
         if (input.startDate || input.endDate) {
             const startDateStr = input.startDate ? toIsoDateString(input.startDate) : "1970-01-01";
-            const endDateStr = input.endDate ? toIsoDateString(input.endDate) : toIsoDateString(new Date());
+            const endDateStr = input.endDate ? toIsoDateString(input.endDate) : getCurrentDateTime().toISO();
             filters.push(`updated: ${startDateStr} .. ${endDateStr}`);
         }
         const sortPart = "sort by: updated desc";
@@ -1057,7 +1088,10 @@ export class YoutrackClient {
                     const limit = input.limit ?? 100;
                     const paginatedIssues = issuesWithActivity.slice(skip, skip + limit);
                     const mapperFn = briefOutput ? mapIssueBrief : mapIssue;
-                    const resultIssues = paginatedIssues.map(({ issue, lastActivityDate }) => ({ ...mapperFn(issue), lastActivityDate }));
+                    const resultIssues = paginatedIssues.map(({ issue, lastActivityDate }) => ({
+                        ...mapperFn(issue),
+                        lastActivityDate,
+                    }));
                     return {
                         issues: resultIssues,
                         userLogins: input.userLogins,
@@ -1085,8 +1119,8 @@ export class YoutrackClient {
      * Used in user_activity mode to determine which issues had activity from specified users
      */
     filterIssuesByUserActivity(candidateIssues, detailsLight, commentsLight, activitiesResults, input) {
-        const startTimestamp = input.startDate ? new Date(input.startDate).getTime() : 0;
-        const endTimestamp = input.endDate ? new Date(input.endDate).getTime() : Date.now();
+        const startTimestamp = input.startDate ? parseDateInput(input.startDate) : 0;
+        const endTimestamp = input.endDate ? parseDateInput(input.endDate) : getCurrentTimestamp();
         const issuesWithActivity = [];
         for (let i = 0; i < candidateIssues.length; i++) {
             const issue = candidateIssues[i];
@@ -1137,7 +1171,7 @@ export class YoutrackClient {
             }
             if (dates.length > 0) {
                 const lastActivityTimestamp = Math.max(...dates);
-                const lastActivityDate = new Date(lastActivityTimestamp).toISOString();
+                const lastActivityDate = DateTime.fromMillis(lastActivityTimestamp).toISO() ?? "";
                 issuesWithActivity.push({
                     issue,
                     lastActivityDate,
@@ -1145,7 +1179,7 @@ export class YoutrackClient {
             }
         }
         // Sort by lastActivityDate descending
-        issuesWithActivity.sort((a, b) => new Date(b.lastActivityDate).getTime() - new Date(a.lastActivityDate).getTime());
+        issuesWithActivity.sort((a, b) => (a.lastActivityDate < b.lastActivityDate ? 1 : -1));
         return issuesWithActivity;
     }
     // Helper to perform fallback request without braces in user filters
@@ -1157,7 +1191,7 @@ export class YoutrackClient {
         }
         if (input.startDate || input.endDate) {
             const startDateStr = input.startDate ? toIsoDateString(input.startDate) : "1970-01-01";
-            const endDateStr = input.endDate ? toIsoDateString(input.endDate) : toIsoDateString(new Date());
+            const endDateStr = input.endDate ? toIsoDateString(input.endDate) : getCurrentDateTime().toISO();
             fallbackFilters.push(`updated: ${startDateStr} .. ${endDateStr}`);
         }
         const fallbackQuery = (fallbackFilters.length ? `${fallbackFilters.join(" and ")} ` : "") + sortPart;
@@ -1788,8 +1822,8 @@ export class YoutrackClient {
     }
     resolveReportBoundary(items, mode) {
         if (!items.length) {
-            const todayIso = toIsoDateString(new Date());
-            return todayIso;
+            const todayIso = getCurrentDateTime().toISO();
+            return todayIso ?? "";
         }
         const timestamps = items.map((item) => item.date);
         const target = mode === "min" ? Math.min(...timestamps) : Math.max(...timestamps);
@@ -2095,7 +2129,7 @@ export class YoutrackClient {
         const { briefOutput = true, limit = DEFAULT_PAGE_SIZE, skip = 0, sortField, sortDirection, ...filtersInput } = input;
         const { query } = await buildIssueQuery(filtersInput, (projectId) => this.getProjectById(projectId));
         const fields = briefOutput ? defaultFields.issueSearchBrief : defaultFields.issueSearch;
-        const { field: resolvedField, direction: resolvedDirection, sortParam } = this.resolveSort(sortField, sortDirection);
+        const { field: resolvedField, direction: resolvedDirection, sortParam, } = this.resolveSort(sortField, sortDirection);
         const params = {
             $top: Math.min(limit, DEFAULT_PAGE_SIZE),
             $skip: skip,
@@ -2104,7 +2138,9 @@ export class YoutrackClient {
             ...(query ? { query } : {}),
         };
         const data = await this.getWithFlexibleTop("/api/issues", params);
-        const issues = Array.isArray(data) ? data.map((issue) => (briefOutput ? mapIssueBrief(issue) : mapIssue(issue))) : [];
+        const issues = Array.isArray(data)
+            ? data.map((issue) => (briefOutput ? mapIssueBrief(issue) : mapIssue(issue)))
+            : [];
         return {
             issues,
             filters: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vitalyostanin/youtrack-mcp",
-  "version": "0.7.4",
+  "version": "0.8.0",
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "postbuild": "chmod +x dist/index.js",