@smartbear/mcp 0.23.0 → 0.25.0

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

@@ -0,0 +1,162 @@
+import { Tool } from "../../../common/tools.js";
+import { TOOL_NAMES, TOOLSETS, ENDPOINTS } from "../../config/constants.js";
+import { ResolverKeys, InputField } from "../../config/field-resolution.types.js";
+import { UpdateTestCycleResponse, UpdateTestCycleBody } from "../../schema/update-test-cycle.schema.js";
+const SIMPLE_FIELD_CONFIG = {
+  [InputField.PRIORITY]: ResolverKeys.CommonAttribute.PRIORITY,
+  [InputField.STATUS]: ResolverKeys.CommonAttribute.TEST_CYCLE_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 UpdateTestCycle extends Tool {
+  specification = {
+    title: TOOL_NAMES.UPDATE_TEST_CYCLE.TITLE,
+    toolset: TOOLSETS.TEST_CYCLES,
+    summary: TOOL_NAMES.UPDATE_TEST_CYCLE.SUMMARY,
+    readOnly: false,
+    idempotent: true,
+    inputSchema: UpdateTestCycleBody,
+    outputSchema: UpdateTestCycleResponse,
+    purpose: "Update an existing test cycle in QTM4J by its human-readable key (e.g. 'SCRUM-TR-101'). Only provided fields are changed — omitted fields stay unchanged. Status and priority are auto-resolved from human-readable names. Labels and components use add/delete objects.",
+    useCases: [
+      "Update summary, status, priority, planned dates, assignee, or reporter",
+      "Clear a nullable field by passing null (e.g. description: null removes text, assignee: null unassigns owner)",
+      "Add or remove labels and components atomically without affecting other entries",
+      "Apply multiple field updates in a single call"
+    ],
+    examples: [
+      {
+        description: "Rename a test cycle",
+        parameters: {
+          key: "SCRUM-TR-101",
+          summary: "Regression Cycle - Sprint 12 Updated"
+        },
+        expectedOutput: "Test cycle updated with new summary"
+      },
+      {
+        description: "Change status and update planned dates",
+        parameters: {
+          key: "SCRUM-TR-101",
+          status: "In Progress",
+          plannedStartDate: "01/May/2026 09:00",
+          plannedEndDate: "31/May/2026 18:00"
+        },
+        expectedOutput: "Test cycle status and planned dates updated"
+      },
+      {
+        description: "Add a label and remove an old one",
+        parameters: {
+          key: "SCRUM-TR-101",
+          labels: { add: ["Regression", "Smoke"], delete: ["Sprint1"] }
+        },
+        expectedOutput: "Test cycle updated — Regression and Smoke labels added, Sprint1 removed"
+      },
+      {
+        description: "Clear the description text",
+        parameters: {
+          key: "SCRUM-TR-101",
+          description: null
+        },
+        expectedOutput: "Test cycle description cleared"
+      },
+      {
+        description: "Unassign the owner and clear planned dates",
+        parameters: {
+          key: "SCRUM-TR-101",
+          assignee: null,
+          plannedStartDate: null,
+          plannedEndDate: null
+        },
+        expectedOutput: "Test cycle owner unassigned and planned dates cleared"
+      },
+      {
+        description: "Full update with all fields",
+        parameters: {
+          key: "SCRUM-TR-101",
+          summary: "Final Regression Cycle",
+          description: "Updated for sprint 12.",
+          status: "In Progress",
+          priority: "High",
+          plannedStartDate: "15/May/2026 09:00",
+          plannedEndDate: "30/May/2026 18:00",
+          assignee: "5b10a2844c20165700ede21f",
+          labels: { add: ["Regression"], delete: ["Sprint1"] },
+          components: { add: ["Backend"], delete: ["Frontend"] }
+        },
+        expectedOutput: "Test cycle updated with all specified fields"
+      }
+    ],
+    hints: [
+      "PREREQUISITE: set_project_context must be called before this tool. NEVER auto-select a project.",
+      "KEY FORMAT: '{PROJECT_KEY}-TR-{number}' — e.g. 'SCRUM-TR-101'.",
+      "Pass explicit null to CLEAR a nullable field — e.g. description: null removes the description text, assignee: null unassigns the owner, plannedStartDate: null removes the date. Omitting a field leaves it unchanged.",
+      "Status and priority are auto-resolved from human-readable names loaded by set_project_context. If a name cannot be resolved, the cycle is still updated and a warning is returned.",
+      "Labels and components use add/delete — names are auto-resolved to IDs. Both operations can be combined in a single call.",
+      "Date format: 'dd/MMM/yyyy HH:mm' e.g. '15/May/2026 09:00'. Month must be capitalised (May not may or MAY).",
+      "Archived test cycles cannot be updated — the server returns 400. Unarchive first if needed."
+    ],
+    outputDescription: "Confirmation object with the test cycle key and updated: true. Warnings are included if any field names could not be resolved."
+  };
+  handle = async (rawArgs) => {
+    const args = UpdateTestCycleBody.parse(rawArgs);
+    const fieldResolver = this.client.getResolverRegistry();
+    const context = fieldResolver.requireProjectContext();
+    const warnings = [];
+    const { key: _key, 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 [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_CYCLE(args.key), body);
+    return {
+      structuredContent: UpdateTestCycleResponse.parse({
+        key: args.key,
+        updated: true
+      }),
+      content: warnings.length > 0 ? [{ type: "text", text: `Note: ${warnings.join(" | ")}` }] : []
+    };
+  };
+}
+export {
+  UpdateTestCycle
+};

package/dist/reflect/client.js

@@ -1,8 +1,7 @@
 import { z } from "zod";
 import { MCP_SERVER_NAME, MCP_SERVER_VERSION } 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";
+import { API_KEY_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";
@@ -18,11 +17,12 @@ 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({
-  api_token: z.string().describe("Reflect API authentication token")
+const ConfigurationSchema = z.object({});
+const AuthenticationSchema = z.object({
+  api_token: z.string().describe("Reflect API authentication token").optional()
 });
 class ReflectClient {
-  _apiToken;
+  _server;
   activeConnections = /* @__PURE__ */ new Map();
   sessionStates = /* @__PURE__ */ new Map();
   mcpSessionConnections = /* @__PURE__ */ new Map();
@@ -30,33 +30,24 @@ class ReflectClient {
   capabilityPrefix = "reflect";
   configPrefix = "Reflect";
   config = ConfigurationSchema;
-  async configure(_server, config, _cache) {
-    this._apiToken = config.api_token;
+  authenticationFields = AuthenticationSchema;
+  async configure(server, _config) {
+    this._server = server;
   }
   getAuthToken() {
-    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;
+    return this._server?.getEnv("api_token", this) || this._server?.getEnv(API_KEY_HEADER) || this._server?.getEnv(AUTHORIZATION_HEADER) || null;
   }
   isConfigured() {
-    return true;
+    return !!this._server;
+  }
+  hasAuth() {
+    return this.isConfigured() && !!this.getAuthToken();
   }
   isOAuthRequest() {
-    if (getRequestHeader(REFLECT_API_TOKEN_HEADER) || getRequestHeader(API_KEY_HEADER)) {
-      return false;
-    }
-    const authHeader = getRequestHeader(AUTHORIZATION_HEADER);
-    if (!authHeader) {
+    if (this._server?.getEnv("api_token", this) || this._server?.getEnv(API_KEY_HEADER)) {
       return false;
     }
-    const headerValue = Array.isArray(authHeader) ? authHeader[0] : authHeader;
-    return headerValue.toLowerCase().startsWith("bearer ");
+    return !!this._server?.getEnv(AUTHORIZATION_HEADER);
   }
   getAuthHeader() {
     const token = this.getAuthToken();

package/dist/reflect/config/constants.js

@@ -1,5 +1,4 @@
 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";
@@ -8,7 +7,6 @@ export {
   API_HOSTNAME,
   API_KEY_HEADER,
   AUTHORIZATION_HEADER,
-  REFLECT_API_TOKEN_HEADER,
   WEBSOCKET_HOSTNAME,
   WEB_APP_HOSTNAME
 };

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

@@ -4,6 +4,7 @@ import { Tool, ToolError } from "../../../common/tools.js";
 class AddPromptStep extends Tool {
   specification = {
     title: "Add Prompt Step",
+    toolset: "Recording",
     summary: "Add a natural language prompt step to an active Reflect recording session",
     readOnly: false,
     idempotent: false,

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

@@ -4,6 +4,7 @@ import { Tool, ToolError } from "../../../common/tools.js";
 class AddSegment extends Tool {
   specification = {
     title: "Add Segment",
+    toolset: "Recording",
     summary: "Insert a reusable test segment into an active Reflect recording session",
     readOnly: false,
     idempotent: false,

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

@@ -5,6 +5,7 @@ import { WebSocketManager } from "../../websocket-manager.js";
 class ConnectToSession extends Tool {
   specification = {
     title: "Connect To Session",
+    toolset: "Recording",
     summary: `Connect to an active Reflect recording session via WebSocket to enable interactive control. When creating or editing a Reflect test using a connected recording session, follow these guidelines:
 
 1. After connecting to a session, get the list of segments for the session's platform type so you know what actions could be added via segments vs needing to create new steps. Do not list tests, only list segments.

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

@@ -4,6 +4,7 @@ import { Tool, ToolError } from "../../../common/tools.js";
 class DeletePreviousStep extends Tool {
   specification = {
     title: "Delete Previous Step",
+    toolset: "Recording",
     summary: "Delete the last step added to an active Reflect recording session",
     readOnly: false,
     idempotent: false,

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

@@ -4,6 +4,7 @@ import { Tool, ToolError } from "../../../common/tools.js";
 class GetScreenshot extends Tool {
   specification = {
     title: "Get Screenshot",
+    toolset: "Recording",
     summary: "Capture a screenshot from the current state of an active Reflect recording session",
     readOnly: true,
     idempotent: true,

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

@@ -4,6 +4,7 @@ import { API_HOSTNAME } from "../../config/constants.js";
 class CancelSuiteExecution extends Tool {
   specification = {
     title: "Cancel Suite Execution",
+    toolset: "Suites",
     summary: "Cancel a reflect suite execution",
     inputSchema: z.object({
       suiteId: z.string().describe("ID of the reflect suite to cancel execution for"),

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

@@ -4,6 +4,7 @@ import { API_HOSTNAME } from "../../config/constants.js";
 class ExecuteSuite extends Tool {
   specification = {
     title: "Execute Suite",
+    toolset: "Suites",
     summary: "Execute a reflect suite",
     inputSchema: z.object({
       suiteId: z.string().describe("ID of the reflect suite to execute")

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

@@ -4,6 +4,7 @@ import { API_HOSTNAME } from "../../config/constants.js";
 class GetSuiteExecutionStatus extends Tool {
   specification = {
     title: "Get Suite Execution Status",
+    toolset: "Suites",
     summary: "Get the status of a reflect suite execution",
     inputSchema: z.object({
       suiteId: z.string().describe("ID of the reflect suite to get execution status for"),

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

@@ -4,6 +4,7 @@ import { API_HOSTNAME } from "../../config/constants.js";
 class ListSuiteExecutions extends Tool {
   specification = {
     title: "List Suite Executions",
+    toolset: "Suites",
     summary: "List all executions for a given suite",
     inputSchema: z.object({
       suiteId: z.string().describe("ID of the reflect suite to list executions for")

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

@@ -4,6 +4,7 @@ import { API_HOSTNAME } from "../../config/constants.js";
 class ListSuites extends Tool {
   specification = {
     title: "List Suites",
+    toolset: "Suites",
     summary: "Retrieve a list of all reflect suites available",
     inputSchema: z.object({})
   };

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

@@ -4,6 +4,7 @@ import { API_HOSTNAME } from "../../config/constants.js";
 class GetTestStatus extends Tool {
   specification = {
     title: "Get Test Status",
+    toolset: "Tests",
     summary: "Get the status of a reflect test execution",
     inputSchema: z.object({
       executionId: z.string().describe("ID of the reflect test execution to get status for")

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

@@ -4,6 +4,7 @@ import { WEB_APP_HOSTNAME, API_HOSTNAME } from "../../config/constants.js";
 class ListSegments extends Tool {
   specification = {
     title: "List Segments",
+    toolset: "Tests",
     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,

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

@@ -4,6 +4,7 @@ import { API_HOSTNAME } from "../../config/constants.js";
 class ListTests extends Tool {
   specification = {
     title: "List Tests",
+    toolset: "Tests",
     summary: "List all reflect tests",
     inputSchema: z.object({})
   };

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

@@ -4,6 +4,7 @@ import { API_HOSTNAME } from "../../config/constants.js";
 class RunTest extends Tool {
   specification = {
     title: "Run Test",
+    toolset: "Tests",
     summary: "Run a reflect test",
     inputSchema: z.object({
       testId: z.string().describe("ID of the reflect test to run")

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

@@ -98,7 +98,7 @@ const CreatePortalArgsSchema = z.object({
     "Whether authentication credentials are enabled for accessing the portal. When true, users can authenticate to access private content. Defaults to true"
   ),
   swaggerHubOrganizationId: z.string().describe(
-    "The corresponding SwaggerHub organization UUID - required for portal creation. This links the portal to your SwaggerHub organization"
+    "The corresponding Swagger organization UUID - required for portal creation. This links the portal to your Swagger organization. Only one Portal per Swagger organization is allowed."
   ),
   openapiRenderer: z.string().optional().describe(
     "OpenAPI renderer type: 'SWAGGER_UI' (Swagger UI), 'ELEMENTS' (Stoplight Elements), or 'TOGGLE' (allows switching between both with Elements as default). Defaults to 'TOGGLE'"

package/dist/swagger/client/tools.js

@@ -4,47 +4,55 @@ import { OrganizationsQuerySchema } from "./user-management-types.js";
 const TOOLS = [
   {
     title: "List Portals",
+    toolset: "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.",
     handler: "getPortals"
   },
   {
     title: "Create Portal",
+    toolset: "Portals",
     summary: "Create a new portal within Swagger.",
     inputSchema: CreatePortalArgsSchema,
     handler: "createPortal"
   },
   {
     title: "Get Portal",
+    toolset: "Portals",
     summary: "Retrieve information about a specific portal.",
     inputSchema: PortalArgsSchema,
     handler: "getPortal"
   },
   {
     title: "Update Portal",
+    toolset: "Portals",
     summary: "Update a specific portal's configuration.",
     inputSchema: UpdatePortalArgsSchema,
     handler: "updatePortal"
   },
   {
     title: "List Portal Products",
+    toolset: "Products",
     summary: "Get products for a specific portal that match your criteria.",
     inputSchema: PortalArgsSchema,
     handler: "getPortalProducts"
   },
   {
     title: "Create Portal Product",
+    toolset: "Products",
     summary: "Create a new product for a specific portal.",
     inputSchema: CreateProductArgsSchema,
     handler: "createPortalProduct"
   },
   {
     title: "Get Portal Product",
+    toolset: "Products",
     summary: "Retrieve information about a specific product resource.",
     inputSchema: ProductArgsSchema,
     handler: "getPortalProduct"
   },
   {
     title: "Delete Portal Product",
+    toolset: "Products",
     summary: "Delete a product from a specific portal",
     inputSchema: ProductArgsSchema,
     handler: "deletePortalProduct",
@@ -52,36 +60,42 @@ const TOOLS = [
   },
   {
     title: "Update Portal Product",
+    toolset: "Products",
     summary: "Update a product's settings within a specific portal.",
     inputSchema: UpdateProductArgsSchema,
     handler: "updatePortalProduct"
   },
   {
     title: "Publish Portal Product",
+    toolset: "Products",
     summary: "Publish a product's content to make it live or as preview. This endpoint publishes the current content of a product, making it visible to portal visitors. Use preview mode to test before going live.",
     inputSchema: PublishProductArgsSchema,
     handler: "publishPortalProduct"
   },
   {
     title: "List Portal Product Sections",
+    toolset: "Sections",
     summary: "Get sections for a specific product within a portal.",
     inputSchema: GetProductSectionsArgsSchema,
     handler: "getPortalProductSections"
   },
   {
     title: "Create Table Of Contents",
+    toolset: "Table Of Contents",
     summary: "Create a new table of contents item in a portal product section. Supports API references, HTML content, and Markdown content types.",
     inputSchema: CreateTableOfContentsArgsSchema,
     handler: "createTableOfContents"
   },
   {
     title: "List Table Of Contents",
+    toolset: "Table Of Contents",
     summary: "Get table of contents for a section of a product within a portal.",
     inputSchema: GetTableOfContentsArgsSchema,
     handler: "getTableOfContents"
   },
   {
     title: "Delete Table Of Contents",
+    toolset: "Table Of Contents",
     summary: "Delete table of contents entry. Performs a soft-delete of an entry from the table of contents. Supports recursive deletion of nested items.",
     inputSchema: DeleteTableOfContentsArgsSchema,
     handler: "deleteTableOfContents"
@@ -89,12 +103,14 @@ const TOOLS = [
   // Document management tools
   {
     title: "Get Document",
+    toolset: "Documents",
     summary: "Get document content and metadata by document ID. Useful for retrieving HTML or Markdown content from table of contents items.",
     inputSchema: GetDocumentArgsSchema,
     handler: "getDocument"
   },
   {
     title: "Update Document",
+    toolset: "Documents",
     summary: "Update the content or source of an existing document. Supports both HTML and Markdown content types.",
     inputSchema: UpdateDocumentArgsSchema,
     handler: "updateDocument"
@@ -102,18 +118,21 @@ const TOOLS = [
   // Registry API tools for SwaggerHub Design functionality
   {
     title: "Search APIs and Domains",
+    toolset: "Registry API",
     summary: "Search for APIs and Domains in SwaggerHub Registry using the comprehensive /specs endpoint and retrieve metadata including owner, name, description, summary, version, and specification.",
     inputSchema: ApiSearchParamsSchema,
     handler: "searchApis"
   },
   {
     title: "Get API Definition",
+    toolset: "Registry API",
     summary: "Fetch resolved API definition from SwaggerHub Registry based on owner, API name, and version.",
     inputSchema: ApiDefinitionParamsSchema,
     handler: "getApiDefinition"
   },
   {
     title: "Create or Update API",
+    toolset: "Registry API",
     summary: "Create a new API or update an existing API in SwaggerHub Registry for Swagger Studio. The API specification type (OpenAPI, AsyncAPI) is automatically detected from the definition content. APIs are always created with fixed values: version 1.0.0, private visibility, and automock disabled (these values cannot be changed). Returns HTTP 201 for creation, HTTP 200 for update. Response includes 'operation' field indicating whether it was a 'create' or 'update' operation along with API details and SwaggerHub URL.",
     inputSchema: CreateApiParamsSchema,
     handler: "createOrUpdateApi"
@@ -121,24 +140,28 @@ const TOOLS = [
   // User Management API tools for organization management functionality
   {
     title: "List Organizations",
+    toolset: "Registry API",
     summary: "Get organizations for a user. Returns a list of organizations that the authenticating user is a member of. On-Premise admin gets a list of all organizations in the system.",
     inputSchema: OrganizationsQuerySchema,
     handler: "getOrganizations"
   },
   {
     title: "Scan API Standardization",
+    toolset: "Registry API",
     summary: "Run a standardization scan against an API definition using the organization's governance and standardization rules. Accepts a YAML or JSON OpenAPI/AsyncAPI definition and returns a list of standardization errors and validation issues. Use this tool when users ask to validate, scan, or check API governance or standardization.",
     inputSchema: ScanStandardizationParamsSchema,
     handler: "scanStandardization"
   },
   {
     title: "Create API from Prompt",
+    toolset: "Registry API",
     summary: "Generate and save an API definition based on a prompt using SmartBear AI. This tool automatically applies organization governance and standardization rules during API generation. The specType parameter determines the format of the generated definition. Use: 'openapi20' for OpenAPI 2.0, 'openapi30x' for OpenAPI 3.0.x, 'openapi31x' for OpenAPI 3.1.x, 'asyncapi2xx' for AsyncAPI 2.x, 'asyncapi30x' for AsyncAPI 3.0.x. Use this tool when creating APIs that comply with governance policies or when generating APIs from natural language descriptions. Use this tool when users ask to create, generate, or design APIs with governance or standardization requirements. Returns HTTP 201 for creation, HTTP 200 for update. Response includes 'operation' field indicating whether it was a 'create' or 'update' operation along with API details and SwaggerHub URL.",
     inputSchema: CreateApiFromPromptParamsSchema,
     handler: "createApiFromPrompt"
   },
   {
     title: "Standardize API",
+    toolset: "Registry API",
     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"

package/dist/swagger/client.js

@@ -1,6 +1,5 @@
 import { z } from "zod";
 import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "../common/info.js";
-import { getRequestHeader } from "../common/request-context.js";
 import "./config-utils.js";
 import { SwaggerAPI } from "./client/api.js";
 import { SwaggerConfiguration } from "./client/configuration.js";
@@ -9,47 +8,45 @@ 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"),
   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()
+});
 class SwaggerClient {
-  api;
-  _apiKey;
+  apiConfig;
+  server;
   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}`
-    );
+  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;
   }
   getAuthToken() {
-    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;
+    return this.server?.getEnv("api_key", this) || this.server?.getEnv("Authorization") || null;
   }
-  isConfigured() {
-    return this.api !== void 0;
+  hasAuth() {
+    return this.isConfigured() && !!this.getAuthToken();
   }
   getApi() {
-    if (!this.api) throw new Error("Client not configured");
-    return this.api;
+    if (!this.apiConfig) throw new Error("Client not configured");
+    return new SwaggerAPI(
+      this.apiConfig,
+      `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`
+    );
   }
   // Delegate API methods to the SwaggerAPI instance
   async getPortals() {