Yandex Tracker MCP

Instructions

Implementation Reference

• mcp_tracker/mcp/tools.py:293-301 (handler)

  MCP tool handler for 'issues_count'. Delegates to the underlying IssueProtocol.issues_count method with authentication.

  @mcp.tool(description="Get the count of Yandex Tracker issues matching a query")
  async def issues_count(
      ctx: Context[Any, AppContext],
      query: YTQuery,
  ) -> int:
      return await ctx.request_context.lifespan_context.issues.issues_count(
          query,
          auth=get_yandex_auth(ctx),
      )

• mcp_tracker/mcp/params.py:50-92 (schema)

  Input schema for the 'query' parameter of the issues_count tool, defining it as a string with detailed Yandex Tracker Query Language instructions.

  YTQuery = Annotated[
      str,
      Field(
          description=(
              """Search query to filter issues using Yandex Tracker Query.\n"""
              """# General instructions\n"""
              """1. To search by a specific field use the following syntax: `Description: "some issue description"`\n"""
              """2. Multiple fields should be separated by space: `Description: "some issue description" Created: today()`\n"""
              """3. If you need to specify multiple values for the same field - provide them using comma (,), e.g.: `author: "vpupkin","iivanov"`\n"""
              """4. You may specify multiple conditions and combine them using `AND` and `OR` statements, e.g. `<param_1>: "<value_1>" AND <param_2>: "<value_2>"`\n"""
              """5. You may use brackets for complex logical expressions\n"""
              """6. To find issues with exact string matching in the field use this syntax: `Summary: #"Version 2.0"`. If you need to pass special characters - you must escape them using `\\` symbol\n"""
              """7. To find issues that don't contain the specified text use this syntax: `Summary: !"Version 2.0"`. If you need to pass special characters - you must escape them using `\\` symbol\n"""
              """8. If you need to search by local queue field use the following syntax: `<QUEUE>.<LOCAL_FIELD_KEY>: "<value>", where <QUEUE> is a queue key, <LOCAL_FIELD_KEY> is a local field's key from the `queue_get_local_fields` tool result.\n"""
              """9. For dates use the format YYYY-MM-DD.\n"""
              """10. For numerical values you may use comparison operators (>, <, >=, <=): `<param>: ><value>`.\n"""
              """11. To sort the result specify the `Sort By` directive (you may provide ASC or DESC for the sort order): `"Sort By": Created ASC`.\n"""
              """12. For Assignee field and any other field representing a user (such as Author and others) always use username and not name.\n"""
              """# Functions\n"""
              """These functions may be used, for example: `Created: week()` - return issues created on the current week"\n"""
              """* `empty()` - empty value\n"""
              """* `notEmpty()` - not empty value\n"""
              """* `now()` - current time\n"""
              """* `today()` - current date\n"""
              """* `week()` - current week\n"""
              """* `month()` - current month\n"""
              """* `quarter()` - current quarter\n"""
              """* `year()` - current year\n"""
              """* `unresolved()` - there is no resolution\n"""
              """* `me()` - currently logged in user\n"""
              """# Examples\n"""
              """Find issues in a specific queue: `"Queue": "PROJ"`\n"""
              """Find issues by an assignee: `"Assignee": "i.ivanov"`\n"""
              """Find not resolved (open, in progress) issues: `"Resolution": unresolved()`\n"""
              """Find issues in specific status: `"Status": "Открыт", "В работе"`\n"""
              """Find issues created in a specific range: `"Created": "2017-01-01".."2017-01-30"`\n"""
              """Find issues created by currently logged in user: `"Author": me()"`\n"""
              """Find issues assigned to currently logged in user: `"Assignee": me()"`\n"""
              """Find issues created no earlier than 1 week and 1 day before today: `Created: > today() - "1w 1d"`\n"""
              """Complete instructions page is available here: https://yandex.ru/support/tracker/ru/user/query-filter\n"""
          )
      ),
  ]

• mcp_tracker/mcp/server.py:166-166 (registration)

  Registration of all MCP tools, including 'issues_count', via the register_tools function call on the FastMCP server instance.

  register_tools(settings, mcp)

• mcp_tracker/tracker/custom/client.py:415-425 (helper)

  Core implementation of issues_count in the TrackerClient, performing a POST request to Yandex Tracker API v3/issues/_count endpoint.

  async def issues_count(self, query: str, *, auth: YandexAuth | None = None) -> int:
      body: dict[str, Any] = {
          "query": query,
      }
  
      async with self._session.post(
          "v3/issues/_count", headers=await self._build_headers(auth), json=body
      ) as response:
          response.raise_for_status()
          return int(await response.text())