@smartbear/mcp 0.19.2 → 0.21.1

package/dist/qtm4j/tool/test-case/update-test-case.js

@@ -0,0 +1,158 @@
+import { Tool, ToolError } from "../../../common/tools.js";
+import { TOOL_NAMES, ENDPOINTS } from "../../config/constants.js";
+import { ResolverKeys, InputField } from "../../config/field-resolution.types.js";
+import { UpdateTestCaseResponse, UpdateTestCaseBody } from "../../schema/update-test-case.schema.js";
+const SIMPLE_FIELD_CONFIG = {
+  [InputField.PRIORITY]: ResolverKeys.CommonAttribute.PRIORITY,
+  [InputField.STATUS]: ResolverKeys.CommonAttribute.TESTCASE_STATUS
+};
+const ADD_DELETE_FIELD_CONFIG = {
+  [InputField.LABELS]: ResolverKeys.SearchableField.LABEL,
+  [InputField.COMPONENTS]: ResolverKeys.SearchableField.COMPONENTS
+};
+async function resolveAddDelete(resolver, inputField, resolverKey, field, context, warnings) {
+  const result = {};
+  for (const op of ["add", "delete"]) {
+    const names = field[op];
+    if (!names?.length) continue;
+    const tempBody = { [inputField]: names };
+    await resolver.resolve(
+      inputField,
+      resolverKey,
+      tempBody,
+      context,
+      warnings
+    );
+    const val = tempBody[inputField];
+    if (Array.isArray(val) && val.length > 0 && typeof val[0] === "number") {
+      result[op] = val;
+    }
+  }
+  return result;
+}
+class UpdateTestCase extends Tool {
+  specification = {
+    title: TOOL_NAMES.UPDATE_TEST_CASE.TITLE,
+    summary: TOOL_NAMES.UPDATE_TEST_CASE.SUMMARY,
+    readOnly: false,
+    idempotent: true,
+    inputSchema: UpdateTestCaseBody,
+    outputSchema: UpdateTestCaseResponse,
+    purpose: "Update an existing test case in QTM4J using its human-readable key (e.g. 'SCRUM-TC-145'). The key is automatically resolved to the internal UID and latest version — no manual ID lookup needed. Only the fields you provide are changed — omitted fields are left as-is. For priority and status, supply the human-readable name and it is auto-resolved to the internal ID. For labels and components, use the add/delete object to atomically add or remove entries by name. PREREQUISITE: set_project_context must be called before this tool.",
+    useCases: [
+      "Change the priority of a test case (e.g., escalate to 'High')",
+      "Update the status of a test case after review",
+      "Add new labels or remove outdated ones without affecting other labels",
+      "Add or remove components from a test case",
+      "Update summary, description, or precondition text",
+      "Reassign a test case to a different team member",
+      "Set or update the estimated time for a test case",
+      "Batch-update metadata as part of sprint planning"
+    ],
+    examples: [
+      {
+        description: "Change the priority of a test case",
+        parameters: { key: "SCRUM-TC-145", priority: "High" },
+        expectedOutput: "Test case updated with new priority"
+      },
+      {
+        description: "Add a label and remove an old one",
+        parameters: {
+          key: "SCRUM-TC-145",
+          labels: { add: ["Release_2"], delete: ["Release_1"] }
+        },
+        expectedOutput: "Test case updated — Release_2 added, Release_1 removed"
+      },
+      {
+        description: "Update summary, status, and add a component",
+        parameters: {
+          key: "SCRUM-TC-32",
+          summary: "Verify login with MFA enabled",
+          status: "In Progress",
+          components: { add: ["Auth"] }
+        },
+        expectedOutput: "Test case summary and status updated, Auth component added"
+      },
+      {
+        description: "Update a specific version",
+        parameters: {
+          key: "SCRUM-TC-85",
+          versionNo: 2,
+          assignee: "5b10a2844c20165700ede21f",
+          estimatedTime: "01:30:00"
+        },
+        expectedOutput: "Version 2 of test case updated with new assignee and estimated time"
+      }
+    ],
+    hints: [
+      "PREREQUISITE: set_project_context must be called before this tool. NEVER auto-select a project.",
+      "KEY FORMAT: '{PROJECT_KEY}-TC-{number}' — e.g. 'SCRUM-TC-145'.",
+      "Priority and status values come from set_project_context. Use NLP to map user intent to available names.",
+      "If priority or status name is not found, the field is skipped with a warning and other fields are still updated.",
+      "Labels and components use add/delete — you can add and delete in a single call. Names are auto-resolved.",
+      "To delete ALL current entries of any add/delete field: first call search_test_cases with filter.searchText set to the test case key and include the relevant field in the fields list, extract all current names from the response, then pass them in the delete array of this tool.",
+      "Only provide the fields you want to change. Omitted fields remain unchanged on the server.",
+      "estimatedTime must be in HH:MM:SS format (e.g., '02:30:00').",
+      "versionNo defaults to the latest version. Use search_test_cases to find available versions if needed."
+    ],
+    outputDescription: "Confirmation object with the test case key, versionNo updated, and updated: true. Warnings are included if any field names could not be resolved."
+  };
+  handle = async (rawArgs) => {
+    const args = UpdateTestCaseBody.parse(rawArgs);
+    const fieldResolver = this.client.getResolverRegistry();
+    const context = fieldResolver.requireProjectContext();
+    const warnings = [];
+    const uidMap = await fieldResolver.getResolver(ResolverKeys.SearchableField.TEST_CASE_KEY_TO_UID).resolveAndReturn(context.projectId, [args.key]);
+    const entry = uidMap[args.key];
+    if (!entry) {
+      throw new ToolError(
+        `Test case '${args.key}' not found in project '${context.projectKey}'. Verify the key using the search_test_cases tool.`
+      );
+    }
+    const versionNo = args.versionNo ?? entry.latestVersion;
+    const {
+      key: _key,
+      versionNo: _vno,
+      labels,
+      components,
+      ...scalarArgs
+    } = args;
+    const body = { ...scalarArgs };
+    await Promise.all(
+      Object.entries(SIMPLE_FIELD_CONFIG).map(
+        ([inputField, resolverKey]) => fieldResolver.getResolver(resolverKey).resolve(inputField, resolverKey, body, context, warnings)
+      )
+    );
+    for (const field of Object.keys(SIMPLE_FIELD_CONFIG)) {
+      if (typeof body[field] === "string") delete body[field];
+    }
+    for (const [inputField, resolverKey] of Object.entries(
+      ADD_DELETE_FIELD_CONFIG
+    )) {
+      const field = args[inputField];
+      if (!field) continue;
+      const resolvedField = await resolveAddDelete(
+        fieldResolver.getResolver(resolverKey),
+        inputField,
+        resolverKey,
+        field,
+        context,
+        warnings
+      );
+      if (Object.keys(resolvedField).length > 0)
+        body[inputField] = resolvedField;
+    }
+    await this.client.getApiClient().put(ENDPOINTS.UPDATE_TEST_CASE(entry.uid, versionNo), body);
+    return {
+      structuredContent: UpdateTestCaseResponse.parse({
+        key: args.key,
+        versionNo,
+        updated: true
+      }),
+      content: warnings.length > 0 ? [{ type: "text", text: `Note: ${warnings.join(" | ")}` }] : []
+    };
+  };
+}
+export {
+  UpdateTestCase
+};

