@vitalyostanin/youtrack-mcp 0.7.0 → 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)
+    - [Сервис](#сервис)
+    - [Задачи](#задачи)
+    - [Связи задач](#связи-задач)
+    - [Звездочки задач](#звездочки-задач)
+    - [Трудозатраты](#трудозатраты)
+    - [Пользователи и проекты](#пользователи-и-проекты)
+    - [Статьи](#статьи)
+    - [Вложения](#вложения)
 
 ## Требования
 
@@ -53,6 +57,7 @@ MCP сервер для полноценной интеграции с YouTrack
   - `YOUTRACK_HOLIDAYS` — опциональный список праздничных дат через запятую (формат `YYYY-MM-DD`), исключаемых из отчётов и массовых операций
   - `YOUTRACK_PRE_HOLIDAYS` — опциональный список предпраздничных дат через запятую, для которых норма времени уменьшается автоматически
   - `YOUTRACK_USER_ALIASES` — опциональный список соответствий `alias:login` через запятую (например, `me:vyt,petya:p.petrov`), используется при автоматическом выборе исполнителей
+  - `YOUTRACK_DEFAULT_PROJECT` — опциональный код проекта (shortName или ID), используемый по умолчанию при создании задач/статей и для преобразования коротких идентификаторов (например, `1234` → `PROJ-1234`)
   - `YOUTRACK_USE_STRUCTURED_CONTENT` — опциональный, управляет форматом ответа (по умолчанию: `true`). При `true` инструменты возвращают только узел MCP `structuredContent` с полными данными. При `false` инструменты возвращают только узел MCP `content` (один текстовый элемент с JSON-строкой)
 
 ## Установка
@@ -64,6 +69,7 @@ MCP сервер для полноценной интеграции с YouTrack
 ```bash
 YOUTRACK_URL="https://youtrack.example.com" \
 YOUTRACK_TOKEN="perm:your-token-here" \
+YOUTRACK_DEFAULT_PROJECT="PROJ" \
 npx -y @vitalyostanin/youtrack-mcp@latest
 ```
 
@@ -281,7 +287,7 @@ YOUTRACK_TOKEN = "perm:your-token-here"
 | `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[]` — массив кодов задач |
-| `issue_create` | Создание новой задачи в YouTrack. **Использование:** Создание задач, подзадач (через `parentIssueId`), назначение исполнителя при создании. **Возвращает:** стандартные поля созданной задачи (id, idReadable, summary, description, wikifiedDescription, usesMarkdown, project, parent, assignee). Пользовательские поля не включены. | `projectId` — ID проекта (внутренний YouTrack ID), `summary` — краткое описание задачи, опционально `description`, `parentIssueId`, `assigneeLogin` (логин или `me`), `usesMarkdown` |
+| `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` |
 | `issue_comment_create` | Добавление комментария к задаче. **Использование:** Оставлять комментарии, заметки, обсуждения в задачах. Поддерживает Markdown. **Возвращает:** поля комментария - id, text, textPreview, usesMarkdown, author, created, updated | `issueId` — ID или код задачи, `text` — текст комментария, опционально `usesMarkdown` |
@@ -299,6 +305,16 @@ YOUTRACK_TOKEN = "perm:your-token-here"
 | `issue_link_add` | Создание связи между двумя задачами | `sourceId` — исходная задача, `targetId` — целевая задача, `linkType` — имя или id типа связи (например, `Relates` или UUID) |
 | `issue_link_delete` | Удаление существующей связи по её id для указанной задачи | `issueId` — код задачи, `linkId` — id связи |
 
+**issue_create — дополнительные параметры:**
+
+- `parentIssueId` — если указан только числовой идентификатор (`"123"`), автоматически добавляет префикс проекта по умолчанию (например, `BC-123`).
+- `links[]` — массив объектов для создания связей после сохранения задачи. Каждый объект поддерживает поля:
+  - `linkType` — имя или id типа связи (например, `Subtask`, `Relates`).
+  - `targetId` — idReadable задачи или числовой идентификатор, который также резолвится через проект по умолчанию.
+  - `direction` — опционально (`"outbound"` по умолчанию). Используйте `"inbound"`, чтобы инвертировать направление для несимметричных типов.
+  - `sourceId` — опционально. Если не указан, исходной считается новая задача; укажите его, чтобы привязать новую задачу как `target` к уже существующей.
+- После создания задачи повторно запросите связи (`issue_links`) для подтверждения, что YouTrack применил все отношения.
+
 ### Звездочки задач
 
 | Tool | Описание | Основные параметры |
@@ -346,6 +362,10 @@ 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

@@ -55,9 +55,10 @@ MCP server for comprehensive YouTrack integration with the following capabilitie
   - `YOUTRACK_TOKEN` — permanent token with read permissions for issues and work items
   - `YOUTRACK_TIMEZONE` — optional timezone for date operations (default: `Europe/Moscow`), must be a valid IANA timezone identifier (e.g., `Europe/London`, `America/New_York`, `Asia/Tokyo`)
   - `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_USE_STRUCTURED_CONTENT` — optional, controls response format (default: `true`). When `true`, tools return only the MCP `structuredContent` node with full data. When `false`, tools return only the MCP `content` node (single text item with JSON string)
+- `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_DEFAULT_PROJECT` — optional project code used for manual verification tasks and default parent issues in docs/examples (use `PROJ` in documentation examples)
+- `YOUTRACK_USE_STRUCTURED_CONTENT` — optional, controls response format (default: `true`). When `true`, tools return only the MCP `structuredContent` node with full data. When `false`, tools return only the MCP `content` node (single text item with JSON string)
 
 ## Installation
 
@@ -68,6 +69,7 @@ You can run the server directly with npx without installation:
 ```bash
 YOUTRACK_URL="https://youtrack.example.com" \
 YOUTRACK_TOKEN="perm:your-token-here" \
+YOUTRACK_DEFAULT_PROJECT="PROJ" \
 npx -y @vitalyostanin/youtrack-mcp@latest
 ```
 
@@ -282,7 +284,7 @@ Tools return either `structuredContent` (default) or a text `content` item, depe
 | `issue_lookup` | Brief issue information | `issueId` — issue code (e.g., PROJ-123) |
 | `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` |
 | `issue_comments` | Issue comments | `issueId` — issue code |
-| `issue_create` | Create issue | `projectId`, `summary`, optionally `description`, `parentIssueId`, `assigneeLogin`, `usesMarkdown` |
+| `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`) |
 | `issue_comment_create` | Add comment to issue | `issueId`, `text` — comment text, optionally `usesMarkdown` |
@@ -352,12 +354,16 @@ 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
 
 | Tool | Description | Main Parameters |
 | --- | --- | --- |
 | `article_search` | Search articles in knowledge base | `query`, optionally `projectId`, `parentArticleId`, `limit`, `returnRendered` |
+| `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 |
 
 ## Important Notes
 
@@ -366,3 +372,12 @@ Tools return either `structuredContent` (default) or a text `content` item, depe
 Some operations cannot be undone and require explicit confirmation:
 
 - **`issue_attachment_delete`** - Requires `confirmation: true` parameter. Deleted attachments cannot be recovered.
+**issue_create parameters:**
+
+- `parentIssueId` — resolves against `YOUTRACK_DEFAULT_PROJECT` when no project prefix is provided (e.g., `123` → `BC-123` if default project is `BC`).
+- `links[]` — optional array describing additional links to create after the issue is saved. Each item supports:
+  - `linkType` — name or id of the link type (e.g., `Subtask`, `Relates`).
+  - `targetId` — issue id or readable id. Plain numbers are resolved with the default project, matching `resolveIssueId` behaviour.
+  - `direction` — optional (`"outbound"` by default). Use `"inbound"` to flip direction for non-symmetric link types.
+  - `sourceId` — optional. When omitted, the new issue is treated as the source. Specify to create links from an existing issue to the new one (useful for complex chains).
+- After creation the tool automatically refreshes the issue and attempts to reopen link caches; always re-fetch links with `issue_links` to confirm the final state.

package/dist/package.json

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

package/dist/src/config.js

@@ -6,6 +6,7 @@ const configSchema = z.object({
     YOUTRACK_HOLIDAYS: z.string().optional(),
     YOUTRACK_PRE_HOLIDAYS: z.string().optional(),
     YOUTRACK_USER_ALIASES: z.string().optional(),
+    YOUTRACK_DEFAULT_PROJECT: z.string().optional(),
     YOUTRACK_USE_STRUCTURED_CONTENT: z
         .string()
         .optional()
@@ -37,6 +38,7 @@ export function loadConfig(env = process.env) {
         userAliases: parsed.data.YOUTRACK_USER_ALIASES
             ? parseAliasMap(parsed.data.YOUTRACK_USER_ALIASES)
             : undefined,
+        defaultProject: parsed.data.YOUTRACK_DEFAULT_PROJECT,
         useStructuredContent: parsed.data.YOUTRACK_USE_STRUCTURED_CONTENT,
     };
 }

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/article-tools.js

@@ -5,7 +5,10 @@ const articleLookupArgs = {
 };
 const articleListArgs = {
     parentArticleId: z.string().optional().describe("Parent article ID"),
-    projectId: z.string().optional().describe("Project ID"),
+    projectId: z
+        .string()
+        .optional()
+        .describe("Project ID (defaults to YOUTRACK_DEFAULT_PROJECT when omitted)"),
 };
 const articleCreateArgs = {
     summary: z.string().min(1).describe("Article title"),
@@ -14,7 +17,10 @@ const articleCreateArgs = {
         .optional()
         .describe("Article content. Supports folded sections: <details> <summary>Title</summary>Content</details>"),
     parentArticleId: z.string().optional().describe("Parent article ID"),
-    projectId: z.string().optional().describe("Project ID"),
+    projectId: z
+        .string()
+        .optional()
+        .describe("Project ID (defaults to YOUTRACK_DEFAULT_PROJECT when omitted)"),
     usesMarkdown: z.boolean().optional().describe("Use Markdown formatting"),
     returnRendered: z.boolean().optional().describe("Return rendered content preview"),
 };
@@ -60,7 +66,7 @@ export function registerArticleTools(server, client) {
             return errorResponse;
         }
     });
-    server.tool("article_create", "Create article in YouTrack knowledge base. Supports markdown with folded sections (<details>/<summary>) in content. Note: Response includes predefined fields only - id, idReadable, summary, content, contentPreview, usesMarkdown, parentArticle (id, idReadable), project (id, shortName, name).", articleCreateArgs, async (rawInput) => {
+    server.tool("article_create", "Create article in YouTrack knowledge base. Supports markdown with folded sections (<details>/<summary>) in content. Note: Response includes predefined fields only - id, idReadable, summary, content, contentPreview, usesMarkdown, parentArticle (id, idReadable), project (id, shortName, name). After creation, fetch the article again to confirm rendered content and hierarchy are correct.", articleCreateArgs, async (rawInput) => {
         try {
             const payload = articleCreateSchema.parse(rawInput);
             const article = await client.createArticle({
@@ -79,7 +85,7 @@ export function registerArticleTools(server, client) {
             return errorResponse;
         }
     });
-    server.tool("article_update", "Update existing article. Supports markdown with folded sections (<details>/<summary>) in content. Note: Response includes predefined fields only - id, idReadable, summary, content, contentPreview, usesMarkdown, parentArticle (id, idReadable), project (id, shortName, name).", articleUpdateArgs, async (rawInput) => {
+    server.tool("article_update", "Update existing article. Supports markdown with folded sections (<details>/<summary>) in content. Note: Response includes predefined fields only - id, idReadable, summary, content, contentPreview, usesMarkdown, parentArticle (id, idReadable), project (id, shortName, name). After updating, re-fetch the article (optionally with rendered content) to verify formatting and links.", articleUpdateArgs, async (rawInput) => {
         try {
             const payload = articleUpdateSchema.parse(rawInput);
             if (payload.summary === undefined && payload.content === undefined) {

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

@@ -64,7 +64,7 @@ export function registerAttachmentTools(server, client) {
             return errorResponse;
         }
     });
-    server.tool("issue_attachment_upload", "Upload one or more files to a YouTrack issue. Files must exist on the local filesystem. Note: Can only attach files to existing issues, not during issue creation.", attachmentUploadArgs, async (rawInput) => {
+    server.tool("issue_attachment_upload", "Upload one or more files to a YouTrack issue. Files must exist on the local filesystem. Note: Can only attach files to existing issues, not during issue creation. After uploading, fetch the attachments list to verify each file appears with correct metadata.", attachmentUploadArgs, async (rawInput) => {
         try {
             const payload = attachmentUploadSchema.parse(rawInput);
             const result = await client.uploadAttachments({
@@ -80,7 +80,7 @@ export function registerAttachmentTools(server, client) {
             return errorResponse;
         }
     });
-    server.tool("issue_attachment_delete", "Delete an attachment from a YouTrack issue. IMPORTANT: Requires explicit confirmation via the 'confirmation' parameter to prevent accidental deletion. This is a destructive operation that cannot be undone.", attachmentDeleteArgs, async (rawInput) => {
+    server.tool("issue_attachment_delete", "Delete an attachment from a YouTrack issue. IMPORTANT: Requires explicit confirmation via the 'confirmation' parameter to prevent accidental deletion. This is a destructive operation that cannot be undone. After deletion, list attachments again to ensure the file no longer appears.", attachmentDeleteArgs, async (rawInput) => {
         try {
             const payload = attachmentDeleteSchema.parse(rawInput);
             const result = await client.deleteAttachment({

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

@@ -11,13 +11,12 @@ const linkCreateArgs = {
         .string()
         .min(1)
         .describe("Link type name or id (e.g., 'Relates', 'Duplicate', or a type id)"),
+    direction: z
+        .enum(["inbound", "outbound"])
+        .optional()
+        .describe("Direction relative to the source issue (use 'inbound' to flip the relationship)"),
 };
 const linkCreateSchema = z.object(linkCreateArgs);
-const linkDeleteArgs = {
-    issueId: z.string().min(1).describe("Issue code that holds the link (e.g., PROJ-123)"),
-    linkId: z.string().min(1).describe("Issue link id (internal youtrack id)"),
-};
-const linkDeleteSchema = z.object(linkDeleteArgs);
 export function registerIssueLinkTools(server, client) {
     server.tool("issue_links", "List issue links for a given YouTrack issue. Use for: inspecting relationships like 'relates to', 'duplicates', 'parent/child'. Response includes link id, direction, linkType, and counterpart issue brief (idReadable, summary, project, assignee).", issueIdArgs, async (rawInput) => {
         try {
@@ -38,7 +37,7 @@ export function registerIssueLinkTools(server, client) {
             return toolError(error);
         }
     });
-    server.tool("issue_link_add", "Create a link between two issues. Provide sourceId, targetId and linkType (name or id). Limitations: link type must exist in project context; API may reject invalid combinations.", linkCreateArgs, async (rawInput) => {
+    server.tool("issue_link_add", "Create a link between two issues. Provide sourceId, targetId and linkType (name or id). Limitations: link type must exist in project context; API may reject invalid combinations. After linking, fetch the issue links again to confirm the relationship appears as expected.", linkCreateArgs, async (rawInput) => {
         try {
             const input = linkCreateSchema.parse(rawInput);
             const result = await client.addIssueLink(input);
@@ -48,15 +47,5 @@ export function registerIssueLinkTools(server, client) {
             return toolError(error);
         }
     });
-    server.tool("issue_link_delete", "Delete an existing issue link by id for a given issue. Use 'issue_links' to discover link ids first.", linkDeleteArgs, async (rawInput) => {
-        try {
-            const input = linkDeleteSchema.parse(rawInput);
-            const result = await client.deleteIssueLink(input);
-            return toolSuccess(result);
-        }
-        catch (error) {
-            return toolError(error);
-        }
-    });
 }
 //# sourceMappingURL=issue-link-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