@smartbear/mcp 0.7.0 → 0.8.0

package/dist/pactflow/client/tools.js

@@ -71,17 +71,17 @@ export const TOOLS = [
         clients: ["pactflow", "pact_broker"],
     },
     {
-        title: "PactFlow AI Status",
-        summary: "Check PactFlow AI usage status, remaining credits, and eligibility",
-        purpose: "Retrieve the AI feature status for the PactFlow account, including whether AI is enabled, the number of remaining and consumed AI credits, and entitlement or permission issues preventing usage.",
+        title: "Check PactFlow AI Entitlements",
+        summary: "Check your PactFlow AI entitlements and credit balance if you encounter 401 Unauthorized errors or permission/credit issues when using PactFlow AI features.",
+        purpose: "Retrieve AI entitlement information when PactFlow AI operations fail with 401 unauthorized errors. Use this to diagnose permission issues, check remaining credits, and verify account eligibility for AI features.",
         useCases: [
-            "Verify if AI functionality is enabled for the account before attempting to use AI-powered features",
-            "Monitor remaining and consumed AI credits to manage usage and avoid unexpected disruptions",
-            "Detect entitlement or permission issues when a user tries to access AI features and guide corrective actions",
-            "Integrate into deployment pipelines to ensure the environment is correctly configured with necessary entitlements and sufficient credits before executing AI-driven tasks",
-            "Fetches usage and entitlement reports for auditing, budgeting, and compliance purposes",
+            "Diagnose 401 unauthorized errors when attempting to use PactFlow AI features",
+            "Check remaining AI credits when PactFlow AI operations are rejected due to insufficient credits",
+            "Verify account entitlements when users receive permission denied errors for PactFlow AI functionality",
+            "Troubleshoot PactFlow AI access issues by retrieving current entitlement status and credit balance",
+            "Provide detailed error context when PactFlow AI features are unavailable due to account limitations",
         ],
-        handler: "getAIStatus",
+        handler: "checkAIEntitlements",
         clients: ["pactflow"],
     },
 ];

package/dist/pactflow/client.js

@@ -99,14 +99,15 @@ export class PactflowClient {
         return await this.pollForCompletion(status_response, "Review Pacts");
     }
     /**
-     * Retrieves AI status information for the current user
-     * and organization.
+     * Retrieve PactFlow AI entitlement information for the current user
+     * and organization when encountering 401 unauthorized errors.
+     * Use this to check AI entitlements and credits when AI operations fail.
      *
-     * @returns Entitlement containing AI status information, organization
+     * @returns Entitlement containing permissions, organization
      *   entitlements, and user entitlements.
      * @throws Error if the request fails or returns a non-OK response.
      */
