@smartbear/mcp 0.25.0 → 0.26.0

package/README.md

@@ -35,6 +35,7 @@ See individual guides for suggested prompts and supported tools and resources:
   - [Portal](https://developer.smartbear.com/smartbear-mcp/docs/swagger-portal-integration) - Portal and product management capabilities
   - [Studio](https://developer.smartbear.com/smartbear-mcp/docs/swagger-studio-integration) - API and Domain management capabilities, including AI-powered API generation from prompts and automatic standardization
   - [Contract Testing (PactFlow)](https://developer.smartbear.com/pactflow/default/getting-started) - Contract testing capabilities
+  - [Functional Testing](https://developer.smartbear.com/smartbear-mcp/docs/functional-testing-integration) - API test discovery capabilities
 - [QMetry](https://developer.smartbear.com/smartbear-mcp/docs/qmetry-integration) - QMetry Test Management capabilities
 - [Zephyr](https://developer.smartbear.com/smartbear-mcp/docs/zephyr-integration) - Zephyr Test Management capabilities
 - [Collaborator](https://developer.smartbear.com/smartbear-mcp/docs/collaborator-integration) - Review and Remote System Configuration management capabilities
@@ -52,7 +53,7 @@ For BugSnag, Swagger, and Zephyr, SmartBear hosts Remote MCP Servers that you ca
 
 See the [Remote MCP Servers guide](https://developer.smartbear.com/smartbear-mcp/docs/remote-mcp-servers) for per-client setup instructions. You can connect to multiple remote servers at the same time.
 
-> **Need BearQ, Reflect, QMetry, QTM4J, PactFlow, or Collaborator?** These products are only available via the local npm package below, which bundles all products into a single MCP server.
+> **Need BearQ, Reflect, QMetry, QTM4J, PactFlow, Collaborator, or Functional Testing?** These products are only available via the local npm package below, which bundles all products into a single MCP server.
 
 ## Prerequisites
 
@@ -108,7 +109,8 @@ Alternatively, you can use `npx` (or globally install) the `@smartbear/mcp` pack
         "COLLABORATOR_LOGIN_TICKET": "${input:collab_login_ticket}",
         "QTM4J_API_KEY": "${input:qtm4j_api_key}",
         "QTM4J_BASE_URL": "${input:qtm4j_base_url}",
-        "QTM4J_AUTOMATION_API_KEY": "${input:qtm4j_automation_api_key}"
+        "QTM4J_AUTOMATION_API_KEY": "${input:qtm4j_automation_api_key}",
+        "SWAGGER_FUNCTIONAL_TESTING_API_TOKEN": "${input:swagger_functional_testing_api_token}"
       }
     }
   },
@@ -250,6 +252,12 @@ Alternatively, you can use `npx` (or globally install) the `@smartbear/mcp` pack
           "type": "promptString",
           "description": "QTM4J Automation API Key - required for automation tools, leave blank to disable them",
           "password": true
+    },
+    {
+          "id": "swagger_functional_testing_api_token",
+          "type": "promptString",
+          "description": "Swagger Functional Testing API Token - leave blank to disable Functional Testing tools",
+          "password": true
     }
   ]
 }
@@ -291,7 +299,8 @@ Add the following configuration to your `claude_desktop_config.json` to launch t
         "COLLABORATOR_LOGIN_TICKET": "your collab login ticket",
         "QTM4J_API_KEY": "your_qtm4j_key",
         "QTM4J_BASE_URL": "https://qtmcloud.qmetry.com",
-        "QTM4J_AUTOMATION_API_KEY": "your_qtm4j_automation_api_key"
+        "QTM4J_AUTOMATION_API_KEY": "your_qtm4j_automation_api_key",
+        "SWAGGER_FUNCTIONAL_TESTING_API_TOKEN": "your_swagger_functional_testing_api_token"
       }
     }
   }

package/dist/bearq/client.js

@@ -1,5 +1,6 @@
 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 { DEFAULT_API_BASE_URL, AUTHORIZATION_HEADER } from "./config/constants.js";
 import { ChatWithQaLead } from "./tool/tasks/chat-with-qa-lead.js";
@@ -15,33 +16,33 @@ import { RunTestsInFunctionalAreas } from "./tool/tasks/run-tests-in-functional-
 import { StopTask } from "./tool/tasks/stop-task.js";
 import { WaitForTask } from "./tool/tasks/wait-for-task.js";
 const ConfigurationSchema = z.object({
+  api_token: z.string().describe("BearQ workspace API token (Bearer)."),
   api_base_url: z.string().optional().describe(
     "Override the BearQ public API base URL. Defaults to https://api.bearq.smartbear.com"
   )
 });
