@smartbear/mcp 0.26.0 → 0.27.0

package/README.md

@@ -110,7 +110,8 @@ Alternatively, you can use `npx` (or globally install) the `@smartbear/mcp` pack
         "QTM4J_API_KEY": "${input:qtm4j_api_key}",
         "QTM4J_BASE_URL": "${input:qtm4j_base_url}",
         "QTM4J_AUTOMATION_API_KEY": "${input:qtm4j_automation_api_key}",
-        "SWAGGER_FUNCTIONAL_TESTING_API_TOKEN": "${input:swagger_functional_testing_api_token}"
+        "SWAGGER_FUNCTIONAL_TESTING_API_TOKEN": "${input:swagger_functional_testing_api_token}",
+        "SWAGGER_FUNCTIONAL_TESTING_BASE_PATH": "${input:swagger_functional_testing_base_path}"
       }
     }
   },
@@ -258,6 +259,12 @@ Alternatively, you can use `npx` (or globally install) the `@smartbear/mcp` pack
           "type": "promptString",
           "description": "Swagger Functional Testing API Token - leave blank to disable Functional Testing tools",
           "password": true
+    },
+    {
+          "id": "swagger_functional_testing_base_path",
+          "type": "promptString",
+          "description": "Swagger Functional Testing API Base URL - leave blank to use the default (https://api.reflect.run/v1)",
+          "password": false
     }
   ]
 }
@@ -300,7 +307,8 @@ Add the following configuration to your `claude_desktop_config.json` to launch t
         "QTM4J_API_KEY": "your_qtm4j_key",
         "QTM4J_BASE_URL": "https://qtmcloud.qmetry.com",
         "QTM4J_AUTOMATION_API_KEY": "your_qtm4j_automation_api_key",
-        "SWAGGER_FUNCTIONAL_TESTING_API_TOKEN": "your_swagger_functional_testing_api_token"
+        "SWAGGER_FUNCTIONAL_TESTING_API_TOKEN": "your_swagger_functional_testing_api_token",
+        "SWAGGER_FUNCTIONAL_TESTING_BASE_PATH": "https://api.reflect.run/v1"
       }
     }
   }

package/dist/package.json.js

