@vitalyostanin/youtrack-mcp 0.3.1 → 0.4.0

package/README-ru.md

@@ -26,6 +26,7 @@ MCP сервер для полноценной интеграции с YouTrack
   - [Запуск сервера (stdio)](#запуск-сервера-stdio)
   - [Конфигурация для Code (Рекомендуется)](#конфигурация-для-code-рекомендуется)
   - [Конфигурация для Claude Code CLI](#конфигурация-для-claude-code-cli)
+  - [Конфигурация для VS Code Cline](#конфигурация-для-vs-code-cline)
   - [Инструменты MCP](#инструменты-mcp)
     - [Сервис](#сервис)
     - [Задачи](#задачи)
@@ -38,12 +39,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 +56,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 +191,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 +210,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"

package/README.md

@@ -26,6 +26,7 @@ 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)
@@ -45,6 +46,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 +57,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 +192,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 +211,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"

package/dist/package.json

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

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

@@ -35,7 +35,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);

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/types.d.ts

@@ -12,6 +12,7 @@ export interface YoutrackConfig {
     holidays?: string[];
     preHolidays?: string[];
     userAliases?: UserAliasMap;
+    compactMode: boolean;
 }
 export interface DurationValue {
     minutes?: number;
@@ -344,6 +345,7 @@ export interface IssueSearchInput {
     startDate?: string | number | Date;
     endDate?: string | number | Date;
     dateFilterMode?: "issue_updated" | "user_activity";
+    briefOutput?: boolean;
     limit?: number;
     skip?: number;
 }

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,

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

@@ -1,5 +1,5 @@
 import { type MappedYoutrackIssueComment, type MappedYoutrackWorkItem } from "./utils/mappers.js";
-import type { ArticleCreateInput, ArticleListPayload, ArticlePayload, ArticleSearchInput, ArticleSearchPayload, ArticleUpdateInput, AttachmentDeleteInput, AttachmentDeletePayload, AttachmentDownloadPayload, AttachmentPayload, AttachmentsListPayload, AttachmentUploadInput, AttachmentUploadPayload, IssueChangeStateInput, IssueChangeStatePayload, IssueCommentsPayload, IssueCommentCreateInput, IssueCommentUpdateInput, IssueCommentUpdatePayload, IssueDetailsPayload, IssueLookupPayload, IssueSearchInput, IssueSearchPayload, IssuesCommentsPayload, IssuesDetailsPayload, IssuesLookupPayload, WorkItemBulkResultPayload, WorkItemDeletePayload, WorkItemInvalidDay, WorkItemReportPayload, WorkItemUsersReportPayload, YoutrackActivityItem, YoutrackConfig, YoutrackCustomField, YoutrackIssueAssignInput, YoutrackIssueCreateInput, YoutrackIssueUpdateInput, YoutrackProject, YoutrackProjectListPayload, YoutrackUser, YoutrackUserListPayload, YoutrackWorkItem, YoutrackWorkItemCreateInput, YoutrackWorkItemIdempotentCreateInput, YoutrackWorkItemPeriodCreateInput, YoutrackWorkItemReportOptions, YoutrackWorkItemUpdateInput } from "./types.js";
+import type { ArticleCreateInput, ArticleListPayload, ArticlePayload, ArticleSearchInput, ArticleSearchPayload, ArticleUpdateInput, AttachmentDeleteInput, AttachmentDeletePayload, AttachmentDownloadPayload, AttachmentPayload, AttachmentsListPayload, AttachmentUploadInput, AttachmentUploadPayload, IssueChangeStateInput, IssueChangeStatePayload, IssueCommentsPayload, IssueCommentCreateInput, IssueCommentUpdateInput, IssueCommentUpdatePayload, IssueDetailsPayload, IssueLookupPayload, IssueSearchInput, IssueSearchPayload, IssuesCommentsPayload, IssuesDetailsPayload, IssuesLookupPayload, WorkItemBulkResultPayload, WorkItemDeletePayload, WorkItemInvalidDay, WorkItemReportPayload, WorkItemUsersReportPayload, YoutrackActivityItem, YoutrackConfig, YoutrackCustomField, YoutrackIssueAssignInput, YoutrackIssueComment, YoutrackIssueCreateInput, YoutrackIssueDetails, YoutrackIssueUpdateInput, YoutrackProject, YoutrackProjectListPayload, YoutrackUser, YoutrackUserListPayload, YoutrackWorkItem, YoutrackWorkItemCreateInput, YoutrackWorkItemIdempotentCreateInput, YoutrackWorkItemPeriodCreateInput, YoutrackWorkItemReportOptions, YoutrackWorkItemUpdateInput } from "./types.js";
 export declare class YoutrackClient {
     private readonly config;
     private readonly http;
@@ -30,10 +30,26 @@ export declare class YoutrackClient {
     assignIssue(input: YoutrackIssueAssignInput): Promise<IssueLookupPayload>;
     getIssues(issueIds: string[]): Promise<IssuesLookupPayload>;
     getIssuesDetails(issueIds: string[]): Promise<IssuesDetailsPayload>;
+    /**
+     * Light version of getIssuesDetails() that fetches only minimal fields (id, idReadable, updated, updater)
+     * Used for filtering in user_activity mode to reduce payload size
+     */
+    getIssuesDetailsLight(issueIds: string[]): Promise<YoutrackIssueDetails[]>;
     getMultipleIssuesComments(issueIds: string[]): Promise<IssuesCommentsPayload>;
+    /**
+     * Light version of getMultipleIssuesComments() that fetches only minimal comment fields
+     * (id, author.login, created, text) for filtering in user_activity mode to reduce payload size
+     */
+    getMultipleIssuesCommentsLight(issueIds: string[]): Promise<Record<string, YoutrackIssueComment[]>>;
     searchIssuesByUserActivity(input: IssueSearchInput): Promise<IssueSearchPayload>;
     private searchIssuesByUserActivitySimple;
     private searchIssuesByUserActivityStrict;
+    /**
+     * Filters candidate issues by user activity dates (comments, activities, updater)
+     * Used in user_activity mode to determine which issues had activity from specified users
+     */
+    private filterIssuesByUserActivity;
+    private searchIssuesStrictFallbackRequest;
     listWorkItems({ author, startDate, endDate, issueId, top: limit, allUsers, }?: {
         author?: string;
         startDate?: string | number | Date;

package/dist/src/youtrack-client.js

@@ -2,14 +2,17 @@ import axios from "axios";
 import FormData from "form-data";
 import fs from "fs";
 import { calculateTotalMinutes, enumerateDateRange, filterWorkingDays, getDayBounds, groupWorkItemsByDate, isWeekend, minutesToHours, parseDateInput, toIsoDateString, validateDateRange, } from "./utils/date.js";
-import { mapAttachment, mapAttachments, mapComment, mapComments, mapIssue, mapIssueDetails, mapWorkItem, mapWorkItems, } from "./utils/mappers.js";
+import { mapAttachment, mapAttachments, mapComment, mapComments, mapIssue, mapIssueBrief, mapIssueDetails, mapWorkItem, mapWorkItems, } from "./utils/mappers.js";
 const DEFAULT_PAGE_SIZE = 200;
 const DEFAULT_EXPECTED_MINUTES = 8 * 60;
 const defaultFields = {
     issue: "id,idReadable,summary,description,wikifiedDescription,usesMarkdown,project(id,shortName,name),parent(id,idReadable),assignee(id,login,name)",
     issueSearch: "id,idReadable,summary,description,wikifiedDescription,usesMarkdown,project(id,shortName,name),parent(id,idReadable),assignee(id,login,name)",
+    issueSearchBrief: "id,idReadable,summary,project(id,shortName,name),parent(id,idReadable),assignee(id,login,name)",
     issueDetails: "id,idReadable,summary,description,wikifiedDescription,usesMarkdown,created,updated,resolved,project(id,shortName,name),parent(id,idReadable),assignee(id,login,name),reporter(id,login,name),updater(id,login,name)",
+    issueDetailsLight: "id,idReadable,updated,updater(login)",
     comments: "id,text,textPreview,usesMarkdown,author(id,login,name),created,updated",
+    commentsLight: "id,author(login),created,text",
     workItem: "id,date,updated,duration(minutes,presentation),text,textPreview,usesMarkdown,description,issue(id,idReadable),author(id,login,name,email)",
     workItems: "id,date,updated,duration(minutes,presentation),text,textPreview,usesMarkdown,description,issue(id,idReadable),author(id,login,name,email)",
     users: "id,login,name,fullName,email",
@@ -403,6 +406,30 @@ export class YoutrackClient {
             throw this.normalizeError(error);
         }
     }
+    /**
+     * Light version of getIssuesDetails() that fetches only minimal fields (id, idReadable, updated, updater)
+     * Used for filtering in user_activity mode to reduce payload size
+     */
+    async getIssuesDetailsLight(issueIds) {
+        if (!issueIds.length) {
+            return [];
+        }
+        // Build query: "issue id: BC-123 BC-124 BC-125"
+        const query = `issue id: ${issueIds.join(" ")}`;
+        try {
+            const response = await this.http.get("/api/issues", {
+                params: {
+                    fields: defaultFields.issueDetailsLight,
+                    query,
+                    $top: issueIds.length,
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw this.normalizeError(error);
+        }
+    }
     async getMultipleIssuesComments(issueIds) {
         if (!issueIds.length) {
             return { commentsByIssue: {}, errors: [] };
@@ -435,6 +462,36 @@ export class YoutrackClient {
             errors: errors.length ? errors : undefined,
         };
     }
+    /**
+     * Light version of getMultipleIssuesComments() that fetches only minimal comment fields
+     * (id, author.login, created, text) for filtering in user_activity mode to reduce payload size
+     */
+    async getMultipleIssuesCommentsLight(issueIds) {
+        if (!issueIds.length) {
+            return {};
+        }
+        // Make parallel requests for all issues
+        const promises = issueIds.map(async (issueId) => {
+            try {
+                const response = await this.http.get(`/api/issues/${issueId}/comments`, {
+                    params: { fields: defaultFields.commentsLight },
+                });
+                return { issueId, comments: response.data, success: true };
+            }
+            catch {
+                // Silently ignore errors in light mode - return empty array
+                return { issueId, success: false };
+            }
+        });
+        const results = await Promise.all(promises);
+        const commentsByIssue = {};
+        for (const result of results) {
+            if (result.success) {
+                commentsByIssue[result.issueId] = result.comments;
+            }
+        }
+        return commentsByIssue;
+    }
     async searchIssuesByUserActivity(input) {
         const mode = input.dateFilterMode ?? "issue_updated";
         if (mode === "issue_updated") {
@@ -467,17 +524,18 @@ export class YoutrackClient {
         const query = filterQuery ? `${filterQuery} ${sortPart}` : sortPart;
         const limit = input.limit ?? 100;
         const skip = input.skip ?? 0;
+        const briefOutput = input.briefOutput ?? true;
         try {
             const response = await this.http.get("/api/issues", {
                 params: {
-                    fields: defaultFields.issueSearch,
+                    fields: briefOutput ? defaultFields.issueSearchBrief : defaultFields.issueSearch,
                     query,
                     $top: Math.min(limit, DEFAULT_PAGE_SIZE),
                     $skip: skip,
                 },
             });
             return {
-                issues: response.data.map(mapIssue),
+                issues: briefOutput ? response.data.map(mapIssueBrief) : response.data.map(mapIssue),
                 userLogins: input.userLogins,
                 period: {
                     startDate: input.startDate ? toIsoDateString(input.startDate) : undefined,
@@ -496,28 +554,31 @@ export class YoutrackClient {
     }
     async searchIssuesByUserActivityStrict(input) {
         const filters = [];
-        // Build query for user activity without date filter
-        if (input.userLogins.length > 0) {
-            const userClauses = input.userLogins.map((login) => `updater: {${login}} or mentions: {${login}} or reporter: {${login}} or assignee: {${login}}`);
-            if (userClauses.length === 1) {
-                filters.push(userClauses[0]);
-            }
-            else {
-                filters.push(`(${userClauses.join(" or ")})`);
-            }
+        // Build query without user filters to avoid parser issues on some YT instances.
+        // We will fetch by date window only, then apply precise user-activity filtering client-side.
+        // Add date range filter (align with simple mode) to avoid YT query parser quirks
+        // 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());
+            filters.push(`updated: ${startDateStr} .. ${endDateStr}`);
         }
         const sortPart = "sort by: updated desc";
         const filterQuery = filters.length > 0 ? filters.join(" and ") : undefined;
         const query = filterQuery ? `${filterQuery} ${sortPart}` : sortPart;
-        // Get candidate issues
+        const briefOutput = input.briefOutput ?? true;
+        // Get candidate issues (use brief fields to reduce payload)
         try {
+            // Fetch candidates by date only (no user filters) to ensure parser compatibility
             const response = await this.http.get("/api/issues", {
                 params: {
-                    fields: defaultFields.issueSearch,
-                    query,
+                    fields: briefOutput ? defaultFields.issueSearchBrief : defaultFields.issueSearch,
+                    query, // use full query with date filter and sorting
                     $top: DEFAULT_PAGE_SIZE,
                 },
             });
+            // If no data returned, still attempt a fallback without braces
+            // No fallback needed here since we purposely avoided user filters in query
             const candidateIssues = response.data;
             if (candidateIssues.length === 0) {
                 return {
@@ -534,86 +595,25 @@ export class YoutrackClient {
                     },
                 };
             }
-            // Get issueIds and fetch details + comments + activities
+            // Get issueIds and fetch details + comments (light versions for filtering)
             const issueIds = candidateIssues.map((issue) => issue.idReadable);
-            const [detailsResult, commentsResult] = await Promise.all([
-                this.getIssuesDetails(issueIds),
-                this.getMultipleIssuesComments(issueIds),
+            const [detailsLight, commentsLight] = await Promise.all([
+                this.getIssuesDetailsLight(issueIds),
+                this.getMultipleIssuesCommentsLight(issueIds),
             ]);
             // Get activities for each issue
             const activitiesPromises = issueIds.map((issueId) => this.getIssueActivities(issueId));
             const activitiesResults = await Promise.all(activitiesPromises);
-            const startTimestamp = input.startDate ? new Date(input.startDate).getTime() : 0;
-            const endTimestamp = input.endDate ? new Date(input.endDate).getTime() : Date.now();
             // Process each issue to determine lastActivityDate
-            const issuesWithActivity = [];
-            for (let i = 0; i < candidateIssues.length; i++) {
-                const issue = candidateIssues[i];
-                const issueId = issue.idReadable;
-                const details = detailsResult.issues.find((d) => d.idReadable === issueId);
-                const comments = commentsResult.commentsByIssue[issueId] ?? [];
-                const activities = activitiesResults[i] ?? [];
-                const dates = [];
-                // Check comments from user
-                for (const userLogin of input.userLogins) {
-                    for (const comment of comments) {
-                        if (comment.author?.login === userLogin && comment.created) {
-                            const commentDate = new Date(comment.created).getTime();
-                            if (commentDate >= startTimestamp && commentDate <= endTimestamp) {
-                                dates.push(commentDate);
-                            }
-                        }
-                        // Check mentions in comment text
-                        if (comment.text?.includes(`@${userLogin}`) && comment.created) {
-                            const commentDate = new Date(comment.created).getTime();
-                            if (commentDate >= startTimestamp && commentDate <= endTimestamp) {
-                                dates.push(commentDate);
-                            }
-                        }
-                    }
-                    // Check activities from user or where user is in added/removed
-                    for (const activity of activities) {
-                        if (activity.timestamp >= startTimestamp && activity.timestamp <= endTimestamp) {
-                            // Activity by user
-                            if (activity.author?.login === userLogin) {
-                                dates.push(activity.timestamp);
-                            }
-                            // User added or removed in field change (e.g., assignee)
-                            const inAdded = activity.added?.some((v) => v.login === userLogin);
-                            const inRemoved = activity.removed?.some((v) => v.login === userLogin);
-                            if (inAdded || inRemoved) {
-                                dates.push(activity.timestamp);
-                            }
-                        }
-                    }
-                    // Check if user is updater and updated date is in range
-                    if (details?.updater?.login === userLogin && details.updated) {
-                        const updateDate = new Date(details.updated).getTime();
-                        if (updateDate >= startTimestamp && updateDate <= endTimestamp) {
-                            dates.push(updateDate);
-                        }
-                    }
-                }
-                if (dates.length > 0) {
-                    const lastActivityTimestamp = Math.max(...dates);
-                    const lastActivityDate = new Date(lastActivityTimestamp).toISOString();
-                    issuesWithActivity.push({
-                        issue,
-                        lastActivityDate,
-                    });
-                }
-            }
-            // Sort by lastActivityDate descending
-            issuesWithActivity.sort((a, b) => {
-                return new Date(b.lastActivityDate).getTime() - new Date(a.lastActivityDate).getTime();
-            });
+            const issuesWithActivity = this.filterIssuesByUserActivity(candidateIssues, detailsLight, commentsLight, activitiesResults, input);
             // Apply pagination
             const skip = input.skip ?? 0;
             const limit = input.limit ?? 100;
             const paginatedIssues = issuesWithActivity.slice(skip, skip + limit);
-            // Map issues with lastActivityDate
+            // Map issues with lastActivityDate (use brief mapping if requested)
+            const mapperFn = briefOutput ? mapIssueBrief : mapIssue;
             const resultIssues = paginatedIssues.map(({ issue, lastActivityDate }) => ({
-                ...mapIssue(issue),
+                ...mapperFn(issue),
                 lastActivityDate,
             }));
             return {
@@ -631,9 +631,153 @@ export class YoutrackClient {
             };
         }
         catch (error) {
-            throw this.normalizeError(error);
+            const normalized = this.normalizeError(error);
+            // Retry once with a relaxed query (without braces) if YT parser rejects the original
+            if ((normalized.message || "").toLowerCase().includes("parse search query")) {
+                try {
+                    const candidateIssues = await this.searchIssuesStrictFallbackRequest(briefOutput, sortPart, input);
+                    if (candidateIssues.length === 0) {
+                        return {
+                            issues: [],
+                            userLogins: input.userLogins,
+                            period: {
+                                startDate: input.startDate ? toIsoDateString(input.startDate) : undefined,
+                                endDate: input.endDate ? toIsoDateString(input.endDate) : undefined,
+                            },
+                            pagination: {
+                                returned: 0,
+                                limit: input.limit ?? 100,
+                                skip: input.skip ?? 0,
+                            },
+                        };
+                    }
+                    // Re-run the rest of the strict pipeline with the already fetched list
+                    const issueIds = candidateIssues.map((issue) => issue.idReadable);
+                    const [detailsLight, commentsLight] = await Promise.all([
+                        this.getIssuesDetailsLight(issueIds),
+                        this.getMultipleIssuesCommentsLight(issueIds),
+                    ]);
+                    const activitiesPromises = issueIds.map((issueId) => this.getIssueActivities(issueId));
+                    const activitiesResults = await Promise.all(activitiesPromises);
+                    const issuesWithActivity = this.filterIssuesByUserActivity(candidateIssues, detailsLight, commentsLight, activitiesResults, input);
+                    const skip = input.skip ?? 0;
+                    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 }));
+                    return {
+                        issues: resultIssues,
+                        userLogins: input.userLogins,
+                        period: {
+                            startDate: input.startDate ? toIsoDateString(input.startDate) : undefined,
+                            endDate: input.endDate ? toIsoDateString(input.endDate) : undefined,
+                        },
+                        pagination: {
+                            returned: resultIssues.length,
+                            limit,
+                            skip,
+                        },
+                    };
+                }
+                catch (fallbackError) {
+                    // If fallback also fails, log for debugging and return original error
+                    console.error("Fallback query also failed:", fallbackError);
+                    throw normalized;
+                }
+            }
+            throw normalized;
         }
     }
+    /**
+     * Filters candidate issues by user activity dates (comments, activities, updater)
+     * 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 issuesWithActivity = [];
+        for (let i = 0; i < candidateIssues.length; i++) {
+            const issue = candidateIssues[i];
+            const issueId = issue.idReadable;
+            const details = detailsLight.find((d) => d.idReadable === issueId);
+            const comments = commentsLight[issueId] ?? [];
+            const activities = activitiesResults[i] ?? [];
+            const dates = [];
+            for (const userLogin of input.userLogins) {
+                // Check comments from user
+                for (const comment of comments) {
+                    if (comment.author?.login === userLogin && comment.created) {
+                        const commentDate = comment.created;
+                        if (commentDate >= startTimestamp && commentDate <= endTimestamp) {
+                            dates.push(commentDate);
+                        }
+                    }
+                    // Check mentions in comment text
+                    if (comment.text?.includes(`@${userLogin}`) && comment.created) {
+                        const commentDate = comment.created;
+                        if (commentDate >= startTimestamp && commentDate <= endTimestamp) {
+                            dates.push(commentDate);
+                        }
+                    }
+                }
+                // Check activities from user or where user is in added/removed
+                for (const activity of activities) {
+                    if (activity.timestamp >= startTimestamp && activity.timestamp <= endTimestamp) {
+                        // Activity by user
+                        if (activity.author?.login === userLogin) {
+                            dates.push(activity.timestamp);
+                        }
+                        // User added or removed in field change (e.g., assignee)
+                        const inAdded = activity.added?.some((v) => v.login === userLogin);
+                        const inRemoved = activity.removed?.some((v) => v.login === userLogin);
+                        if (inAdded || inRemoved) {
+                            dates.push(activity.timestamp);
+                        }
+                    }
+                }
+                // Check if user is updater and updated date is in range
+                if (details?.updater?.login === userLogin && details.updated) {
+                    const updateDate = details.updated;
+                    if (updateDate >= startTimestamp && updateDate <= endTimestamp) {
+                        dates.push(updateDate);
+                    }
+                }
+            }
+            if (dates.length > 0) {
+                const lastActivityTimestamp = Math.max(...dates);
+                const lastActivityDate = new Date(lastActivityTimestamp).toISOString();
+                issuesWithActivity.push({
+                    issue,
+                    lastActivityDate,
+                });
+            }
+        }
+        // Sort by lastActivityDate descending
+        issuesWithActivity.sort((a, b) => new Date(b.lastActivityDate).getTime() - new Date(a.lastActivityDate).getTime());
+        return issuesWithActivity;
+    }
+    // Helper to perform fallback request without braces in user filters
+    async searchIssuesStrictFallbackRequest(briefOutput, sortPart, input) {
+        const fallbackFilters = [];
+        if (input.userLogins.length > 0) {
+            const noBraceClauses = input.userLogins.map((login) => `updater: ${login} or mentions: ${login} or reporter: ${login} or assignee: ${login}`);
+            fallbackFilters.push(noBraceClauses.length === 1 ? noBraceClauses[0] : `(${noBraceClauses.join(" or ")})`);
+        }
+        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());
+            fallbackFilters.push(`updated: ${startDateStr} .. ${endDateStr}`);
+        }
+        const fallbackQuery = (fallbackFilters.length ? `${fallbackFilters.join(" and ")} ` : "") + sortPart;
+        const response = await this.http.get("/api/issues", {
+            params: {
+                fields: briefOutput ? defaultFields.issueSearchBrief : defaultFields.issueSearch,
+                query: fallbackQuery,
+                $top: DEFAULT_PAGE_SIZE,
+            },
+        });
+        return response.data;
+    }
     async listWorkItems({ author, startDate, endDate, issueId, top: limit, allUsers = false, } = {}) {
         const requestParams = {
             fields: defaultFields.workItems,

package/package.json

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