package/dist/reflect/client.js

@@ -27,7 +27,7 @@ class ReflectClient {
   sessionStates = /* @__PURE__ */ new Map();
   mcpSessionConnections = /* @__PURE__ */ new Map();
   name = "Reflect";
-  toolPrefix = "reflect";
+  capabilityPrefix = "reflect";
   configPrefix = "Reflect";
   config = ConfigurationSchema;
   async configure(_server, config, _cache) {
@@ -136,10 +136,10 @@ class ReflectClient {
       register(tool.specification, tool.handle);
     }
   }
-  registerPrompts(register) {
+  async registerPrompts(register) {
     const prompts = [new SapTest(this)];
     for (const prompt of prompts) {
-      register(prompt.name, prompt.params, prompt.callback);
+      register(prompt.specification, prompt.callback);
     }
   }
 }

package/dist/reflect/prompt/sap-test.js

@@ -1,12 +1,12 @@
+import { z } from "zod";
 import { Prompt } from "../../common/prompts.js";
 class SapTest extends Prompt {
-  name = "reflect-sap-test";
-  params = {
-    title: "Reflect SAP Test",
+  specification = {
+    title: "SAP Test",
     description: "Guidelines for creating a Reflect test against an SAP S4/HANA or SAP BTP application.",
-    argsSchema: {}
+    argsSchema: z.object({})
   };
-  callback = () => ({
+  callback = (_args) => ({
     messages: [
       {
         role: "user",

package/dist/reflect/tool/recording/add-prompt-step.js

@@ -7,20 +7,12 @@ class AddPromptStep extends Tool {
     summary: "Add a natural language prompt step to an active Reflect recording session",
     readOnly: false,
     idempotent: false,
-    parameters: [
-      {
-        name: "sessionId",
-        type: z.string(),
-        description: "The ID of the Reflect recording session",
-        required: true
-      },
-      {
-        name: "prompt",
-        type: z.string(),
-        description: 'The natural language prompt describing the test step. The prompt should describe a single action, assertion, or query. The prompt can only contain literal text; it cannot contain template variables, secrets, or other dynamic syntax. If we are in a Web recording, the prompt can perform browser navigation (e.g. "Click on the back button", "Navigate to https://www.example.com") and use the tab and enter keys to navigate (e.g. "Press the tab key", "Press the enter key").',
-        required: true
-      }
-    ]
+    inputSchema: z.object({
+      sessionId: z.string().describe("The ID of the Reflect recording session"),
+      prompt: z.string().describe(
+        "The natural language prompt describing the test step. The prompt should describe a single action, assertion, or query. The prompt can only contain literal text; it cannot contain template variables, secrets, or other dynamic syntax. If we are in a Web recording, the prompt can perform browser navigation (e.g. 'Click on the back button', 'Navigate to https://www.example.com') and use the tab and enter keys to navigate (e.g. 'Press the tab key', 'Press the enter key')."
+      )
+    })
   };
   handle = async (args) => {
     const { sessionId, prompt } = args;

package/dist/reflect/tool/recording/add-segment.js

@@ -7,20 +7,10 @@ class AddSegment extends Tool {
     summary: "Insert a reusable test segment into an active Reflect recording session",
     readOnly: false,
     idempotent: false,
-    parameters: [
-      {
-        name: "sessionId",
-        type: z.string(),
-        description: "The ID of the Reflect recording session",
-        required: true
-      },
-      {
-        name: "segmentId",
-        type: z.number(),
-        description: "The ID of the segment to add",
-        required: true
-      }
-    ]
+    inputSchema: z.object({
+      sessionId: z.string().describe("The ID of the Reflect recording session"),
+      segmentId: z.number().describe("The ID of the segment to add")
+    })
   };
   handle = async (args) => {
     const { sessionId, segmentId } = args;

package/dist/reflect/tool/recording/connect-to-session.js

@@ -16,14 +16,9 @@ class ConnectToSession extends Tool {
 7. After completing a task, if the task required multiple prompt steps, add a final prompt step that validates the current state of the page based on what you see on the screen. In your validation, do not reference information that can change from run to run.`,
     readOnly: false,
     idempotent: true,
-    parameters: [
-      {
-        name: "sessionId",
-        type: z.string(),
-        description: "The ID of the Reflect recording session to connect to",
-        required: true
-      }
-    ]
+    inputSchema: z.object({
+      sessionId: z.string().describe("The ID of the Reflect recording session to connect to")
+    })
   };
   handle = async (args, extra) => {
     const { sessionId } = args;

package/dist/reflect/tool/recording/delete-previous-step.js

@@ -8,14 +8,9 @@ class DeletePreviousStep extends Tool {
     readOnly: false,
     idempotent: false,
     destructive: true,
-    parameters: [
-      {
-        name: "sessionId",
-        type: z.string(),
-        description: "The ID of the Reflect recording session",
-        required: true
-      }
-    ]
+    inputSchema: z.object({
+      sessionId: z.string().describe("The ID of the Reflect recording session")
+    })
   };
   handle = async (args) => {
     const { sessionId } = args;

package/dist/reflect/tool/recording/get-screenshot.js

@@ -7,20 +7,10 @@ class GetScreenshot extends Tool {
     summary: "Capture a screenshot from the current state of an active Reflect recording session",
     readOnly: true,
     idempotent: true,
-    parameters: [
-      {
-        name: "sessionId",
-        type: z.string(),
-        description: "The ID of the Reflect recording session",
-        required: true
-      },
-      {
-        name: "format",
-        type: z.enum(["png", "jpeg"]),
-        description: "The image format for the screenshot (png or jpeg)",
-        required: false
-      }
-    ]
+    inputSchema: z.object({
+      sessionId: z.string().describe("The ID of the Reflect recording session"),
+      format: z.enum(["png", "jpeg"]).optional().describe("The image format for the screenshot (png or jpeg)")
+    })
   };
   handle = async (args) => {
     const { sessionId, format } = args;

package/dist/reflect/tool/suites/cancel-suite-execution.js

@@ -5,20 +5,10 @@ class CancelSuiteExecution extends Tool {
   specification = {
     title: "Cancel Suite Execution",
     summary: "Cancel a reflect suite execution",
-    parameters: [
-      {
-        name: "suiteId",
-        type: z.string(),
-        description: "ID of the reflect suite to cancel execution for",
-        required: true
-      },
-      {
-        name: "executionId",
-        type: z.string(),
-        description: "ID of the reflect suite execution to cancel",
-        required: true
-      }
-    ]
+    inputSchema: z.object({
+      suiteId: z.string().describe("ID of the reflect suite to cancel execution for"),
+      executionId: z.string().describe("ID of the reflect suite execution to cancel")
+    })
   };
   handle = async (args) => {
     const { suiteId, executionId } = args;

package/dist/reflect/tool/suites/execute-suite.js

@@ -5,14 +5,9 @@ class ExecuteSuite extends Tool {
   specification = {
     title: "Execute Suite",
     summary: "Execute a reflect suite",
-    parameters: [
-      {
-        name: "suiteId",
-        type: z.string(),
-        description: "ID of the reflect suite to execute",
-        required: true
-      }
-    ]
+    inputSchema: z.object({
+      suiteId: z.string().describe("ID of the reflect suite to execute")
+    })
   };
   handle = async (args) => {
     const { suiteId } = args;

package/dist/reflect/tool/suites/get-suite-execution-status.js

@@ -5,20 +5,10 @@ class GetSuiteExecutionStatus extends Tool {
   specification = {
     title: "Get Suite Execution Status",
     summary: "Get the status of a reflect suite execution",
-    parameters: [
-      {
-        name: "suiteId",
-        type: z.string(),
-        description: "ID of the reflect suite to get execution status for",
-        required: true
-      },
-      {
-        name: "executionId",
-        type: z.string(),
-        description: "ID of the reflect suite execution to get status for",
-        required: true
-      }
-    ]
+    inputSchema: z.object({
+      suiteId: z.string().describe("ID of the reflect suite to get execution status for"),
+      executionId: z.string().describe("ID of the reflect suite execution to get status for")
+    })
   };
   handle = async (args) => {
     const { suiteId, executionId } = args;

package/dist/reflect/tool/suites/list-suite-executions.js

@@ -5,14 +5,9 @@ class ListSuiteExecutions extends Tool {
   specification = {
     title: "List Suite Executions",
     summary: "List all executions for a given suite",
-    parameters: [
-      {
-        name: "suiteId",
-        type: z.string(),
-        description: "ID of the reflect suite to list executions for",
-        required: true
-      }
-    ]
+    inputSchema: z.object({
+      suiteId: z.string().describe("ID of the reflect suite to list executions for")
+    })
   };
   handle = async (args) => {
     const { suiteId } = args;

package/dist/reflect/tool/suites/list-suites.js

@@ -1,10 +1,11 @@
+import { z } from "zod";
 import { Tool, ToolError } from "../../../common/tools.js";
 import { API_HOSTNAME } from "../../config/constants.js";
 class ListSuites extends Tool {
   specification = {
     title: "List Suites",
     summary: "Retrieve a list of all reflect suites available",
-    parameters: []
+    inputSchema: z.object({})
   };
   handle = async (_args) => {
     const response = await fetch(`https://${API_HOSTNAME}/v1/suites`, {

package/dist/reflect/tool/tests/get-test-status.js

@@ -5,14 +5,9 @@ class GetTestStatus extends Tool {
   specification = {
     title: "Get Test Status",
     summary: "Get the status of a reflect test execution",
-    parameters: [
-      {
-        name: "executionId",
-        type: z.string(),
-        description: "ID of the reflect test execution to get status for",
-        required: true
-      }
-    ]
+    inputSchema: z.object({
+      executionId: z.string().describe("ID of the reflect test execution to get status for")
+    })
   };
   handle = async (args) => {
     const { executionId } = args;

package/dist/reflect/tool/tests/list-segments.js

@@ -7,26 +7,11 @@ class ListSegments extends Tool {
     summary: "Retrieve available reusable test segments for the given platform type. Segments are reusable test steps with an optional set of parameters that can used across multiple tests.",
     readOnly: true,
     idempotent: true,
-    parameters: [
-      {
-        name: "platform",
-        type: z.enum(["api", "native-mobile", "web"]),
-        description: "The platform type to retrieve segments for",
-        required: true
-      },
-      {
-        name: "offset",
-        type: z.number(),
-        description: "Offset for pagination",
-        required: false
-      },
-      {
-        name: "limit",
-        type: z.number(),
-        description: "Maximum number of segments to return",
-        required: false
-      }
-    ]
+    inputSchema: z.object({
+      platform: z.enum(["api", "native-mobile", "web"]).describe("The platform type to retrieve segments for"),
+      offset: z.number().optional().describe("Offset for pagination"),
+      limit: z.number().optional().describe("Maximum number of segments to return")
+    })
   };
   handle = async (args) => {
     const {

package/dist/reflect/tool/tests/list-tests.js

@@ -1,10 +1,11 @@
+import { z } from "zod";
 import { Tool, ToolError } from "../../../common/tools.js";
 import { API_HOSTNAME } from "../../config/constants.js";
 class ListTests extends Tool {
   specification = {
     title: "List Tests",
     summary: "List all reflect tests",
-    parameters: []
+    inputSchema: z.object({})
   };
   handle = async (_args) => {
     const response = await fetch(`https://${API_HOSTNAME}/v1/tests`, {

package/dist/reflect/tool/tests/run-test.js

@@ -5,14 +5,9 @@ class RunTest extends Tool {
   specification = {
     title: "Run Test",
     summary: "Run a reflect test",
-    parameters: [
-      {
-        name: "testId",
-        type: z.string(),
-        description: "ID of the reflect test to run",
-        required: true
-      }
-    ]
+    inputSchema: z.object({
+      testId: z.string().describe("ID of the reflect test to run")
+    })
   };
   handle = async (args) => {
     const { testId } = args;

package/dist/swagger/client/api.js

@@ -37,7 +37,7 @@ class SwaggerAPI {
       return defaultReturn;
     }
     const contentType = response.headers.get("content-type");
-    if (contentType?.includes("application/json")) {
+    if (contentType?.includes("application/json") || contentType?.includes("application/problem+json")) {
       try {
         return await response.json();
       } catch (error) {
@@ -69,7 +69,16 @@ class SwaggerAPI {
    */
   async handleResponse(response, defaultReturn = {}) {
     if (!response.ok) {
-      throw new ToolError(`HTTP ${response.status}: ${response.statusText}`);
+      const errorBody = await this.parseResponse(
+        response,
+        {}
+      );
+      const detail = typeof errorBody === "object" && errorBody !== null && String(
+        errorBody.detail ?? errorBody.message ?? ""
+      ) || response.statusText;
+      throw new ToolError(
+        `HTTP ${response.status}${detail ? `: ${detail}` : ""}`
+      );
     }
     return this.parseResponse(
       response,

package/dist/swagger/client/portal-types.js

@@ -157,9 +157,6 @@ const CreateProductArgsSchema = PortalArgsSchema.extend({
   ),
   hidden: z.boolean().optional().describe(
     "Whether the product is hidden from the portal landing page navigation menus - useful for internal or draft products"
-  ),
-  role: z.boolean().optional().describe(
-    "Whether the product has role-based access restrictions - controls if specific user roles are required to access the product"
   )
 });
 const UpdateProductArgsSchema = ProductArgsSchema.extend({

package/dist/swagger/client/tools.js

@@ -5,7 +5,6 @@ const TOOLS = [
   {
     title: "List Portals",
     summary: "Search for available portals within Swagger. Only portals where you have at least a designer role, either at the product level or organization level, are returned.",
-    parameters: [],
     handler: "getPortals"
   },
   {

package/dist/swagger/client.js

@@ -18,7 +18,7 @@ class SwaggerClient {
   api;
   _apiKey;
   name = "Swagger";
-  toolPrefix = "swagger";
+  capabilityPrefix = "swagger";
   configPrefix = "Swagger";
   config = ConfigurationSchema;
   async configure(_server, config, _cache) {

package/dist/zephyr/client.js

@@ -45,7 +45,7 @@ class ZephyrClient {
   apiClient;
   _apiToken;
   name = "Zephyr";
-  toolPrefix = "zephyr";
+  capabilityPrefix = "zephyr";
   configPrefix = "Zephyr";
   config = ConfigurationSchema;
   async configure(_server, config, _cache) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartbear/mcp",
-  "version": "0.19.2",
+  "version": "0.21.1",
   "description": "MCP server for interacting SmartBear Products",
   "keywords": [
     "smartbear",
@@ -9,7 +9,8 @@
     "reflect",
     "swagger",
     "pactflow",
-    "zephyr"
+    "zephyr",
+    "qtm4j"
   ],
   "homepage": "https://developer.smartbear.com/smartbear-mcp",
   "mcpName": "com.smartbear/smartbear-mcp",
@@ -31,7 +32,8 @@
     "mcpServerName": "SmartBear MCP Server"
   },
   "scripts": {
-    "build": "vite build && shx chmod +x dist/*.js",
+    "build": "tsc && vite build && shx chmod +x dist/*.js",
+    "build:mcpb": "npm run build && node scripts/pack-mcpb.js",
     "lint": "biome lint .",
     "lint:fix": "biome lint . --fix",
     "format": "biome format . --write",
@@ -43,7 +45,7 @@
     "test:coverage": "vitest --coverage",
     "test:coverage:ci": "vitest --coverage --reporter=verbose",
     "test:run": "vitest run",
-    "coverage:check": "vitest --coverage --reporter=verbose --config vitest.config.coverage.ts",
+    "coverage:check": "vitest --coverage --reporter=verbose",
     "bump": "node scripts/bump.js"
   },
   "dependencies": {