@@ -1,4 +1,4 @@
-const version = "0.26.0";
+const version = "0.27.0";
 const config = { "mcpServerName": "SmartBear MCP Server" };
 const packageJson = {
   version,

package/dist/qmetry/client/api/client-api.js

@@ -7,7 +7,10 @@ async function qmetryRequest({
   token,
   project,
   baseUrl,
-  body
+  body,
+  scopeId,
+  orgCode,
+  extraHeaders
 }) {
   const url = `${baseUrl}${path}`;
   const headers = {
@@ -16,6 +19,15 @@ async function qmetryRequest({
     "User-Agent": USER_AGENT,
     "qmetry-source": "smartbear-mcp"
   };
+  if (scopeId !== void 0) {
+    headers.scope = String(scopeId);
+  }
+  if (orgCode !== void 0) {
+    headers.orgcode = orgCode;
+  }
+  if (extraHeaders) {
+    Object.assign(headers, extraHeaders);
+  }
   if (body) {
     headers["Content-Type"] = "application/json";
   }

package/dist/qmetry/client/auto-resolve.js

@@ -9,6 +9,7 @@ const AUTO_RESOLVE_MODULES = [
     handler: QMetryToolsHandlers.CREATE_TEST_CASE,
     folderIdPath: "rootFolders.TC.id",
     folderIdField: "tcFolderID",
+    folderIdAsString: true,
     moduleName: "Test Cases"
   },
   {
@@ -26,6 +27,11 @@ const AUTO_RESOLVE_MODULES = [
     viewIdPath: "latestViews.TE.viewId",
     moduleName: "Test Case Run By Test Suite Run"
   },
+  {
+    handler: QMetryToolsHandlers.FETCH_TEST_RUN_UDF_VALUES,
+    viewIdPath: "latestViews.TE.viewId",
+    moduleName: "Test Run UDF Values"
+  },
   {
     handler: QMetryToolsHandlers.FETCH_EXECUTIONS_BY_TESTSUITE,
     viewIdPath: "latestViews.TEL.viewId",
@@ -42,8 +48,15 @@ const AUTO_RESOLVE_MODULES = [
     handler: QMetryToolsHandlers.CREATE_TEST_SUITE,
     folderIdPath: "rootFolders.TS.id",
     folderIdField: "parentFolderId",
+    folderIdAsString: true,
     moduleName: "Test Suites"
   },
+  {
+    handler: QMetryToolsHandlers.UPDATE_TEST_SUITE,
+    folderIdPath: "rootFolders.TS.id",
+    folderIdField: "TsFolderID",
+    moduleName: "Test Suite"
+  },
   {
     handler: QMetryToolsHandlers.FETCH_ISSUES,
     viewIdPath: "latestViews.IS.viewId",
@@ -69,7 +82,7 @@ function autoResolveViewIdAndFolderPath(args, projectInfo, config) {
   if (config.folderIdPath && config.folderIdField && !updatedArgs[config.folderIdField]) {
     const folderId = getNestedProperty(projectInfo, config.folderIdPath);
     if (folderId) {
-      updatedArgs[config.folderIdField] = folderId;
+      updatedArgs[config.folderIdField] = config.folderIdAsString ? String(folderId) : folderId;
     }
   }
   return updatedArgs;
@@ -77,9 +90,18 @@ function autoResolveViewIdAndFolderPath(args, projectInfo, config) {
 function findAutoResolveConfig(handler) {
   return AUTO_RESOLVE_MODULES.find((module) => module.handler === handler);
 }
+function extractProjectContext(projectInfo) {
+  const rawScopeId = projectInfo?.currentProjectId;
+  const parsedScopeId = rawScopeId !== void 0 ? Number(rawScopeId) : NaN;
+  return {
+    scopeId: Number.isFinite(parsedScopeId) ? parsedScopeId : void 0,
+    orgCode: projectInfo?.clientCode !== void 0 ? String(projectInfo.clientCode) : void 0
+  };
+}
 export {
   AUTO_RESOLVE_MODULES,
   autoResolveViewIdAndFolderPath,
+  extractProjectContext,
   findAutoResolveConfig,
   getNestedProperty
 };

package/dist/qmetry/client/handlers.js

@@ -1,10 +1,11 @@
 import { QMetryToolsHandlers } from "../config/constants.js";
 import { getAutomationStatus, importAutomationResults } from "./automation.js";
-import { linkIssuesToTestcaseRun, fetchIssues, updateIssue, createIssue, fetchIssuesLinkedToTestCase } from "./issues.js";
+import { fetchIssueExecutions, linkIssuesToTestcaseRun, fetchIssues, updateIssue, createIssue, fetchIssuesLinkedToTestCase } from "./issues.js";
 import { updateCycle, createCycle, createRelease, getPlatforms, getBuilds, getReleasesCycles, getProjectInfo, getProjects } from "./project.js";
 import { fetchRequirementsLinkedToTestCase, fetchRequirementDetails, fetchRequirements } from "./requirement.js";
 import { fetchTestCasesLinkedToRequirement, linkRequirementToTestCase, fetchTestCaseExecutions, fetchTestCaseSteps, fetchTestCaseVersionDetails, fetchTestCaseDetails, fetchTestCases, updateTestCase, createTestCases } from "./testcase.js";
 import { linkPlatformsToTestSuite, fetchLinkedIssuesByTestCaseRun, fetchTestCaseRunsByTestSuiteRun, bulkUpdateExecutionStatus, fetchExecutionsByTestSuite, fetchTestCasesByTestSuite, reqLinkedTestCasesToTestSuite, linkTestCasesToTestSuite, fetchTestSuitesForTestCase, fetchTestSuites, updateTestSuite, createTestSuites } from "./testsuite.js";
+import { fetchCascadeChildValues, fetchTestRunUdfValues, fetchTestRunUdfMetadata, bulkUpdateTestRunUdfs, fetchUdfModules, fetchUdfFieldTypes } from "./udf.js";
 const QMETRY_HANDLER_MAP = {
   [QMetryToolsHandlers.FETCH_PROJECTS]: getProjects,
   [QMetryToolsHandlers.SET_PROJECT_INFO]: getProjectInfo,
@@ -45,7 +46,14 @@ const QMETRY_HANDLER_MAP = {
   [QMetryToolsHandlers.LINK_ISSUES_TO_TESTCASE_RUN]: linkIssuesToTestcaseRun,
   [QMetryToolsHandlers.LINK_PLATFORMS_TO_TESTSUITE]: linkPlatformsToTestSuite,
   [QMetryToolsHandlers.IMPORT_AUTOMATION_RESULTS]: importAutomationResults,
-  [QMetryToolsHandlers.FETCH_AUTOMATION_STATUS]: getAutomationStatus
+  [QMetryToolsHandlers.FETCH_AUTOMATION_STATUS]: getAutomationStatus,
+  [QMetryToolsHandlers.FETCH_UDF_FIELD_TYPES]: fetchUdfFieldTypes,
+  [QMetryToolsHandlers.FETCH_UDF_MODULES]: fetchUdfModules,
+  [QMetryToolsHandlers.BULK_UPDATE_TEST_RUN_UDFS]: bulkUpdateTestRunUdfs,
+  [QMetryToolsHandlers.FETCH_TEST_RUN_UDF_METADATA]: fetchTestRunUdfMetadata,
+  [QMetryToolsHandlers.FETCH_TEST_RUN_UDF_VALUES]: fetchTestRunUdfValues,
+  [QMetryToolsHandlers.FETCH_ISSUE_EXECUTIONS]: fetchIssueExecutions,
+  [QMetryToolsHandlers.FETCH_CASCADE_CHILD_VALUES]: fetchCascadeChildValues
 };
 export {
   QMETRY_HANDLER_MAP

package/dist/qmetry/client/issues.js

@@ -1,5 +1,5 @@
 import { QMETRY_PATHS } from "../config/rest-endpoints.js";
-import { DEFAULT_LINK_ISSUES_TO_TESTCASE_RUN_PAYLOAD, DEFAULT_FETCH_ISSUES_PAYLOAD, DEFAULT_UPDATE_ISSUE_PAYLOAD, DEFAULT_CREATE_ISSUE_PAYLOAD, DEFAULT_FETCH_ISSUES_LINKED_TO_TESTCASE_PAYLOAD } from "../types/issues.js";
+import { DEFAULT_LINK_ISSUES_TO_TESTCASE_RUN_PAYLOAD, DEFAULT_FETCH_ISSUES_PAYLOAD, DEFAULT_UPDATE_ISSUE_PAYLOAD, DEFAULT_CREATE_ISSUE_PAYLOAD, DEFAULT_FETCH_ISSUES_LINKED_TO_TESTCASE_PAYLOAD, DEFAULT_FETCH_ISSUE_EXECUTIONS_PAYLOAD } from "../types/issues.js";
 import { qmetryRequest } from "./api/client-api.js";
 import { resolveDefaults } from "./utils.js";
 async function createIssue(token, baseUrl, project, payload) {
@@ -104,6 +104,117 @@ async function fetchIssuesLinkedToTestCase(token, baseUrl, project, payload) {
     body
   });
 }
+async function fetchIssueExecutions(token, baseUrl, project, payload) {
+  const { resolvedBaseUrl, resolvedProject } = resolveDefaults(
+    baseUrl,
+    project
+  );
+  const { linkedAssetId, ...rest } = payload;
+  const resolvedLinkedAsset = payload.linkedAsset ?? (typeof linkedAssetId === "number" ? { type: "DF", id: linkedAssetId } : void 0);
+  if (!resolvedLinkedAsset || typeof resolvedLinkedAsset.id !== "number") {
+    throw new Error(
+      "[fetchIssueExecutions] Missing or invalid required parameter: 'linkedAssetId'."
+    );
+  }
+  const body = {
+    ...DEFAULT_FETCH_ISSUE_EXECUTIONS_PAYLOAD,
+    ...rest,
+    linkedAsset: resolvedLinkedAsset
+  };
+  const result = await qmetryRequest({
+    method: "POST",
+    path: QMETRY_PATHS.ISSUES.GET_ISSUE_EXECUTIONS,
+    token,
+    project: resolvedProject,
+    baseUrl: resolvedBaseUrl,
+    body,
+    extraHeaders: {
+      action: "link-tc-list-view",
+      screenname: "ISSUE"
+    }
+  });
+  if (result.hasTcRunUdf === false) {
+    return {
+      ...result,
+      testRunUdfNote: "No Test Run UDFs are configured for this project. The 'testRunUdfs' field will not be present in execution records. To enable Test Run UDF features, a project administrator must define Test Run UDF fields in the project settings."
+    };
+  }
+  let fieldDefs = {};
+  try {
+    const meta = await qmetryRequest({
+      method: "POST",
+      path: QMETRY_PATHS.UDF.TEST_RUN_UDF_METADATA,
+      token,
+      project: resolvedProject,
+      baseUrl: resolvedBaseUrl,
+      body: { entityType: "TCR" },
+      extraHeaders: {
+        action: "fetch-steps",
+        screenname: "EXECUTION RUN"
+      }
+    });
+    fieldDefs = meta.qmUDF?.TCR ?? {};
+  } catch {
+  }
+  const hasMetadata = Object.keys(fieldDefs).length > 0;
+  const rows = result.data ?? [];
+  const enrichedData = rows.map((row) => {
+    let rawUdfs = {};
+    if (row.udfjson) {
+      try {
+        rawUdfs = JSON.parse(row.udfjson);
+      } catch {
+        rawUdfs = {};
+      }
+    }
+    let testRunUdfs;
+    if (hasMetadata) {
+      testRunUdfs = Object.values(fieldDefs).map((def) => {
+        let value = Object.hasOwn(rawUdfs, def.name) ? rawUdfs[def.name] : null;
+        if (typeof value === "string" && /<[^>]+>/.test(value)) {
+          value = value.replace(/<[^>]*>/g, " ").replace(/&(nbsp|amp|lt|gt|quot);/g, (_, entity) => {
+            if (entity === "nbsp") return " ";
+            if (entity === "amp") return "&";
+            if (entity === "lt") return "<";
+            if (entity === "gt") return ">";
+            if (entity === "quot") return '"';
+            return `&${entity};`;
+          }).replace(/\s+/g, " ").trim();
+        }
+        return {
+          name: def.name,
+          label: def.fieldLabel,
+          fieldID: def.projectUserFieldID,
+          fieldType: def.fieldTypeName,
+          value
+        };
+      });
+    } else {
+      testRunUdfs = Object.fromEntries(
+        Object.entries(rawUdfs).map(([key, val]) => {
+          if (typeof val === "string" && /<[^>]+>/.test(val)) {
+            const text = val.replace(/<[^>]*>/g, " ").replace(/&(nbsp|amp|lt|gt|quot);/g, (_, entity) => {
+              if (entity === "nbsp") return " ";
+              if (entity === "amp") return "&";
+              if (entity === "lt") return "<";
+              if (entity === "gt") return ">";
+              if (entity === "quot") return '"';
+              return `&${entity};`;
+            }).replace(/\s+/g, " ").trim();
+            return [key, text];
+          }
+          return [key, val];
+        })
+      );
+    }
+    const { udfjson: _udfjson, ...rowRest } = row;
+    return { ...rowRest, testRunUdfs };
+  });
+  return {
+    ...result,
+    data: enrichedData
+  };
+}
 async function linkIssuesToTestcaseRun(token, baseUrl, project, payload) {
   const { resolvedBaseUrl, resolvedProject } = resolveDefaults(
     baseUrl,
@@ -134,6 +245,7 @@ async function linkIssuesToTestcaseRun(token, baseUrl, project, payload) {
 }
 export {
   createIssue,
+  fetchIssueExecutions,
   fetchIssues,
   fetchIssuesLinkedToTestCase,
   linkIssuesToTestcaseRun,

package/dist/qmetry/client/testcase.js

@@ -197,7 +197,7 @@ async function fetchTestCaseExecutions(token, baseUrl, project, payload) {
       "[fetchTestCaseExecutions] Missing or invalid required parameter: 'tcid'."
     );
   }
-  return qmetryRequest({
+  const result = await qmetryRequest({
     method: "POST",
     path: QMETRY_PATHS.TESTCASE.GET_TC_EXECUTIONS,
     token,
@@ -205,6 +205,87 @@ async function fetchTestCaseExecutions(token, baseUrl, project, payload) {
     baseUrl: resolvedBaseUrl,
     body
   });
+  if (result.hasTcRunUdf === false) {
+    return {
+      ...result,
+      testRunUdfNote: "No Test Run UDFs are configured for this project. The 'testRunUdfs' field will not be present in execution records. To enable Test Run UDF features, a project administrator must define Test Run UDF fields in the project settings."
+    };
+  }
+  let fieldDefs = {};
+  try {
+    const meta = await qmetryRequest({
+      method: "POST",
+      path: QMETRY_PATHS.UDF.TEST_RUN_UDF_METADATA,
+      token,
+      project: resolvedProject,
+      baseUrl: resolvedBaseUrl,
+      body: { entityType: "TCR" },
+      extraHeaders: {
+        action: "fetch-steps",
+        screenname: "EXECUTION RUN"
+      }
+    });
+    fieldDefs = meta.qmUDF?.TCR ?? {};
+  } catch {
+  }
+  const hasMetadata = Object.keys(fieldDefs).length > 0;
+  const rows = result.data ?? [];
+  const enrichedData = rows.map((row) => {
+    let rawUdfs = {};
+    if (row.udfjson) {
+      try {
+        rawUdfs = JSON.parse(row.udfjson);
+      } catch {
+        rawUdfs = {};
+      }
+    }
+    let testRunUdfs;
+    if (hasMetadata) {
+      testRunUdfs = Object.values(fieldDefs).map((def) => {
+        let value = Object.hasOwn(rawUdfs, def.name) ? rawUdfs[def.name] : null;
+        if (typeof value === "string" && /<[^>]+>/.test(value)) {
+          value = value.replace(/<[^>]*>/g, " ").replace(/&(nbsp|amp|lt|gt|quot);/g, (_, entity) => {
+            if (entity === "nbsp") return " ";
+            if (entity === "amp") return "&";
+            if (entity === "lt") return "<";
+            if (entity === "gt") return ">";
+            if (entity === "quot") return '"';
+            return `&${entity};`;
+          }).replace(/\s+/g, " ").trim();
+        }
+        return {
+          name: def.name,
+          label: def.fieldLabel,
+          fieldID: def.projectUserFieldID,
+          fieldType: def.fieldTypeName,
+          value
+        };
+      });
+    } else {
+      testRunUdfs = Object.fromEntries(
+        Object.entries(rawUdfs).map(([key, val]) => {
+          if (typeof val === "string" && /<[^>]+>/.test(val)) {
+            const text = val.replace(/<[^>]*>/g, " ").replace(/&(nbsp|amp|lt|gt|quot);/g, (_, entity) => {
+              if (entity === "nbsp") return " ";
+              if (entity === "amp") return "&";
+              if (entity === "lt") return "<";
+              if (entity === "gt") return ">";
+              if (entity === "quot") return '"';
+              return `&${entity};`;
+            }).replace(/\s+/g, " ").trim();
+            return [key, text];
+          }
+          return [key, val];
+        })
+      );
+    }
+    const { udfjson: _udfjson, ...rest } = row;
+    return { ...rest, testRunUdfs };
+  });
+  return {
+    ...result,
+    data: enrichedData
+  };
 }
 async function linkRequirementToTestCase(token, baseUrl, project, payload) {
   const { resolvedBaseUrl, resolvedProject } = resolveDefaults(

package/dist/qmetry/client/testsuite.js

@@ -142,9 +142,10 @@ async function fetchExecutionsByTestSuite(token, baseUrl, project, payload) {
     baseUrl,
     project
   );
+  const { scopeId, orgCode, ...payloadRest } = payload;
   const body = {
     ...DEFAULT_FETCH_EXECUTIONS_BY_TESTSUITE_PAYLOAD,
-    ...payload
+    ...payloadRest
   };
   if (typeof body.tsID !== "number") {
     throw new Error(
@@ -157,7 +158,9 @@ async function fetchExecutionsByTestSuite(token, baseUrl, project, payload) {
     token,
     project: resolvedProject,
     baseUrl: resolvedBaseUrl,
-    body
+    body,
+    scopeId,
+    orgCode
   });
 }
 async function fetchTestCaseRunsByTestSuiteRun(token, baseUrl, project, payload) {
@@ -165,9 +168,10 @@ async function fetchTestCaseRunsByTestSuiteRun(token, baseUrl, project, payload)
     baseUrl,
     project
   );
+  const { scopeId, orgCode, ...payloadRest } = payload;
   const body = {
     ...DEFAULT_FETCH_TESTCASE_RUNS_BY_TESTSUITE_RUN_PAYLOAD,
-    ...payload
+    ...payloadRest
   };
   if (typeof body.tsrunID !== "string" || !body.tsrunID) {
     throw new Error(
@@ -185,7 +189,9 @@ async function fetchTestCaseRunsByTestSuiteRun(token, baseUrl, project, payload)
     token,
     project: resolvedProject,
     baseUrl: resolvedBaseUrl,
-    body
+    body,
+    scopeId,
+    orgCode
   });
 }
 async function fetchLinkedIssuesByTestCaseRun(token, baseUrl, project, payload) {
@@ -216,9 +222,10 @@ async function linkTestCasesToTestSuite(token, baseUrl, project, payload) {
     baseUrl,
     project
   );
+  const { scopeId, orgCode, ...payloadRest } = payload;
   const body = {
     ...DEFAULT_LINKED_TESTCASE_TO_TESTSUITE_PAYLOAD,
-    ...payload
+    ...payloadRest
   };
   if (typeof body.tsID !== "number") {
     throw new Error(
@@ -234,7 +241,9 @@ async function linkTestCasesToTestSuite(token, baseUrl, project, payload) {
     token,
     project: resolvedProject,
     baseUrl: resolvedBaseUrl,
-    body
+    body,
+    scopeId,
+    orgCode
   });
 }
 async function reqLinkedTestCasesToTestSuite(token, baseUrl, project, payload) {
@@ -242,9 +251,10 @@ async function reqLinkedTestCasesToTestSuite(token, baseUrl, project, payload) {
     baseUrl,
     project
   );
+  const { scopeId, orgCode, ...payloadRest } = payload;
   const body = {
     ...DEFAULT_REQLINKED_TESTCASE_TO_TESTSUITE_PAYLOAD,
-    ...payload
+    ...payloadRest
   };
   if (typeof body.tsID !== "number") {
     throw new Error(
@@ -262,7 +272,9 @@ async function reqLinkedTestCasesToTestSuite(token, baseUrl, project, payload) {
     token,
     project: resolvedProject,
     baseUrl: resolvedBaseUrl,
-    body
+    body,
+    scopeId,
+    orgCode
   });
 }
 async function linkPlatformsToTestSuite(token, baseUrl, project, payload) {

package/dist/qmetry/client/tools/index.js

@@ -4,13 +4,15 @@ import { PROJECT_TOOLS } from "./project-tools.js";
 import { REQUIREMENT_TOOLS } from "./requirement-tools.js";
 import { TESTCASE_TOOLS } from "./testcase-tools.js";
 import { TESTSUITE_TOOLS } from "./testsuite-tools.js";
+import { UDF_TOOLS } from "./udf-tools.js";
 const TOOLS = [
   ...PROJECT_TOOLS,
   ...TESTCASE_TOOLS,
   ...REQUIREMENT_TOOLS,
   ...TESTSUITE_TOOLS,
   ...ISSUE_TOOLS,
-  ...AUTOMATION_TOOLS
+  ...AUTOMATION_TOOLS,
+  ...UDF_TOOLS
 ];
 export {
   AUTOMATION_TOOLS,
@@ -19,5 +21,6 @@ export {
   REQUIREMENT_TOOLS,
   TESTCASE_TOOLS,
   TESTSUITE_TOOLS,
-  TOOLS
+  TOOLS,
+  UDF_TOOLS
 };