@smartbear/mcp 0.25.1 → 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,5 @@
 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";
@@ -53,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,5 @@
 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";
@@ -123,7 +123,7 @@ class BugsnagClient {
         );
       },
       headers: {
-        "User-Agent": `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`,
+        "User-Agent": USER_AGENT,
         "Content-Type": "application/json",
         "X-Bugsnag-API": "true",
         "X-Version": "2"

package/dist/collaborator/client.js

@@ -1,4 +1,5 @@
 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"),
@@ -47,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/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/transport-stdio.js

@@ -1,7 +1,7 @@
 import { enableCompileCache } from "node:module";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { clientRegistry } from "./client-registry.js";
-import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "./info.js";
+import { USER_AGENT } from "./info.js";
 import { SmartBearMcpServer } from "./server.js";
 import { registerShutdownHandler } from "./shutdown.js";
 import { isOptionalType, getTypeDescription } from "./zod-utils.js";
@@ -21,7 +21,7 @@ function getNoConfigMessage() {
 }
 async function runStdioMode() {
   if (process.argv.includes("--version")) {
-    console.log(`${MCP_SERVER_NAME}: v${MCP_SERVER_VERSION}`);
+    console.log(`User-Agent: ${USER_AGENT}`);
     process.exit(0);
   } else if (process.argv.includes("--help")) {
     console.log(

package/dist/package.json.js

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

package/dist/pactflow/client.js

@@ -1,5 +1,5 @@
 import zod__default from "zod";
-import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "../common/info.js";
+import { USER_AGENT } from "../common/info.js";
 import { isSamplingPolyfillResult } from "../common/pollyfills.js";
 import { getRequestHeader } from "../common/request-context.js";
 import { ToolError } from "../common/tools.js";
@@ -178,7 +178,7 @@ class PactflowClient {
       return {
         Authorization: authHeader,
         "Content-Type": "application/json",
-        "User-Agent": `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`
+        "User-Agent": USER_AGENT
       };
     }
     if (this.token) {
@@ -189,14 +189,14 @@ class PactflowClient {
       return {
         Authorization: authHeader,
         "Content-Type": "application/json",
-        "User-Agent": `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`
+        "User-Agent": USER_AGENT
       };
     } else if (this.username && this.password) {
       const authString = `${this.username}:${this.password}`;
       return {
         Authorization: `Basic ${Buffer.from(authString).toString("base64")}`,
         "Content-Type": "application/json",
-        "User-Agent": `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`
+        "User-Agent": USER_AGENT
       };
     }
     return void 0;

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

@@ -1,4 +1,4 @@
-import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "../../../common/info.js";
+import { USER_AGENT } from "../../../common/info.js";
 import { QMETRY_DEFAULTS } from "../../config/constants.js";
 import { handleQMetryFetchError, handleQMetryApiError } from "./error-handler.js";
 async function qmetryRequest({
@@ -13,7 +13,7 @@ async function qmetryRequest({
   const headers = {
     apikey: token,
     project: project || QMETRY_DEFAULTS.PROJECT_KEY,
-    "User-Agent": `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`,
+    "User-Agent": USER_AGENT,
     "qmetry-source": "smartbear-mcp"
   };
   if (body) {

package/dist/qmetry/client/automation.js

@@ -1,4 +1,4 @@
-import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "../../common/info.js";
+import { USER_AGENT } from "../../common/info.js";
 import { QMETRY_DEFAULTS } from "../config/constants.js";
 import { QMETRY_PATHS } from "../config/rest-endpoints.js";
 import { DEFAULT_IMPORT_AUTOMATION_PAYLOAD } from "../types/automation.js";
@@ -91,7 +91,7 @@ async function importAutomationResults(token, baseUrl, project, payload) {
   const headers = {
     apikey: token,
     project: finalPayload.projectID || project || QMETRY_DEFAULTS.PROJECT_KEY,
-    "User-Agent": `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`,
+    "User-Agent": USER_AGENT,
     "qmetry-source": "smartbear-mcp"
     // Note: Content-Type will be set automatically by fetch for FormData
   };

package/dist/qtm4j/http/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";
 import { CONTENT_TYPES, HTTP_HEADERS } from "../config/constants.js";
 class AuthService {
   apiKey;
@@ -13,7 +13,7 @@ class AuthService {
     return {
       [HTTP_HEADERS.API_KEY]: this.apiKey,
       [HTTP_HEADERS.CONTENT_TYPE]: CONTENT_TYPES.JSON,
-      [HTTP_HEADERS.USER_AGENT]: `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`,
+      [HTTP_HEADERS.USER_AGENT]: USER_AGENT,
       [HTTP_HEADERS.ACCEPT]: CONTENT_TYPES.JSON
     };
   }

package/dist/reflect/client.js

@@ -1,5 +1,5 @@
 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, REFLECT_API_TOKEN_HEADER, AUTHORIZATION_HEADER } from "./config/constants.js";
@@ -14,6 +14,7 @@ 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";
@@ -72,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) {
@@ -120,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/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,7 +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";
@@ -9,29 +11,43 @@ 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().describe("Swagger API key for authentication"),
+  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)")
+  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 {
   api;
   _apiKey;
+  ftApi;
+  _ftApiToken;
   name = "Swagger";
   capabilityPrefix = "swagger";
   configPrefix = "Swagger";
   config = ConfigurationSchema;
   async configure(_server, config, _cache) {
-    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
-      }),
-      `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`
-    );
+    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() {
     const contextHeader = getRequestHeader("Swagger-Api-Key") || getRequestHeader("Authorization");
@@ -44,8 +60,16 @@ class SwaggerClient {
     }
     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;
+  }
   isConfigured() {
-    return this.api !== void 0;
+    return this.api !== void 0 || this.ftApi !== void 0;
   }
   getApi() {
     if (!this.api) throw new Error("Client not configured");
@@ -129,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/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.1",
+  "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",