@smartbear/mcp 0.25.0 → 0.26.0

package/dist/reflect/client.js

@@ -1,7 +1,8 @@
 import { z } from "zod";
-import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "../common/info.js";
+import { USER_AGENT } from "../common/info.js";
+import { getRequestHeader } from "../common/request-context.js";
 import { ToolError } from "../common/tools.js";
-import { API_KEY_HEADER, AUTHORIZATION_HEADER } from "./config/constants.js";
+import { API_KEY_HEADER, REFLECT_API_TOKEN_HEADER, AUTHORIZATION_HEADER } from "./config/constants.js";
 import { SapTest } from "./prompt/sap-test.js";
 import { AddPromptStep } from "./tool/recording/add-prompt-step.js";
 import { AddSegment } from "./tool/recording/add-segment.js";
@@ -13,16 +14,16 @@ import { ExecuteSuite } from "./tool/suites/execute-suite.js";
 import { GetSuiteExecutionStatus } from "./tool/suites/get-suite-execution-status.js";
 import { ListSuiteExecutions } from "./tool/suites/list-suite-executions.js";
 import { ListSuites } from "./tool/suites/list-suites.js";
+import { GetTestDetail } from "./tool/tests/get-test-detail.js";
 import { GetTestStatus } from "./tool/tests/get-test-status.js";
 import { ListSegments } from "./tool/tests/list-segments.js";
 import { ListTests } from "./tool/tests/list-tests.js";
 import { RunTest } from "./tool/tests/run-test.js";
