@uarlouski/testrail-mcp-server 3.0.0 → 3.1.0

package/dist/tools/cases/add_case.js

@@ -17,7 +17,7 @@ export const addCaseTool = {
     parameters,
     handler: async ({ section_id, title, fields }, client) => {
         if (fields) {
-            validateCaseFields(fields, await client.getCaseFields());
+            validateCaseFields(fields, await client.getCaseFields(), { allowReadonly: false });
         }
         const caseData = {
             title,

package/dist/tools/cases/fields.js

@@ -45,3 +45,13 @@ export const SYSTEM_FIELDS = [
     { system_name: "refs", label: "References", type: getFieldType(CaseFieldTypeId.String).name, is_required: false, project_scope: { scope: "global" } },
     { system_name: "labels", label: "Labels", type: getFieldType(CaseFieldTypeId.List).name, is_required: false, project_scope: { scope: "global" }, description: "Use get_labels tool to get available labels/tags." },
 ];
+export const READONLY_CASE_FIELDS = [
+    "id",
+    "suite_id",
+    "created_on",
+    "updated_on",
+    "created_by",
+    "updated_by",
+    "estimate_forecast",
+    "is_deleted",
+];

package/dist/tools/cases/get_case_fields.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { CaseFieldTypeId, FIELD_TYPES, getFieldType, SYSTEM_FIELDS } from "./fields.js";
+import { CaseFieldTypeId, FIELD_TYPES, getFieldType, SYSTEM_FIELDS, READONLY_CASE_FIELDS } from "./fields.js";
 import { parseDropdownOptions } from "../../utils/mapper.js";
 import { isActive } from "../../utils/sanitizer.js";
 // Field remains optional for backward compatibility with previous implementation.
@@ -14,7 +14,7 @@ Example: {"priority_id": 2, "template_id": 1, "labels": [1, 2]}
 Call get_case_fields with project_id first if field names are not already known.
 Using an unknown field name (e.g. 'label_ids') will result in an error.
 `;
-export { CaseFieldTypeId, FIELD_TYPES, getFieldType, SYSTEM_FIELDS };
+export { CaseFieldTypeId, FIELD_TYPES, getFieldType, SYSTEM_FIELDS, READONLY_CASE_FIELDS };
 function isFieldRequired(field) {
     return field.configs.some(config => config.options?.is_required === true);
 }

package/dist/tools/cases/get_cases.js

@@ -11,7 +11,7 @@ const parameters = {
     }).optional().describe("Section filter configuration. Use query_section to find available sections"),
     filter: z.record(z.string(), z.string()).optional().describe("Optional API-side filters (more efficient for large datasets). Supported: priority_id, type_id, created_by, updated_by, milestone_id, refs, created_after, created_before, updated_after, updated_before. Use comma-separated values for IDs. Example: {\"priority_id\": \"1,2\", \"type_id\": \"3\"}"),
     where: z.record(z.string(), z.any()).optional().describe("Optional client-side filter for any field including custom fields (filters after fetching all cases). Supports exact value matching. Example: {\"custom_automation_status\": 1, \"priority_id\": 2}"),
-    fields: z.array(z.string()).optional().describe("Additional fields to include in response beyond id, title, and suite_id. Use get_case_fields to see available fields. Example: [\"priority_id\", \"type_id\", \"custom_automation_status\"]"),
+    fields: z.array(z.string()).optional().describe("Additional fields to include in response beyond id, title, and suite_id (supports system fields such as updated_on, created_on, created_by, updated_by, as well as custom fields). Example: [\"updated_on\", \"priority_id\", \"custom_automation_status\"]"),
     output_file: z.string().optional().describe("Absolute file path to save the JSON response to. Use this for large datasets to avoid blowing up context limits."),
 };
 export async function fetchFilteredCases(client, options) {

package/dist/tools/cases/types.js

@@ -34,10 +34,14 @@ export const CaseSchema = z.object({
     priority_id: z.number(),
     milestone_id: z.number().nullable(),
     refs: z.string().nullable(),
+    created_by: z.number().optional(),
     created_on: z.number(),
+    updated_by: z.number().optional(),
     updated_on: z.number(),
     estimate: z.string().nullable(),
+    estimate_forecast: z.string().nullable().optional(),
     suite_id: z.number(),
+    is_deleted: z.number().optional(),
     labels: z.array(LabelSchema),
 }).loose();
 export const CaseHistoryChangeSchema = z.object({

package/dist/tools/cases/update_case.js

@@ -17,7 +17,7 @@ export const updateCaseTool = {
     description: description.trim(),
     parameters,
     handler: async ({ case_id, fields }, client) => {
-        validateCaseFields(fields, await client.getCaseFields());
+        validateCaseFields(fields, await client.getCaseFields(), { allowReadonly: false });
         const id = normalizeEntityId(case_id);
         const updatedCase = await client.updateCase(id, fields);
         return {

package/dist/tools/cases/update_cases.js

@@ -16,7 +16,7 @@ export const updateCasesTool = {
     description: description.trim(),
     parameters,
     handler: async ({ case_ids, fields }, client) => {
-        validateCaseFields(fields, await client.getCaseFields());
+        validateCaseFields(fields, await client.getCaseFields(), { allowReadonly: false });
         const caseData = await client.getCase(case_ids[0]);
         const updatedCases = await client.updateCases(caseData.suite_id, case_ids, fields);
         return {

package/dist/utils/validator.js

@@ -1,4 +1,4 @@
-import { SYSTEM_FIELDS, mapToFieldSchema } from "../tools/cases/get_case_fields.js";
+import { SYSTEM_FIELDS, READONLY_CASE_FIELDS, mapToFieldSchema } from "../tools/cases/get_case_fields.js";
 import { isActive } from "./sanitizer.js";
 const SUITE_MODE_SINGLE_WITH_BASELINES = 2;
 const SUITE_MODE_MULTI = 3;
@@ -21,16 +21,20 @@ export async function validateSuiteId(client, projectId, suiteId) {
  *
  * @param fields A record of fields or array of field names to validate
  * @param caseFields Available custom case fields from TestRail
+ * @param options Validation options (e.g. allowReadonly)
  */
-export function validateCaseFields(fields, caseFields) {
+export function validateCaseFields(fields, caseFields, options = { allowReadonly: true }) {
     const fieldKeys = Array.isArray(fields) ? fields : Object.keys(fields);
     if (fieldKeys.length === 0) {
         return;
     }
     const customFieldSchemas = caseFields.filter(isActive).map(mapToFieldSchema);
     const validFieldNames = new Set([...SYSTEM_FIELDS, ...customFieldSchemas].map(f => f.system_name));
-    validFieldNames.add('id');
-    validFieldNames.add('suite_id');
+    if (options.allowReadonly !== false) {
+        for (const field of READONLY_CASE_FIELDS) {
+            validFieldNames.add(field);
+        }
+    }
     const invalidFields = [];
     for (const key of fieldKeys) {
         if (!validFieldNames.has(key)) {

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "3.0.0";
+export const VERSION = "3.1.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uarlouski/testrail-mcp-server",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "mcpName": "io.github.uarlouski/testrail-mcp-server",
   "description": "Model Context Protocol (MCP) server for TestRail: let Claude, Cursor, and Windsurf manage test cases, runs, results, and attachments.",
   "main": "dist/index.js",