@smartbear/mcp 0.4.0 → 0.5.0

package/README.md

@@ -18,7 +18,7 @@
 </div>
 <br />
 
-A Model Context Protocol (MCP) server which provides AI assistants with seamless access to SmartBear's suite of testing and monitoring tools, including [Insight Hub](https://www.smartbear.com/insight-hub), [Reflect](https://reflect.run), [API Hub](https://www.smartbear.com/api-hub), [PactFlow](https://pactflow.io/) and [Pact Broker](https://docs.pact.io/)
+A Model Context Protocol (MCP) server which provides AI assistants with seamless access to SmartBear's suite of testing and monitoring tools, including [BugSnag](https://www.bugsnag.com/), [Reflect](https://reflect.run), [API Hub](https://www.smartbear.com/api-hub), [PactFlow](https://pactflow.io/) and [Pact Broker](https://docs.pact.io/)
 
 ## What is MCP?
 
@@ -28,7 +28,7 @@ The [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction)
 
 See individual guides for suggested prompts and supported tools and resources:
 
-- [Insight Hub](https://developer.smartbear.com/smartbear-mcp/docs/insight-hub-integration) - Comprehensive error monitoring and debugging capabilities
+- [BugSnag](https://developer.smartbear.com/smartbear-mcp/docs/bugsnag-integration) - Comprehensive error monitoring and debugging capabilities
 - [Test Hub](https://developer.smartbear.com/smartbear-mcp/docs/test-hub-integration) - Test management and execution capabilities
 - [API Hub](https://developer.smartbear.com/smartbear-mcp/docs/api-hub-integration) - Portal management capabilities
 - [PactFlow](https://developer.smartbear.com/pactflow/default/getting-started) - Contract testing capabilities
@@ -37,14 +37,14 @@ See individual guides for suggested prompts and supported tools and resources:
 ## Prerequisites
 
 - Node.js 20+ and npm
-- Access to SmartBear products (Insight Hub, Reflect, or API Hub)
+- Access to SmartBear products (BugSnag, Reflect, or API Hub)
 - Valid API tokens for the products you want to integrate
 
 ## Installation
 
 The MCP server is distributed as an npm package [`@smartbear/mcp`](https://www.npmjs.com/package/@smartbear/mcp), making it easy to integrate into your development workflow.
 
-The server is started with the API key or auth token that you use with your SmartBear product(s). They are optional and can be removed from your configuration if you aren't using the product. For Insight Hub, if you provide a project API key it will narrow down all searches to a single project in your Insight Hub dashboard. Leave this field blank if you wish to interact across multiple projects at a time.
+The server is started with the API key or auth token that you use with your SmartBear product(s). They are optional and can be removed from your configuration if you aren't using the product. For BugSnag, if you provide a project API key it will narrow down all searches to a single project in your BugSnag dashboard. Leave this field blank if you wish to interact across multiple projects at a time.
 
 ### VS Code with Copilot
 
@@ -66,8 +66,8 @@ Alternatively, you can use `npx` (or globally install) the `@smartbear/mcp` pack
         "@smartbear/mcp@latest"
       ],
       "env": {
-        "INSIGHT_HUB_AUTH_TOKEN": "${input:insight_hub_auth_token}",
-        "INSIGHT_HUB_PROJECT_API_KEY": "${input:insight_hub_project_api_key}",
+        "BUGSNAG_AUTH_TOKEN": "${input:bugsnag_auth_token}",
+        "BUGSNAG_PROJECT_API_KEY": "${input:bugsnag_project_api_key}",
         "REFLECT_API_TOKEN": "${input:reflect_api_token}",
         "API_HUB_API_KEY": "${input:api_hub_api_key}",
         "PACT_BROKER_BASE_URL": "${input:pact_broker_base_url}",
@@ -79,15 +79,15 @@ Alternatively, you can use `npx` (or globally install) the `@smartbear/mcp` pack
   },
   "inputs": [
       {
-         "id": "insight_hub_auth_token",
+         "id": "bugsnag_auth_token",
          "type": "promptString",
-         "description": "Insight Hub Auth Token - leave blank to disable Insight Hub tools",
+         "description": "BugSnag Auth Token - leave blank to disable BugSnag tools",
          "password": true
       },
       {
-         "id": "insight_hub_project_api_key",
+         "id": "bugsnag_project_api_key",
          "type": "promptString",
-         "description": "Insight Hub Project API Key - for single project interactions",
+         "description": "BugSnag Project API Key - for single project interactions",
          "password": false
       },
       {
@@ -145,8 +145,8 @@ Add the following configuration to your `claude_desktop_config.json` to launch t
         "@smartbear/mcp@latest"
       ],
       "env": {
-        "INSIGHT_HUB_AUTH_TOKEN": "your_personal_auth_token",
-        "INSIGHT_HUB_PROJECT_API_KEY": "your_project_api_key",
+        "BUGSNAG_AUTH_TOKEN": "your_personal_auth_token",
+        "BUGSNAG_PROJECT_API_KEY": "your_project_api_key",
         "REFLECT_API_TOKEN": "your_reflect_token",
         "API_HUB_API_KEY": "your_api_hub_key",
         "PACT_BROKER_BASE_URL": "your_pactflow_or_pactbroker_base_url",
@@ -202,8 +202,8 @@ For developers who want to contribute to the SmartBear MCP server, customize its
         },
         "args": ["<PATH_TO_SMARTBEAR_MCP_REPO>/dist/index.js"],
         "env": {
-            "INSIGHT_HUB_AUTH_TOKEN": "${input:insight_hub_auth_token}",
-            "INSIGHT_HUB_PROJECT_API_KEY": "${input:insight_hub_project_api_key}",
+            "BUGSNAG_AUTH_TOKEN": "${input:bugsnag_auth_token}",
+            "BUGSNAG_PROJECT_API_KEY": "${input:bugsnag_project_api_key}",
             "REFLECT_API_TOKEN": "${input:reflect_api_token}",
             "API_HUB_API_KEY": "${input:api_hub_api_key}",
             "PACT_BROKER_BASE_URL": "${input:pact_broker_base_url}",
@@ -215,15 +215,15 @@ For developers who want to contribute to the SmartBear MCP server, customize its
       },
       "inputs": [
         {
-          "id": "insight_hub_auth_token",
+          "id": "bugsnag_auth_token",
           "type": "promptString",
-          "description": "Insight Hub Auth Token - leave blank to disable Insight Hub tools",
+          "description": "BugSnag Auth Token - leave blank to disable BugSnag tools",
           "password": true
         },
         {
-          "id": "insight_hub_project_api_key",
+          "id": "bugsnag_project_api_key",
           "type": "promptString",
-          "description": "Insight Hub Project API Key - for single project interactions",
+          "description": "BugSnag Project API Key - for single project interactions",
           "password": false
         },
         {
@@ -270,7 +270,7 @@ For developers who want to contribute to the SmartBear MCP server, customize its
 5. **Local testing** using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector) web interface:
 
     ```bash
-    INSIGHT_HUB_AUTH_TOKEN="your_token" REFLECT_API_TOKEN="your_reflect_token" API_HUB_API_KEY="your_api_hub_key" PACT_BROKER_BASE_URL="your-pactflow-url" PACT_BROKER_TOKEN="your-pactflow-token" PACT_BROKER_USERNAME="your-pact-broker-username" PACT_BROKER_PASSWORD="your-pact-broker-password" npx @modelcontextprotocol/inspector npx @smartbear/mcp@latest
+    BUGSNAG_AUTH_TOKEN="your_token" REFLECT_API_TOKEN="your_reflect_token" API_HUB_API_KEY="your_api_hub_key" PACT_BROKER_BASE_URL="your-pactflow-url" PACT_BROKER_TOKEN="your-pactflow-token" PACT_BROKER_USERNAME="your-pact-broker-username" PACT_BROKER_PASSWORD="your-pact-broker-password" npx @modelcontextprotocol/inspector npx @smartbear/mcp@latest
     ```
 
 ## License
@@ -285,4 +285,4 @@ This MCP server is licensed under the MIT License. This means you are free to us
 
 ---
 
-**SmartBear MCP Server** - Bringing the power of SmartBear's testing and monitoring ecosystem to your AI-powered development workflow.
+**SmartBear MCP Server** - Bringing the power of SmartBear's testing and monitoring ecosystem to your AI-powered development workflow.

package/dist/{insight-hub → bugsnag}/client/api/CurrentUser.js

@@ -1,10 +1,11 @@
 import { BaseAPI, pickFieldsFromArray } from './base.js';
 // --- API Class ---
 export class CurrentUserAPI extends BaseAPI {
+    static filterFields = ["collaborators_url", "projects_url", "upgrade_url"];
     static organizationFields = ['id', 'name', 'slug'];
     static projectFields = ['id', 'name', 'slug', 'api_key'];
     constructor(configuration) {
-        super(configuration);
+        super(configuration, CurrentUserAPI.filterFields);
     }
     /**
      * List the current user's organizations

package/dist/{insight-hub → bugsnag}/client/api/Error.js

@@ -22,8 +22,9 @@ export const ReopenConditions = [
 ];
 // --- API Class ---
 export class ErrorAPI extends BaseAPI {
+    static filterFields = ["url", "project_url", "events_url"];
     constructor(configuration) {
-        super(configuration);
+        super(configuration, ErrorAPI.filterFields);
     }
     /**
      * View an Error on a Project
@@ -95,9 +96,41 @@ export class ErrorAPI extends BaseAPI {
      * GET /projects/{project_id}/errors
      */
     async listProjectErrors(projectId, options = {}) {
-        const url = options.filters
-            ? `/projects/${projectId}/errors?${toQueryString(options.filters)}`
-            : `/projects/${projectId}/errors`;
+        let url = `/projects/${projectId}/errors`;
+        // Next links need to be used as-is to ensure results are consistent, so only the page size can be modified
+        if (options.next !== undefined) {
+            const nextUrl = new URL(options.next);
+            if (options.per_page !== undefined) {
+                nextUrl.searchParams.set('per_page', options.per_page.toString());
+            }
+            url = nextUrl.toString();
+        }
+        else {
+            const params = new URLSearchParams();
+            // Add filter parameters
+            if (options.filters) {
+                const filterParams = new URLSearchParams(toQueryString(options.filters));
+                filterParams.forEach((value, key) => {
+                    params.append(key, value);
+                });
+            }
+            // Add pagination and sorting parameters
+            if (options.base !== undefined) {
+                params.append('base', options.base);
+            }
+            if (options.sort !== undefined) {
+                params.append('sort', options.sort);
+            }
+            if (options.direction !== undefined) {
+                params.append('direction', options.direction);
+            }
+            if (options.per_page !== undefined) {
+                params.append('per_page', options.per_page.toString());
+            }
+            if (params.size > 0) {
+                url = `/projects/${projectId}/errors?${params}`;
+            }
+        }
         return (await this.request({
             method: 'GET',
             url,

package/dist/{insight-hub → bugsnag}/client/api/Project.js

@@ -1,6 +1,7 @@
 import { BaseAPI, pickFieldsFromArray } from "./base.js";
 // --- API Class ---
 export class ProjectAPI extends BaseAPI {
+    static filterFields = ["errors_url", "events_url", "url", "html_url"];
     static eventFieldFields = [
         'custom',
         'display_id',
@@ -8,7 +9,7 @@ export class ProjectAPI extends BaseAPI {
         'pivot_options'
     ];
     constructor(configuration) {
-        super(configuration);
+        super(configuration, ProjectAPI.filterFields);
     }
     /**
      * List the Event Fields for a Project

package/dist/{insight-hub → bugsnag}/client/api/base.js

@@ -14,8 +14,10 @@ export function pickFieldsFromArray(arr, keys) {
 }
 export class BaseAPI {
     configuration;
-    constructor(configuration) {
+    filterFields;
+    constructor(configuration, filterFields) {
         this.configuration = configuration;
+        this.filterFields = filterFields || [];
     }
     async request(options, paginate = false) {
         const headers = {
@@ -61,6 +63,21 @@ export class BaseAPI {
         if (paginate) {
             apiResponse.body = results;
         }
+        if (Array.isArray(apiResponse.body)) {
+            apiResponse.body.forEach(this.sanitizeResponse.bind(this));
+        }
+        else {
+            this.sanitizeResponse(apiResponse.body ?? {});
+        }
         return apiResponse;
     }
+    sanitizeResponse(data) {
+        if (!data)
+            return;
+        for (const key of this.filterFields) {
+            if (key in data) {
+                delete data[key];
+            }
+        }
+    }
 }

package/dist/{insight-hub → bugsnag}/client/api/filters.js

@@ -1,8 +1,8 @@
 /**
- * Filters utility for Insight Hub API
+ * Filters utility for BugSnag API
  *
  * This file provides utility functions for creating filter URL parameters
- * based on the Insight Hub filtering specification described in the Filtering.md document.
+ * based on the BugSnag filtering specification described in the Filtering.md document.
  */
 import { z } from "zod";
 export const FilterValueSchema = z.object({

package/dist/{insight-hub → bugsnag}/client.js

@@ -6,12 +6,12 @@ import { ProjectAPI } from "./client/api/Project.js";
 import { FilterObjectSchema, toQueryString } from "./client/api/filters.js";
 const HUB_PREFIX = "00000";
 const DEFAULT_DOMAIN = "bugsnag.com";
-const HUB_DOMAIN = "insighthub.smartbear.com";
+const HUB_DOMAIN = "bugsnag.smartbear.com";
 const cacheKeys = {
-    ORG: "insight_hub_org",
-    PROJECTS: "insight_hub_projects",
-    CURRENT_PROJECT: "insight_hub_current_project",
-    CURRENT_PROJECT_EVENT_FILTERS: "insight_hub_current_project_event_filters",
+    ORG: "bugsnag_org",
+    PROJECTS: "bugsnag_projects",
+    CURRENT_PROJECT: "bugsnag_current_project",
+    CURRENT_PROJECT_EVENT_FILTERS: "bugsnag_current_project_event_filters",
 };
 // Exclude certain event fields from the project event filters to improve agent usage
 const EXCLUDED_EVENT_FIELDS = new Set([
@@ -25,7 +25,7 @@ const PERMITTED_UPDATE_OPERATIONS = [
     "discard",
     "undiscard"
 ];
-export class InsightHubClient {
+export class BugsnagClient {
     currentUserApi;
     errorsApi;
     cache;
@@ -33,8 +33,8 @@ export class InsightHubClient {
     projectApiKey;
     apiEndpoint;
     appEndpoint;
-    name = "Insight Hub";
-    prefix = "insight_hub";
+    name = "Bugsnag";
+    prefix = "bugsnag";
     constructor(token, projectApiKey, endpoint) {
         this.apiEndpoint = this.getEndpoint("api", projectApiKey, endpoint);
         this.appEndpoint = this.getEndpoint("app", projectApiKey, endpoint);
@@ -318,7 +318,7 @@ export class InsightHubClient {
                 }
             ],
             hints: [
-                "Error IDs can be found using the List Errors tool",
+                "Error IDs can be found using the List Project Errors tool",
                 "Use this after filtering errors to get detailed information about specific errors",
                 "If you used a filter to get this error, you can pass the same filters here to restrict the results or apply further filters",
                 "The URL provided in the response points should be shown to the user in all cases as it allows them to view the error in the dashboard and perform further analysis",
@@ -378,7 +378,7 @@ export class InsightHubClient {
                 {
                     name: "link",
                     type: z.string(),
-                    description: "Full URL to the event details page in the Insight Hub dashboard (web interface)",
+                    description: "Full URL to the event details page in the BugSnag dashboard (web interface)",
                     required: true,
                     examples: [
                         "https://app.bugsnag.com/my-org/my-project/errors/6863e2af8c857c0a5023b411?event_id=6863e2af012caf1d5c320000"
@@ -399,7 +399,7 @@ export class InsightHubClient {
             ],
             hints: [
                 "The URL must contain both project slug in the path and event_id in query parameters",
-                "This is useful when users share Insight Hub dashboard URLs and you need to extract the event data"
+                "This is useful when users share BugSnag dashboard URLs and you need to extract the event data"
             ]
         }, async (args, _extra) => {
             if (!args.link)
@@ -423,7 +423,7 @@ export class InsightHubClient {
         // Dynamically infer the filters schema from cached project event fields
         register({
             title: "List Project Errors",
-            summary: "List and search errors in a project using customizable filters",
+            summary: "List and search errors in a project using customizable filters and pagination",
             purpose: "Retrieve filtered list of errors from a project for analysis, debugging, and reporting",
             useCases: [
                 "Debug recent application errors by filtering for open errors in the last 7 days",
@@ -435,7 +435,7 @@ export class InsightHubClient {
                 {
                     name: "filters",
                     type: FilterObjectSchema,
-                    description: "Apply filters to narrow down the error list. Use the List Errors or Get Error tools to discover available filter fields",
+                    description: "Apply filters to narrow down the error list. Use the List Project Event Filters tool to discover available filter fields",
                     required: false,
                     examples: [
                         '{"error.status": [{"type": "eq", "value": "open"}]}',
@@ -449,6 +449,35 @@ export class InsightHubClient {
                         "Relative time periods: h (hours), d (days)"
                     ]
                 },
+                {
+                    name: "sort",
+                    type: z.enum(["first_seen", "last_seen", "events", "users", "unsorted"]),
+                    description: "Field to sort the errors by (default: last_seen)",
+                    required: false,
+                    examples: ["last_seen"]
+                },
+                {
+                    name: "direction",
+                    type: z.enum(["asc", "desc"]).default("desc"),
+                    description: "Sort direction for ordering results",
+                    required: false,
+                    examples: ["desc"]
+                },
+                {
+                    name: "per_page",
+                    type: z.number().min(1).max(100),
+                    description: "How many results to return per page.",
+                    required: false,
+                    examples: ["30", "50", "100"]
+                },
+                {
+                    name: "next",
+                    type: z.string().url(),
+                    description: "URL for retrieving the next page of results. Use the value in the previous response to get the next page when more results are available.",
+                    required: false,
+                    examples: ["https://api.bugsnag.com/projects/515fb9337c1074f6fd000003/errors?offset=30&per_page=30&sort=last_seen"],
+                    constraints: ["Only values provided in the output from this tool can be used. Do not attempt to construct it manually."]
+                },
                 ...(this.projectApiKey ? [] : [
                     {
                         name: "projectId",
@@ -467,7 +496,28 @@ export class InsightHubClient {
                             "event.since": [{ "type": "eq", "value": "24h" }]
                         }
                     },
-                    expectedOutput: "JSON object with a list of errors in the 'data' field, and an error count in the 'count' field"
+                    expectedOutput: "JSON object with a list of errors in the 'data' field, a count of the current page of results in the 'count' field, and a total count of all results in the 'total' field"
+                },
+                {
+                    description: "Get the 10 open errors with the most users affected in the last 30 days",
+                    parameters: {
+                        filters: {
+                            "event.since": [{ "type": "eq", "value": "30d" }],
+                            "error.status": [{ "type": "eq", "value": "open" }]
+                        },
+                        sort: "users",
+                        direction: "desc",
+                        per_page: 10
+                    },
+                    expectedOutput: "JSON object with a list of errors in the 'data' field, a count of the current page of results in the 'count' field, and a total count of all results in the 'total' field"
+                },
+                {
+                    description: "Get the next 50 results",
+                    parameters: {
+                        next: "https://api.bugsnag.com/projects/515fb9337c1074f6fd000003/errors?base=2025-08-29T13%3A11%3A37Z&direction=desc&filters%5Berror.status%5D%5B%5D%5Btype%5D=eq&filters%5Berror.status%5D%5B%5D%5Bvalue%5D=open&offset=10&per_page=10&sort=users",
+                        per_page: 50
+                    },
+                    expectedOutput: "JSON object with a list of errors in the 'data' field, a count of the current page of results in the 'count' field, and a total count of all results in the 'total' field"
                 }
             ],
             hints: [
@@ -475,13 +525,16 @@ export class InsightHubClient {
                 "Combine multiple filters to narrow results - filters are applied with AND logic",
                 "For time filters: use relative format (7d, 24h) for recent periods or ISO 8601 UTC format (2018-05-20T00:00:00Z) for specific dates",
                 "Common time filters: event.since (from this time), event.before (until this time)",
-                "There may not be any errors matching the filters - this is not a problem with the tool, in fact it might be a good thing that the user's application had no errors"
+                "There may not be any errors matching the filters - this is not a problem with the tool, in fact it might be a good thing that the user's application had no errors",
+                "This tool returns paged results. The 'count' field indicates the number of results returned in the current page, and the 'total' field indicates the total number of results across all pages.",
+                "If the output contains a 'next' value, there are more results available - call this tool again supplying the next URL as a parameter to retrieve the next page.",
+                "Do not modify the next URL as this can cause incorrect results. The only other parameter that can be used with 'next' is 'per_page' to control the page size."
             ]
         }, async (args, _extra) => {
             const project = await this.getInputProject(args.projectId);
-            // Optionally, validate filter keys against cached event fields
-            const eventFields = this.cache.get(cacheKeys.CURRENT_PROJECT_EVENT_FILTERS) || [];
+            // Validate filter keys against cached event fields
             if (args.filters) {
+                const eventFields = this.cache.get(cacheKeys.CURRENT_PROJECT_EVENT_FILTERS) || [];
                 const validKeys = new Set(eventFields.map(f => f.display_id));
                 for (const key of Object.keys(args.filters)) {
                     if (!validKeys.has(key)) {
@@ -489,11 +542,26 @@ export class InsightHubClient {
                     }
                 }
             }
-            const response = await this.errorsApi.listProjectErrors(project.id, { filters: args.filters });
+            const options = {};
+            if (args.filters)
+                options.filters = args.filters;
+            if (args.sort !== undefined)
+                options.sort = args.sort;
+            if (args.direction !== undefined)
+                options.direction = args.direction;
+            if (args.per_page !== undefined)
+                options.per_page = args.per_page;
+            if (args.next !== undefined)
+                options.next = args.next;
+            const response = await this.errorsApi.listProjectErrors(project.id, options);
             const errors = response.body || [];
+            const totalCount = response.headers.get('X-Total-Count');
+            const linkHeader = response.headers.get('Link');
             const result = {
                 data: errors,
                 count: errors.length,
+                total: totalCount ? parseInt(totalCount) : undefined,
+                next: linkHeader?.match(/<([^>]+)>/)?.[1],
             };
             return {
                 content: [{ type: "text", text: JSON.stringify(result) }],
@@ -572,7 +640,7 @@ export class InsightHubClient {
                 }
             ],
             hints: [
-                "Only use valid operations - Insight Hub may reject invalid values"
+                "Only use valid operations - BugSnag may reject invalid values"
             ],
             readOnly: false,
             idempotent: false,

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

@@ -96,10 +96,9 @@ export class SmartBearMcpServer extends McpServer {
         }
         if (zodSchema && zodSchema instanceof ZodObject) {
             description += "\n\n**Parameters:**\n";
-            for (const key of Object.keys(zodSchema.shape)) {
-                const field = zodSchema.shape[key];
-                description += this.formatParameterDescription(key, field);
-            }
+            description += Object.keys(zodSchema.shape)
+                .map(key => this.formatParameterDescription(key, zodSchema.shape[key]))
+                .join('\n');
         }
         if (outputFormat) {
             description += `\n\n**Output Format:** ${outputFormat}`;
@@ -119,7 +118,11 @@ export class SmartBearMcpServer extends McpServer {
         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  - ')}` : ''} \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 ZodString)

package/dist/index.js

@@ -1,21 +1,21 @@
 #!/usr/bin/env node
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import Bugsnag from "./common/bugsnag.js";
-import { InsightHubClient } from "./insight-hub/client.js";
+import { BugsnagClient } from "./bugsnag/client.js";
 import { ReflectClient } from "./reflect/client.js";
 import { ApiHubClient } from "./api-hub/client.js";
 import { SmartBearMcpServer } from "./common/server.js";
 import { PactflowClient } from "./pactflow/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_INSIGHT_HUB_API_KEY environment variable
-const McpServerBugsnagAPIKey = process.env.MCP_SERVER_INSIGHT_HUB_API_KEY;
+// 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;
 if (McpServerBugsnagAPIKey) {
     Bugsnag.start(McpServerBugsnagAPIKey);
 }
 async function main() {
     const server = new SmartBearMcpServer();
     const reflectToken = process.env.REFLECT_API_TOKEN;
-    const insightHubToken = process.env.INSIGHT_HUB_AUTH_TOKEN;
+    const bugsnagToken = process.env.BUGSNAG_AUTH_TOKEN;
     const apiHubToken = process.env.API_HUB_API_KEY;
     const pactBrokerToken = process.env.PACT_BROKER_TOKEN;
     const pactBrokerUrl = process.env.PACT_BROKER_BASE_URL;
@@ -26,10 +26,10 @@ async function main() {
         server.addClient(new ReflectClient(reflectToken));
         client_defined = true;
     }
-    if (insightHubToken) {
-        const insightHubClient = new InsightHubClient(insightHubToken, process.env.INSIGHT_HUB_PROJECT_API_KEY, process.env.INSIGHT_HUB_ENDPOINT);
-        await insightHubClient.initialize();
-        server.addClient(insightHubClient);
+    if (bugsnagToken) {
+        const bugsnagClient = new BugsnagClient(bugsnagToken, process.env.BUGSNAG_PROJECT_API_KEY, process.env.BUGSNAG_ENDPOINT);
+        await bugsnagClient.initialize();
+        server.addClient(bugsnagClient);
         client_defined = true;
     }
     if (apiHubToken) {
@@ -50,7 +50,7 @@ async function main() {
         }
     }
     if (!client_defined) {
-        console.error("Please set one of REFLECT_API_TOKEN, INSIGHT_HUB_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 or PACT_BROKER_BASE_URL / (and relevant Pact auth) environment variables");
         process.exit(1);
     }
     const transport = new StdioServerTransport();

package/dist/pactflow/client/ai.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { addOpenAPISpecToSchema } from "./utils.js";
 // Type definitions for PactFlow AI API
 export const GenerationLanguages = [
     "javascript",
@@ -53,12 +54,11 @@ export const OpenAPISchema = z
         .describe("OpenAPI components section (schemas, responses, etc.)"),
 })
     .passthrough()
-    .describe("The complete OpenAPI document describing the API")
+    .describe("The complete OpenAPI document describing the API.")
     .refine((data) => data.openapi || data.swagger, {
     message: "Either 'openapi' (for v3+) or 'swagger' (for v2) must be provided",
     path: ["openapi"],
-})
-    .optional();
+});
 export const EndpointMatcherSchema = z
     .object({
     path: z
@@ -80,12 +80,31 @@ export const EndpointMatcherSchema = z
 })
     .required()
     .describe("REQUIRED: Matcher to specify which endpoints from the OpenAPI document to generate tests for. At least one matcher field must be provided");
+export const RemoteOpenAPIDocumentSchema = z
+    .object({
+    authToken: z
+        .string()
+        .describe("Auth Bearer Token if the OpenAPI spec requires authentication.")
+        .optional(),
+    authScheme: z
+        .string()
+        .describe("Authentication scheme (e.g., 'Bearer', 'Basic'). Default scheme passed should be Bearer if authToken is specified and this field is not set.")
+        .default("Bearer")
+        .optional(),
+    url: z
+        .string()
+        .url("Must be a valid openapi url")
+        .describe("URL of the remote OpenAPI document.")
+        .optional(),
+})
+    .describe("Use this schema to fetch openapi documents present over a url.");
 export const OpenAPIWithMatcherSchema = z
     .object({
-    document: OpenAPISchema,
+    document: OpenAPISchema.describe("The OpenAPI document describing the API being tested. if document is not provided, don't add the field if remoteOpenAPIDocument is provided.").optional(),
     matcher: EndpointMatcherSchema,
+    remoteDocument: RemoteOpenAPIDocumentSchema.optional().describe("The remote OpenAPI document to use for the review/generation in case openapi document is not provided. If provided do not include the document field under openapi."),
 })
-    .describe("If provided, the OpenAPI document which describes the API being tested and is accompanied by a matcher which will be used to identify the interactions in the OpenAPI document which are relevant to the Pact refinement process.");
+    .describe("If provided, the OpenAPI document which describes the API being tested and is accompanied by a matcher which will be used to identify the interactions in the OpenAPI document which are relevant to the Pact refinement process.").transform(addOpenAPISpecToSchema);
 export const RefineInputSchema = z.object({
     pactTests: FileInputSchema.describe("Primary pact tests that needs to be refined."),
     code: z

package/dist/pactflow/client/base.js

@@ -1 +1,6 @@
-export {};
+import { z } from "zod";
+export const CanIDeploySchema = z.object({
+    pacticipant: z.string(),
+    version: z.string(),
+    environment: z.string(),
+});

package/dist/pactflow/client/tools.js

@@ -11,6 +11,7 @@
  */
 import { z } from "zod";
 import { GenerationInputSchema, RefineInputSchema } from "./ai.js";
+import { CanIDeploySchema } from "./base.js";
 export const TOOLS = [
     {
         title: "Generate Pact Tests",
@@ -42,5 +43,13 @@ export const TOOLS = [
         ],
         handler: "getProviderStates",
         clients: ["pactflow", "pact_broker"]
+    },
+    {
+        title: "Can I Deploy",
+        summary: "Performs a comprehensive compatibility check to determine whether a specific version of a service (pacticipant) can be safely deployed into a given environment. It analyzes the complete contract matrix of consumer-provider relationships to confirm that all required integrations are verified and compatible.",
+        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"]
     }
 ];