@vitalyostanin/youtrack-mcp 0.3.1 → 0.5.0

package/README-ru.md

@@ -6,6 +6,7 @@
 MCP сервер для полноценной интеграции с YouTrack со следующими возможностями:
 
 - **Управление задачами** - создание, обновление, комментирование, назначение, изменение статуса, пакетные операции
+- **Звездочки для задач** - отметка важных задач звездочками, массовое добавление (до 50), список отмеченных задач
 - **Управление вложениями** - загрузка файлов (до 10), скачивание по подписанным URL, удаление
 - **Учёт трудозатрат** - создание записей с идемпотентными операциями, массовое создание за период
 - **Детальные отчёты по времени** - сводные отчёты, анализ отклонений, статистика по пользователям
@@ -26,9 +27,11 @@ MCP сервер для полноценной интеграции с YouTrack
   - [Запуск сервера (stdio)](#запуск-сервера-stdio)
   - [Конфигурация для Code (Рекомендуется)](#конфигурация-для-code-рекомендуется)
   - [Конфигурация для Claude Code CLI](#конфигурация-для-claude-code-cli)
+  - [Конфигурация для VS Code Cline](#конфигурация-для-vs-code-cline)
   - [Инструменты MCP](#инструменты-mcp)
     - [Сервис](#сервис)
     - [Задачи](#задачи)
+    - [Звездочки задач](#звездочки-задач)
     - [Трудозатраты](#трудозатраты)
     - [Пользователи и проекты](#пользователи-и-проекты)
     - [Статьи](#статьи)
@@ -38,12 +41,13 @@ MCP сервер для полноценной интеграции с YouTrack
 
 - Node.js ≥ 20
 - Переменные окружения:
-- `YOUTRACK_URL` — базовый URL YouTrack
-- `YOUTRACK_TOKEN` — постоянный токен с правами на чтение задач и work items
-- `YOUTRACK_TIMEZONE` — опциональная таймзона для операций с датами (по умолчанию: `Europe/Moscow`), должна быть валидным идентификатором IANA (например, `Europe/London`, `America/New_York`, `Asia/Tokyo`)
-- `YOUTRACK_HOLIDAYS` — опциональный список праздничных дат через запятую (формат `YYYY-MM-DD`), исключаемых из отчётов и массовых операций
-- `YOUTRACK_PRE_HOLIDAYS` — опциональный список предпраздничных дат через запятую, для которых норма времени уменьшается автоматически
-- `YOUTRACK_USER_ALIASES` — опциональный список соответствий `alias:login` через запятую (например, `me:vyt,petya:p.petrov`), используется при автоматическом выборе исполнителей
+  - `YOUTRACK_URL` — базовый URL YouTrack
+  - `YOUTRACK_TOKEN` — постоянный токен с правами на чтение задач и work items
+  - `YOUTRACK_TIMEZONE` — опциональная таймзона для операций с датами (по умолчанию: `Europe/Moscow`), должна быть валидным идентификатором IANA (например, `Europe/London`, `America/New_York`, `Asia/Tokyo`)
+  - `YOUTRACK_HOLIDAYS` — опциональный список праздничных дат через запятую (формат `YYYY-MM-DD`), исключаемых из отчётов и массовых операций
+  - `YOUTRACK_PRE_HOLIDAYS` — опциональный список предпраздничных дат через запятую, для которых норма времени уменьшается автоматически
+  - `YOUTRACK_USER_ALIASES` — опциональный список соответствий `alias:login` через запятую (например, `me:vyt,petya:p.petrov`), используется при автоматическом выборе исполнителей
+  - `YOUTRACK_COMPACT_MODE` — опциональный, управляет минимизацией ответов для оптимизации контекстного окна AI (по умолчанию: `true`). Установите `false` для Claude Code, чтобы получать полный текст ответа в поле MCP content вместо минимальной заглушки. При `true` полные данные доступны в поле `structuredContent`
 
 ## Установка
 
@@ -54,7 +58,7 @@ MCP сервер для полноценной интеграции с YouTrack
 ```bash
 YOUTRACK_URL="https://youtrack.example.com" \
 YOUTRACK_TOKEN="perm:your-token-here" \
-npx -y @vitalyostanin/youtrack-mcp
+npx -y @vitalyostanin/youtrack-mcp@latest
 ```
 
 ### Используя Claude MCP CLI
@@ -189,7 +193,7 @@ node dist/index.js
 ```toml
 [mcp_servers.youtrack-mcp]
 command = "npx"
-args = ["-y", "@vitalyostanin/youtrack-mcp"]
+args = ["-y", "@vitalyostanin/youtrack-mcp@latest"]
 env = { "YOUTRACK_URL" = "https://youtrack.example.com", "YOUTRACK_TOKEN" = "perm:your-token-here" }
 ```
 
@@ -208,7 +212,36 @@ env = { "YOUTRACK_URL" = "https://youtrack.example.com", "YOUTRACK_TOKEN" = "per
     "youtrack-mcp": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@vitalyostanin/youtrack-mcp"],
+      "args": ["-y", "@vitalyostanin/youtrack-mcp@latest"],
+      "env": {
+        "YOUTRACK_URL": "https://youtrack.example.com",
+        "YOUTRACK_TOKEN": "perm:your-token-here",
+        "YOUTRACK_COMPACT_MODE": "false"
+      }
+    }
+  }
+}
+```
+
+**Примечание:** Эта конфигурация использует npx для запуска опубликованного пакета. Для локальной разработки используйте `"command": "node"` с `"args": ["/абсолютный/путь/к/youtrack-mcp/dist/index.js"]`. Переменные окружения `YOUTRACK_TIMEZONE`, `YOUTRACK_HOLIDAYS`, `YOUTRACK_PRE_HOLIDAYS` и `YOUTRACK_USER_ALIASES` являются опциональными.
+
+**Для пользователей Claude Code:** Установите `YOUTRACK_COMPACT_MODE` в `"false"`, чтобы включить полные данные ответа в поле MCP content. Это помогает Claude Code легче получать доступ к структурированным данным. При `true` (по умолчанию) в поле content возвращается только минимальная заглушка для оптимизации использования контекстного окна для других AI агентов.
+
+## Конфигурация для VS Code Cline
+
+Чтобы использовать этот MCP сервер с расширением [Cline](https://github.com/cline/cline) в VS Code:
+
+1. Откройте VS Code с установленным расширением Cline
+2. Нажмите на иконку MCP Servers в верхней навигации Cline
+3. Выберите вкладку "Configure" и нажмите "Configure MCP Servers"
+4. Добавьте следующую конфигурацию в `cline_mcp_settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "youtrack-mcp": {
+      "command": "npx",
+      "args": ["-y", "@vitalyostanin/youtrack-mcp@latest"],
       "env": {
         "YOUTRACK_URL": "https://youtrack.example.com",
         "YOUTRACK_TOKEN": "perm:your-token-here"
@@ -249,6 +282,16 @@ env = { "YOUTRACK_URL" = "https://youtrack.example.com", "YOUTRACK_TOKEN" = "per
 | `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_star` | Добавление звездочки к задаче для текущего пользователя. **Использование:** Отметка важных задач, добавление задач в список наблюдения, быстрый доступ к часто используемым задачам. **Возвращает:** подтверждение статуса звездочки с issueId и флагом starred. **Примечание:** Идемпотентная операция - возвращает успех, даже если задача уже отмечена звездочкой | `issueId` — код задачи (например, `PROJ-123`) |
+| `issue_unstar` | Удаление звездочки у задачи для текущего пользователя. **Использование:** Удаление задач из списка наблюдения, очистка ненужных звездочек, управление списком отмеченных задач. **Возвращает:** подтверждение операции снятия звездочки с issueId и флагом starred. **Примечание:** Идемпотентная операция - возвращает успех, даже если задача не была отмечена звездочкой | `issueId` — код задачи |
+| `issues_star_batch` | Добавление звездочек к нескольким задачам (пакетный режим, макс 50 задач). **Использование:** Массовая отметка важных задач, пакетное добавление в список наблюдения, обработка нескольких задач одновременно, быстрая настройка списка отмеченных задач. **Возвращает:** объект с массивами `successful` (отмеченные задачи) и `failed` (ошибки с ID задач). **Примечание:** Операции обрабатываются с ограничением конкурентности (10 одновременных запросов) для предотвращения перегрузки API. Возможен частичный успех - некоторые задачи могут быть обработаны успешно, а другие - нет | `issueIds[]` — массив кодов задач (например, `['PROJ-123', 'PROJ-124']`), макс 50 |
+| `issues_unstar_batch` | Удаление звездочек у нескольких задач (пакетный режим, макс 50 задач). **Использование:** Массовая очистка списка наблюдения, пакетное удаление ненужных звездочек, обработка нескольких задач одновременно, управление списком отмеченных задач. **Возвращает:** объект с массивами `successful` (задачи с удаленными звездочками) и `failed` (ошибки с ID задач). **Примечание:** Операции обрабатываются с ограничением конкурентности (10 одновременных запросов) для предотвращения перегрузки API. Возможен частичный успех - некоторые задачи могут быть обработаны успешно, а другие - нет | `issueIds[]` — массив кодов задач, макс 50 |
+| `issues_starred_list` | Получение всех отмеченных звездочками задач для текущего пользователя. **Использование:** Просмотр списка наблюдения, получение часто используемых задач, поиск всех отмеченных важных задач, проверка наличия звездочек у задач. **Возвращает:** массив отмеченных задач (краткий формат без description) и общее количество. **Примечание:** Ограничено 200 задачами за запрос. Результаты включают только базовую информацию (id, idReadable, summary, project, parent, assignee) без description для уменьшения размера ответа. Опциональное поле message в ответах star/unstar предоставляет информацию о статусе операции (например, 'Issue already starred', 'Issue starred successfully') | Опционально `limit` — максимальное количество задач (по умолчанию 50, макс 200), `skip` — количество задач для пропуска при пагинации (по умолчанию 0) |
+
 ### Трудозатраты
 
 | Tool | Описание | Основные параметры |

package/README.md

@@ -6,6 +6,7 @@
 MCP server for comprehensive YouTrack integration with the following capabilities:
 
 - **Issue management** - create, update, comment, assign, change state, batch operations
+- **Issue starring** - mark important issues with stars, batch starring (up to 50), list starred issues
 - **Attachment management** - upload files (up to 10), download with signed URLs, delete
 - **Work items tracking** - create entries with idempotent operations, batch creation for periods
 - **Detailed time reports** - summary reports, deviation analysis, multi-user statistics
@@ -26,9 +27,11 @@ MCP server for comprehensive YouTrack integration with the following capabilitie
   - [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 Stars](#issue-stars)
     - [Work Items](#work-items)
     - [Users and Projects](#users-and-projects)
     - [Articles](#articles)
@@ -45,6 +48,7 @@ MCP server for comprehensive YouTrack integration with the following capabilitie
   - `YOUTRACK_HOLIDAYS` — optional comma-separated list of holiday dates (format `YYYY-MM-DD`), excluded from reports and batch operations
   - `YOUTRACK_PRE_HOLIDAYS` — optional comma-separated list of pre-holiday dates with reduced working hours
   - `YOUTRACK_USER_ALIASES` — optional comma-separated list of `alias:login` mappings (e.g., `me:vyt,petya:p.petrov`), used for automatic assignee selection
+  - `YOUTRACK_COMPACT_MODE` — optional, controls response minimization for AI context window optimization (default: `true`). Set to `false` for Claude Code to get full response text in MCP content field instead of minimal stub. When `true`, full data is available in `structuredContent` field
 
 ## Installation
 
@@ -55,7 +59,7 @@ You can run the server directly with npx without installation:
 ```bash
 YOUTRACK_URL="https://youtrack.example.com" \
 YOUTRACK_TOKEN="perm:your-token-here" \
-npx -y @vitalyostanin/youtrack-mcp
+npx -y @vitalyostanin/youtrack-mcp@latest
 ```
 
 ### Using Claude MCP CLI
@@ -190,7 +194,7 @@ To use this MCP server with [Code](https://github.com/just-every/code), add the
 ```toml
 [mcp_servers.youtrack-mcp]
 command = "npx"
-args = ["-y", "@vitalyostanin/youtrack-mcp"]
+args = ["-y", "@vitalyostanin/youtrack-mcp@latest"]
 env = { "YOUTRACK_URL" = "https://youtrack.example.com", "YOUTRACK_TOKEN" = "perm:your-token-here" }
 ```
 
@@ -209,7 +213,36 @@ To use this MCP server with [Claude Code CLI](https://github.com/anthropics/clau
     "youtrack-mcp": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@vitalyostanin/youtrack-mcp"],
+      "args": ["-y", "@vitalyostanin/youtrack-mcp@latest"],
+      "env": {
+        "YOUTRACK_URL": "https://youtrack.example.com",
+        "YOUTRACK_TOKEN": "perm:your-token-here",
+        "YOUTRACK_COMPACT_MODE": "false"
+      }
+    }
+  }
+}
+```
+
+**Note:** This configuration uses npx to run the published package. For local development, use `"command": "node"` with `"args": ["/absolute/path/to/youtrack-mcp/dist/index.js"]`. The `YOUTRACK_TIMEZONE`, `YOUTRACK_HOLIDAYS`, `YOUTRACK_PRE_HOLIDAYS`, and `YOUTRACK_USER_ALIASES` environment variables are optional.
+
+**For Claude Code users:** Set `YOUTRACK_COMPACT_MODE` to `"false"` to include full response data in the MCP content field. This helps Claude Code access structured data more easily. When `true` (default), only a minimal stub is returned in the content field to optimize context window usage for other AI agents.
+
+## Configuration for VS Code Cline
+
+To use this MCP server with [Cline](https://github.com/cline/cline) extension in VS Code:
+
+1. Open VS Code with Cline extension installed
+2. Click the MCP Servers icon in Cline's top navigation
+3. Select the "Configure" tab and click "Configure MCP Servers"
+4. Add the following configuration to `cline_mcp_settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "youtrack-mcp": {
+      "command": "npx",
+      "args": ["-y", "@vitalyostanin/youtrack-mcp@latest"],
       "env": {
         "YOUTRACK_URL": "https://youtrack.example.com",
         "YOUTRACK_TOKEN": "perm:your-token-here"
@@ -252,6 +285,16 @@ All tools return `structuredContent` with a `success` flag and payload formatted
 | `issue_attachment_upload` | Upload files to issue | `issueId`, `filePaths[]` — array of file paths (max 10), optionally `muteUpdateNotifications` |
 | `issue_attachment_delete` | Delete attachment (requires confirmation) | `issueId`, `attachmentId`, `confirmation` (must be `true`) |
 
+### Issue Stars
+
+| Tool | Description | Main Parameters |
+| --- | --- | --- |
+| `issue_star` | Add star to issue for current user | `issueId` — issue code (e.g., PROJ-123). Idempotent operation - returns success even if already starred |
+| `issue_unstar` | Remove star from issue for current user | `issueId` — issue code. Idempotent operation - returns success even if not currently starred |
+| `issues_star_batch` | Add stars to multiple issues (batch mode, max 50) | `issueIds[]` — array of issue codes (max 50). Returns object with `successful` and `failed` arrays. Processes with concurrency limit (10 concurrent requests) |
+| `issues_unstar_batch` | Remove stars from multiple issues (batch mode, max 50) | `issueIds[]` — array of issue codes (max 50). Returns object with `successful` and `failed` arrays. Processes with concurrency limit (10 concurrent requests) |
+| `issues_starred_list` | Get all starred issues for current user | Optionally `limit` (default 50, max 200), `skip` for pagination. Returns array of starred issues with basic information (id, idReadable, summary, project, parent, assignee) without description fields |
+
 ### Work Items
 
 | Tool | Description | Main Parameters |

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@vitalyostanin/youtrack-mcp",
-    "version": "0.3.1",
+    "version": "0.5.0",
     "scripts": {
         "build": "tsc -p tsconfig.json",
         "postbuild": "chmod +x dist/index.js",
@@ -51,6 +51,7 @@
     },
     "dependencies": {
         "@modelcontextprotocol/sdk": "^1.20.0",
+        "@vitalyostanin/mutex-pool": "^0.0.3",
         "axios": "^1.12.2",
         "form-data": "^4.0.1",
         "luxon": "^3.5.0",

package/dist/src/config.d.ts

@@ -6,5 +6,6 @@ export declare function enrichConfigWithRedaction(config: YoutrackConfig): {
     timezone: string;
     holidays: string[] | undefined;
     preHolidays: string[] | undefined;
+    compactMode: boolean;
 };
 //# sourceMappingURL=config.d.ts.map

package/dist/src/config.js

@@ -6,6 +6,11 @@ const configSchema = z.object({
     YOUTRACK_HOLIDAYS: z.string().optional(),
     YOUTRACK_PRE_HOLIDAYS: z.string().optional(),
     YOUTRACK_USER_ALIASES: z.string().optional(),
+    YOUTRACK_COMPACT_MODE: z
+        .string()
+        .optional()
+        .default("true")
+        .transform((val) => val !== "false"),
 });
 export function loadConfig(env = process.env) {
     const parsed = configSchema.safeParse(env);
@@ -32,6 +37,7 @@ export function loadConfig(env = process.env) {
         userAliases: parsed.data.YOUTRACK_USER_ALIASES
             ? parseAliasMap(parsed.data.YOUTRACK_USER_ALIASES)
             : undefined,
+        compactMode: parsed.data.YOUTRACK_COMPACT_MODE,
     };
 }
 export function enrichConfigWithRedaction(config) {
@@ -41,6 +47,7 @@ export function enrichConfigWithRedaction(config) {
         timezone: config.timezone,
         holidays: config.holidays,
         preHolidays: config.preHolidays,
+        compactMode: config.compactMode,
     };
 }
 function parseCsvList(value) {

package/dist/src/server.js

@@ -10,6 +10,7 @@ import { registerArticleSearchTools } from "./tools/article-search-tools.js";
 import { registerUserTools } from "./tools/user-tools.js";
 import { registerProjectTools } from "./tools/project-tools.js";
 import { registerAttachmentTools } from "./tools/attachment-tools.js";
+import { registerIssueStarTools } from "./tools/issue-star-tools.js";
 import { YoutrackClient } from "./youtrack-client.js";
 import { loadConfig } from "./config.js";
 import { initializeTimezone } from "./utils/date.js";
@@ -35,7 +36,7 @@ export class YoutrackServer {
         registerServiceInfoTool(this.server, this.client);
         registerIssueTools(this.server, this.client);
         registerIssueActivityTools(this.server, this.client);
-        registerIssueSearchTools(this.server, this.client);
+        registerIssueSearchTools(this.server, this.client, config);
         registerWorkitemTools(this.server, this.client);
         registerWorkitemReportTools(this.server, this.client);
         registerArticleTools(this.server, this.client);
@@ -43,6 +44,7 @@ export class YoutrackServer {
         registerUserTools(this.server, this.client);
         registerProjectTools(this.server, this.client);
         registerAttachmentTools(this.server, this.client);
+        registerIssueStarTools(this.server, this.client);
     }
     async connect(transport) {
         await this.server.connect(transport);

package/dist/src/tools/issue-search-tools.d.ts

@@ -1,4 +1,5 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { YoutrackClient } from "../youtrack-client.js";
-export declare function registerIssueSearchTools(server: McpServer, client: YoutrackClient): void;
+import type { YoutrackConfig } from "../types.js";
+export declare function registerIssueSearchTools(server: McpServer, client: YoutrackClient, config: YoutrackConfig): void;
 //# sourceMappingURL=issue-search-tools.d.ts.map

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

@@ -17,6 +17,10 @@ const issueSearchByUserActivityArgs = {
         .enum(["issue_updated", "user_activity"])
         .optional()
         .describe("Date filter mode: 'issue_updated' (default, fast) filters by issue.updated field; 'user_activity' (slow, precise) filters by actual user activity dates including comments, mentions, and field changes history. Use 'user_activity' when you need exact date of user's involvement, e.g., when user was assignee but later changed."),
+    briefOutput: z
+        .boolean()
+        .optional()
+        .describe("Return brief issue data without description fields (default: true). Set to false to include full description and wikifiedDescription fields."),
     limit: z
         .number()
         .int()
@@ -32,8 +36,8 @@ const issueSearchByUserActivityArgs = {
         .describe("Number of results to skip for pagination (default: 0)"),
 };
 const issueSearchByUserActivitySchema = z.object(issueSearchByUserActivityArgs);
-export function registerIssueSearchTools(server, client) {
-    server.tool("issue_search_by_user_activity", "Search for issues where specified users had activity (updated, mentioned, reported, assigned, commented) within a given time period. Supports two filter modes: 'issue_updated' (default, fast) uses issue.updated field, 'user_activity' (slow, precise) checks actual user activity dates including comments, mentions, and field changes history. Results are sorted by activity time (most recent first). When 'user_activity' mode is used, each issue includes 'lastActivityDate' field with exact timestamp of user's last activity. Supports pagination via limit and skip parameters. Note: Each issue includes predefined fields only - id, idReadable, summary, project (id, shortName, name), parent (id, idReadable), assignee (id, login, name). Description is not included to reduce response size - use issue_details or issues_details to get full details. Custom fields are not included.", issueSearchByUserActivityArgs, async (rawInput) => {
+export function registerIssueSearchTools(server, client, config) {
+    server.tool("issue_search_by_user_activity", "Search for issues where specified users had activity (updated, mentioned, reported, assigned, commented) within a given time period. Supports two filter modes: 'issue_updated' (default, fast) uses issue.updated field, 'user_activity' (slow, precise) checks actual user activity dates including comments, mentions, and field changes history. Results are sorted by activity time (most recent first). When 'user_activity' mode is used, each issue includes 'lastActivityDate' field with exact timestamp of user's last activity. Supports pagination via limit and skip parameters. Note: By default (briefOutput=true), each issue includes minimal fields only - id, idReadable, summary, project (id, shortName, name), parent (id, idReadable), assignee (id, login, name). Description fields are excluded to reduce response size. Set briefOutput=false to include full description and wikifiedDescription fields. Custom fields are not included.", issueSearchByUserActivityArgs, async (rawInput) => {
         try {
             const payload = issueSearchByUserActivitySchema.parse(rawInput);
             const results = await client.searchIssuesByUserActivity({
@@ -41,10 +45,11 @@ export function registerIssueSearchTools(server, client) {
                 startDate: payload.startDate,
                 endDate: payload.endDate,
                 dateFilterMode: payload.dateFilterMode,
+                briefOutput: payload.briefOutput,
                 limit: payload.limit,
                 skip: payload.skip,
             });
-            const response = toolSuccess(results);
+            const response = toolSuccess(results, config.compactMode);
             return response;
         }
         catch (error) {

package/dist/src/tools/issue-star-tools.d.ts

@@ -0,0 +1,7 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { YoutrackClient } from "../youtrack-client.js";
+/**
+ * Register issue star management tools
+ */
+export declare function registerIssueStarTools(server: McpServer, client: YoutrackClient): void;
+//# sourceMappingURL=issue-star-tools.d.ts.map

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

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import { toolSuccess, toolError } from "../utils/tool-response.js";
+/**
+ * Creates a tool handler with standard error handling
+ */
+function createToolHandler(handler) {
+    return async (args) => {
+        try {
+            const result = await handler(args);
+            const response = toolSuccess(result);
+            return response;
+        }
+        catch (error) {
+            const errorResponse = toolError(error);
+            return errorResponse;
+        }
+    };
+}
+/**
+ * Register issue star management tools
+ */
+export function registerIssueStarTools(server, client) {
+    // Tool: issue_star
+    server.tool("issue_star", "Add star to YouTrack issue for current user. Use for: Marking important issues, Adding issues to watchlist, Quick access to frequently used issues. Returns: Confirmation of star status with issueId and starred flag. Note: If issue is already starred, returns success without making changes (idempotent operation).", {
+        issueId: z.string().min(1).describe("Issue code (e.g., PROJ-123)"),
+    }, createToolHandler(async (args) => client.starIssue(args.issueId)));
+    // Tool: issue_unstar
+    server.tool("issue_unstar", "Remove star from YouTrack issue for current user. Use for: Removing issues from watchlist, Cleaning up unneeded stars, Managing starred issues list. Returns: Confirmation of unstar operation with issueId and starred flag. Note: If issue is not currently starred, returns success without making changes (idempotent operation).", {
+        issueId: z.string().min(1).describe("Issue code (e.g., PROJ-123)"),
+    }, createToolHandler(async (args) => client.unstarIssue(args.issueId)));
+    // Tool: issues_star_batch
+    server.tool("issues_star_batch", "Add stars to multiple YouTrack issues (batch mode, max 50 issues). Use for: Bulk marking important issues, Batch adding to watchlist, Processing multiple issues at once, Quick setup of starred issues list. Returns: Object with 'successful' array (starred issues) and 'failed' array (errors with issue IDs). Note: Operations are processed with concurrency limit (10 concurrent requests) to prevent API overload. Partial success is possible - some issues may succeed while others fail.", {
+        issueIds: z
+            .array(z.string().min(1))
+            .min(1)
+            .max(50)
+            .describe("Array of issue codes (e.g., ['PROJ-123', 'PROJ-124']), max 50"),
+    }, createToolHandler(async (args) => client.starIssues(args.issueIds)));
+    // Tool: issues_unstar_batch
+    server.tool("issues_unstar_batch", "Remove stars from multiple YouTrack issues (batch mode, max 50 issues). Use for: Bulk cleanup of watchlist, Batch removal of unneeded stars, Processing multiple issues at once, Managing starred issues list. Returns: Object with 'successful' array (unstarred issues) and 'failed' array (errors with issue IDs). Note: Operations are processed with concurrency limit (10 concurrent requests) to prevent API overload. Partial success is possible - some issues may succeed while others fail.", {
+        issueIds: z
+            .array(z.string().min(1))
+            .min(1)
+            .max(50)
+            .describe("Array of issue codes (e.g., ['PROJ-123', 'PROJ-124']), max 50"),
+    }, createToolHandler(async (args) => client.unstarIssues(args.issueIds)));
+    // Tool: issues_starred_list
+    server.tool("issues_starred_list", "Get all starred issues for current user with pagination. Use for: Viewing watchlist, Getting frequently used issues, Finding all marked important issues, Checking which issues are starred. Returns: Array of starred issues (brief format without description fields), returnedCount (count of issues in current page), and pagination info. Note: Default limit is 50 issues, max 200. Results include basic issue information only (id, idReadable, summary, project, parent, assignee) without description fields to reduce payload size. The optional message field in star/unstar responses provides status information about the operation (e.g., 'Issue already starred', 'Issue starred successfully').", {
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .max(200)
+            .optional()
+            .describe("Maximum number of issues to return (default: 50, max: 200)"),
+        skip: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe("Number of issues to skip for pagination (default: 0)"),
+    }, createToolHandler(async (args) => client.getStarredIssues({
+        limit: args.limit,
+        skip: args.skip,
+    })));
+}
+//# sourceMappingURL=issue-star-tools.js.map

package/dist/src/types.d.ts

@@ -12,6 +12,7 @@ export interface YoutrackConfig {
     holidays?: string[];
     preHolidays?: string[];
     userAliases?: UserAliasMap;
+    compactMode: boolean;
 }
 export interface DurationValue {
     minutes?: number;
@@ -23,6 +24,10 @@ export interface YoutrackProject {
     shortName: string;
     name?: string;
 }
+export interface YoutrackIssueWatchers {
+    hasStar: boolean;
+    $type: string;
+}
 export interface YoutrackIssue {
     id: string;
     idReadable: string;
@@ -36,6 +41,7 @@ export interface YoutrackIssue {
         id?: string;
     } | null;
     assignee?: YoutrackUser | null;
+    watchers?: YoutrackIssueWatchers | null;
 }
 export interface YoutrackIssueCreateInput {
     project: string;
@@ -344,6 +350,7 @@ export interface IssueSearchInput {
     startDate?: string | number | Date;
     endDate?: string | number | Date;
     dateFilterMode?: "issue_updated" | "user_activity";
+    briefOutput?: boolean;
     limit?: number;
     skip?: number;
 }
@@ -525,4 +532,41 @@ export interface IssueActivitiesPayload {
         skip?: number;
     };
 }
+export interface YoutrackIssueWatcher {
+    id: string;
+    user: YoutrackUser;
+    isStarred: boolean;
+    $type: string;
+}
+export interface IssueStarInput {
+    issueId: string;
+}
+export interface IssueStarBatchInput {
+    issueIds: string[];
+}
+export interface IssueStarPayload {
+    issueId: string;
+    starred: boolean;
+    message?: string;
+}
+export interface IssueStarBatchPayload {
+    successful: Array<{
+        issueId: string;
+        starred: boolean;
+    }>;
+    failed: Array<{
+        issueId: string;
+        error: string;
+    }>;
+}
+export interface PaginationInfo {
+    returned: number;
+    limit: number;
+    skip: number;
+}
+export interface IssuesStarredPayload {
+    issues: MappedYoutrackIssue[];
+    returnedCount: number;
+    pagination: PaginationInfo;
+}
 //# sourceMappingURL=types.d.ts.map

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

@@ -46,6 +46,11 @@ export declare function mapIssue(issue: YoutrackIssue): MappedYoutrackIssue;
  * Map YoutrackIssueDetails to MappedYoutrackIssueDetails
  */
 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;
 /**
  * Map YoutrackWorkItem to MappedYoutrackWorkItem
  */

package/dist/src/utils/mappers.js

@@ -48,6 +48,15 @@ export function mapIssueDetails(issue) {
         resolved: timestampToIsoDateTime(issue.resolved),
     };
 }
+/**
+ * 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
+    const { description, wikifiedDescription, ...rest } = issue;
+    return rest;
+}
 /**
  * Map YoutrackWorkItem to MappedYoutrackWorkItem
  */

package/dist/src/utils/tool-response.d.ts

@@ -1,4 +1,4 @@
 import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-export declare function toolSuccess<T>(payload: T): CallToolResult;
+export declare function toolSuccess<T>(payload: T, compactMode?: boolean): CallToolResult;
 export declare function toolError(error: unknown): CallToolResult;
 //# sourceMappingURL=tool-response.d.ts.map

package/dist/src/utils/tool-response.js

@@ -1,14 +1,20 @@
 import { ZodError } from "zod";
-export function toolSuccess(payload) {
+export function toolSuccess(payload, compactMode = true) {
     const structuredContent = {
         success: true,
         payload,
     };
+    // In compact mode, minimize content field to reduce context window usage for AI agents.
+    // Claude Code (when compactMode=false) gets full data in content field for better accessibility.
+    // Other AI agents benefit from minimal content to save context window tokens.
+    const contentText = compactMode
+        ? "Success. Use structuredContent for full data."
+        : JSON.stringify(structuredContent, null, 2);
     return {
         content: [
             {
                 type: "text",
-                text: JSON.stringify(structuredContent, null, 2),
+                text: contentText,
             },
         ],
         structuredContent,