@vitalyostanin/youtrack-mcp 0.7.3 → 0.8.0

package/README-ru.md

@@ -45,6 +45,7 @@ MCP сервер для полноценной интеграции с YouTrack
     - [Трудозатраты](#трудозатраты)
     - [Пользователи и проекты](#пользователи-и-проекты)
     - [Статьи](#статьи)
+    - [Лента активности](#лента-активности)
     - [Вложения](#вложения)
 
 ## Требования
@@ -282,11 +283,11 @@ YOUTRACK_TOKEN = "perm:your-token-here"
 | Tool | Описание | Основные параметры |
 | --- | --- | --- |
 | `issue_lookup` | Краткая информация о задаче. **Использование:** Быстрый просмотр базовой информации о задаче без полной детализации. **Возвращает:** предопределенные поля - id, idReadable, summary, description, wikifiedDescription, usesMarkdown, project, parent, assignee. Пользовательские поля не включены. | `issueId` — код задачи (например, `PROJ-123`) |
-| `issues_lookup` | Краткая информация о нескольких задачах (пакетный режим, макс 50). **Использование:** Эффективное получение информации о множестве задач одновременно. **Возвращает:** те же поля, что и `issue_lookup`. **Ограничение:** максимум 50 задач за запрос | `issueIds[]` — массив кодов задач (например, `['PROJ-123', 'PROJ-124']`) |
+| `issues_lookup` | Краткая информация о нескольких задачах (пакетный режим, макс 50). **Использование:** Эффективное получение информации о множестве задач одновременно. **Возвращает:** те же поля, что и `issue_lookup`. **Ограничение:** максимум 50 задач за запрос | `issueIds[]` — массив кодов задач (например, `['PROJ-123', 'PROJ-124']`), макс 50; `briefOutput` — опционально (по умолчанию `true`) |
 | `issue_details` | Режимы краткий/полный для деталей задачи. **Использование:** Просмотр деталей задачи. **Краткий (по умолчанию):** предопределённые поля — id, idReadable, summary, description, wikifiedDescription, usesMarkdown, created, updated, resolved, project, parent, assignee, reporter, updater, watchers(hasStar). **Полный (`briefOutput=false`):** добавляет `customFields(id,name,value(id,name,presentation),$type,possibleEvents(id,presentation))`, включая поле `State`. | `issueId` — код задачи; `briefOutput` — опционально (по умолчанию `true`) |
-| `issues_details` | Режимы краткий/полный для множества задач (макс 50). **Краткий:** предопределённые поля. **Полный (`briefOutput=false`):** добавляет `customFields` для каждой задачи. **Замечание:** объём ответа может быть большим, поэтому по умолчанию используется краткий режим. **Ограничение:** максимум 50 задач за запрос | `issueIds[]` — массив кодов задач; `briefOutput` — опционально (по умолчанию `true`) |
-| `issue_comments` | Комментарии задачи. **Использование:** Просмотр всех комментариев к задаче. **Возвращает:** предопределенные поля - id, text, textPreview, usesMarkdown, author (id, login, name), created, updated | `issueId` — код задачи |
-| `issues_comments` | Комментарии для нескольких задач (пакетный режим, макс 50). **Использование:** Эффективное получение комментариев для множества задач одновременно. **Ограничение:** максимум 50 задач за запрос | `issueIds[]` — массив кодов задач |
+| `issues_details` | Режимы краткий/полный для множества задач (макс 50). **Краткий:** предопределённые поля. **Полный (`briefOutput=false`):** добавляет `customFields` для каждой задачи. **Замечание:** объём ответа может быть большим, поэтому по умолчанию используется краткий режим. **Ограничение:** максимум 50 задач за запрос | `issueIds[]` — массив кодов задач, макс 50; `briefOutput` — опционально (по умолчанию `true`) |
+| `issue_comments` | Комментарии задачи. **Использование:** Просмотр всех комментариев к задаче. **Возвращает:** предопределенные поля - id, text, textPreview, usesMarkdown, author (id, login, name), created, updated, commentUrl (прямая ссылка на комментарий) | `issueId` — код задачи |
+| `issues_comments` | Комментарии для нескольких задач (пакетный режим, макс 50). **Использование:** Эффективное получение комментариев для множества задач одновременно. **Ограничение:** максимум 50 задач за запрос | `issueIds[]` — массив кодов задач, макс 50; `briefOutput` — опционально (по умолчанию `true`) |
 | `issue_create` | Создание новой задачи в YouTrack. **Использование:** Создание задач, подзадач (через `parentIssueId`), назначение исполнителя при создании, одновременное создание дополнительных связей. **Возвращает:** стандартные поля созданной задачи (id, idReadable, summary, description, wikifiedDescription, usesMarkdown, project, parent, assignee). Пользовательские поля не включены. | `projectId` — внутренний ID проекта, `summary`, опционально `description`, `parentIssueId`, `assigneeLogin`, `stateName`, `usesMarkdown`, `links[]` — массив объектов связи |
 | `issue_update` | Обновление существующей задачи. **Использование:** Изменение summary, description, родительской задачи. **Примечание:** для изменения исполнителя используйте `issue_assign`. Пустая строка в `parentIssueId` удаляет родителя. **Возвращает:** стандартные поля обновленной задачи | `issueId` — ID или код задачи, опционально `summary`, `description`, `parentIssueId` (пустая строка очищает родителя), `usesMarkdown` |
 | `issue_assign` | Назначение исполнителя для задачи. **Использование:** Изменение исполнителя задачи. Поддерживает алиас `me` для текущего пользователя. **Возвращает:** стандартные поля обновленной задачи | `issueId` — ID или код задачи, `assigneeLogin` — логин исполнителя или `me` |
@@ -294,16 +295,15 @@ 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` для пагинации |
 
 ### Связи задач
 
 | Tool | Описание | Основные параметры |
 | --- | --- | --- |
-| `issue_links` | Список связей (линков) для задачи: «relates to», «duplicate», «parent/child». Возвращает id связи, направление (inward/outward), тип связи и краткую информацию о связанной задаче | `issueId` — код задачи |
+| `issue_links` | Список связей (линков) для задачи: «relates to», «duplicate», «parent/child». Возвращает id связи, направление (inward/outbound), тип связи и краткую информацию о связанной задаче | `issueId` — код задачи |
 | `issue_link_types` | Список доступных типов связей в YouTrack. Полезно для подбора корректного типа при создании связи | — |
-| `issue_link_add` | Создание связи между двумя задачами | `sourceId` — исходная задача, `targetId` — целевая задача, `linkType` — имя или id типа связи (например, `Relates` или UUID) |
-| `issue_link_delete` | Удаление существующей связи по её id для указанной задачи | `issueId` — код задачи, `linkId` — id связи |
+| `issue_link_add` | Создание связи между двумя задачами | `sourceId` — исходная задача, `targetId` — целевая задача, `linkType` — имя или id типа связи (например, `Relates` или UUID), опционально `direction` (`outbound` или `inbound`) |
+| `issue_link_delete` | Удаление существующей связи по её id для указанной задачи | `issueId` — код задачи, `linkId` — id связи для удаления |
 
 **issue_create — дополнительные параметры:**
 
@@ -363,10 +363,16 @@ YOUTRACK_TOKEN = "perm:your-token-here"
 | `article_update` | Обновление существующей статьи. **Использование:** Редактирование содержимого, изменение заголовка статьи. **Возвращает:** предопределенные поля обновленной статьи | `articleId` — ID статьи, опционально `summary` — новый заголовок, `content` — новое содержимое, `usesMarkdown`, `returnRendered` |
 | `article_search` | Поиск статей в базе знаний по тексту. **Использование:** Полнотекстовый поиск по заголовкам и содержимому статей, поиск документации. Поддерживает фильтрацию по проекту и родительской статье. **Возвращает:** предопределенные поля - id, idReadable, summary, usesMarkdown, contentPreview (если `returnRendered=true`), parentArticle, project. Поле content не включено для производительности. **Ограничение:** минимум 2 символа в запросе, максимум 200 результатов | `query` — текст для поиска (минимум 2 символа), опционально `projectId` — фильтр по проекту, `parentArticleId` — фильтр по родительской статье, `limit` — максимум результатов (макс 200), `returnRendered` — вернуть отрендеренный preview содержимого |
 | `articles_search` | Полнотекстовый поиск по статьям базы знаний YouTrack по заголовку и содержимому. Возвращает `webUrl` для прямого перехода. | `query`, `limit`, `skip`, опционально `projectId`, `parentArticleId` |
-| `issues_search` | Полнотекстовый поиск по задачам YouTrack по summary, description и комментариям. | `query`, `limit`, `skip` |
+| `issues_search` | Полнотекстовый поиск по задачам YouTrack по summary, description и комментариям. Если `query` не указан или пуст, будут возвращены все задачи. Поддерживает фильтрацию по проектам, исполнителю, автору, статусу и типу. | `query` (необязательный), `limit`, `skip`, `countOnly` (необязательный), `projects` (необязательный), `assignee` (необязательный), `reporter` (необязательный), `state` (необязательный), `type` (необязательный) |
 | `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

@@ -21,31 +21,36 @@ MCP server for comprehensive YouTrack integration with the following capabilitie
 
 ## Table of Contents
 
-- [Requirements](#requirements)
-- [Installation](#installation)
-  - [Using npx (Recommended)](#using-npx-recommended)
-  - [Using Claude MCP CLI](#using-claude-mcp-cli)
-  - [Manual Installation (Development)](#manual-installation-development)
-- [Development & Release](#development--release)
-  - [GitHub Actions Workflows](#github-actions-workflows)
-  - [Setting up NPM_TOKEN](#setting-up-npmtoken)
-  - [Release Process](#release-process)
-  - [Manual Build & Test](#manual-build--test)
-- [Running the server (stdio)](#running-the-server-stdio)
-- [Configuration for Code (Recommended)](#configuration-for-code-recommended)
-- [Configuration for Claude Code CLI](#configuration-for-claude-code-cli)
-- [Configuration for VS Code Cline](#configuration-for-vs-code-cline)
-- [MCP Tools](#mcp-tools)
-  - [Service](#service)
-  - [Issues](#issues)
-  - [Issue Links](#issue-links)
-  - [Issue Stars](#issue-stars)
-  - [Work Items](#work-items)
-  - [Users and Projects](#users-and-projects)
-  - [Articles](#articles)
-  - [Search](#search)
-- [Important Notes](#important-notes)
-  - [Destructive Operations](#destructive-operations)
+- [YouTrack MCP Server](#youtrack-mcp-server)
+  - [Table of Contents](#table-of-contents)
+  - [Requirements](#requirements)
+  - [Installation](#installation)
+    - [Using npx (Recommended)](#using-npx-recommended)
+    - [Using Claude MCP CLI](#using-claude-mcp-cli)
+    - [Manual Installation (Development)](#manual-installation-development)
+  - [Development \& Release](#development--release)
+    - [GitHub Actions Workflows](#github-actions-workflows)
+      - [CI Workflow (`.github/workflows/ci.yml`)](#ci-workflow-githubworkflowsciyml)
+      - [Publish Workflow (`.github/workflows/publish.yml`)](#publish-workflow-githubworkflowspublishyml)
+    - [Setting up NPM\_TOKEN](#setting-up-npm_token)
+    - [Release Process](#release-process)
+    - [Manual Build \& Test](#manual-build--test)
+  - [Running the server (stdio)](#running-the-server-stdio)
+  - [Configuration for Code (Recommended)](#configuration-for-code-recommended)
+  - [Configuration for Claude Code CLI](#configuration-for-claude-code-cli)
+  - [Configuration for VS Code Cline](#configuration-for-vs-code-cline)
+  - [MCP Tools](#mcp-tools)
+    - [Service](#service)
+    - [Issues](#issues)
+    - [Issue Links](#issue-links)
+    - [Issue Stars](#issue-stars)
+    - [Work Items](#work-items)
+    - [Users and Projects](#users-and-projects)
+    - [Articles](#articles)
+    - [Search](#search)
+    - [Activity Feed](#activity-feed)
+  - [Important Notes](#important-notes)
+    - [Destructive Operations](#destructive-operations)
 
 ## Requirements
 
@@ -282,8 +287,11 @@ Tools return either `structuredContent` (default) or a text `content` item, depe
 | Tool | Description | Main Parameters |
 | --- | --- | --- |
 | `issue_lookup` | Brief issue information | `issueId` — issue code (e.g., PROJ-123) |
+| `issues_lookup` | Brief information about multiple issues (batch mode, max 50) | `issueIds[]` — array of issue codes (e.g., ['PROJ-123', 'PROJ-124']), max 50; `briefOutput` — optional boolean (default `true`) |
 | `issue_details` | Issue details with brief/full modes | `issueId` — issue code; `briefOutput` — optional boolean (default `true`). Brief: predefined fields only. Full (`false`): adds `customFields` including `State` |
+| `issues_details` | Detailed information about multiple issues (batch mode, max 50). Brief (default): predefined fields only. Full (`briefOutput=false`): adds `customFields` for each issue | `issueIds[]` — array of issue codes, max 50; `briefOutput` — optional boolean (default `true`) |
 | `issue_comments` | Issue comments | `issueId` — issue code |
+| `issues_comments` | Comments for multiple issues (batch mode, max 50) | `issueIds[]` — array of issue codes, max 50; `briefOutput` — optional boolean (default `true`) |
 | `issue_create` | Create issue | `projectId`, `summary`, optional `description`, `parentIssueId`, `assigneeLogin`, `stateName`, `usesMarkdown`, `links` (array of link objects) |
 | `issue_update` | Update existing issue | `issueId`, optionally `summary`, `description`, `parentIssueId` (empty string clears parent), `usesMarkdown` |
 | `issue_assign` | Assign issue to user | `issueId`, `assigneeLogin` (login or `me`) |
@@ -291,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 |
@@ -304,8 +311,8 @@ Tools return either `structuredContent` (default) or a text `content` item, depe
 | --- | --- | --- |
 | `issue_links` | List links for an issue (relates to, duplicate, parent/child). Returns link id, direction, linkType, and counterpart issue brief | `issueId` — issue code |
 | `issue_link_types` | List available link types | — |
-| `issue_link_add` | Create a link between two issues | `sourceId`, `targetId`, `linkType` (name or id) |
-| `issue_link_delete` | Delete a link by id for a specific issue | `issueId`, `linkId` |
+| `issue_link_add` | Create a link between two issues | `sourceId`, `targetId`, `linkType` (name or id), optionally `direction` (`outbound` or `inbound`) |
+| `issue_link_delete` | Delete a link by id for a specific issue | `issueId` — issue code, `linkId` — link id to delete |
 
 ### Issue Stars
 
@@ -355,13 +362,20 @@ Tools return either `structuredContent` (default) or a text `content` item, depe
 | `article_update` | Update article | `articleId`, optionally `summary`, `content`, `usesMarkdown`, `returnRendered` |
 | `article_search` | Search articles in knowledge base | `query`, optionally `projectId`, `parentArticleId`, `limit`, `returnRendered` |
 | `articles_search` | Full-text search across YouTrack knowledge base articles by title and content. Returns `webUrl` for direct access. | `query`, `limit`, `skip`, optionally `projectId`, `parentArticleId` |
-| `issues_search` | Full-text search across YouTrack issues by summary, description, and comments. | `query`, `limit`, `skip` |
+| `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`, `skip`, `countOnly` (optional), `projects` (optional), `assignee` (optional), `reporter` (optional), `state` (optional), `type` (optional) |
 
 ### Search
 
 | Tool | Description | Main Parameters |
 | --- | --- | --- |
-| `article_search` | Search articles in knowledge base | `query`, optionally `projectId`, `parentArticleId`, `limit`, `returnRendered` |
+| `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.3",
+    "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/issue-search-tools.d.ts

@@ -1,23 +1,43 @@
 import { z } from "zod";
 import type { YoutrackClient } from "../youtrack-client.js";
 export declare const issuesSearchArgs: {
-    query: z.ZodString;
+    query: z.ZodOptional<z.ZodString>;
     limit: z.ZodDefault<z.ZodNumber>;
     skip: z.ZodDefault<z.ZodNumber>;
+    projects: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    assignee: z.ZodOptional<z.ZodString>;
+    reporter: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
 };
-export declare const issuesSearchSchema: z.ZodObject<{
-    query: z.ZodString;
+export declare const issuesSearchSchema: z.ZodDefault<z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
     limit: z.ZodDefault<z.ZodNumber>;
     skip: z.ZodDefault<z.ZodNumber>;
+    projects: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    assignee: z.ZodOptional<z.ZodString>;
+    reporter: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    query: string;
     skip: number;
     limit: number;
+    reporter?: string | undefined;
+    assignee?: string | undefined;
+    type?: string | undefined;
+    query?: string | undefined;
+    projects?: string[] | undefined;
+    state?: string | undefined;
 }, {
-    query: string;
+    reporter?: string | undefined;
+    assignee?: string | undefined;
+    type?: string | undefined;
+    query?: string | undefined;
     skip?: number | undefined;
+    projects?: string[] | undefined;
     limit?: number | undefined;
-}>;
+    state?: string | undefined;
+}>>;
 export declare function issuesSearchHandler(client: YoutrackClient, rawInput: unknown): Promise<{
     [x: string]: unknown;
     content: ({

package/dist/src/tools/issue-search-tools.js

@@ -1,21 +1,88 @@
 import { z } from "zod";
 import { toolSuccess, toolError } from "../utils/tool-response.js";
 export const issuesSearchArgs = {
-    query: z.string().min(2).describe("Search string for issues (e.g., 'login error')"),
+    query: z
+        .string()
+        .optional()
+        .describe("Search string for issues (e.g., 'login error'). If not provided or empty, all issues will be returned. You can also use YouTrack Query Language (e.g., 'State: Open', 'Type: Bug')"),
     limit: z.number().int().positive().max(200).default(50).describe("Max results per page"),
     skip: z.number().int().nonnegative().default(0).describe("Offset for pagination"),
+    projects: z.array(z.string().min(1)).optional().describe("Filter by project short names (e.g., ['PROJ', 'TEST'])"),
+    assignee: z.string().optional().describe("Filter by assignee login (e.g., 'john.doe' or 'me')"),
+    reporter: z.string().optional().describe("Filter by reporter/author login (e.g., 'john.doe' or 'me')"),
+    state: z.string().optional().describe("Filter by state/status (e.g., 'Open', 'In Progress', 'Fixed')"),
+    type: z.string().optional().describe("Filter by issue type (e.g., 'Bug', 'Feature', 'Task')"),
 };
-export const issuesSearchSchema = z.object(issuesSearchArgs);
+export const issuesSearchSchema = z
+    .object({
+    query: z
+        .string()
+        .optional()
+        .describe("Search string for issues (e.g., 'login error'). If not provided or empty, all issues will be returned. You can also use YouTrack Query Language (e.g., 'State: Open', 'Type: Bug')"),
+    limit: z.number().int().positive().max(200).default(50).describe("Max results per page"),
+    skip: z.number().int().nonnegative().default(0).describe("Offset for pagination"),
+    projects: z.array(z.string().min(1)).optional().describe("Filter by project short names (e.g., ['PROJ', 'TEST'])"),
+    assignee: z.string().optional().describe("Filter by assignee login (e.g., 'john.doe' or 'me')"),
+    reporter: z.string().optional().describe("Filter by reporter/author login (e.g., 'john.doe' or 'me')"),
+    state: z.string().optional().describe("Filter by state/status (e.g., 'Open', 'In Progress', 'Fixed')"),
+    type: z.string().optional().describe("Filter by issue type (e.g., 'Bug', 'Feature', 'Task')"),
+})
+    .default({});
 export async function issuesSearchHandler(client, rawInput) {
     const input = issuesSearchSchema.parse(rawInput);
     try {
+        // Build query parameters
+        let { query = "" } = input;
+        const { limit = 50, skip = 0 } = input;
+        // Collect all filters
+        const filters = [];
+        // Add project filter
+        if (input.projects && input.projects.length > 0) {
+            const projectFilter = input.projects.map((p) => `project: ${p}`).join(" or ");
+            filters.push(`(${projectFilter})`);
+        }
+        // Add assignee filter
+        if (input.assignee) {
+            filters.push(`assignee: ${input.assignee}`);
+        }
+        // Add reporter filter
+        if (input.reporter) {
+            filters.push(`reporter: ${input.reporter}`);
+        }
+        // Add state filter
+        if (input.state) {
+            filters.push(`State: {${input.state}}`);
+        }
+        // Add type filter
+        if (input.type) {
+            filters.push(`Type: {${input.type}}`);
+        }
+        // Combine query with filters
+        if (filters.length > 0) {
+            const combinedFilters = filters.join(" and ");
+            query = query ? `(${query}) and ${combinedFilters}` : combinedFilters;
+        }
+        // Fetch issues
         const data = await client["getWithFlexibleTop"]("/api/issues", {
-            query: input.query,
-            $top: input.limit,
-            $skip: input.skip,
+            query,
+            $top: limit,
+            $skip: skip,
             fields: "id,idReadable,summary,project(shortName,name),assignee(name,login)",
         });
-        return toolSuccess(data);
+        // Count logic
+        const allIssues = Array.isArray(data) ? data : [];
+        const total = allIssues.length;
+        const byProject = {};
+        for (const issue of allIssues) {
+            const project = issue.project?.shortName ?? "UNKNOWN";
+            byProject[project] = (byProject[project] ?? 0) + 1;
+        }
+        const result = {
+            total,
+            byProject: Object.entries(byProject).map(([project, count]) => ({ project, count })),
+            items: allIssues,
+        };
+        return toolSuccess(result);
     }
     catch (error) {
         return toolError(error);

package/dist/src/tools/issue-tools.js

@@ -92,6 +92,18 @@ const issueChangeStateArgs = {
         .describe("Target state name (e.g., 'In Progress', 'Open', 'Fixed', 'Verified'). Case-insensitive."),
 };
 const issueChangeStateSchema = z.object(issueChangeStateArgs);
+const issuesCountArgs = {
+    projectIds: z.array(z.string().min(1)).optional().describe("Filter by project IDs or short names"),
+    createdAfter: z.string().optional().describe("Filter by creation date (YYYY-MM-DD or timestamp)"),
+    createdBefore: z.string().optional().describe("Filter by creation date (YYYY-MM-DD or timestamp)"),
+    updatedAfter: z.string().optional().describe("Filter by update date (YYYY-MM-DD or timestamp)"),
+    updatedBefore: z.string().optional().describe("Filter by update date (YYYY-MM-DD or timestamp)"),
+    statuses: z.array(z.string().min(1)).optional().describe("Filter by state names"),
+    types: z.array(z.string().min(1)).optional().describe("Filter by issue types"),
+    assigneeLogin: z.string().optional().describe("Filter by assignee login"),
+    top: z.number().int().positive().optional().describe("Maximum number of issues to count (optional limit)"),
+};
+const issuesCountSchema = z.object(issuesCountArgs);
 export function registerIssueTools(server, client) {
     server.tool("issue_lookup", "Get brief information about YouTrack issue. Note: Returns predefined fields only - id, idReadable, summary, description, wikifiedDescription, usesMarkdown, project (id, shortName, name), parent (id, idReadable), assignee (id, login, name). Custom fields are not included.", issueIdArgs, async (rawInput) => {
         try {
@@ -278,5 +290,17 @@ export function registerIssueTools(server, client) {
             return errorResponse;
         }
     });
+    server.tool("issues_count", "Count YouTrack issues with optional filters. Returns total count and breakdown by projects. Use for: Getting accurate issue counts without pagination limits, analyzing issue distribution across projects.", issuesCountArgs, async (rawInput) => {
+        try {
+            const payload = issuesCountSchema.parse(rawInput);
+            const result = await client.countIssues(payload);
+            const response = toolSuccess(result);
+            return response;
+        }
+        catch (error) {
+            const errorResponse = toolError(error);
+            return errorResponse;
+        }
+    });
 }
 //# sourceMappingURL=issue-tools.js.map

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.3",
+  "version": "0.8.0",
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "postbuild": "chmod +x dist/index.js",