@smartbear/mcp 0.27.1 → 0.28.0

package/dist/common/initialize.js

@@ -0,0 +1,22 @@
+function handleInitializeMessage(server, message) {
+  if (typeof message !== "object" || message === null || !("method" in message) || message.method !== "initialize") {
+    return;
+  }
+  const params = message.params;
+  const clientInfo = params?.clientInfo;
+  if (clientInfo) {
+    server.setClientInfo(clientInfo);
+  }
+  if (params?.protocolVersion === "2025-11-25") {
+    const clientCapabilities = params.capabilities ?? {};
+    if (Object.hasOwn(clientCapabilities, "sampling")) {
+      server.setSamplingSupported(true);
+    }
+    if (Object.hasOwn(clientCapabilities, "elicitation")) {
+      server.setElicitationSupported(true);
+    }
+  }
+}
+export {
+  handleInitializeMessage
+};

package/dist/common/server.js

@@ -10,6 +10,7 @@ class SmartBearMcpServer extends McpServer {
   cache;
   samplingSupported = false;
   elicitationSupported = false;
+  clientInfo;
   clients = [];
   enabledToolsets;
   constructor(enabledToolsets) {
@@ -48,6 +49,12 @@ class SmartBearMcpServer extends McpServer {
   isElicitationSupported() {
     return this.elicitationSupported;
   }
+  setClientInfo(info) {
+    this.clientInfo = info;
+  }
+  getClientInfo() {
+    return this.clientInfo;
+  }
   getClients() {
     return this.clients;
   }

package/dist/common/transport-http.js

@@ -5,6 +5,7 @@ import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
 import { clientRegistry } from "./client-registry.js";
+import { handleInitializeMessage } from "./initialize.js";
 import { withRequestContext } from "./request-context.js";
 import { SmartBearMcpServer } from "./server.js";
 import { isDraining, registerShutdownHandler } from "./shutdown.js";
@@ -211,19 +212,7 @@ async function createNewTransport(req, res, transports) {
       transports.set(newSessionId, { server, transport });
     }
   });
-  transport.onmessage = (message) => {
-    if ("method" in message && message.method === "initialize") {
-      if (message.params?.protocolVersion === "2025-11-25") {
-        const clientCapabilities = message.params?.capabilities;
-        if (Object.hasOwn(clientCapabilities, "sampling")) {
-          server.setSamplingSupported(true);
-        }
-        if (Object.hasOwn(clientCapabilities, "elicitation")) {
-          server.setElicitationSupported(true);
-        }
-      }
-    }
-  };
+  transport.onmessage = (message) => handleInitializeMessage(server, message);
   transport.onclose = () => {
     if (transport.sessionId) {
       console.log(`[MCP] Session closed: ${transport.sessionId}`);

package/dist/common/transport-stdio.js

@@ -2,6 +2,7 @@ import { enableCompileCache } from "node:module";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { clientRegistry } from "./client-registry.js";
 import { USER_AGENT } from "./info.js";
+import { handleInitializeMessage } from "./initialize.js";
 import { SmartBearMcpServer } from "./server.js";
 import { registerShutdownHandler } from "./shutdown.js";
 import { isOptionalType, getTypeDescription } from "./zod-utils.js";
@@ -57,19 +58,7 @@ ${message.join("\n")}` : "No clients support environment variable configuration.
       console.error("[MCP][shutdown] Error closing stdio transport:", err);
     }
   });
-  transport.onmessage = (message) => {
-    if ("method" in message && message.method === "initialize") {
-      if (message.params?.protocolVersion === "2025-11-25") {
-        const clientCapabilities = message.params?.capabilities;
-        if (Object.hasOwn(clientCapabilities, "sampling")) {
-          server.setSamplingSupported(true);
-        }
-        if (Object.hasOwn(clientCapabilities, "elicitation")) {
-          server.setElicitationSupported(true);
-        }
-      }
-    }
-  };
+  transport.onmessage = (message) => handleInitializeMessage(server, message);
   await server.connect(transport);
 }
 function getEnvVarName(clientPrefix, key) {

package/dist/package.json.js

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

package/dist/pactflow/client.js

@@ -170,6 +170,10 @@ class PactflowClient {
     if (Array.isArray(contextToken)) {
       contextToken = contextToken[0];
     }
+    const clientInfo = this._server?.getClientInfo();
+    const sourceApplicationHeader = {
+      SOURCE_APPLICATION: clientInfo ? `${clientInfo.name}/${clientInfo.version}` : "unknown"
+    };
     if (contextToken) {
       let authHeader = contextToken;
       if (!contextToken.startsWith("Basic ") && !contextToken.startsWith("Bearer ")) {
@@ -178,7 +182,8 @@ class PactflowClient {
       return {
         Authorization: authHeader,
         "Content-Type": "application/json",
-        "User-Agent": USER_AGENT
+        "User-Agent": USER_AGENT,
+        ...sourceApplicationHeader
       };
     }
     if (this.token) {
@@ -189,14 +194,16 @@ class PactflowClient {
       return {
         Authorization: authHeader,
         "Content-Type": "application/json",
-        "User-Agent": USER_AGENT
+        "User-Agent": USER_AGENT,
+        ...sourceApplicationHeader
       };
     } 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": USER_AGENT
+        "User-Agent": USER_AGENT,
+        ...sourceApplicationHeader
       };
     }
     return void 0;

package/dist/swagger/client/api.js

@@ -677,7 +677,8 @@ class SwaggerAPI {
       contentType = "markdown",
       source = "internal",
       order = 0,
-      parentId = null
+      parentId = null,
+      pageSlug
     } = args;
     if (contentType === "html" && source === "internal" && pageContent !== void 0) {
       throw new ToolError(
@@ -694,12 +695,12 @@ class SwaggerAPI {
       );
     }
     const section = sections.items[0];
-    const pageSlug = normalizeSlug(pageTitle);
+    const resolvedPageSlug = pageSlug || normalizeSlug(pageTitle);
     const normalizedTitle = pageTitle.slice(0, 255);
     const tocItem = await this.createTableOfContents(section.id, {
       type: "new",
       title: normalizedTitle,
-      slug: pageSlug,
+      slug: resolvedPageSlug,
       order,
       parentId,
       content: {
@@ -724,7 +725,7 @@ class SwaggerAPI {
       sectionSlug: section.slug,
       pageDetails: {
         tableOfContentsId: tocItem.id,
-        slug: pageSlug,
+        slug: resolvedPageSlug,
         title: normalizedTitle,
         content: {
           type: contentType,

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

@@ -65,6 +65,31 @@ class FunctionalTestingAPI {
     }
     return response.json();
   }
+  async listSuites() {
+    const headers = this.getFtHeaders();
+    let response;
+    try {
+      response = await fetch(`${this.baseUrl}/suites`, {
+        method: "GET",
+        headers
+      });
+    } catch {
+      throw new ToolError(
+        "Swagger Functional Testing service is currently unreachable. Retry after a moment."
+      );
+    }
+    if (response.status === 401 || response.status === 403) {
+      throw new ToolError(
+        "Authentication failed. Verify your API token is valid and has not expired."
+      );
+    }
+    if (!response.ok) {
+      throw new ToolError(
+        `Failed to list Functional Testing suites: ${response.status} ${response.statusText}`
+      );
+    }
+    return response.json();
+  }
 }
 export {
   FUNCTIONAL_TESTING_API_KEY_HEADER,

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

@@ -22,6 +22,14 @@ const FUNCTIONAL_TESTING_TOOLS = [
     inputSchema: GetFunctionalTestingExecutionTestSchema,
     handler: "getFunctionalTestingExecution",
     idempotent: false
+  },
+  {
+    title: "List Suites",
+    toolset: "Functional Testing",
+    summary: "Lists all test suites available in your Swagger Functional Testing workspace. Use this tool when you need to discover available suites before running them or checking their execution history. Do not use this tool to retrieve individual tests or test suite execution results.",
+    handler: "listFunctionalTestingSuites",
+    idempotent: true,
+    readOnly: true
   }
 ];
 export {

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

@@ -216,7 +216,10 @@ const CreateDocumentationPageArgsSchema = z.object({
   portalId: z.string().describe("Portal UUID or subdomain - unique identifier for the portal"),
   productId: z.string().uuid().describe("Product UUID - unique identifier for the product"),
   pageTitle: z.string().describe(
-    "Title of the documentation page - will be displayed in navigation (3-255 characters, used to generate the page slug)"
+    "Title of the documentation page - will be displayed in navigation (3-255 characters)"
+  ),
+  pageSlug: z.string().optional().describe(
+    "URL slug for the documentation page. 3-255 characters, lowercase, alphanumeric with hyphens, underscores, or dots (e.g. 'my-page'). If not provided, the slug is generated from the page title."
   ),
   pageContent: z.string().optional().describe(
     "Content of the documentation page. Provide HTML when contentType is 'html', Markdown when contentType is 'markdown'."

package/dist/swagger/client.js

@@ -191,6 +191,9 @@ class SwaggerClient {
     }
     return fn(this.ftApi);
   }
+  async listFunctionalTestingSuites() {
+    return this.withFunctionalTesting((ftApi) => ftApi.listSuites());
+  }
   async registerTools(register, _getInput) {
     TOOLS.forEach((tool) => {
       if (tool.toolset === "Functional Testing" && !this.ftApi) {