@smartbear/mcp 0.26.0 → 0.27.0

package/dist/qmetry/client.js

@@ -1,10 +1,10 @@
 import zod__default from "zod";
 import { getRequestHeader } from "../common/request-context.js";
-import { findAutoResolveConfig, autoResolveViewIdAndFolderPath } from "./client/auto-resolve.js";
+import { extractProjectContext, findAutoResolveConfig, autoResolveViewIdAndFolderPath } from "./client/auto-resolve.js";
 import { QMETRY_HANDLER_MAP } from "./client/handlers.js";
 import { getProjectInfo } from "./client/project.js";
 import { TOOLS } from "./client/tools/index.js";
-import { QMETRY_DEFAULTS } from "./config/constants.js";
+import { QMETRY_DEFAULTS, QMetryToolsHandlers } from "./config/constants.js";
 const ConfigurationSchema = zod__default.object({
   api_key: zod__default.string().describe("QMetry API key for authentication"),
   base_url: zod__default.string().url().optional().describe(
@@ -19,6 +19,8 @@ class QmetryClient {
   token;
   projectApiKey = QMETRY_DEFAULTS.PROJECT_KEY;
   endpoint = QMETRY_DEFAULTS.BASE_URL;
+  projectNumericId;
+  orgCode;
   async configure(_server, config, _cache) {
     this.token = config.api_key;
     if (config.base_url) {
@@ -42,6 +44,11 @@ class QmetryClient {
   getBaseUrl() {
     return this.endpoint;
   }
+  persistProjectContext(projectInfo) {
+    const { scopeId, orgCode } = extractProjectContext(projectInfo);
+    if (scopeId !== void 0) this.projectNumericId = scopeId;
+    if (orgCode !== void 0) this.orgCode = orgCode;
+  }
   async registerTools(register, _getInput) {
     const resolveContext = (args) => ({
       baseUrl: args.baseUrl ?? this.endpoint,
@@ -101,15 +108,35 @@ class QmetryClient {
                   autoResolveConfig
                 )
               );
+              this.persistProjectContext(projectInfo);
             }
           }
           const { projectKey: _, baseUrl: __, ...cleanArgs } = a;
+          const SCOPE_AWARE_HANDLERS = /* @__PURE__ */ new Set([
+            QMetryToolsHandlers.FETCH_TESTCASE_RUNS_BY_TESTSUITE_RUN,
+            QMetryToolsHandlers.BULK_UPDATE_TEST_RUN_UDFS,
+            QMetryToolsHandlers.FETCH_TEST_RUN_UDF_METADATA,
+            QMetryToolsHandlers.FETCH_TEST_RUN_UDF_VALUES,
+            QMetryToolsHandlers.FETCH_CASCADE_CHILD_VALUES
+          ]);
+          const isScopeAware = SCOPE_AWARE_HANDLERS.has(tool.handler);
+          const enrichedArgs = {
+            ...cleanArgs,
+            ...isScopeAware && this.projectNumericId !== void 0 && {
+              scopeId: this.projectNumericId
+            },
+            ...isScopeAware && this.orgCode !== void 0 && { orgCode: this.orgCode }
+          };
           const result = await handlerFn(
             this.getToken(),
             baseUrl,
             projectKey,
-            cleanArgs
+            enrichedArgs
           );
+          if (tool.handler === QMetryToolsHandlers.SET_PROJECT_INFO) {
+            this.projectApiKey = projectKey;
+            this.persistProjectContext(result);
+          }
           const formatted = tool.formatResponse ? tool.formatResponse(result) : result ?? {};
           return {
             content: [

package/dist/qmetry/config/constants.js

@@ -2,6 +2,58 @@ const QMETRY_DEFAULTS = {
   BASE_URL: "https://testmanagement.qmetry.com",
   PROJECT_KEY: "default"
 };
+const UDF_MODULES = [
+  { id: 1, name: "Requirement" },
+  { id: 3, name: "Test Case" },
+  { id: 5, name: "Test Step" },
+  { id: 6, name: "Test Suite" },
+  { id: 11, name: "Issue" },
+  { id: 32, name: "Test Run" }
+];
+const UDF_FIELD_TYPES = [
+  {
+    Id: 6,
+    Fieldtype: "STRING",
+    Description: "Any text string can be entered in this field in plain text.",
+    Preview: "ad-string-ico"
+  },
+  {
+    Id: 2,
+    Fieldtype: "LARGETEXT",
+    Description: "A large plain text field.",
+    Preview: "ad-large-text-ico"
+  },
+  {
+    Id: 3,
+    Fieldtype: "LOOKUPLIST",
+    Description: "An input which can be associated to any custom list define within the current project. Only one item can be selected at a time from this list.",
+    Preview: "ad-lookup-list-ico"
+  },
+  {
+    Id: 4,
+    Fieldtype: "MULTILOOKUPLIST",
+    Description: "An input which can be associated to any custom list define within the current project. Multiple is can be selected at a time.",
+    Preview: "ad-multi-select-lookup-list-ico"
+  },
+  {
+    Id: 5,
+    Fieldtype: "NUMBER",
+    Description: "Any number can be entered into this field.",
+    Preview: "ad-number-ico"
+  },
+  {
+    Id: 1,
+    Fieldtype: "DATETIMEPICKER",
+    Description: "This will open a calendar control which will allow the user to select a date.",
+    Preview: "ad-date-picker-ico"
+  },
+  {
+    Id: 7,
+    Fieldtype: "CASCADINGLIST",
+    Description: "A single-level cascading select list where child values depend on the parent selection.",
+    Preview: "ad-cascading-list-ico"
+  }
+];
 const QMetryToolsHandlers = {
   FETCH_PROJECTS: "getProjects",
   SET_PROJECT_INFO: "setProjectInfo",
@@ -42,9 +94,18 @@ const QMetryToolsHandlers = {
   FETCH_AUTOMATION_STATUS: "fetchAutomationStatus",
   CREATE_RELEASE: "createRelease",
   CREATE_CYCLE: "createCycle",
-  UPDATE_CYCLE: "updateCycle"
+  UPDATE_CYCLE: "updateCycle",
+  FETCH_UDF_FIELD_TYPES: "fetchUdfFieldTypes",
+  FETCH_UDF_MODULES: "fetchUdfModules",
+  BULK_UPDATE_TEST_RUN_UDFS: "bulkUpdateTestRunUdfs",
+  FETCH_TEST_RUN_UDF_METADATA: "fetchTestRunUdfMetadata",
+  FETCH_TEST_RUN_UDF_VALUES: "fetchTestRunUdfValues",
+  FETCH_ISSUE_EXECUTIONS: "getIssueExecutions",
+  FETCH_CASCADE_CHILD_VALUES: "fetchCascadeChildValues"
 };
 export {
   QMETRY_DEFAULTS,
-  QMetryToolsHandlers
+  QMetryToolsHandlers,
+  UDF_FIELD_TYPES,
+  UDF_MODULES
 };

package/dist/qmetry/config/rest-endpoints.js

@@ -40,11 +40,17 @@ const QMETRY_PATHS = {
     GET_ISSUES_LIST: "/rest/issues/list/viewColumns",
     CREATE_UPDATE_ISSUE: "/rest/issues",
     GET_ISSUES_LINKED_TO_TC: "/rest/issues/list/ForTC",
-    LINK_ISSUES_TO_TESTCASE_RUN: "/rest/execution/link/issue"
+    LINK_ISSUES_TO_TESTCASE_RUN: "/rest/execution/link/issue",
+    GET_ISSUE_EXECUTIONS: "/rest/execution/getExecutionsForIssue"
   },
   AUTOMATION: {
     IMPORT_RESULTS: "/rest/import/createandscheduletestresults/1",
     GET_STATUS: "/rest/admin/status/automation/:requestID"
+  },
+  UDF: {
+    BULK_UPDATE_TEST_RUN_UDFS: "/rest/execution/udf/bulkupdate",
+    TEST_RUN_UDF_METADATA: "/rest/admin/udf/metadata",
+    FETCH_CASCADE_CHILD_VALUES: "/rest/admin/udf/cascade/childValue"
   }
 };
 export {

package/dist/qmetry/types/common.js

@@ -34,15 +34,15 @@ const SkipWarningEnum = z.enum(["0", "1"]);
 const CommonFields = {
   projectKey: z.string().describe("Project key - unique identifier for the project").default(QMETRY_DEFAULTS.PROJECT_KEY),
   projectKeyOptional: z.string().optional().describe("Project key - unique identifier for the project").default(QMETRY_DEFAULTS.PROJECT_KEY),
-  baseUrl: z.string().url().optional().describe("The base URL for the QMetry instance (must be a valid URL)").default(QMETRY_DEFAULTS.BASE_URL),
+  baseUrl: z.string().url().optional().describe("The base URL for the QMetry instance (must be a valid URL)"),
   start: z.number().optional().describe("Start index for pagination - defaults to 0").default(0),
   page: z.number().optional().describe("Page number to return (starts from 1)").default(1),
   limit: z.number().optional().describe("Number of records (default 10).").default(10),
-  tcID: z.number().describe(
-    "Test Case numeric ID. This is the internal numeric identifier, not the entity key like 'MAC-TC-1684'. You can get this ID from test case search results or by using filters."
+  tcID: z.coerce.number().describe(
+    "Test Case numeric ID. CRITICAL: the parameter name is 'tcID' — do NOT use 'testCaseId', 'testCaseID', 'tcId', or other variants. Accepts a string or number. This is the internal numeric identifier, not the entity key like 'MAC-TC-1684'. You can get this ID from test case search results or by using filters."
   ),
-  id: z.number().describe(
-    "Test Case numeric ID (required for fetching steps or version details). This is the internal numeric identifier, not the entity key like 'MAC-TC-1684'. You can get this ID from test case search results."
+  id: z.coerce.number().describe(
+    "Test Case numeric ID (required for fetching steps or version details). Accepts a string or number. This is the internal numeric identifier, not the entity key like 'MAC-TC-1684'. You can get this ID from test case search results."
   ),
   version: z.number().describe(
     "Test Case version number. This is the internal numeric identifier for the version."
@@ -59,10 +59,10 @@ const CommonFields = {
   rqVersion: z.number().describe(
     "Requirement version number (required for fetching specific requirement version details). This is the internal numeric identifier for the version."
   ),
-  tcViewId: z.number().describe(
+  tcViewId: z.number().optional().describe(
     "ViewId for test cases - SYSTEM AUTOMATICALLY RESOLVES THIS. Leave empty unless you have a specific viewId. System will fetch project info using the projectKey and extract latestViews.TC.viewId automatically. Manual viewId only needed if you want to override the automatic resolution."
   ),
-  rqViewId: z.number().describe(
+  rqViewId: z.number().optional().describe(
     "ViewId for requirements - SYSTEM AUTOMATICALLY RESOLVES THIS. Leave empty unless you have a specific viewId. System will fetch project info using the projectKey and extract latestViews.RQ.viewId automatically. Manual viewId only needed if you want to override the automatic resolution."
   ),
   rqFolderPath: z.string().optional().describe(
@@ -77,28 +77,28 @@ const CommonFields = {
   folderID: z.number().optional().describe(
     "Folder ID - unique numeric identifier for the specific folder. Use this to target a specific folder within the project hierarchy. Applies to any entity type (test cases, requirements, test suites, etc.)."
   ),
-  tsFolderID: z.number().describe(
-    "Test Suite folder ID (required for fetching test suites). This is the numeric identifier for the test suite folder. IMPORTANT: Get from project info response → rootFolders.TS.id (e.g., 113557 for MAC project). Use FETCH_PROJECT_INFO tool first to get this ID if not provided by user. For root folder: use rootFolders.TS.id, for sub-folders: use specific folder IDs."
+  tsFolderID: z.coerce.number().describe(
+    "Test Suite folder ID. CRITICAL: the parameter name is 'tsFolderID' — do NOT use 'testSuiteFolderId', 'folderId', 'folderID', or other variants. Accepts a string or number. Get from project info response → rootFolders.TS.id. Use FETCH_PROJECT_INFO tool first if not provided by user."
   ),
-  tsID: z.number().describe(
-    "Test Suite numeric ID (required for fetching test cases linked to test suite). This is the internal numeric identifier, not the entity key. NOTE: To get the tsID - Call API 'Testsuite/Fetch Testsuite' From the response, get value of following attribute -> data[<index>].id"
+  tsID: z.coerce.number().describe(
+    "Test Suite numeric ID. CRITICAL: the parameter name is 'tsID' — do NOT use 'testSuiteId', 'testSuiteID', 'suiteId', or other variants. Accepts a string or number. NOTE: To get the tsID - Call API 'Testsuite/Fetch Testsuite' From the response, get value of following attribute -> data[<index>].id"
   ),
   gridName: z.string().optional().describe("Grid Name to be displayed (default 'TESTEXECUTIONLIST')"),
   teViewId: z.number().optional().describe(
     "ViewId for test execution - SYSTEM AUTOMATICALLY RESOLVES THIS. Leave empty unless you have a specific viewId. System will fetch project info using the projectKey and extract latestViews.TE.viewId automatically. Manual viewId only needed if you want to override the automatic resolution."
   ),
-  tsfeViewId: z.number().describe(
+  tsfeViewId: z.number().optional().describe(
     "ViewId for test suite folders - SYSTEM AUTOMATICALLY RESOLVES THIS. Leave empty unless you have a specific viewId. System will fetch project info using the projectKey and extract latestViews.TSFS.viewId automatically. Manual viewId only needed if you want to override the automatic resolution."
   ),
-  tsViewId: z.number().describe(
+  tsViewId: z.number().optional().describe(
     "ViewId for test suites - SYSTEM AUTOMATICALLY RESOLVES THIS. Leave empty unless you have a specific viewId. System will fetch project info using the projectKey and extract latestViews.TS.viewId automatically. Manual viewId only needed if you want to override the automatic resolution."
   ),
-  tsrunID: z.string().describe(
-    "Test Suite Run ID (required for fetching test case runs). This is the string identifier for the test suite run execution. NOTE: To get the tsrunID - Call API 'Execution/Fetch Executions' From the response, get value of following attribute -> data[<index>].tsRunID"
+  tsrunID: z.coerce.string().describe(
+    "Test Suite Run ID. CRITICAL: the parameter name is 'tsrunID' — do NOT use 'testSuiteRunId', 'tsRunID', 'testSuiteRunID', or any other variant. Accepts a string or number (e.g. 731600 or '731600' — both are valid). To get this value: Call 'Fetch Executions by Test Suite' → use data[<index>].tsRunID from the response."
   ),
   showTcWithDefects: z.boolean().optional().describe("Show test case runs with linked defects").default(false),
-  entityId: z.number().describe(
-    "Id of Test case run (required for fetching linked issues). This is the internal numeric identifier for the test case run execution. NOTE: To get the entityId - Call API 'Execution/Fetch Testcase Run ID' From the response, get value of following attribute -> data[<index>].tcRunID"
+  entityId: z.coerce.number().describe(
+    "Id of Test case run (required for fetching linked issues). CRITICAL: the parameter name is 'entityId' — do NOT use 'tcRunId', 'testCaseRunId', 'runId', or other variants. Accepts a string or number. NOTE: To get the entityId - Call API 'Execution/Fetch Testcase Run ID' From the response, get value of following attribute -> data[<index>].tcRunID"
   ),
   getLinked: z.boolean().optional().describe(
     "True to get only those issues that are linked with this Test case Run, False to get those issues which are not linked with this Test case Run. Default value true (get linked issues)."
@@ -109,6 +109,9 @@ const CommonFields = {
   ).default("project"),
   filter: z.string().optional().describe("Filter criteria as JSON string (default '[]')").default("[]"),
   udfFilter: z.string().optional().describe("User-defined field filter as JSON string (default '[]')").default("[]"),
+  tcrUdfFilter: z.string().optional().describe(
+    `Test Case Run (TCR) UDF filter as JSON string (default '[]'). Used to filter test case runs by Test Run UDF field values. Format: '[{"type":"list","value":[<listItemId1>,<listItemId2>],"field":"<udfFieldKey>"}]'. Example: '[{"type":"list","value":[5108701,5108697],"field":"8260LUP"}]' filters runs where the UDF field '8260LUP' has those list item IDs.`
+  ).default("[]"),
   showRootOnly: z.boolean().optional().describe("Whether to show only root folders."),
   getSubEntities: z.boolean().optional().describe("Whether to include sub-entities."),
   getColumns: z.boolean().optional().describe("Whether to get column information in response.").default(true),
@@ -242,7 +245,9 @@ const UpdateTestCaseRemoveStepSchema = z.object({
   tcsIsParameterized: z.boolean()
 });
 const CreateTestCaseArgsSchema = z.object({
-  tcFolderID: z.string(),
+  tcFolderID: z.string().optional().describe(
+    "Test Case folder ID - SYSTEM AUTOMATICALLY RESOLVES THIS. Leave empty unless you have a specific folder ID. System will fetch project info using the projectKey and extract rootFolders.TC.id automatically. Manual folder ID only needed if you want to target a specific sub-folder."
+  ),
   steps: z.array(CreateTestCaseStepSchema).optional(),
   name: z.string(),
   priority: z.number().optional(),
@@ -420,18 +425,20 @@ const TestCasesLinkedToRequirementArgsSchema = z.object({
   tcFolderPath: z.string().optional().describe(
     'Folder path to get test cases under specific folder. Use empty string "" for root folder or specify path like "/Sample Template".'
   ).default(""),
-  releaseID: z.string().optional().describe(
-    "Filter test cases by release ID. Use string representation of release ID (e.g., '7138'). Get release IDs from FETCH_RELEASES_AND_CYCLES tool."
+  releaseID: z.coerce.string().optional().describe(
+    "Filter test cases by release ID. Accepts a string or number. Get release IDs from FETCH_RELEASES_AND_CYCLES tool."
   ),
-  cycleID: z.string().optional().describe(
-    "Filter test cases by cycle ID. Use string representation of cycle ID (e.g., '13382'). Get cycle IDs from FETCH_RELEASES_AND_CYCLES tool."
+  cycleID: z.coerce.string().optional().describe(
+    "Filter test cases by cycle ID. Accepts a string or number. Get cycle IDs from FETCH_RELEASES_AND_CYCLES tool."
   ),
   filter: CommonFields.filter,
   getSubEntities: z.boolean().optional().describe("Allow filter of sub-entities for requirement.").default(true),
   getColumns: z.boolean().optional().describe("True to get column information in response.").default(true)
 });
 const CreateTestSuiteArgsSchema = z.object({
-  parentFolderId: z.string(),
+  parentFolderId: z.string().optional().describe(
+    "Test Suite parent folder ID - SYSTEM AUTOMATICALLY RESOLVES THIS. Leave empty unless you have a specific folder ID. System will fetch project info using the projectKey and extract rootFolders.TS.id automatically. Manual folder ID only needed if you want to target a specific sub-folder."
+  ),
   name: z.string(),
   isAutomatedFlag: z.boolean().optional(),
   description: z.string().optional(),
@@ -447,7 +454,9 @@ const CreateTestSuiteArgsSchema = z.object({
 });
 const UpdateTestSuiteArgsSchema = z.object({
   id: z.number().describe("Id of Test Suite to be updated (required)"),
-  TsFolderID: z.number().describe("Folder ID where Test Suite resides (required)"),
+  TsFolderID: z.number().optional().describe(
+    "Folder ID where Test Suite resides - SYSTEM AUTOMATICALLY RESOLVES THIS. Leave empty unless you have a specific folder ID. System will fetch project info using the projectKey and extract rootFolders.TS.id automatically. Manual folder ID only needed if you want to override the automatic resolution."
+  ),
   entityKey: z.string().describe("Entity Key of Test Suite to be updated (required)"),
   name: z.string().optional().describe("Name of the Test Suite"),
   description: z.string().optional().describe("Description of the Test Suite"),
@@ -473,8 +482,8 @@ const TestSuiteListArgsSchema = z.object({
 const TestSuitesForTestCaseArgsSchema = z.object({
   projectKey: CommonFields.projectKeyOptional,
   baseUrl: CommonFields.baseUrl,
-  tsFolderID: CommonFields.tsFolderID,
-  viewId: CommonFields.tsfeViewId.optional(),
+  tsFolderID: CommonFields.tsFolderID.optional(),
+  viewId: CommonFields.tsfeViewId,
   start: CommonFields.start,
   page: CommonFields.page,
   limit: CommonFields.limit,
@@ -482,16 +491,20 @@ const TestSuitesForTestCaseArgsSchema = z.object({
   filter: CommonFields.filter
 });
 const LinkTestCasesToTestSuiteArgsSchema = z.object({
-  tsID: z.number().describe("Id of Test Suite (required)"),
-  tcvdIDs: z.array(z.number()).describe(
-    "Array of Test Case Version IDs (required if fromReqs is false)"
+  tsID: z.coerce.number().describe(
+    "Id of Test Suite (required). CRITICAL: parameter name is 'tsID' — do NOT use 'testSuiteId', 'testSuiteID', or other variants."
+  ),
+  tcvdIDs: z.array(z.coerce.number()).describe(
+    "Array of Test Case Version IDs (required if fromReqs is false). CRITICAL: parameter name is 'tcvdIDs' — do NOT use 'tcVersionIds', 'testCaseVersionIds', or other variants."
   ),
   fromReqs: z.boolean().optional().describe("Link TestCases from Requirements (optional, default false)")
 }).strip();
 const RequirementsLinkedTestCasesToTestSuiteArgsSchema = z.object({
-  tsID: z.number().describe("Id of Test Suite (required)"),
-  tcvdIDs: z.array(z.number()).describe(
-    "Array of Test Case Version IDs (required if fromReqs is true)"
+  tsID: z.coerce.number().describe(
+    "Id of Test Suite (required). CRITICAL: parameter name is 'tsID' — do NOT use 'testSuiteId', 'testSuiteID', or other variants."
+  ),
+  tcvdIDs: z.array(z.coerce.number()).describe(
+    "Array of Test Case Version IDs (required if fromReqs is true). CRITICAL: parameter name is 'tcvdIDs' — do NOT use 'tcVersionIds', 'testCaseVersionIds', or other variants."
   ),
   fromReqs: z.boolean().optional().describe("Link TestCases from Requirements (optional, default true)")
 }).strip();
@@ -533,11 +546,15 @@ const TestCaseRunsByTestSuiteRunArgsSchema = z.object({
   baseUrl: CommonFields.baseUrl,
   tsrunID: CommonFields.tsrunID,
   // API payload param - sent in request body (REQUIRED)
-  viewId: CommonFields.teViewId.pipe(z.number()),
-  // API payload param - sent in request body (REQUIRED)
+  viewId: CommonFields.teViewId,
+  // auto-resolved via SYSTEM if not provided
   start: CommonFields.start,
   page: CommonFields.page,
-  limit: CommonFields.limit
+  limit: CommonFields.limit,
+  filter: CommonFields.filter,
+  udfFilter: CommonFields.udfFilter,
+  tcrUdfFilter: CommonFields.tcrUdfFilter,
+  showTcWithDefects: CommonFields.showTcWithDefects
 });
 const LinkedIssuesByTestCaseRunArgsSchema = z.object({
   projectKey: CommonFields.projectKeyOptional,
@@ -569,7 +586,9 @@ const CreateIssueArgsSchema = z.object({
   )
 });
 const UpdateIssueArgsSchema = z.object({
-  DefectId: z.number().describe("ID of the defect/issue to be updated"),
+  DefectId: z.coerce.number().describe(
+    "ID of the defect/issue to be updated. CRITICAL: the parameter name is 'DefectId' (capital D) — do NOT use 'defectId', 'issueId', 'id', or other variants. Accepts a string or number."
+  ),
   entityKey: z.string().optional().describe("Entity Key of the defect/issue to be updated"),
   issueType: z.number().optional().describe("Issue type ID (e.g. Bug, Enhancement, etc.)"),
   issuePriority: z.number().optional().describe("Issue priority ID (e.g. High, Medium, Low, etc.)"),
@@ -582,7 +601,7 @@ const UpdateIssueArgsSchema = z.object({
 const IssuesListArgsSchema = z.object({
   projectKey: CommonFields.projectKeyOptional,
   baseUrl: CommonFields.baseUrl,
-  viewId: z.number().describe(
+  viewId: z.number().optional().describe(
     "ViewId for issues - SYSTEM AUTOMATICALLY RESOLVES THIS. Leave empty unless you have a specific viewId. System will fetch project info using the projectKey and extract latestViews.IS.viewId automatically. Manual viewId only needed if you want to override the automatic resolution."
   ),
   start: CommonFields.start,
@@ -598,29 +617,45 @@ const LinkIssuesToTestcaseRunArgsSchema = z.object({
   projectKey: CommonFields.projectKeyOptional,
   baseUrl: CommonFields.baseUrl,
   issueIds: z.array(z.union([z.string(), z.number()])).describe("ID of issues to be linked to Testcase Run"),
-  tcrId: z.number().describe("ID of Testcase Run to link issues with")
+  tcrId: z.coerce.number().describe(
+    "ID of Testcase Run to link issues with. CRITICAL: parameter name is 'tcrId' — do NOT use 'tcRunId', 'testCaseRunId', or other variants. Accepts a string or number."
+  )
+});
+const IssueExecutionsArgsSchema = z.object({
+  projectKey: CommonFields.projectKeyOptional,
+  baseUrl: CommonFields.baseUrl,
+  linkedAssetId: z.coerce.number().describe(
+    "Numeric defect ID of the QMetry issue. CRITICAL: parameter name is 'linkedAssetId' — do NOT use 'issueId', 'defectId', 'id', or other variants. Accepts a string or number. To get this ID, call the Fetch Defects or Issues tool and use data[<index>].id from the response."
+  ),
+  start: CommonFields.start,
+  page: CommonFields.page,
+  limit: CommonFields.limit,
+  platformID: z.string().optional().describe("Platform ID to filter executions by environment/platform"),
+  filter: z.string().optional().describe(
+    `JSON filter string. Supported fields: tcName (string), linkageLevel (string), executedVersion (string), runStatusName (list of status names), platformID (list of numeric IDs), executionCreatedByLoginAlias (list of usernames), isTestSuiteArchived (list: [1] active, [0] archived, [1,0] both). Example: '[{"type":"string","value":"login","field":"tcName"}]'`
+  ).default("[]")
 });
 const LinkPlatformsToTestSuiteArgsSchema = z.object({
   projectKey: CommonFields.projectKeyOptional,
   baseUrl: CommonFields.baseUrl,
-  qmTsId: z.number().describe(
-    "Id of Test Suite (required). To get the qmTsId - Call API 'Testsuite/Fetch Testsuite' From the response, get value of following attribute -> data[<index>].id"
+  qmTsId: z.coerce.number().describe(
+    "Id of Test Suite (required). CRITICAL: the parameter name is 'qmTsId' — do NOT use 'tsId', 'testSuiteId', 'tsID', or other variants. Accepts a string or number. To get the qmTsId - Call API 'Testsuite/Fetch Testsuite'. From the response, get value -> data[<index>].id"
   ),
-  qmPlatformId: z.string().describe(
-    "Comma-separated value of PlatformId (required). To get the qmPlatformId - Call API 'Platform/List' From the response, get value of following attribute -> data[<index>].platformID"
+  qmPlatformId: z.coerce.string().describe(
+    "Comma-separated Platform IDs (required). CRITICAL: the parameter name is 'qmPlatformId' — do NOT use 'platformId', 'platformID', 'platformIds', or other variants. Accepts a number or string. To get the qmPlatformId - Call API 'Platform/List'. From the response, get value -> data[<index>].platformID"
   )
 });
 const BulkUpdateExecutionStatusArgsSchema = z.object({
   projectKey: CommonFields.projectKeyOptional,
   baseUrl: CommonFields.baseUrl,
-  entityIDs: z.string().describe(
-    "Comma-separated IDs of Test Case Runs to update (e.g., '66095087' for single or '66095069,66095075' for bulk). To get the entityIDs - Call API 'Execution/Fetch Testcase Run ID' From the response, get value of following attribute -> data[<index>].tcRunID"
+  entityIDs: z.coerce.string().describe(
+    "Comma-separated IDs of Test Case Runs to update. CRITICAL: the parameter name is 'entityIDs' — do NOT use 'tcRunIDs', 'testCaseRunIds', 'runIds', or other variants. Accepts a number or string (e.g., 66095087 or '66095087' for single, '66095069,66095075' for bulk). To get the entityIDs - Call API 'Execution/Fetch Testcase Run ID'. From the response, get value -> data[<index>].tcRunID"
   ),
   entityType: z.enum(["TCR", "TCSR"]).describe(
     "Type of Entity to Execute: 'TCR' (Test Case Run) or 'TCSR' (Test Case Step Run)"
   ).default("TCR"),
-  qmTsRunId: z.string().describe(
-    "Id of Test Suite Run to execute (required). To get the qmTsRunId - Call API 'Execution/Fetch Executions' From the response, get value of following attribute -> data[<index>].tsRunID"
+  qmTsRunId: z.coerce.string().describe(
+    "Id of Test Suite Run to execute (required). CRITICAL: the parameter name is 'qmTsRunId' — do NOT use 'tsrunID', 'testSuiteRunId', 'tsRunID', or other variants. Accepts a number or string. To get the qmTsRunId - Call API 'Execution/Fetch Executions'. From the response, get value -> data[<index>].tsRunID"
   ),
   runStatusID: z.number().describe(
     "Id of the execution status to set (required). To get the runStatusID - Call API 'Admin/Project GET info Service' From the response, get value of following attribute -> allstatus[<index>].id Common statuses: Pass, Fail, Not Run, Blocked, WIP, etc."
@@ -718,7 +753,9 @@ const ImportAutomationResultsPayloadSchema = z.object({
 const FetchAutomationStatusPayloadSchema = z.object({
   projectKey: CommonFields.projectKeyOptional,
   baseUrl: CommonFields.baseUrl,
-  requestID: z.number().describe("Numeric request ID from import automation response")
+  requestID: z.coerce.number().describe(
+    "Numeric request ID from import automation response. CRITICAL: parameter name is 'requestID' — do NOT use 'requestId', 'jobId', or other variants. Accepts a string or number."
+  )
 });
 export {
   AutomationHierarchyEnum,
@@ -739,6 +776,7 @@ export {
   ExecutionsByTestSuiteArgsSchema,
   FetchAutomationStatusPayloadSchema,
   ImportAutomationResultsPayloadSchema,
+  IssueExecutionsArgsSchema,
   IssuesLinkedToTestCaseArgsSchema,
   IssuesListArgsSchema,
   LinkIssuesToTestcaseRunArgsSchema,

package/dist/qmetry/types/issues.js

@@ -7,6 +7,10 @@ const DEFAULT_FETCH_ISSUES_LINKED_TO_TESTCASE_PAYLOAD = {
 const DEFAULT_CREATE_ISSUE_PAYLOAD = {};
 const DEFAULT_UPDATE_ISSUE_PAYLOAD = {};
 const DEFAULT_LINK_ISSUES_TO_TESTCASE_RUN_PAYLOAD = {};
+const DEFAULT_FETCH_ISSUE_EXECUTIONS_PAYLOAD = {
+  ...DEFAULT_PAGINATION,
+  filter: "[]"
+};
 const DEFAULT_FETCH_ISSUES_PAYLOAD = {
   ...DEFAULT_PAGINATION,
   ...DEFAULT_FILTER,
@@ -23,6 +27,7 @@ export {
   DEFAULT_CREATE_ISSUE_PAYLOAD,
   DEFAULT_FETCH_ISSUES_LINKED_TO_TESTCASE_PAYLOAD,
   DEFAULT_FETCH_ISSUES_PAYLOAD,
+  DEFAULT_FETCH_ISSUE_EXECUTIONS_PAYLOAD,
   DEFAULT_LINK_ISSUES_TO_TESTCASE_RUN_PAYLOAD,
   DEFAULT_UPDATE_ISSUE_PAYLOAD
 };

package/dist/qmetry/types/udf.js

@@ -0,0 +1,77 @@
+import { z } from "zod";
+import { CommonFields } from "./common.js";
+z.object({
+  projectKey: CommonFields.projectKey,
+  baseUrl: CommonFields.baseUrl
+});
+z.object({
+  projectKey: CommonFields.projectKeyOptional,
+  baseUrl: CommonFields.baseUrl
+});
+const UdfFieldValueSchema = z.object({
+  fieldID: z.number().int().positive().describe(
+    "Numeric ID of the UDF field to update. Get this from the UDF field definition in QMetry admin or from the field's metadata."
+  ),
+  value: z.union([
+    z.string(),
+    z.number(),
+    z.array(z.number().int()),
+    z.object({
+      parent: z.number().int().describe("Parent item ID for cascading list."),
+      child: z.number().int().describe("Child item ID for cascading list.")
+    })
+  ]).describe(
+    "Value to set for this UDF field. Type depends on field type:\nSTRING: plain string, e.g. 'test value'\nNUMBER: number, e.g. 3\nDATETIMEPICKER: date string in MM-DD-YYYY format, e.g. '06-20-2026'\nLOOKUPLIST (single): numeric item ID, e.g. 5108697\nMULTILOOKUPLIST (multi-select): array of item IDs, e.g. [5158524, 5158525]\nCASCADINGLIST: object with parent and child IDs, e.g. {parent: 5126498, child: 5126499}"
+  ),
+  multiSelectAction: z.enum(["append", "replace"]).optional().default("append").describe(
+    "Action for MULTILOOKUPLIST fields only. 'append' adds the new values to existing selections (default). 'replace' clears existing selections and sets only the new values. Omit or use 'append' if user does not specify — never assume 'replace'."
+  )
+});
+const BulkUpdateTestRunUdfsArgsSchema = z.object({
+  projectKey: CommonFields.projectKeyOptional,
+  baseUrl: CommonFields.baseUrl,
+  tcRunIDs: z.array(z.number().int().positive()).min(1).describe(
+    "Array of Test Case Run IDs to update UDF values for. To get tcRunIDs — Call 'Fetch Test Case Runs by Test Suite Run' tool. From the response, get value of data[<index>].tcRunID. Example: [41572006, 41572009, 41572013]"
+  ),
+  UDF: z.record(z.string(), UdfFieldValueSchema).describe(
+    "Object mapping UDF field names to their new values. Each key is the UDF field name (e.g. 'test_env', 'priority_field'). Each value is an object with fieldID and value (and optionally multiSelectAction for multi-select fields). All UDF fields are optional — include only the fields you want to update."
+  )
+});
+const FetchTestRunUdfMetadataArgsSchema = z.object({
+  projectKey: CommonFields.projectKeyOptional,
+  baseUrl: CommonFields.baseUrl
+});
+const FetchCascadeChildValuesArgsSchema = z.object({
+  projectKey: CommonFields.projectKeyOptional,
+  baseUrl: CommonFields.baseUrl,
+  id: z.number().int().positive().describe(
+    "Numeric ID of the parent cascade list item to fetch child values for. Get this from the 'lookupOptions' returned by 'Fetch Test Run UDF Metadata' for a CASCADINGLIST field — each option has an 'id' field."
+  ),
+  isArchReq: z.boolean().optional().default(false).describe(
+    "Whether to include archived child items in the response (default: false)."
+  )
+});
+const FetchTestRunUdfValuesArgsSchema = z.object({
+  projectKey: CommonFields.projectKeyOptional,
+  baseUrl: CommonFields.baseUrl,
+  tsrunID: z.coerce.string().optional().describe(
+    "Test Suite Run ID. CRITICAL: the parameter name is 'tsrunID' — do NOT use 'testSuiteRunId', 'tsRunID', or any other variant. Accepts a string or number (e.g. 731600 or '731600' — both are valid). Get this from 'Fetch Executions by Test Suite' → use data[<index>].tsRunID from the response. Required when sourceRows is not provided."
+  ),
+  viewId: z.number().int().positive().optional().describe(
+    "View ID for the test execution list (latestViews.TE.viewId from project info). Auto-resolved from project info when omitted. Required when sourceRows is not provided."
+  ),
+  sourceContext: z.enum(["testSuiteRun", "testCaseExecutions"]).optional().default("testSuiteRun").describe(
+    "Which parent tool produced sourceRows. Use 'testSuiteRun' for Fetch Test Case Runs by Test Suite Run. Do NOT use this tool for Fetch Test Case Executions — that tool calls metadata internally and returns testRunUdfs on every execution row; use that data directly. Do NOT use this tool for Fetch Issue Executions; that tool already reads udfjson and enriches it with metadata."
+  ),
+  sourceRows: z.array(z.record(z.string(), z.unknown())).optional().describe(
+    "Optional rows already returned by Fetch Test Case Runs by Test Suite Run. The UDF tool will reuse these rows, enrich/pivot UDF values, and preserve identification fields instead of making the same execution-list API call again. Do NOT pass Fetch Test Case Executions rows here — those rows already have testRunUdfs enriched. Do not pass issue execution rows here; use Fetch Issue Executions output directly for issue UDFs."
+  ),
+  startIndex: z.number().int().min(0).optional().default(0).describe("Zero-based start index for pagination (default: 0)."),
+  size: z.number().int().min(1).optional().default(50).describe("Number of test case runs to return per page (default: 50).")
+});
+export {
+  BulkUpdateTestRunUdfsArgsSchema,
+  FetchCascadeChildValuesArgsSchema,
+  FetchTestRunUdfMetadataArgsSchema,
+  FetchTestRunUdfValuesArgsSchema
+};