@uarlouski/testrail-mcp-server 1.7.0 → 1.8.0

package/dist/client/testrail.js

@@ -112,6 +112,10 @@ export class TestRailClient {
         }
         return this.projectsPromise;
     }
+    async getLabels(projectId) {
+        const url = `${API_BASE_V2}/get_labels/${projectId}`;
+        return this.paginateAll(url, 'labels');
+    }
     async getTests(runId, statusId) {
         let url = `${API_BASE_V2}/get_tests/${runId}`;
         if (statusId && statusId.length > 0) {

package/dist/index.js

@@ -19,6 +19,7 @@ import { getTestsTool } from "./tools/get_tests.js";
 import { addResultsTool } from "./tools/add_results.js";
 import { addAttachmentToRunTool } from "./tools/add_attachment_to_run.js";
 import { addResultsForCasesTool } from "./tools/add_results_for_cases.js";
+import { getLabelsTool } from "./tools/get_labels.js";
 import { removeNullish } from "./utils/sanitizer.js";
 import z from "zod";
 const EnvSchema = z.object({
@@ -34,7 +35,7 @@ if (!parseResult.success) {
 const { TESTRAIL_INSTANCE_URL, TESTRAIL_USERNAME, TESTRAIL_API_KEY } = parseResult.data;
 const server = new McpServer({
     name: "TestRail MCP Server",
-    version: "1.7.0",
+    version: "1.8.0",
 });
 const client = new TestRailClient(TESTRAIL_INSTANCE_URL, TESTRAIL_USERNAME, TESTRAIL_API_KEY);
 const tools = [
@@ -54,6 +55,7 @@ const tools = [
     addResultsTool,
     addResultsForCasesTool,
     addAttachmentToRunTool,
+    getLabelsTool,
 ];
 for (const tool of tools) {
     server.registerTool(tool.name, {

package/dist/tools/get_case_fields.js

@@ -14,6 +14,7 @@ const FIELD_TYPE_NAMES = {
     11: "Step Results",
     12: "Multi-select",
     13: "Scenarios",
+    14: "List",
 };
 function getFieldTypeName(typeId) {
     return FIELD_TYPE_NAMES[typeId] || `Unknown (${typeId})`;
@@ -45,6 +46,7 @@ export const SYSTEM_FIELDS = [
     { system_name: "estimate", label: "Estimate", type: "String", is_required: false },
     { system_name: "milestone_id", label: "Milestone", type: "Integer", is_required: false },
     { system_name: "refs", label: "References", type: "String", is_required: false },
+    { system_name: "labels", label: "Labels", type: "List", is_required: false, comment: "Use get_labels tool to get available labels/tags." },
 ];
 export const getCaseFieldsTool = {
     name: "get_case_fields",

package/dist/tools/get_labels.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import { LabelSchema } from "../types/testrail.js";
+const parameters = {
+    project_id: z.number().describe("The ID of the project to retrieve labels for"),
+};
+export const getLabelsTool = {
+    name: "get_labels",
+    description: "Get all available test case labels (sometimes called tags) for a project. Returns label IDs and titles that can be used when creating or updating test cases.",
+    parameters,
+    handler: async ({ project_id }, client) => {
+        const labels = await client.getLabels(project_id);
+        return {
+            labels: labels.map(l => LabelSchema.parse(l)),
+        };
+    },
+};

package/dist/types/testrail.js

@@ -19,6 +19,7 @@ export const CaseFieldSchema = z.object({
     configs: z.array(CaseFieldConfigSchema),
 });
 export const LabelSchema = z.object({
+    id: z.number(),
     title: z.string(),
 });
 export const CaseSchema = z.object({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uarlouski/testrail-mcp-server",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "mcpName": "io.github.uarlouski/testrail-mcp-server",
   "description": "Model Context Protocol (MCP) server for TestRail integration, enabling LLMs to fetch test cases and metadata.",
   "main": "dist/index.js",