-const ConfigurationSchema = z.object({});
-const AuthenticationSchema = z.object({
-  api_token: z.string().describe("Reflect API authentication token").optional()
+const ConfigurationSchema = z.object({
+  api_token: z.string().describe("Reflect API authentication token")
 });
 class ReflectClient {
-  _server;
+  _apiToken;
   activeConnections = /* @__PURE__ */ new Map();
   sessionStates = /* @__PURE__ */ new Map();
   mcpSessionConnections = /* @__PURE__ */ new Map();
@@ -30,24 +31,33 @@ class ReflectClient {
   capabilityPrefix = "reflect";
   configPrefix = "Reflect";
   config = ConfigurationSchema;
-  authenticationFields = AuthenticationSchema;
-  async configure(server, _config) {
-    this._server = server;
+  async configure(_server, config, _cache) {
+    this._apiToken = config.api_token;
   }
   getAuthToken() {
-    return this._server?.getEnv("api_token", this) || this._server?.getEnv(API_KEY_HEADER) || this._server?.getEnv(AUTHORIZATION_HEADER) || null;
+    const contextHeader = getRequestHeader(REFLECT_API_TOKEN_HEADER) || getRequestHeader(API_KEY_HEADER) || getRequestHeader(AUTHORIZATION_HEADER);
+    if (contextHeader) {
+      let token = Array.isArray(contextHeader) ? contextHeader[0] : contextHeader;
+      if (token.startsWith("Bearer ")) {
+        token = token.substring(7);
+      }
+      return token;
+    }
+    return this._apiToken || null;
   }
   isConfigured() {
-    return !!this._server;
-  }
-  hasAuth() {
-    return this.isConfigured() && !!this.getAuthToken();
+    return true;
   }
   isOAuthRequest() {
-    if (this._server?.getEnv("api_token", this) || this._server?.getEnv(API_KEY_HEADER)) {
+    if (getRequestHeader(REFLECT_API_TOKEN_HEADER) || getRequestHeader(API_KEY_HEADER)) {
+      return false;
+    }
+    const authHeader = getRequestHeader(AUTHORIZATION_HEADER);
+    if (!authHeader) {
       return false;
     }
-    return !!this._server?.getEnv(AUTHORIZATION_HEADER);
+    const headerValue = Array.isArray(authHeader) ? authHeader[0] : authHeader;
+    return headerValue.toLowerCase().startsWith("bearer ");
   }
   getAuthHeader() {
     const token = this.getAuthToken();
@@ -63,7 +73,7 @@ class ReflectClient {
     return {
       ...this.getAuthHeader(),
       "Content-Type": "application/json",
-      "User-Agent": `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`
+      "User-Agent": USER_AGENT
     };
   }
   getSessionState(sessionId) {
@@ -111,6 +121,7 @@ class ReflectClient {
       new ExecuteSuite(this),
       new CancelSuiteExecution(this),
       new ListTests(this),
+      new GetTestDetail(this),
       new RunTest(this),
       new GetTestStatus(this)
     ];

package/dist/reflect/config/constants.js

@@ -1,4 +1,5 @@
 const API_KEY_HEADER = "X-API-KEY";
+const REFLECT_API_TOKEN_HEADER = "Reflect-Api-Token";
 const AUTHORIZATION_HEADER = "Authorization";
 const API_HOSTNAME = "api.reflect.run";
 const WEBSOCKET_HOSTNAME = "recording.us-east-1.reflect.run";
@@ -7,6 +8,7 @@ export {
   API_HOSTNAME,
   API_KEY_HEADER,
   AUTHORIZATION_HEADER,
+  REFLECT_API_TOKEN_HEADER,
   WEBSOCKET_HOSTNAME,
   WEB_APP_HOSTNAME
 };

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

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { Tool, ToolError } from "../../../common/tools.js";
+import { API_HOSTNAME } from "../../config/constants.js";
+class GetTestDetail extends Tool {
+  specification = {
+    title: "Get Test Detail",
+    toolset: "Tests",
+    summary: "Get the full detail of a reflect test, including its name, description, and all recorded steps",
+    inputSchema: z.object({
+      testId: z.string().describe("ID of the reflect test to retrieve details for")
+    })
+  };
+  handle = async (args) => {
+    const { testId } = args;
+    if (!testId || !testId.trim())
+      throw new ToolError("testId argument is required");
+    const response = await fetch(
+      `https://${API_HOSTNAME}/v1/tests/${encodeURIComponent(testId)}`,
+      {
+        method: "GET",
+        headers: this.client.getHeaders()
+      }
+    );
+    if (!response.ok) {
+      throw new ToolError(
+        `Failed to get test detail: ${response.status} ${response.statusText}`
+      );
+    }
+    const data = await response.json();
+    return {
+      content: [{ type: "text", text: JSON.stringify(data) }]
+    };
+  };
+}
+export {
+  GetTestDetail
+};

package/dist/swagger/client/functional-testing-api.js

@@ -0,0 +1,36 @@
+import { ToolError } from "../../common/tools.js";
+const API_HOSTNAME = "api.reflect.run";
+const FUNCTIONAL_TESTING_API_KEY_HEADER = "X-API-KEY";
+class FunctionalTestingAPI {
+  constructor(getToken, userAgent) {
+    this.getToken = getToken;
+    this.userAgent = userAgent;
+  }
+  getFtHeaders() {
+    const token = this.getToken();
+    if (!token) {
+      throw new ToolError("Swagger Functional Testing API token not found");
+    }
+    return {
+      [FUNCTIONAL_TESTING_API_KEY_HEADER]: token,
+      "Content-Type": "application/json",
+      "User-Agent": this.userAgent
+    };
+  }
+  async listTests() {
+    const response = await fetch(`https://${API_HOSTNAME}/v1/tests`, {
+      method: "GET",
+      headers: this.getFtHeaders()
+    });
+    if (!response.ok) {
+      throw new ToolError(
+        `Failed to list Functional Testing tests: ${response.status} ${response.statusText}`
+      );
+    }
+    return response.json();
+  }
+}
+export {
+  FUNCTIONAL_TESTING_API_KEY_HEADER,
+  FunctionalTestingAPI
+};

package/dist/swagger/client/functional-testing-tools.js

@@ -0,0 +1,11 @@
+const FUNCTIONAL_TESTING_TOOLS = [
+  {
+    title: "List Tests",
+    toolset: "Functional Testing",
+    summary: "Lists all API tests available in your Swagger Functional Testing account. Use this tool when you need to discover available tests before running them or checking their status. Do not use this tool to retrieve test execution results or history.",
+    handler: "listFunctionalTestingTests"
+  }
+];
+export {
+  FUNCTIONAL_TESTING_TOOLS
+};

package/dist/swagger/client/tools.js

@@ -1,3 +1,4 @@
+import { FUNCTIONAL_TESTING_TOOLS } from "./functional-testing-tools.js";
 import { CreatePortalArgsSchema, PortalArgsSchema, UpdatePortalArgsSchema, CreateProductArgsSchema, ProductArgsSchema, UpdateProductArgsSchema, PublishProductArgsSchema, GetProductSectionsArgsSchema, CreateTableOfContentsArgsSchema, GetTableOfContentsArgsSchema, DeleteTableOfContentsArgsSchema, GetDocumentArgsSchema, UpdateDocumentArgsSchema } from "./portal-types.js";
 import { ApiSearchParamsSchema, ApiDefinitionParamsSchema, CreateApiParamsSchema, ScanStandardizationParamsSchema, CreateApiFromPromptParamsSchema, StandardizeApiParamsSchema } from "./registry-types.js";
 import { OrganizationsQuerySchema } from "./user-management-types.js";
@@ -165,7 +166,8 @@ const TOOLS = [
     summary: "Standardize and fix an API definition using AI to ensure compliance with governance policies. Scans the API definition for standardization errors and automatically fixes them using SmartBear AI. Optionally provide 'newVersion' (e.g. patch bump '1.0.0' → '1.0.1') to save the fixed definition as a new version — omitting it will overwrite the current version. Returns the number of errors found and the fixed definition if successful. Use this tool when users ask to standardize, fix, govern, or ensure governance compliance of APIs.",
     inputSchema: StandardizeApiParamsSchema,
     handler: "standardizeApi"
-  }
+  },
+  ...FUNCTIONAL_TESTING_TOOLS
 ];
 export {
   TOOLS

package/dist/swagger/client.js

@@ -1,6 +1,9 @@
 import { z } from "zod";
-import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "../common/info.js";
+import { USER_AGENT } from "../common/info.js";
+import { getRequestHeader } from "../common/request-context.js";
+import { ToolError } from "../common/tools.js";
 import "./config-utils.js";
+import { FunctionalTestingAPI, FUNCTIONAL_TESTING_API_KEY_HEADER } from "./client/functional-testing-api.js";
 import { SwaggerAPI } from "./client/api.js";
 import { SwaggerConfiguration } from "./client/configuration.js";
 import "./client/portal-types.js";
@@ -8,45 +11,69 @@ import "./client/registry-types.js";
 import { TOOLS } from "./client/tools.js";
 import "./client/user-management-types.js";
 const ConfigurationSchema = z.object({
+  api_key: z.string().optional().describe("Swagger API key for authentication"),
   portal_base_path: z.string().optional().describe("Base path for Portal API requests (optional)"),
   registry_base_path: z.string().optional().describe("Base path for Registry API requests (optional)"),
-  ui_base_path: z.string().optional().describe("Base URL for the SwaggerHub UI (optional)")
-});
-const AuthenticationSchema = z.object({
-  api_key: z.string().describe("Swagger API key for authentication").optional()
+  ui_base_path: z.string().optional().describe("Base URL for the SwaggerHub UI (optional)"),
+  functional_testing_api_token: z.string().optional().describe(
+    "Swagger Functional Testing API token. Leave empty to disable Functional Testing tools."
+  )
 });
 class SwaggerClient {
-  apiConfig;
-  server;
+  api;
+  _apiKey;
+  ftApi;
+  _ftApiToken;
   name = "Swagger";
   capabilityPrefix = "swagger";
   configPrefix = "Swagger";
   config = ConfigurationSchema;
-  authenticationFields = AuthenticationSchema;
-  async configure(server, config) {
-    this.server = server;
-    this.apiConfig = new SwaggerConfiguration({
-      token: () => this.getAuthToken(),
-      portalBasePath: config.portal_base_path,
-      registryBasePath: config.registry_base_path,
-      uiBasePath: config.ui_base_path
-    });
-  }
-  isConfigured() {
-    return this.apiConfig !== void 0;
+  async configure(_server, config, _cache) {
+    if (config.api_key) {
+      this._apiKey = config.api_key;
+      this.api = new SwaggerAPI(
+        new SwaggerConfiguration({
+          token: () => this.getAuthToken(),
+          portalBasePath: config.portal_base_path,
+          registryBasePath: config.registry_base_path,
+          uiBasePath: config.ui_base_path
+        }),
+        USER_AGENT
+      );
+    }
+    if (config.functional_testing_api_token) {
+      this._ftApiToken = config.functional_testing_api_token;
+      this.ftApi = new FunctionalTestingAPI(
+        () => this.getFtAuthToken(),
+        USER_AGENT
+      );
+    }
   }
   getAuthToken() {
-    return this.server?.getEnv("api_key", this) || this.server?.getEnv("Authorization") || null;
+    const contextHeader = getRequestHeader("Swagger-Api-Key") || getRequestHeader("Authorization");
+    if (contextHeader) {
+      let token = Array.isArray(contextHeader) ? contextHeader[0] : contextHeader;
+      if (token.startsWith("Bearer ")) {
+        token = token.substring(7);
+      }
+      return token;
+    }
+    return this._apiKey || null;
+  }
+  getFtAuthToken() {
+    if (!this.ftApi) return null;
+    const contextHeader = getRequestHeader(FUNCTIONAL_TESTING_API_KEY_HEADER);
+    if (contextHeader) {
+      return Array.isArray(contextHeader) ? contextHeader[0] : contextHeader;
+    }
+    return this._ftApiToken || null;
   }
-  hasAuth() {
-    return this.isConfigured() && !!this.getAuthToken();
+  isConfigured() {
+    return this.api !== void 0 || this.ftApi !== void 0;
   }
   getApi() {
-    if (!this.apiConfig) throw new Error("Client not configured");
-    return new SwaggerAPI(
-      this.apiConfig,
-      `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`
-    );
+    if (!this.api) throw new Error("Client not configured");
+    return this.api;
   }
   // Delegate API methods to the SwaggerAPI instance
   async getPortals() {
@@ -126,8 +153,20 @@ class SwaggerClient {
   async standardizeApi(args) {
     return this.getApi().standardizeApi(args);
   }
+  async listFunctionalTestingTests() {
+    if (!this.ftApi) {
+      throw new ToolError("Functional Testing API not configured");
+    }
+    return this.ftApi.listTests();
+  }
   async registerTools(register, _getInput) {
     TOOLS.forEach((tool) => {
+      if (tool.toolset === "Functional Testing" && !this.ftApi) {
+        return;
+      }
+      if (tool.toolset !== "Functional Testing" && !this.api && this.isConfigured()) {
+        return;
+      }
       const { handler, formatResponse, ...toolParams } = tool;
       register(toolParams, async (args, _extra) => {
         try {

package/dist/zephyr/client.js

@@ -1,4 +1,5 @@
 import zod__default from "zod";
+import { getRequestHeader } from "../common/request-context.js";
 import { ApiClient } from "./common/api-client.js";
 import { GetEnvironments } from "./tool/environment/get-environments.js";
 import { CreateFolder } from "./tool/folder/create-folder.js";
@@ -35,32 +36,38 @@ import { GetTestExecutions } from "./tool/test-execution/get-test-executions.js"
 import { GetTestExecutionSteps } from "./tool/test-execution/get-test-steps.js";
 import { UpdateTestExecution } from "./tool/test-execution/update-test-execution.js";
 import { UpdateTestExecutionSteps } from "./tool/test-execution/update-test-steps.js";
+const BASE_URL_DEFAULT = "https://api.zephyrscale.smartbear.com/v2";
 const ConfigurationSchema = zod__default.object({
-  base_url: zod__default.url().optional().describe("Zephyr Scale API base URL").default("https://api.zephyrscale.smartbear.com/v2")
-});
-const AuthenticationSchema = zod__default.object({
-  api_token: zod__default.string().describe("Zephyr Scale API token for authentication").optional()
+  api_token: zod__default.string().describe("Zephyr Scale API token for authentication"),
+  base_url: zod__default.string().url().optional().describe("Zephyr Scale API base URL").default(BASE_URL_DEFAULT)
 });
 class ZephyrClient {
   apiClient;
-  server;
+  _apiToken;
   name = "Zephyr";
   capabilityPrefix = "zephyr";
   configPrefix = "Zephyr";
   config = ConfigurationSchema;
-  authenticationFields = AuthenticationSchema;
-  async configure(server, config) {
-    this.server = server;
-    this.apiClient = new ApiClient(() => this.getAuthToken(), config.base_url);
+  async configure(_server, config, _cache) {
+    this._apiToken = config.api_token;
+    this.apiClient = new ApiClient(
+      () => this.getAuthToken(),
+      config.base_url || process.env.ZEPHYR_CUSTOM_BASE_URL || BASE_URL_DEFAULT
+    );
   }
   getAuthToken() {
-    return this.server?.getEnv("api_token", this) || this.server?.getEnv("Authorization") || null;
+    const contextHeader = getRequestHeader("Zephyr-Api-Token") || getRequestHeader("Authorization");
+    if (contextHeader) {
+      let token = Array.isArray(contextHeader) ? contextHeader[0] : contextHeader;
+      if (token.startsWith("Bearer ")) {
+        token = token.substring(7);
+      }
+      return token;
+    }
+    return this._apiToken || null;
   }
   isConfigured() {
-    return !!this.apiClient;
-  }
-  hasAuth() {
-    return this.isConfigured() && !!this.getAuthToken();
+    return this.apiClient !== void 0;
   }
   getApiClient() {
     if (!this.apiClient) throw new Error("Client not configured");

package/dist/zephyr/common/auth-service.js

@@ -1,4 +1,4 @@
-import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "../../common/info.js";
+import { USER_AGENT } from "../../common/info.js";
 class AuthService {
   bearerToken;
   constructor(accessToken) {
@@ -8,7 +8,7 @@ class AuthService {
     return {
       Authorization: `Bearer ${this.bearerToken}`,
       "Content-Type": "application/json",
-      "User-Agent": `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`,
+      "User-Agent": USER_AGENT,
       "zscale-source": "smartbear-mcp"
     };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartbear/mcp",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "MCP server for interacting SmartBear Products",
   "keywords": [
     "smartbear",
@@ -51,6 +51,7 @@
   "dependencies": {
     "@bugsnag/js": "^8.8.1",
     "@modelcontextprotocol/sdk": "^1.27.1",
+    "js-yaml": "^4.2.0",
     "node-cache": "^5.1.2",
     "swagger-client": "^3.37.1",
     "vite": "^7.3.1",