@smartbear/mcp 0.6.0 → 0.8.0

package/dist/common/info.js

@@ -1,3 +1,3 @@
-import packageJson from '../../package.json' with { type: "json" };
+import packageJson from "../../package.json" with { type: "json" };
 export const MCP_SERVER_NAME = packageJson.config.mcpServerName;
 export const MCP_SERVER_VERSION = packageJson.version;

package/dist/common/server.js

@@ -1,5 +1,5 @@
-import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { ZodAny, ZodArray, ZodBoolean, ZodEnum, ZodLiteral, ZodNumber, ZodObject, ZodString, ZodUnion, } from "zod";
+import { McpServer, ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ZodAny, ZodArray, ZodBoolean, ZodEnum, ZodLiteral, ZodNumber, ZodObject, ZodOptional, ZodString, ZodUnion, } from "zod";
 import Bugsnag from "../common/bugsnag.js";
 import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "./info.js";
 export class SmartBearMcpServer extends McpServer {
@@ -41,7 +41,9 @@ export class SmartBearMcpServer extends McpServer {
         });
         if (client.registerResources) {
             client.registerResources((name, path, cb) => {
-                return super.registerResource(name, new ResourceTemplate(`${client.prefix}://${name}/${path}`, { list: undefined }), {}, async (url, variables, extra) => {
+                return super.registerResource(name, new ResourceTemplate(`${client.prefix}://${name}/${path}`, {
+                    list: undefined,
+                }), {}, async (url, variables, extra) => {
                     try {
                         return await cb(url, variables, extra);
                     }
@@ -94,64 +96,73 @@ export class SmartBearMcpServer extends McpServer {
         return args;
     }
     getDescription(params) {
-        const { summary, useCases, examples, parameters, zodSchema, hints, outputFormat } = params;
+        const { summary, useCases, examples, parameters, zodSchema, hints, outputFormat, } = params;
         let description = summary;
         // Parameters if available otherwise use zodSchema
         if ((parameters ?? []).length > 0) {
-            description += `\n\n**Parameters:**\n${parameters?.map(p => `- ${p.name} (${this.getReadableTypeName(p.type)})${p.required ? ' *required*' : ''}` +
-                `${p.description ? `: ${p.description}` : ''}` +
-                `${p.examples ? ` (e.g. ${p.examples.join(', ')})` : ''}` +
-                `${p.constraints ? `\n  - ${p.constraints.join('\n  - ')}` : ''}`).join('\n')}`;
+            description += `\n\n**Parameters:**\n${parameters
+                ?.map((p) => `- ${p.name} (${this.getReadableTypeName(p.type)})${p.required ? " *required*" : ""}` +
+                `${p.description ? `: ${p.description}` : ""}` +
+                `${p.examples ? ` (e.g. ${p.examples.join(", ")})` : ""}` +
+                `${p.constraints ? `\n  - ${p.constraints.join("\n  - ")}` : ""}`)
+                .join("\n")}`;
         }
         if (zodSchema && zodSchema instanceof ZodObject) {
             description += "\n\n**Parameters:**\n";
             description += Object.keys(zodSchema.shape)
-                .map(key => this.formatParameterDescription(key, zodSchema.shape[key]))
-                .join('\n');
+                .map((key) => this.formatParameterDescription(key, zodSchema.shape[key]))
+                .join("\n");
         }
         if (outputFormat) {
             description += `\n\n**Output Format:** ${outputFormat}`;
         }
         // Use Cases
         if (useCases && useCases.length > 0) {
-            description += `\n\n**Use Cases:** ${useCases.map((uc, i) => `${i + 1}. ${uc}`).join(' ')}`;
+            description += `\n\n**Use Cases:** ${useCases.map((uc, i) => `${i + 1}. ${uc}`).join(" ")}`;
         }
         // Examples
         if (examples && examples.length > 0) {
-            description += `\n\n**Examples:**\n` + examples.map((ex, idx) => `${idx + 1}. ${ex.description}\n\`\`\`json\n${JSON.stringify(ex.parameters, null, 2)}\n\`\`\`${ex.expectedOutput ? `\nExpected Output: ${ex.expectedOutput}` : ''}`).join('\n\n');
+            description +=
+                `\n\n**Examples:**\n` +
+                    examples
+                        .map((ex, idx) => `${idx + 1}. ${ex.description}\n\`\`\`json\n${JSON.stringify(ex.parameters, null, 2)}\n\`\`\`${ex.expectedOutput ? `\nExpected Output: ${ex.expectedOutput}` : ""}`)
+                        .join("\n\n");
         }
         // Hints
         if (hints && hints.length > 0) {
-            description += `\n\n**Hints:** ${hints.map((hint, i) => `${i + 1}. ${hint}`).join(' ')}`;
+            description += `\n\n**Hints:** ${hints.map((hint, i) => `${i + 1}. ${hint}`).join(" ")}`;
         }
         return description.trim();
     }
     formatParameterDescription(key, field) {
-        return `- ${key} (${this.getReadableTypeName(field)})` +
-            `${field.isOptional() ? '' : ' *required*'}` +
-            `${field.description ? `: ${field.description}` : ''}` +
-            `${key === "examples" && field instanceof ZodEnum ? ` (e.g. ${Object.keys(field.enum).join(', ')})` : ''}` +
-            `${key === "constraints" && field instanceof ZodEnum ? `\n  - ${Object.keys(field.enum).join('\n  - ')}` : ''}`;
+        return (`- ${key} (${this.getReadableTypeName(field)})` +
+            `${field.isOptional() ? "" : " *required*"}` +
+            `${field.description ? `: ${field.description}` : ""}` +
+            `${key === "examples" && field instanceof ZodEnum ? ` (e.g. ${Object.keys(field.enum).join(", ")})` : ""}` +
+            `${key === "constraints" && field instanceof ZodEnum ? `\n  - ${Object.keys(field.enum).join("\n  - ")}` : ""}`);
     }
     getReadableTypeName(zodType) {
+        if (zodType instanceof ZodOptional) {
+            zodType = zodType._def.innerType;
+        }
         if (zodType instanceof ZodString)
-            return 'string';
+            return "string";
         if (zodType instanceof ZodNumber)
-            return 'number';
+            return "number";
         if (zodType instanceof ZodBoolean)
-            return 'boolean';
+            return "boolean";
         if (zodType instanceof ZodArray)
-            return 'array';
+            return "array";
         if (zodType instanceof ZodObject)
-            return 'object';
+            return "object";
         if (zodType instanceof ZodEnum)
-            return 'enum';
+            return "enum";
         if (zodType instanceof ZodLiteral)
-            return 'literal';
+            return "literal";
         if (zodType instanceof ZodUnion)
-            return 'union';
+            return "union";
         if (zodType instanceof ZodAny)
-            return 'any';
-        return 'any';
+            return "any";
+        return "any";
     }
 }

package/dist/index.js

@@ -1,11 +1,13 @@
 #!/usr/bin/env node
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import Bugsnag from "./common/bugsnag.js";
-import { BugsnagClient } from "./bugsnag/client.js";
-import { ReflectClient } from "./reflect/client.js";
 import { ApiHubClient } from "./api-hub/client.js";
+import { BugsnagClient } from "./bugsnag/client.js";
+import Bugsnag from "./common/bugsnag.js";
 import { SmartBearMcpServer } from "./common/server.js";
 import { PactflowClient } from "./pactflow/client.js";
+import { QmetryClient } from "./qmetry/client.js";
+import { ReflectClient } from "./reflect/client.js";
+import { ZephyrClient } from "./zephyr/client.js";
 // This is used to report errors in the MCP server itself
 // If you want to use your own BugSnag API key, set the MCP_SERVER_BUGSNAG_API_KEY environment variable
 const McpServerBugsnagAPIKey = process.env.MCP_SERVER_BUGSNAG_API_KEY;
@@ -21,6 +23,10 @@ async function main() {
     const pactBrokerUrl = process.env.PACT_BROKER_BASE_URL;
     const pactBrokerUsername = process.env.PACT_BROKER_USERNAME;
     const pactBrokerPassword = process.env.PACT_BROKER_PASSWORD;
+    const qmetryToken = process.env.QMETRY_API_KEY;
+    const qmetryBaseUrl = process.env.QMETRY_BASE_URL;
+    const zephyrToken = process.env.ZEPHYR_API_TOKEN;
+    const zephyrBaseUrl = process.env.ZEPHYR_BASE_URL;
     let client_defined = false;
     if (reflectToken) {
         server.addClient(new ReflectClient(reflectToken));
@@ -49,8 +55,16 @@ async function main() {
             console.error("If the Pact Broker base URL is specified, you must specify either (a) a PactFlow token, or (b) a Pact Broker username and password pair.");
         }
     }
+    if (qmetryToken) {
+        server.addClient(new QmetryClient(qmetryToken, qmetryBaseUrl));
+        client_defined = true;
+    }
+    if (zephyrToken) {
+        server.addClient(new ZephyrClient(zephyrToken, zephyrBaseUrl));
+        client_defined = true;
+    }
     if (!client_defined) {
-        console.error("Please set one of REFLECT_API_TOKEN, BUGSNAG_AUTH_TOKEN, API_HUB_API_KEY or PACT_BROKER_BASE_URL / (and relevant Pact auth) environment variables");
+        console.error("Please set one of REFLECT_API_TOKEN, BUGSNAG_AUTH_TOKEN, API_HUB_API_KEY, QMETRY_API_KEY, ZEPHYR_API_TOKEN, or PACT_BROKER_BASE_URL / (and relevant Pact auth) environment variables");
         process.exit(1);
     }
     const transport = new StdioServerTransport();

package/dist/pactflow/client/ai.js

@@ -146,18 +146,15 @@ export const GenerationInputSchema = z.object({
     testTemplate: FileInputSchema.optional().describe("Optional test template to use as a basis for generation. Helps ensure generated tests follow your specific patterns, frameworks, and coding standards"),
 });
 export const MatcherRecommendationInputSchema = z.array(EndpointMatcherSchema);
-export const AiCreditsSchema = z.object({
-    total: z
-        .number()
-        .describe("The total number of AI credits available."),
-    used: z
-        .number()
-        .describe("The number of AI credits used."),
-}).describe("AI credits information.");
-export const OrganizationEntitlementsSchema = z.object({
-    name: z
-        .string()
-        .describe("The name of the organization."),
+export const AiCreditsSchema = z
+    .object({
+    total: z.number().describe("The total number of AI credits available."),
+    used: z.number().describe("The number of AI credits used."),
+})
+    .describe("AI credits information.");
+export const OrganizationEntitlementsSchema = z
+    .object({
+    name: z.string().describe("The name of the organization."),
     planAiEnabled: z
         .boolean()
         .describe("Whether AI features are enabled at the plan level."),
@@ -165,13 +162,16 @@ export const OrganizationEntitlementsSchema = z.object({
         .boolean()
         .describe("Whether AI features are enabled at the preferences level."),
     aiCredits: AiCreditsSchema.describe("AI credits information."),
-}).describe("Organization entitlements information.");
-export const UserEntitlementsSchema = z.object({
-    aiPermissions: z
-        .array(z.string())
-        .describe("List of AI permissions."),
-}).describe("User entitlements information.");
-export const EntitlementsSchema = z.object({
+})
+    .describe("Organization entitlements information.");
+export const UserEntitlementsSchema = z
+    .object({
+    aiPermissions: z.array(z.string()).describe("List of AI permissions."),
+})
+    .describe("User entitlements information.");
+export const EntitlementsSchema = z
+    .object({
     organizationEntitlements: OrganizationEntitlementsSchema.describe("Organization entitlements information."),
     userEntitlements: UserEntitlementsSchema.describe("User entitlements information."),
-}).describe("Entitlements information.");
+})
+    .describe("Entitlements information.");

package/dist/pactflow/client/base.js

@@ -1,19 +1,54 @@
 import { z } from "zod";
 export const CanIDeploySchema = z.object({
-    pacticipant: z.string().describe("The name of the pacticipant (application/service) being evaluated for deployment"),
-    version: z.string().describe("The version of the pacticipant that you want to check if it's safe to deploy"),
-    environment: z.string().describe("The target environment where the pacticipant version will be deployed (e.g., 'production', 'staging', 'test')"),
+    pacticipant: z
+        .string()
+        .describe("The name of the pacticipant (application/service) being evaluated for deployment"),
+    version: z
+        .string()
+        .describe("The version of the pacticipant that you want to check if it's safe to deploy"),
+    environment: z
+        .string()
+        .describe("The target environment where the pacticipant version will be deployed (e.g., 'production', 'staging', 'test')"),
 });
 export const MatrixSchema = z.object({
-    latestby: z.string().optional().describe("This property removes the rows for the overridden pacts/verifications from the results. The options are cvp (show only the latest row for each consumer version and provider) and cvpv (show only the latest row each consumer version and provider version). For a can-i-deploy query with one selector, it should be set to cvp. For a can-i-deploy query with two selectors, it should be set to cvpv."),
-    limit: z.number().min(1).max(1000).default(100).optional().describe("The limit on the number of results to return (1-1000, default: 100)"),
-    q: z.array(z.object({
-        pacticipant: z.string().describe("Name of the pacticipant (application)"),
+    latestby: z
+        .string()
+        .optional()
+        .describe("This property removes the rows for the overridden pacts/verifications from the results. The options are cvp (show only the latest row for each consumer version and provider) and cvpv (show only the latest row each consumer version and provider version). For a can-i-deploy query with one selector, it should be set to cvp. For a can-i-deploy query with two selectors, it should be set to cvpv."),
+    limit: z
+        .number()
+        .min(1)
+        .max(1000)
+        .default(100)
+        .optional()
+        .describe("The limit on the number of results to return (1-1000, default: 100)"),
+    q: z
+        .array(z.object({
+        pacticipant: z
+            .string()
+            .describe("Name of the pacticipant (application)"),
         version: z.string().optional().describe("Version number"),
-        branch: z.string().optional().describe("Name of the pacticipant version branch"),
-        environment: z.string().optional().describe("The name of the environment that the pacticipant version is deployed to"),
-        latest: z.boolean().optional().describe("Used in conjunction with other properties to indicate whether the selector is describing the latest version from a branch/with a tag/for a pacticipant, or all of them. Note that when used with tags, the 'latest' is calculated using the creation date of the pacticipant version, NOT the creation date of the tag."),
-        tag: z.string().optional().describe("The name of the pacticipant version tag (superseded by branch and environments)"),
-        mainBranch: z.boolean().optional().describe("Whether or not the version(s) described are from the main branch of the pacticipant, as set in the mainBranch property of the pacticipant resource."),
-    })).min(1).max(2)
+        branch: z
+            .string()
+            .optional()
+            .describe("Name of the pacticipant version branch"),
+        environment: z
+            .string()
+            .optional()
+            .describe("The name of the environment that the pacticipant version is deployed to"),
+        latest: z
+            .boolean()
+            .optional()
+            .describe("Used in conjunction with other properties to indicate whether the selector is describing the latest version from a branch/with a tag/for a pacticipant, or all of them. Note that when used with tags, the 'latest' is calculated using the creation date of the pacticipant version, NOT the creation date of the tag."),
+        tag: z
+            .string()
+            .optional()
+            .describe("The name of the pacticipant version tag (superseded by branch and environments)"),
+        mainBranch: z
+            .boolean()
+            .optional()
+            .describe("Whether or not the version(s) described are from the main branch of the pacticipant, as set in the mainBranch property of the pacticipant resource."),
+    }))
+        .min(1)
+        .max(2),
 });

package/dist/pactflow/client/prompts.js

@@ -116,18 +116,16 @@ export const PROMPTS = [
                 openAPI: z.string(),
             },
         },
-        callback: function ({ openAPI }) {
-            return {
-                messages: [
-                    {
-                        role: "user",
-                        content: {
-                            type: "text",
-                            text: OADMatcherPrompt.replace("{0}", openAPI),
-                        },
+        callback: ({ openAPI }) => ({
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: OADMatcherPrompt.replace("{0}", openAPI),
                     },
-                ],
-            };
-        },
+                },
+            ],
+        }),
     },
 ];

package/dist/pactflow/client/tools.js

@@ -10,7 +10,7 @@
  * and registered with their corresponding handler.
  */
 import { z } from "zod";
-import { GenerationInputSchema, RefineInputSchema, } from "./ai.js";
+import { GenerationInputSchema, RefineInputSchema } from "./ai.js";
 import { CanIDeploySchema, MatrixSchema } from "./base.js";
 export const TOOLS = [
     {
@@ -40,11 +40,11 @@ export const TOOLS = [
                 name: "provider",
                 type: z.string(),
                 description: "name of the provider to retrieve states for",
-                required: true
-            }
+                required: true,
+            },
         ],
         handler: "getProviderStates",
-        clients: ["pactflow", "pact_broker"]
+        clients: ["pactflow", "pact_broker"],
     },
     {
         title: "Can I Deploy",
@@ -52,7 +52,7 @@ export const TOOLS = [
         purpose: "To serve as a deployment safety check within the PactBroker and PactFlow ecosystem, leveraging contract testing results to validate whether a specific service / pacticipant version is compatible with all integrated services. This feature prevents unsafe releases, reduces integration risks, and enables teams to confidently automate deployments across environments with a clear, auditable record of verification results.",
         zodSchema: CanIDeploySchema,
         handler: "canIDeploy",
-        clients: ["pactflow", "pact_broker"]
+        clients: ["pactflow", "pact_broker"],
     },
     {
         title: "Matrix",
@@ -64,24 +64,24 @@ export const TOOLS = [
             "Visualize the overall contract compatibility across two pacticipants / services.",
             "Perform advanced queries using selectors to understand compatibility within specific branches, environments, or version ranges.",
             "Support informed deployment decisions by answering 'can I deploy version X of this service to production?'",
-            "Expose contract verification details to non-frequent API users in a more accessible format."
+            "Expose contract verification details to non-frequent API users in a more accessible format.",
         ],
         zodSchema: MatrixSchema,
         handler: "getMatrix",
-        clients: ["pactflow", "pact_broker"]
+        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",
-        clients: ["pactflow"]
-    }
+        handler: "checkAIEntitlements",
+        clients: ["pactflow"],
+    },
 ];

package/dist/pactflow/client/utils.js

@@ -1,7 +1,7 @@
-import { RemoteOpenAPIDocumentSchema, } from "./ai.js";
 import yaml from "js-yaml";
 // @ts-expect-error missing type declarations
 import Swagger from "swagger-client";
+import { RemoteOpenAPIDocumentSchema, } from "./ai.js";
 /**
  * Resolve the OpenAPI specification from the provided input.
  *

package/dist/pactflow/client.js

@@ -1,7 +1,7 @@
 import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "../common/info.js";
-import { TOOLS } from "./client/tools.js";
-import { getOADMatcherRecommendations, getUserMatcherSelection } from "./client/prompt-utils.js";
+import { getOADMatcherRecommendations, getUserMatcherSelection, } from "./client/prompt-utils.js";
 import { PROMPTS } from "./client/prompts.js";
+import { TOOLS } from "./client/tools.js";
 // Tool definitions for PactFlow AI API client
 export class PactflowClient {
     name = "Contract Testing";
@@ -51,7 +51,9 @@ export class PactflowClient {
      * @throws Error if the HTTP request fails or the operation times out.
      */
     async generate(toolInput, getInput) {
-        if (toolInput.openapi?.document && (!toolInput.openapi?.matcher || Object.keys(toolInput.openapi.matcher).length === 0)) {
+        if (toolInput.openapi?.document &&
+            (!toolInput.openapi?.matcher ||
+                Object.keys(toolInput.openapi.matcher).length === 0)) {
             const matcherResponse = await getOADMatcherRecommendations(toolInput.openapi.document, this.server);
             const userSelection = await getUserMatcherSelection(matcherResponse, getInput);
             toolInput.openapi.matcher = userSelection;
@@ -77,7 +79,9 @@ export class PactflowClient {
      * @throws Error if the HTTP request fails or the operation times out.
      */
     async review(toolInput, getInput) {
-        if (toolInput.openapi?.document && (!toolInput.openapi?.matcher || Object.keys(toolInput.openapi.matcher).length === 0)) {
+        if (toolInput.openapi?.document &&
+            (!toolInput.openapi?.matcher ||
+                Object.keys(toolInput.openapi.matcher).length === 0)) {
             const matcherResponse = await getOADMatcherRecommendations(toolInput.openapi.document, this.server);
             const userSelection = await getUserMatcherSelection(matcherResponse, getInput);
             toolInput.openapi.matcher = userSelection;
@@ -95,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, {
@@ -111,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;
         }
     }
@@ -130,6 +135,9 @@ export class PactflowClient {
             isComplete: response.status === 200,
         };
     }
+    get requestHeaders() {
+        return this.headers;
+    }
     async getResult(resultUrl) {
         const response = await fetch(resultUrl, {
             method: "GET",
@@ -161,7 +169,7 @@ export class PactflowClient {
         throw new Error(`${operationName} timed out after ${timeout / 1000} seconds`);
     }
     // PactFlow / Pact_Broker client methods
-    async getProviderStates({ provider }) {
+    async getProviderStates({ provider, }) {
         const uri_encoded_provider_name = encodeURIComponent(provider);
         const response = await fetch(`${this.baseUrl}/pacts/provider/${uri_encoded_provider_name}/provider-states`, {
             method: "GET",
@@ -249,7 +257,7 @@ export class PactflowClient {
                 queryParts.push(`q[]mainBranch=${selector.mainBranch}`);
             }
         });
-        const url = `${this.baseUrl}/matrix?${queryParts.join('&')}`;
+        const url = `${this.baseUrl}/matrix?${queryParts.join("&")}`;
         try {
             const response = await fetch(url, {
                 method: "GET",
@@ -273,8 +281,8 @@ export class PactflowClient {
      * @param getInput - The function used to get input for tools.
      */
     registerTools(register, getInput) {
-        for (const tool of TOOLS.filter(t => t.clients.includes(this.clientType))) {
-            const { handler, clients: _, formatResponse, ...toolparams } = tool; // eslint-disable-line @typescript-eslint/no-unused-vars
+        for (const tool of TOOLS.filter((t) => t.clients.includes(this.clientType))) {
+            const { handler, clients: _, formatResponse, ...toolparams } = tool;
             register(toolparams, async (args, _extra) => {
                 const handler_fn = this[handler];
                 if (typeof handler_fn !== "function") {
@@ -304,7 +312,7 @@ export class PactflowClient {
      * @param register - The function used to register prompts.
      */
     registerPrompts(register) {
-        PROMPTS.forEach(prompt => {
+        PROMPTS.forEach((prompt) => {
             register(prompt.name, prompt.params, prompt.callback);
         });
     }

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

@@ -0,0 +1,39 @@
+import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "../../../common/info.js";
+import { QMETRY_DEFAULTS } from "../../config/constants.js";
+export async function qmetryRequest({ method = "GET", path, token, project, baseUrl, body, }) {
+    const url = `${baseUrl}${path}`;
+    const headers = {
+        apikey: token,
+        project: project || QMETRY_DEFAULTS.PROJECT_KEY,
+        "User-Agent": `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`,
+    };
+    if (body) {
+        headers["Content-Type"] = "application/json";
+    }
+    const init = {
+        method,
+        headers,
+    };
+    if (body && ["POST", "PUT", "PATCH"].includes(method)) {
+        init.body = JSON.stringify(body);
+    }
+    const res = await fetch(url, init);
+    if (!res.ok) {
+        let errorText;
+        try {
+            const contentType = res.headers.get("content-type");
+            if (contentType?.includes("application/json")) {
+                const json = await res.json();
+                errorText = JSON.stringify(json);
+            }
+            else {
+                errorText = await res.text();
+            }
+        }
+        catch {
+            errorText = res.statusText;
+        }
+        throw new Error(`QMetry API request failed (${res.status}): ${errorText}`);
+    }
+    return (await res.json());
+}

package/dist/qmetry/client/handlers.js

@@ -0,0 +1,11 @@
+import { QMetryToolsHandlers } from "../config/constants.js";
+import { getProjectInfo } from "./project.js";
+import { fetchTestCaseDetails, fetchTestCaseSteps, fetchTestCases, fetchTestCaseVersionDetails, } from "./testcase.js";
+export const QMETRY_HANDLER_MAP = {
+    [QMetryToolsHandlers.SET_PROJECT_INFO]: getProjectInfo,
+    [QMetryToolsHandlers.FETCH_PROJECT_INFO]: getProjectInfo,
+    [QMetryToolsHandlers.FETCH_TEST_CASES]: fetchTestCases,
+    [QMetryToolsHandlers.FETCH_TEST_CASE_DETAILS]: fetchTestCaseDetails,
+    [QMetryToolsHandlers.FETCH_TEST_CASE_VERSION_DETAILS]: fetchTestCaseVersionDetails,
+    [QMetryToolsHandlers.FETCH_TEST_CASE_STEPS]: fetchTestCaseSteps,
+};

package/dist/qmetry/client/project.js

@@ -0,0 +1,27 @@
+import { QMETRY_DEFAULTS } from "../config/constants.js";
+import { QMETRY_PATHS } from "../config/rest-endpoints.js";
+import { qmetryRequest } from "./api/client-api.js";
+/**
+ * Retrieves project information from QMetry
+ *
+ * This function serves dual purpose:
+ * 1. SET_PROJECT_INFO - Sets/switches the current project context
+ * 2. FETCH_PROJECT_INFO - Retrieves project details and configuration
+ *
+ * Both operations use the same API endpoint as QMetry handles project context
+ * switching and information retrieval through the same GET request.
+ *
+ * @param token - QMetry API authentication token
+ * @param baseUrl - QMetry instance base URL (defaults to configured URL)
+ * @param project - Project key to retrieve info for (defaults to configured project)
+ * @returns Promise resolving to project information including viewIds, folders, and configuration
+ */
+export async function getProjectInfo(token, baseUrl, project) {
+    return qmetryRequest({
+        method: "GET",
+        path: QMETRY_PATHS.PROJECT.GET_INFO,
+        token,
+        baseUrl: baseUrl || QMETRY_DEFAULTS.BASE_URL,
+        project: project || QMETRY_DEFAULTS.PROJECT_KEY,
+    });
+}