-    async getAIStatus() {
+    async checkAIEntitlements() {
         const url = `${this.aiBaseUrl}/entitlement`;
         try {
             const response = await fetch(url, {
@@ -115,12 +116,12 @@ export class PactflowClient {
             });
             if (!response.ok) {
                 const errorText = await response.text().catch(() => "");
-                throw new Error(`PactFlow AI Status Request Failed - status: ${response.status} ${response.statusText}${errorText ? ` - ${errorText}` : ""}`);
+                throw new Error(`PactFlow AI Entitlements Request Failed - status: ${response.status} ${response.statusText}${errorText ? ` - ${errorText}` : ""}`);
             }
             return (await response.json());
         }
         catch (error) {
-            process.stderr.write(`[GetAICredits] Unexpected error: ${error}\n`);
+            process.stderr.write(`[CheckAIEntitlements] Unexpected error: ${error}\n`);
             throw error;
         }
     }

package/dist/zephyr/client.js

@@ -0,0 +1,16 @@
+import { ApiClient } from "./common/api-client.js";
+import { GetProjects } from "./tool/project/get-projects.js";
+export class ZephyrClient {
+    apiClient;
+    name = "Zephyr";
+    prefix = "zephyr";
+    constructor(bearerToken, baseUrl = "https://api.zephyrscale.smartbear.com/v2") {
+        this.apiClient = new ApiClient(bearerToken, baseUrl);
+    }
+    registerTools(register, _getInput) {
+        const tools = [new GetProjects(this.apiClient)];
+        tools.forEach((tool) => {
+            register(tool.specification, tool.handle);
+        });
+    }
+}

package/dist/zephyr/common/api-client.js

@@ -0,0 +1,27 @@
+import { AuthService } from "./auth-service.js";
+export class ApiClient {
+    baseUrl;
+    defaultHeaders;
+    constructor(bearerToken, baseUrl) {
+        this.baseUrl = baseUrl.trim().replace(/\/$/, "");
+        this.defaultHeaders = new AuthService(bearerToken).getAuthHeaders();
+    }
+    getUrl(endpoint, params) {
+        const url = new URL(this.baseUrl + endpoint);
+        if (params) {
+            Object.entries(params).forEach(([key, value]) => {
+                if (value !== undefined) {
+                    url.searchParams.append(key, String(value));
+                }
+            });
+        }
+        return url.toString();
+    }
+    async get(endpoint, params) {
+        const response = await fetch(this.getUrl(endpoint, params), {
+            method: "GET",
+            headers: this.defaultHeaders,
+        });
+        return response.json();
+    }
+}

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

@@ -0,0 +1,14 @@
+import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "../../common/info.js";
+export class AuthService {
+    bearerToken;
+    constructor(accessToken) {
+        this.bearerToken = accessToken.trim();
+    }
+    getAuthHeaders() {
+        return {
+            Authorization: `Bearer ${this.bearerToken}`,
+            "Content-Type": "application/json",
+            "User-Agent": `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`,
+        };
+    }
+}

package/dist/zephyr/common/types.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+export const MaxResultsSchema = z
+    .number()
+    .min(1)
+    .max(1000)
+    .describe(`
+    Specifies the maximum number of results to return in a single call. The default value is 10, and the maximum value that can be requested is 1000.
+
+    Note that the server may enforce a lower limit than requested, depending on resource availability or other internal constraints.
+    If this happens, the result set may be truncated. Always check the maxResults value in the response to confirm how many results were actually returned.
+  `);
+export const StartAtSchema = z
+    .number()
+    .min(0)
+    .max(1000000)
+    .describe(`
+    Zero-indexed starting position used to paginate through results. Defaults to 0.
+  `);
+export const ZephyrProjectSchema = z.object({
+    id: z.number(),
+    jiraProjectId: z.number(),
+    key: z.string(),
+    enabled: z.boolean(),
+});
+export function createListSchema(itemSchema) {
+    return z.object({
+        next: z.string().nullable(),
+        startAt: StartAtSchema,
+        maxResults: MaxResultsSchema,
+        total: z.number(),
+        isLast: z.boolean(),
+        values: z.array(itemSchema),
+    });
+}
+export const ZephyrProjectListSchema = createListSchema(ZephyrProjectSchema);

package/dist/zephyr/tool/project/get-projects.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { MaxResultsSchema, StartAtSchema } from "../../common/types.js";
+export const GetProjectsInputSchema = z.object({
+    startAt: StartAtSchema.optional(),
+    maxResults: MaxResultsSchema.optional(),
+});
+export class GetProjects {
+    apiClient;
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    specification = {
+        title: "Get Projects",
+        summary: "Get details of projects in Zephyr",
+        readOnly: true,
+        idempotent: true,
+        zodSchema: GetProjectsInputSchema,
+        examples: [
+            {
+                description: "Get the first 10 projects",
+                parameters: {
+                    maxResults: 10,
+                    startAt: 0,
+                },
+                expectedOutput: "The first 10 projects with their details",
+            },
+            {
+                description: "Get any project",
+                parameters: {
+                    maxResults: 1,
+                },
+                expectedOutput: "One project with its details",
+            },
+            {
+                description: "Get five projects starting from the 7th project of the list",
+                parameters: {
+                    maxResults: 5,
+                    startAt: 6,
+                },
+                expectedOutput: "The 7th to the 11th projects with their details",
+            },
+        ],
+    };
+    handle = async (args) => {
+        const { maxResults, startAt } = args;
+        const response = await this.apiClient.get("/projects", {
+            maxResults,
+            startAt,
+        });
+        return {
+            content: [{ type: "text", text: JSON.stringify(response) }],
+        };
+    };
+}

package/dist/zephyr/tool/zephyr-tool.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartbear/mcp",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "MCP server for interacting SmartBear Products",
   "keywords": [
     "smartbear",
@@ -8,7 +8,8 @@
     "bugsnag",
     "reflect",
     "api-hub",
-    "pactflow"
+    "pactflow",
+    "zephyr"
   ],
   "homepage": "https://developer.smartbear.com/smartbear-mcp",
   "mcpName": "com.smartbear/smartbear-mcp",