@vitalyostanin/youtrack-mcp 0.7.1 → 0.7.3

package/README-ru.md

@@ -19,29 +19,33 @@ MCP сервер для полноценной интеграции с YouTrack
 
 ## Содержание
 
-- [Требования](#требования)
-- [Установка](#установка)
-  - [Используя npx (Рекомендуется)](#используя-npx-рекомендуется)
-  - [Используя Claude MCP CLI](#используя-claude-mcp-cli)
-  - [Ручная установка (Для разработки)](#ручная-установка-для-разработки)
-- [Разработка и релиз](#разработка-и-релиз)
-  - [GitHub Actions Workflows](#github-actions-workflows)
-  - [Настройка NPM_TOKEN](#настройка-npmtoken)
-  - [Процесс релиза](#процесс-релиза)
-  - [Ручная сборка и тестирование](#ручная-сборка-и-тестирование)
-- [Запуск сервера (stdio)](#запуск-сервера-stdio)
-- [Конфигурация для Code (Рекомендуется)](#конфигурация-для-code-рекомендуется)
-- [Конфигурация для Claude Code CLI](#конфигурация-для-claude-code-cli)
-- [Конфигурация для VS Code Cline](#конфигурация-для-vs-code-cline)
-- [Инструменты MCP](#инструменты-mcp)
-  - [Сервис](#сервис)
-  - [Задачи](#задачи)
-  - [Связи задач](#связи-задач)
-  - [Звездочки задач](#звездочки-задач)
-  - [Трудозатраты](#трудозатраты)
-  - [Пользователи и проекты](#пользователи-и-проекты)
-  - [Статьи](#статьи)
-  - [Вложения](#вложения)
+- [YouTrack MCP Server](#youtrack-mcp-server)
+  - [Содержание](#содержание)
+  - [Требования](#требования)
+  - [Установка](#установка)
+    - [Используя npx (Рекомендуется)](#используя-npx-рекомендуется)
+    - [Используя Claude MCP CLI](#используя-claude-mcp-cli)
+    - [Ручная установка (Для разработки)](#ручная-установка-для-разработки)
+  - [Разработка и релиз](#разработка-и-релиз)
+    - [GitHub Actions Workflows](#github-actions-workflows)
+      - [CI Workflow (`.github/workflows/ci.yml`)](#ci-workflow-githubworkflowsciyml)
+      - [Publish Workflow (`.github/workflows/publish.yml`)](#publish-workflow-githubworkflowspublishyml)
+    - [Настройка NPM\_TOKEN](#настройка-npm_token)
+    - [Процесс релиза](#процесс-релиза)
+    - [Ручная сборка и тестирование](#ручная-сборка-и-тестирование)
+  - [Запуск сервера (stdio)](#запуск-сервера-stdio)
+  - [Конфигурация для Code (Рекомендуется)](#конфигурация-для-code-рекомендуется)
+  - [Конфигурация для Claude Code CLI](#конфигурация-для-claude-code-cli)
+  - [Конфигурация для VS Code Cline](#конфигурация-для-vs-code-cline)
+  - [Инструменты MCP](#инструменты-mcp)
+    - [Сервис](#сервис)
+    - [Задачи](#задачи)
+    - [Связи задач](#связи-задач)
+    - [Звездочки задач](#звездочки-задач)
+    - [Трудозатраты](#трудозатраты)
+    - [Пользователи и проекты](#пользователи-и-проекты)
+    - [Статьи](#статьи)
+    - [Вложения](#вложения)
 
 ## Требования
 
@@ -358,6 +362,8 @@ YOUTRACK_TOKEN = "perm:your-token-here"
 | `article_create` | Создание статьи в базе знаний. **Использование:** Создание документации, инструкций, статей поддержки. Поддерживает иерархическую структуру через `parentArticleId`. **Возвращает:** предопределенные поля созданной статьи - id, idReadable, summary, content, contentPreview, usesMarkdown, parentArticle, project | `summary` — заголовок статьи, опционально `content` — содержимое, `parentArticleId` — ID родительской статьи для создания подстатьи, `projectId` — ID проекта, `usesMarkdown` — использовать Markdown форматирование, `returnRendered` — вернуть отрендеренный preview |
 | `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_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` ограничивает объём ручной агрегации (при необходимости частичной выборки) |
 

package/README.md

@@ -354,6 +354,8 @@ Tools return either `structuredContent` (default) or a text `content` item, depe
 | `article_create` | Create article in knowledge base | `summary`, optionally `content`, `parentArticleId`, `projectId`, `usesMarkdown`, `returnRendered` |
 | `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` |
 
 ### Search
 

package/dist/package.json

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

package/dist/src/server.js

@@ -2,11 +2,11 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { registerServiceInfoTool } from "./tools/service-info.js";
 import { registerIssueTools } from "./tools/issue-tools.js";
 import { registerIssueActivityTools } from "./tools/issue-activity-tools.js";
-import { registerIssueSearchTools } from "./tools/issue-search-tools.js";
+import { issuesSearchArgs, issuesSearchHandler } from "./tools/issue-search-tools.js";
+import { articlesSearchArgs, articlesSearchHandler } from "./tools/article-search-tools.js";
 import { registerWorkitemTools } from "./tools/workitem-tools.js";
 import { registerWorkitemReportTools } from "./tools/workitem-report-tools.js";
 import { registerArticleTools } from "./tools/article-tools.js";
-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";
@@ -39,11 +39,12 @@ export class YoutrackServer {
         registerServiceInfoTool(this.server, this.client);
         registerIssueTools(this.server, this.client);
         registerIssueActivityTools(this.server, this.client);
-        registerIssueSearchTools(this.server, this.client);
+        this.server.tool("issues_search", "Search YouTrack issues by text in summary, description, and comments.", issuesSearchArgs, async (args) => issuesSearchHandler(this.client, args));
+        this.server.tool("articles_search", "Search YouTrack knowledge base articles by title and content.", articlesSearchArgs, async (args) => articlesSearchHandler(this.client, args));
         registerWorkitemTools(this.server, this.client);
         registerWorkitemReportTools(this.server, this.client);
         registerArticleTools(this.server, this.client);
-        registerArticleSearchTools(this.server, this.client);
+        // Removed redundant registerArticleSearchTools call (articles_search tool registered manually above)
         registerUserTools(this.server, this.client);
         registerProjectTools(this.server, this.client);
         registerAttachmentTools(this.server, this.client);

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

@@ -1,4 +1,103 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
 import type { YoutrackClient } from "../youtrack-client.js";
-export declare function registerArticleSearchTools(server: McpServer, client: YoutrackClient): void;
+export declare const articlesSearchArgs: {
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    skip: z.ZodDefault<z.ZodNumber>;
+    projectId: z.ZodOptional<z.ZodString>;
+    parentArticleId: z.ZodOptional<z.ZodString>;
+};
+export declare const articlesSearchSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    skip: z.ZodDefault<z.ZodNumber>;
+    projectId: z.ZodOptional<z.ZodString>;
+    parentArticleId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    skip: number;
+    limit: number;
+    projectId?: string | undefined;
+    parentArticleId?: string | undefined;
+}, {
+    query: string;
+    skip?: number | undefined;
+    limit?: number | undefined;
+    projectId?: string | undefined;
+    parentArticleId?: string | undefined;
+}>;
+export declare function articlesSearchHandler(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=article-search-tools.d.ts.map

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

@@ -1,31 +1,40 @@
 import { z } from "zod";
-import { toolError, toolSuccess } from "../utils/tool-response.js";
-const articleSearchArgs = {
-    query: z.string().min(2).describe("Search string for summary and content"),
+import { toolSuccess, toolError } from "../utils/tool-response.js";
+export const articlesSearchArgs = {
+    query: z.string().min(2).describe("Search string for articles (e.g., 'API token')"),
+    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"),
     projectId: z.string().optional().describe("Filter by project ID"),
-    parentArticleId: z.string().optional().describe("Filter by parent article"),
-    limit: z.number().int().positive().max(200).optional().describe("Maximum number of results"),
-    returnRendered: z.boolean().optional().describe("Return rendered content preview"),
+    parentArticleId: z.string().optional().describe("Filter by parent article ID"),
 };
-const articleSearchSchema = z.object(articleSearchArgs);
-export function registerArticleSearchTools(server, client) {
-    server.tool("article_search", "Search articles in knowledge base by text. Note: Returns predefined fields only - id, idReadable, summary, usesMarkdown, contentPreview (when returnRendered is true), parentArticle (id, idReadable), project (id, shortName, name). Content field is not included for performance reasons.", articleSearchArgs, async (rawInput) => {
-        try {
-            const payload = articleSearchSchema.parse(rawInput);
-            const articles = await client.searchArticles({
-                query: payload.query,
-                projectId: payload.projectId,
-                parentArticleId: payload.parentArticleId,
-                limit: payload.limit,
-                returnRendered: payload.returnRendered,
-            });
-            const response = toolSuccess(articles);
-            return response;
+export const articlesSearchSchema = z.object(articlesSearchArgs);
+export async function articlesSearchHandler(client, rawInput) {
+    const input = articlesSearchSchema.parse(rawInput);
+    try {
+        const params = {
+            fields: "id,idReadable,summary,parentArticle(id,idReadable),project(id,shortName,name)",
+            query: `{${input.query}}`,
+            $top: input.limit,
+            $skip: input.skip,
+        };
+        if (input.projectId) {
+            params.query += ` and project: {${input.projectId}}`;
         }
-        catch (error) {
-            const errorResponse = toolError(error);
-            return errorResponse;
+        if (input.parentArticleId) {
+            params.query += ` and parent article: {${input.parentArticleId}}`;
         }
-    });
+        const data = await client["getWithFlexibleTop"]("/api/articles", params);
+        const baseUrl = client.config?.baseUrl ?? "";
+        const articlesWithLinks = Array.isArray(data)
+            ? data.map((article) => ({
+                ...article,
+                webUrl: `${baseUrl}/articles/${article.idReadable}`,
+            }))
+            : data;
+        return toolSuccess(articlesWithLinks);
+    }
+    catch (error) {
+        return toolError(error);
+    }
 }
 //# sourceMappingURL=article-search-tools.js.map

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

@@ -1,4 +1,95 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
 import type { YoutrackClient } from "../youtrack-client.js";
-export declare function registerIssueSearchTools(server: McpServer, client: YoutrackClient): void;
+export declare const issuesSearchArgs: {
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    skip: z.ZodDefault<z.ZodNumber>;
+};
+export declare const issuesSearchSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    skip: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    skip: number;
+    limit: number;
+}, {
+    query: string;
+    skip?: number | undefined;
+    limit?: number | undefined;
+}>;
+export declare function issuesSearchHandler(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=issue-search-tools.d.ts.map

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

@@ -1,211 +1,24 @@
 import { z } from "zod";
-import { toolError, toolSuccess } from "../utils/tool-response.js";
-const issueSearchByUserActivityArgs = {
-    userLogins: z
-        .array(z.string().min(1))
-        .min(1)
-        .describe("Array of user logins to search for activity (updater, mentions, reporter, assignee, commenter)"),
-    startDate: z
-        .string()
-        .optional()
-        .describe("Start date for period filter (YYYY-MM-DD format or timestamp)"),
-    endDate: z
-        .string()
-        .optional()
-        .describe("End date for period filter (YYYY-MM-DD format or timestamp)"),
-    dateFilterMode: z
-        .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()
-        .positive()
-        .max(200)
-        .optional()
-        .describe("Maximum number of results (default: 100, max: 200)"),
-    skip: z
-        .number()
-        .int()
-        .nonnegative()
-        .optional()
-        .describe("Number of results to skip for pagination (default: 0)"),
+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')"),
+    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"),
 };
-const issueSearchByUserActivitySchema = z.object(issueSearchByUserActivityArgs);
-const issueListArgs = {
-    projectIds: z
-        .array(z.string().min(1))
-        .optional()
-        .describe("Filter by project IDs (e.g., ['0-0']). When omitted, returns issues from all projects."),
-    createdAfter: z
-        .string()
-        .optional()
-        .describe("Only include issues created on or after this date (YYYY-MM-DD or ISO timestamp)."),
-    createdBefore: z
-        .string()
-        .optional()
-        .describe("Only include issues created on or before this date (YYYY-MM-DD or ISO timestamp)."),
-    updatedAfter: z
-        .string()
-        .optional()
-        .describe("Only include issues updated on or after this date (YYYY-MM-DD or ISO timestamp)."),
-    updatedBefore: z
-        .string()
-        .optional()
-        .describe("Only include issues updated on or before this date (YYYY-MM-DD or ISO timestamp)."),
-    statuses: z
-        .array(z.string().min(1))
-        .optional()
-        .describe("Filter by workflow states (e.g., ['Open', 'In Progress'])."),
-    assigneeLogin: z
-        .string()
-        .optional()
-        .describe("Filter by assignee login (case-sensitive; use 'me' for current user)."),
-    types: z
-        .array(z.string().min(1))
-        .optional()
-        .describe("Filter by issue types (e.g., ['Bug', 'Feature'])."),
-    sortField: z
-        .enum(["created", "updated"])
-        .optional()
-        .describe("Sort by created or updated timestamp (default: created)."),
-    sortDirection: z
-        .enum(["asc", "desc"])
-        .optional()
-        .describe("Sort direction: 'asc' for oldest first, 'desc' for newest first (default)."),
-    briefOutput: z
-        .boolean()
-        .optional()
-        .describe("Return brief issue data without description fields (default: true). Set to false to include description and wikifiedDescription fields."),
-    limit: z
-        .number()
-        .int()
-        .positive()
-        .max(200)
-        .optional()
-        .describe("Maximum number of issues to return (default: 200, max: 200)."),
-    skip: z
-        .number()
-        .int()
-        .nonnegative()
-        .optional()
-        .describe("Number of issues to skip for pagination (default: 0)."),
-};
-const issueListSchema = z.object(issueListArgs);
-const issueCountArgs = {
-    projectIds: z
-        .array(z.string().min(1))
-        .optional()
-        .describe("Filter by project IDs (e.g., ['0-0']). When omitted, counts cover all projects."),
-    createdAfter: z
-        .string()
-        .optional()
-        .describe("Only include issues created on or after this date (YYYY-MM-DD or ISO timestamp)."),
-    createdBefore: z
-        .string()
-        .optional()
-        .describe("Only include issues created on or before this date (YYYY-MM-DD or ISO timestamp)."),
-    updatedAfter: z
-        .string()
-        .optional()
-        .describe("Only include issues updated on or after this date (YYYY-MM-DD or ISO timestamp)."),
-    updatedBefore: z
-        .string()
-        .optional()
-        .describe("Only include issues updated on or before this date (YYYY-MM-DD or ISO timestamp)."),
-    statuses: z
-        .array(z.string().min(1))
-        .optional()
-        .describe("Filter by workflow states (e.g., ['Open', 'In Progress'])."),
-    assigneeLogin: z
-        .string()
-        .optional()
-        .describe("Filter by assignee login (case-sensitive; use 'me' for current user)."),
-    types: z
-        .array(z.string().min(1))
-        .optional()
-        .describe("Filter by issue types (e.g., ['Bug', 'Feature'])."),
-    top: z
-        .number()
-        .int()
-        .positive()
-        .max(1000)
-        .optional()
-        .describe("Optional safety limit for manual aggregation when multiple projects are requested. When set, counting stops after processing this many issues, so totals may be partial."),
-};
-const issueCountSchema = z.object(issueCountArgs);
-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: 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({
-                userLogins: payload.userLogins,
-                startDate: payload.startDate,
-                endDate: payload.endDate,
-                dateFilterMode: payload.dateFilterMode,
-                briefOutput: payload.briefOutput,
-                limit: payload.limit,
-                skip: payload.skip,
-            });
-            const response = toolSuccess(results);
-            return response;
-        }
-        catch (error) {
-            const errorResponse = toolError(error);
-            return errorResponse;
-        }
-    });
-    server.tool("issues_list", "List issues across projects with rich filtering and configurable sorting. Use for: Building dashboards, auditing work across teams, feeding batch workflows. Supports filtering by project IDs, creation/update windows, workflow states, assignee login, and issue types. Sorting accepts created/updated fields with asc/desc direction so you can fetch newest or oldest pages first. Pagination is controlled with limit/skip (max 200 per call). Note: By default (briefOutput=true) returns minimal fields (id, idReadable, summary, project, parent, assignee, watchers.hasStar). Set briefOutput=false to include description and wikifiedDescription fields. After processing a page, re-fetch if you must verify that status or assignee changes did not occur in the meantime.", issueListArgs, async (rawInput) => {
-        try {
-            const payload = issueListSchema.parse(rawInput);
-            const results = await client.listIssues({
-                projectIds: payload.projectIds,
-                createdAfter: payload.createdAfter,
-                createdBefore: payload.createdBefore,
-                updatedAfter: payload.updatedAfter,
-                updatedBefore: payload.updatedBefore,
-                statuses: payload.statuses,
-                assigneeLogin: payload.assigneeLogin,
-                types: payload.types,
-                sortField: payload.sortField,
-                sortDirection: payload.sortDirection,
-                briefOutput: payload.briefOutput,
-                limit: payload.limit,
-                skip: payload.skip,
-            });
-            const response = toolSuccess(results);
-            return response;
-        }
-        catch (error) {
-            const errorResponse = toolError(error);
-            return errorResponse;
-        }
-    });
-    server.tool("issues_count", "Count issues across projects using the same filters as issues_list. Use for: Gauging workload distribution, preparing dashboards, validating automation scope before fetching full issue payloads. Returns total matches and per-project breakdown when multiple projects are involved. When only one project is filtered, delegates to YouTrack's /api/issuesGetter/count for an exact total; otherwise counts are aggregated client-side with pagination (default batches of 200, controlled by optional top limit for partial sampling). If you use a small top value, totals may be truncated — re-run without top to confirm final numbers.", issueCountArgs, async (rawInput) => {
-        try {
-            const payload = issueCountSchema.parse(rawInput);
-            const results = await client.countIssues({
-                projectIds: payload.projectIds,
-                createdAfter: payload.createdAfter,
-                createdBefore: payload.createdBefore,
-                updatedAfter: payload.updatedAfter,
-                updatedBefore: payload.updatedBefore,
-                statuses: payload.statuses,
-                assigneeLogin: payload.assigneeLogin,
-                types: payload.types,
-                top: payload.top,
-            });
-            const response = toolSuccess(results);
-            return response;
-        }
-        catch (error) {
-            const errorResponse = toolError(error);
-            return errorResponse;
-        }
-    });
+export const issuesSearchSchema = z.object(issuesSearchArgs);
+export async function issuesSearchHandler(client, rawInput) {
+    const input = issuesSearchSchema.parse(rawInput);
+    try {
+        const data = await client["getWithFlexibleTop"]("/api/issues", {
+            query: input.query,
+            $top: input.limit,
+            $skip: input.skip,
+            fields: "id,idReadable,summary,project(shortName,name),assignee(name,login)",
+        });
+        return toolSuccess(data);
+    }
+    catch (error) {
+        return toolError(error);
+    }
 }
 //# sourceMappingURL=issue-search-tools.js.map

package/dist/src/utils/mappers.js

@@ -55,7 +55,23 @@ export function mapIssueDetails(issue) {
 export function mapIssueBrief(issue) {
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     const { description, wikifiedDescription, ...rest } = issue;
-    return rest;
+    // Try to extract assignee from customFields if not present
+    let assignee = issue.assignee ?? null;
+    if (!assignee && Array.isArray(issue.customFields)) {
+        const assigneeField = issue.customFields?.find((f) => f.name === "Assignee" && f.value);
+        if (assigneeField?.value) {
+            const { id = "", login = "", name = "" } = assigneeField.value;
+            assignee = {
+                id,
+                login,
+                name,
+            };
+        }
+    }
+    return {
+        ...rest,
+        assignee,
+    };
 }
 /**
  * Map YoutrackWorkItem to MappedYoutrackWorkItem

package/dist/src/youtrack-client.js

@@ -38,7 +38,7 @@ const defaultFields = {
         "summary",
         "project(id,shortName,name)",
         "parent(id,idReadable)",
-        "assignee(id,login,name)",
+        "customFields(id,name,value(id,login,name,presentation),$type)",
         "watchers(hasStar)",
     ].join(","),
     issueDetails: [

package/package.json

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