Yandex Tracker MCP

Instructions

Implementation Reference

• mcp_tracker/mcp/tools.py:335-346 (handler)

  The primary MCP tool handler for 'issue_get_checklist'. It performs authorization check via check_issue_id and delegates to the issues protocol implementation.

  @mcp.tool(description="Get checklist items of a Yandex Tracker issue by its id")
  async def issue_get_checklist(
      ctx: Context[Any, AppContext],
      issue_id: IssueID,
  ) -> list[ChecklistItem]:
      check_issue_id(settings, issue_id)
  
      return await ctx.request_context.lifespan_context.issues.issue_get_checklist(
          issue_id,
          auth=get_yandex_auth(ctx),
      )

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

  Explicit registration of all MCP tools, including 'issue_get_checklist', by invoking register_tools on the FastMCP server instance.

  register_tools(settings, mcp)

• mcp_tracker/mcp/params.py:23-26 (schema)

  Pydantic-based input schema definition for the 'issue_id' parameter using Annotated type with description and validation.

  IssueID = Annotated[
      str,
      Field(description="Issue ID in the format '<project>-<id>', like 'SOMEPROJECT-1'"),
  ]

• mcp_tracker/tracker/custom/client.py:403-414 (helper)

  Core implementation in TrackerClient that performs the HTTP GET request to Yandex Tracker API endpoint '/v3/issues/{issue_id}/checklistItems' and parses the JSON response into ChecklistItem list.

  async def issue_get_checklist(
      self, issue_id: str, *, auth: YandexAuth | None = None
  ) -> list[ChecklistItem]:
      async with self._session.get(
          f"v3/issues/{issue_id}/checklistItems",
          headers=await self._build_headers(auth),
      ) as response:
          if response.status == 404:
              raise IssueNotFound(issue_id)
          response.raise_for_status()
          return ChecklistItemList.model_validate_json(await response.read()).root