@vitalyostanin/youtrack-mcp 0.7.3 → 0.7.4

package/README-ru.md

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

package/README.md

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

package/dist/package.json

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

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

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

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

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

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

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

package/package.json

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