docs: make MCP tools descriptions collapsible in README

- Wrap each tool category in <details> tags for better navigation
- Update both English and Russian README files

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: igorcoding

README.md

@@ -487,7 +487,9 @@ For other MCP-compatible clients, use the standard MCP server configuration form
 
 The server exposes the following tools through the MCP protocol:
 
-### Queue Management
+<details>
+<summary><strong>Queue Management</strong></summary>
+
 - **`queues_get_all`**: List all available Yandex Tracker queues
   - Parameters:
     - `fields` (optional): Fields to include in the response (e.g., ["key", "name"]). Helps optimize context window usage by selecting only needed fields. If not specified, returns all available fields.
@@ -524,7 +526,11 @@ The server exposes the following tools through the MCP protocol:
   - Use `expand: ["issueTypesConfig"]` to get available resolutions for each issue type (needed for `issue_close` tool)
   - Respects `TRACKER_LIMIT_QUEUES` restrictions
 
-### User Management
+</details>
+
+<details>
+<summary><strong>User Management</strong></summary>
+
 - **`users_get_all`**: Get information about user accounts registered in the organization
   - Parameters:
     - `per_page` (optional): Number of users per page (default: 50)
@@ -548,12 +554,20 @@ The server exposes the following tools through the MCP protocol:
   - Uses fuzzy matching for real names with a similarity threshold of 80%
   - Prioritizes exact matches for login and email over fuzzy name matches
 
-### Field Management
+</details>
+
+<details>
+<summary><strong>Field Management</strong></summary>
+
 - **`get_global_fields`**: Get all global fields available in Yandex Tracker
   - Returns complete list of global fields that can be used in issues
   - Includes field schema, type information, and configuration
 
-### Status and Type Management
+</details>
+
+<details>
+<summary><strong>Status and Type Management</strong></summary>
+
 - **`get_statuses`**: Get all available issue statuses
   - Returns complete list of issue statuses that can be assigned
   - Includes status IDs, names, and type information
@@ -570,7 +584,11 @@ The server exposes the following tools through the MCP protocol:
   - Returns complete list of resolutions that can be used when closing issues
   - Includes resolution keys, names, descriptions, and order information
 
-### Issue Operations
+</details>
+
+<details>
+<summary><strong>Issue Operations</strong></summary>
+
 - **`issue_get`**: Retrieve detailed issue information by ID
   - Parameters:
     - `issue_id` (string, format: "QUEUE-123")
@@ -683,7 +701,11 @@ The server exposes the following tools through the MCP protocol:
   - Only provided fields are updated; omitted fields remain unchanged
   - Respects `TRACKER_LIMIT_QUEUES` restrictions
 
-### Search and Discovery
+</details>
+
+<details>
+<summary><strong>Search and Discovery</strong></summary>
+
 - **`issues_find`**: Search issues using [Yandex Tracker Query Language](https://yandex.ru/support/tracker/ru/user/query-filter)
   - Parameters:
     - `query` (required): Query string using Yandex Tracker Query Language syntax
@@ -700,6 +722,7 @@ The server exposes the following tools through the MCP protocol:
   - Supports all query language features: field filtering, date functions, logical operators, and complex expressions
   - Useful for analytics, reporting, and understanding issue distribution without retrieving full issue data
 
+</details>
 
 ## http Transport
 

README_ru.md

@@ -484,7 +484,9 @@ claude mcp add yandex-tracker docker "run --rm -i -e TRACKER_TOKEN=ваш_ток
 
 Сервер предоставляет следующие инструменты через протокол MCP:
 
-### Управление очередями
+<details>
+<summary><strong>Управление очередями</strong></summary>
+
 - **`queues_get_all`**: Список всех доступных очередей Яндекс.Трекера
   - Параметры:
     - `fields` (опционально): Поля для включения в ответ (например, ["key", "name"]). Помогает оптимизировать использование контекстного окна, выбирая только необходимые поля. Если не указано, возвращает все доступные поля.
@@ -521,7 +523,11 @@ claude mcp add yandex-tracker docker "run --rm -i -e TRACKER_TOKEN=ваш_ток
   - Используйте `expand: ["issueTypesConfig"]` для получения доступных резолюций для каждого типа задачи (необходимо для инструмента `issue_close`)
   - Учитывает ограничения `TRACKER_LIMIT_QUEUES`
 
-### Управление пользователями
+</details>
+
+<details>
+<summary><strong>Управление пользователями</strong></summary>
+
 - **`users_get_all`**: Получить информацию об учетных записях пользователей, зарегистрированных в организации
   - Параметры:
     - `per_page` (опционально): Количество пользователей на страницу (по умолчанию: 50)
@@ -545,12 +551,20 @@ claude mcp add yandex-tracker docker "run --rm -i -e TRACKER_TOKEN=ваш_ток
   - Использует нечеткое сопоставление для реальных имен с порогом сходства 80%
   - Приоритизирует точные совпадения для логина и электронной почты перед нечеткими совпадениями имен
 
-### Управление полями
+</details>
+
+<details>
+<summary><strong>Управление полями</strong></summary>
+
 - **`get_global_fields`**: Получить все глобальные поля, доступные в Яндекс.Трекере
   - Возвращает полный список глобальных полей, которые можно использовать в задачах
   - Включает схему полей, информацию о типах и конфигурацию
 
-### Управление статусами и типами
+</details>
+
+<details>
+<summary><strong>Управление статусами и типами</strong></summary>
+
 - **`get_statuses`**: Получить все доступные статусы задач
   - Возвращает полный список статусов задач, которые могут быть назначены
   - Включает идентификаторы статусов, имена и информацию о типах
@@ -567,7 +581,11 @@ claude mcp add yandex-tracker docker "run --rm -i -e TRACKER_TOKEN=ваш_ток
   - Возвращает полный список резолюций, которые могут быть использованы при закрытии задач
   - Включает ключи резолюций, имена, описания и информацию о порядке
 
-### Операции с задачами
+</details>
+
+<details>
+<summary><strong>Операции с задачами</strong></summary>
+
 - **`issue_get`**: Получить подробную информацию о задаче по ID
   - Параметры:
     - `issue_id` (строка, формат: "QUEUE-123")
@@ -680,7 +698,11 @@ claude mcp add yandex-tracker docker "run --rm -i -e TRACKER_TOKEN=ваш_ток
   - Обновляются только предоставленные поля; непереданные поля остаются без изменений
   - Учитывает ограничения `TRACKER_LIMIT_QUEUES`
 
-### Поиск и обнаружение
+</details>
+
+<details>
+<summary><strong>Поиск и обнаружение</strong></summary>
+
 - **`issues_find`**: Поиск задач с использованием [языка запросов Яндекс.Трекера](https://yandex.ru/support/tracker/ru/user/query-filter)
   - Параметры:
     - `query` (обязательно): Строка запроса с использованием синтаксиса языка запросов Яндекс.Трекера
@@ -697,6 +719,8 @@ claude mcp add yandex-tracker docker "run --rm -i -e TRACKER_TOKEN=ваш_ток
   - Поддерживает все функции языка запросов: фильтрация полей, функции дат, логические операторы и сложные выражения
   - Полезно для аналитики, отчетности и понимания распределения задач без получения полных данных задач
 
+</details>
+
 ## Транспорт http
 
 MCP сервер также может работать в режиме streamable-http для веб-интеграций или когда транспорт stdio не подходит.