-const AuthenticationSchema = z.object({
-  api_token: z.string().describe("BearQ workspace API token (Bearer).")
-});
 class BearQClient {
-  server;
+  _apiToken;
   _baseUrl = DEFAULT_API_BASE_URL;
   name = "BearQ";
   capabilityPrefix = "bearq";
   configPrefix = "BearQ";
   config = ConfigurationSchema;
-  authenticationFields = AuthenticationSchema;
-  async configure(server, config) {
-    this.server = server;
+  async configure(_server, config) {
+    this._apiToken = config.api_token;
     if (config.api_base_url) this._baseUrl = config.api_base_url;
   }
   getAuthToken() {
-    return this.server?.getEnv("api_token", this) || this.server?.getEnv(AUTHORIZATION_HEADER) || null;
+    const contextHeader = 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 !== void 0;
-  }
-  hasAuth() {
-    return this.isConfigured() && !!this.getAuthToken();
+    return true;
   }
   getBaseUrl() {
     return this._baseUrl;
@@ -52,7 +53,7 @@ class BearQClient {
     return {
       Authorization: `Bearer ${token}`,
       "Content-Type": "application/json",
-      "User-Agent": `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`
+      "User-Agent": USER_AGENT
     };
   }
   async registerTools(register, _getInput) {

package/dist/bugsnag/client.js

@@ -1,5 +1,6 @@
 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 { CurrentUserAPI } from "./client/api/CurrentUser.js";
 import { Configuration } from "./client/api/configuration.js";
@@ -39,14 +40,11 @@ const EXCLUDED_EVENT_FIELDS = /* @__PURE__ */ new Set([
   // This is searches multiple fields and is more a convenience for humans, we're removing to avoid over-matching
 ]);
 const ConfigurationSchema = z.object({
+  auth_token: z.string().describe("BugSnag personal access token"),
   project_api_key: z.string().describe("BugSnag project API key").optional(),
-  endpoint: z.url().describe("BugSnag endpoint URL").optional()
-});
-const AuthenticationSchema = z.object({
-  auth_token: z.string().describe("BugSnag personal access token").optional()
+  endpoint: z.string().url().describe("BugSnag endpoint URL").optional()
 });
 class BugsnagClient {
-  server;
   cache;
   _projectApiKey;
   _isConfigured = false;
@@ -54,7 +52,7 @@ class BugsnagClient {
   _errorsApi;
   _projectApi;
   _appEndpoint;
-  apiConfig;
+  _authToken;
   get currentUserApi() {
     if (!this._currentUserApi) throw new Error("Client not configured");
     return this._currentUserApi;
@@ -76,9 +74,7 @@ class BugsnagClient {
   configPrefix = "Bugsnag";
   config = ConfigurationSchema;
   defaultToolsets = ["Projects"];
-  authenticationFields = AuthenticationSchema;
   async configure(server, config) {
-    this.server = server;
     this.cache = server.getCache();
     this._appEndpoint = this.getEndpoint(
       "app",
@@ -86,20 +82,48 @@ class BugsnagClient {
       config.endpoint
     );
     this._projectApiKey = config.project_api_key;
-    this.apiConfig = new Configuration({
-      apiKey: () => {
-        const authToken = this.server?.getEnv("auth_token", this);
+    this._authToken = config.auth_token;
+    await this.initializeApis(config);
+  }
+  getAuthToken() {
+    const contextHeader = getRequestHeader("Bugsnag-Auth-Token");
+    if (contextHeader) {
+      let token = Array.isArray(contextHeader) ? contextHeader[0] : contextHeader;
+      if (token.startsWith("token ")) {
+        token = token.substring(6);
+      }
+      return `token ${token}`;
+    }
+    const bearerToken = this.getBearerToken();
+    if (bearerToken) {
+      return bearerToken;
+    }
+    return this._authToken ? `token ${this._authToken}` : null;
+  }
+  getBearerToken() {
+    const contextHeader = getRequestHeader("Authorization");
+    if (contextHeader) {
+      let token = Array.isArray(contextHeader) ? contextHeader[0] : contextHeader;
+      if (token.startsWith("Bearer ")) {
+        token = token.substring(7);
+      }
+      return `Bearer ${token}`;
+    }
+    return null;
+  }
+  async initializeApis(config) {
+    const apiConfig = new Configuration({
+      apiKey: (_name) => {
+        const authToken = this.getAuthToken();
         if (authToken) {
-          return `token ${authToken}`;
+          return authToken;
         }
-        const bearerToken = this.server?.getEnv("Authorization");
-        if (bearerToken) {
-          return `Bearer ${bearerToken}`;
-        }
-        return void 0;
+        throw new Error(
+          "Authentication token not found in request headers or configuration"
+        );
       },
       headers: {
-        "User-Agent": `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`,
+        "User-Agent": USER_AGENT,
         "Content-Type": "application/json",
         "X-Bugsnag-API": "true",
         "X-Version": "2"
@@ -110,17 +134,14 @@ class BugsnagClient {
         config.endpoint
       )
     });
-    this._currentUserApi = new CurrentUserAPI(this.apiConfig);
-    this._errorsApi = new ErrorAPI(this.apiConfig);
-    this._projectApi = new ProjectAPI(this.apiConfig);
+    this._currentUserApi = new CurrentUserAPI(apiConfig);
+    this._errorsApi = new ErrorAPI(apiConfig);
+    this._projectApi = new ProjectAPI(apiConfig);
     this._isConfigured = true;
   }
   isConfigured() {
     return this._isConfigured;
   }
-  hasAuth() {
-    return this.isConfigured() && !!this.apiConfig?.apiKey();
-  }
   // If the endpoint is not provided, it will use the default API endpoint based on the project API key.
   // if the project api key is not provided, the endpoint will be the default API endpoint.
   // if the endpoint is provided, it will be used as is for custom domains, or normalized for known domains.

package/dist/collaborator/client.js

@@ -1,29 +1,27 @@
 import { z } from "zod";
+import { USER_AGENT } from "../common/info.js";
+import { getRequestHeader } from "../common/request-context.js";
 const ConfigurationSchema = z.object({
-  base_url: z.url().describe("Collaborator server base URL")
-});
-const AuthenticationSchema = z.object({
-  login: z.string().describe("Collaborator username for authentication").optional(),
-  ticket: z.string().describe("Collaborator login ticket for authentication").optional()
+  base_url: z.url().describe("Collaborator server base URL"),
+  username: z.string().describe("Collaborator username for authentication").optional(),
+  login_ticket: z.string().describe("Collaborator login ticket for authentication").optional()
 });
 class CollaboratorClient {
   name = "Collaborator";
   capabilityPrefix = "collaborator";
   configPrefix = "Collaborator";
   config = ConfigurationSchema;
-  authenticationFields = AuthenticationSchema;
   baseUrl;
-  server;
-  async configure(server, config) {
+  username;
+  loginTicket;
+  async configure(_server, config, _cache) {
     this.baseUrl = config.base_url;
-    this.server = server;
+    this.username = config.username;
+    this.loginTicket = config.login_ticket;
   }
   isConfigured() {
     return this.baseUrl !== void 0;
   }
-  hasAuth() {
-    return this.isConfigured() && this.server?.getEnv("Login", this) !== void 0 && this.server?.getEnv("Ticket", this) !== void 0;
-  }
   /**
    * Calls the Collaborator API with the given commands, prepending authentication automatically.
    * @param commands Array of Collaborator API commands (excluding authentication)
@@ -31,8 +29,16 @@ class CollaboratorClient {
    */
   async call(commands) {
     const url = `${this.baseUrl}/services/json/v1`;
-    const login = this.server?.getEnv("Login", this);
-    const ticket = this.server?.getEnv("Ticket", this);
+    let login = this.username;
+    let ticket = this.loginTicket;
+    const contextLogin = getRequestHeader("Collaborator-Login");
+    const contextTicket = getRequestHeader("Collaborator-Ticket");
+    if (contextLogin) {
+      login = Array.isArray(contextLogin) ? contextLogin[0] : contextLogin;
+    }
+    if (contextTicket) {
+      ticket = Array.isArray(contextTicket) ? contextTicket[0] : contextTicket;
+    }
     const body = [
       {
         command: "SessionService.authenticate",
@@ -42,7 +48,7 @@ class CollaboratorClient {
     ];
     const response = await fetch(url, {
       method: "POST",
-      headers: { "Content-Type": "application/json" },
+      headers: { "Content-Type": "application/json", "User-Agent": USER_AGENT },
       body: JSON.stringify(body)
     });
     if (!response.ok) {

package/dist/common/client-registry.js

@@ -1,4 +1,4 @@
-import { ZodURL, ZodError } from "zod";
+import { ZodURL } from "zod";
 import { fullyUnwrapZodType, isOptionalType } from "./zod-utils.js";
 class ClientRegistry {
   entries = [];
@@ -84,57 +84,31 @@ class ClientRegistry {
     return this.entries.filter((entry) => this.isClientEnabled(entry.name));
   }
   /**
-   * Registers all enabled clients on the given MCP server
+   * Configures all enabled clients on the given MCP server
    * @param server The MCP server on which the client is registered
    * @param getConfigValue A function that obtains a configuration value for the given client and requirement name
-   * @returns The number of clients successfully added
+   * @returns The number of clients successfully configured
    */
-  async registerAll(server, getConfigValue, configure, authorizationCheck) {
-    if (authorizationCheck && !configure) {
-      throw new Error(
-        "Cannot perform authorization check without configuring clients"
-      );
-    }
-    let addedCount = 0;
-    clientLoop: for (const client of this.getAll()) {
-      if (configure) {
-        const config = {};
-        for (const configKey of Object.keys(client.config.shape)) {
-          const value = getConfigValue(configKey, client);
-          if (value) {
-            this.validateAllowedEndpoint(client.config.shape[configKey], value);
-            config[configKey] = value;
-          } else if (!isOptionalType(client.config.shape[configKey])) {
-            continue clientLoop;
-          }
-        }
-        let parsedConfig;
-        try {
-          parsedConfig = client.config.parse(config);
-        } catch (error) {
-          if (error instanceof ZodError) {
-            console.warn(
-              `Configuration for client ${client.name} is invalid: ${error.issues.map((e) => `${e.path.join(".")}: ${e.message}`).join("; ")}`
-            );
-          } else {
-            console.warn(
-              `Unable to apply configuration for client ${client.name}: ${error}`
-            );
-          }
-          continue;
-        }
-        await client.configure(server, parsedConfig);
-        if (!client.isConfigured()) {
-          continue;
-        }
-        if (authorizationCheck && !client.hasAuth()) {
-          continue;
+  async configure(server, getConfigValue, ignoreMissingRequiredConfigs = false) {
+    let configuredCount = 0;
+    entryLoop: for (const entry of this.getAll()) {
+      const config = {};
+      for (const configKey of Object.keys(entry.config.shape)) {
+        const value = getConfigValue(entry, configKey);
+        if (value !== null) {
+          this.validateAllowedEndpoint(entry.config.shape[configKey], value);
+          config[configKey] = value;
+        } else if (!ignoreMissingRequiredConfigs && !isOptionalType(entry.config.shape[configKey])) {
+          continue entryLoop;
         }
       }
-      await server.addClient(client);
-      addedCount++;
+      await entry.configure(server, config);
+      if (entry.isConfigured()) {
+        await server.addClient(entry);
+        configuredCount++;
+      }
     }
-    return addedCount;
+    return configuredCount;
   }
   /**
    * Clear all registrations (useful for testing)

package/dist/common/info.js

@@ -1,7 +1,11 @@
 import packageJson from "../package.json.js";
 const MCP_SERVER_NAME = packageJson.config.mcpServerName;
 const MCP_SERVER_VERSION = packageJson.version;
+const MCP_TRANSPORT = process.env.MCP_TRANSPORT?.toLowerCase().trim() || "stdio";
+const USER_AGENT = `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION} ${MCP_TRANSPORT}`;
 export {
   MCP_SERVER_NAME,
-  MCP_SERVER_VERSION
+  MCP_SERVER_VERSION,
+  MCP_TRANSPORT,
+  USER_AGENT
 };

package/dist/common/request-context.js

@@ -0,0 +1,20 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+const requestContextStorage = new AsyncLocalStorage();
+function withRequestContext(req, fn) {
+  return requestContextStorage.run({ headers: req.headers }, fn);
+}
+function getRequestContext() {
+  return requestContextStorage.getStore();
+}
+function getRequestHeader(name) {
+  const context = getRequestContext();
+  if (!context?.headers) return void 0;
+  const headerValue = context.headers[name] || context.headers[name.toLowerCase()];
+  return headerValue;
+}
+export {
+  getRequestContext,
+  getRequestHeader,
+  requestContextStorage,
+  withRequestContext
+};

package/dist/common/server.js

@@ -12,8 +12,7 @@ class SmartBearMcpServer extends McpServer {
   elicitationSupported = false;
   clients = [];
   enabledToolsets;
-  getEnvFn;
-  constructor(getEnvFn, enabledToolsets) {
+  constructor(enabledToolsets) {
     super(
       {
         name: MCP_SERVER_NAME,
@@ -29,7 +28,6 @@ class SmartBearMcpServer extends McpServer {
         }
       }
     );
-    this.getEnvFn = getEnvFn;
     this.cache = new CacheService();
     if (enabledToolsets) {
       this.enabledToolsets = enabledToolsets.split(",").map((s) => s.trim().toLowerCase());
@@ -38,17 +36,6 @@ class SmartBearMcpServer extends McpServer {
   getCache() {
     return this.cache;
   }
-  /**
-   * Makes the server's getEnv function available to clients, validating that it is defined in the client's authentication fields if a client is provided
-   */
-  getEnv = (key, client) => {
-    if (client && !Object.keys(client.authenticationFields.shape).includes(key)) {
-      throw new Error(
-        `Environment variable "${key}" is not defined in the ${client.name} client's authentication schema.`
-      );
-    }
-    return this.getEnvFn(key, client);
-  };
   setSamplingSupported(supported) {
     this.samplingSupported = supported;
   }