@smartbear/mcp 0.4.0 → 0.6.0

package/README.md

@@ -9,7 +9,7 @@
 
   <!-- Badges -->
   <div>
-    <a href="https://github.com/SmartBear/smartbear-mcp/actions/workflows/test.yml"><img src="https://github.com/SmartBear/smartbear-mcp/workflows/Test%20Suite/badge.svg" alt="Test Status"></a>
+    <a href="https://github.com/SmartBear/smartbear-mcp/actions/workflows/node-ci.yml"><img src="https://github.com/SmartBear/smartbear-mcp/actions/workflows/node-ci.yml/badge.svg?branch=next" alt="Test Status"></a>
     <a href="https://smartbear.github.io/smartbear-mcp/"><img src="https://img.shields.io/badge/coverage-dynamic-brightgreen" alt="Coverage"></a>
     <a href="https://www.npmjs.com/package/@smartbear/mcp"><img src="https://img.shields.io/npm/v/@smartbear/mcp" alt="npm version"></a>
     <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-Compatible-blue" alt="MCP Compatible"></a>
@@ -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",
@@ -165,113 +165,7 @@ For detailed introduction, examples, and advanced configuration visit our 📖 [
 
 ## Local Development
 
-For developers who want to contribute to the SmartBear MCP server, customize its functionality, or work with the latest development features, you can build and run the server directly from source code. This approach gives you full control over the implementation and allows you to make modifications as needed.
-
-1. **Clone the repository:**
-   ```bash
-   git clone https://github.com/SmartBear/smartbear-mcp.git
-   cd smartbear-mcp
-   ```
-
-2. **Install dependencies:**
-   ```bash
-   npm install
-   ```
-
-3. **Build the server:**
-   ```bash
-   npm run build
-   ```
-
-4. **Add the server to your IDE** configuration updating `.vscode/mcp.json` (or equivalent) to point to your local build
-
-    <details>
-    <summary><strong>📋 VSCode (mcp.json)</strong></summary>
-
-    ```json
-    {
-      "servers": {
-        "smartbear": {
-        "type": "stdio",
-        "command": "node",
-        "dev": {                            // <-- To allow debugging in VS Code
-          "watch": "dist/**/*.js",
-          "debug": {
-              "type": "node"
-          },
-        },
-        "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}",
-            "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}",
-            "PACT_BROKER_TOKEN": "${input:pact_broker_token}",
-            "PACT_BROKER_USERNAME": "${input:pact_broker_username}",
-            "PACT_BROKER_PASSWORD": "${input:pact_broker_password}"
-          }
-        }
-      },
-      "inputs": [
-        {
-          "id": "insight_hub_auth_token",
-          "type": "promptString",
-          "description": "Insight Hub Auth Token - leave blank to disable Insight Hub tools",
-          "password": true
-        },
-        {
-          "id": "insight_hub_project_api_key",
-          "type": "promptString",
-          "description": "Insight Hub Project API Key - for single project interactions",
-          "password": false
-        },
-        {
-          "id": "reflect_api_token",
-          "type": "promptString",
-          "description": "Reflect API Token - leave blank to disable Reflect tools",
-          "password": true
-        },
-        {
-          "id": "api_hub_api_key",
-          "type": "promptString",
-          "description": "API Hub API Key - leave blank to disable API Hub tools",
-          "password": true
-        },
-        {
-          "id": "pact_broker_base_url",
-          "type": "promptString",
-          "description": "PactFlow or Pact Broker base url - leave blank to disable PactFlow tools",
-          "password": true
-        },
-        {
-          "id": "pact_broker_token",
-          "type": "promptString",
-          "description": "PactFlow Authentication Token",
-          "password": true
-        },
-        {
-          "id": "pact_broker_username",
-          "type": "promptString",
-          "description": "Pact Broker Username",
-          "password": true
-        },
-        {
-          "id": "pact_broker_password",
-          "type": "promptString",
-          "description": "Pact Broker Password",
-          "password": true
-        },
-      ]
-    }
-    ```
-    </details>
-
-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
-    ```
+For developers who want to contribute to the SmartBear MCP server, please see the [CONTRIBUTING.md](CONTRIBUTING.md) guide.
 
 ## License
 
@@ -285,4 +179,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
@@ -38,7 +39,7 @@ export class CurrentUserAPI extends BaseAPI {
      * @returns A promise that resolves to the list of projects in the organization
      */
     async getOrganizationProjects(organizationId, options = {}) {
-        const { paginate = false, ...queryOptions } = options;
+        const { ...queryOptions } = options;
         const params = new URLSearchParams();
         for (const [key, value] of Object.entries(queryOptions)) {
             if (value !== undefined)
@@ -50,8 +51,7 @@ export class CurrentUserAPI extends BaseAPI {
         const data = await this.request({
             method: 'GET',
             url,
-        }, paginate);
-        // Only return allowed fields
+        }, true); // Always paginate for projects
         return {
             ...data,
             body: pickFieldsFromArray(data.body || [], CurrentUserAPI.projectFields)

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/bugsnag/client/api/Project.js

@@ -0,0 +1,163 @@
+import { BaseAPI, pickFieldsFromArray, pickFields } from "./base.js";
+// --- API Class ---
+export class ProjectAPI extends BaseAPI {
+    static filterFields = ["errors_url", "events_url", "url", "html_url"];
+    static eventFieldFields = ["custom", "display_id", "filter_options", "pivot_options"];
+    static buildFields = [
+        "id",
+        "release_time",
+        "app_version",
+        "release_stage",
+        "errors_introduced_count",
+        "errors_seen_count",
+        "total_sessions_count",
+        "unhandled_sessions_count",
+        "accumulative_daily_users_seen",
+        "accumulative_daily_users_with_unhandled",
+    ];
+    static releaseFields = [
+        "id",
+        "release_stage_name",
+        "app_version",
+        "first_released_at",
+        "first_release_id",
+        "releases_count",
+        "visible",
+        "total_sessions_count",
+        "unhandled_sessions_count",
+        "sessions_count_in_last_24h",
+        "accumulative_daily_users_seen",
+        "accumulative_daily_users_with_unhandled",
+    ];
+    static stabilityFields = [
+        "critical_stability",
+        "target_stability",
+        "stability_target_type",
+    ];
+    constructor(configuration) {
+        super(configuration, ProjectAPI.filterFields);
+    }
+    /**
+     * List the Event Fields for a Project
+     * GET /projects/{project_id}/event_fields
+     * @param projectId The project ID
+     * @returns A promise that resolves to the list of event fields
+     */
+    async listProjectEventFields(projectId) {
+        const url = `/projects/${projectId}/event_fields`;
+        const data = await this.request({
+            method: 'GET',
+            url,
+        });
+        // Only return allowed fields
+        return {
+            ...data,
+            body: pickFieldsFromArray(data.body || [], ProjectAPI.eventFieldFields)
+        };
+    }
+    /**
+     * Create a Project in an Organization
+     * POST /organizations/{organization_id}/projects
+     * @param organizationId The organization ID
+     * @param data The project creation request body
+     * @returns A promise that resolves to the created project
+     */
+    async createProject(organizationId, data) {
+        const url = `/organizations/${organizationId}/projects`;
+        return await this.request({
+            method: 'POST',
+            url,
+            body: data,
+        });
+    }
+    /**
+     * Retrieves the stability targets for a specific project.
+     * GET /projects/{project_id} (with internal header)
+     * @param projectId The ID of the project.
+     * @returns A promise that resolves to the project's stability targets.
+     */
+    async getProjectStabilityTargets(projectId) {
+        const url = `/projects/${projectId}`;
+        const response = await this.request({
+            method: "GET",
+            url,
+        });
+        return pickFields(response.body || {}, ProjectAPI.stabilityFields);
+    }
+    /**
+     * Lists builds for a specific project.
+     * GET /projects/{project_id}/releases
+     * @param projectId The ID of the project.
+     * @param opts Options for listing releases, including filtering by release stage.
+     * @returns A promise that resolves to an array of `ListReleasesResponse` objects.
+     */
+    async listBuilds(projectId, opts) {
+        const url = opts.next_url ?? `/projects/${projectId}/releases${opts.release_stage ? `?release_stage=${opts.release_stage}` : ""}`;
+        const response = await this.request({
+            method: "GET",
+            url,
+        });
+        return {
+            ...response,
+            body: pickFieldsFromArray(response.body || [], ProjectAPI.buildFields),
+        };
+    }
+    /**
+     * Retrieves a specific build from a project.
+     * GET /projects/{project_id}/releases/{release_id}
+     * @param projectId The ID of the project.
+     * @param buildId The ID of the release to retrieve.
+     * @returns A promise that resolves to the release data.
+     */
+    async getBuild(projectId, buildId) {
+        const url = `/projects/${projectId}/releases/${buildId}`;
+        return await this.request({
+            method: "GET",
+            url,
+        });
+    }
+    /**
+     * Lists releases for a specific project.
+     * GET /projects/{project_id}/release_groups
+     * @param projectId The ID of the project.
+     * @param opts Options for listing releases, including filtering by release stage and visibility.
+     * @returns A promise that resolves to an array of `ReleaseSummaryResponse` objects.
+     */
+    async listReleases(projectId, opts) {
+        const url = opts.next_url ?? `/projects/${projectId}/release_groups?release_stage_name=${opts.release_stage_name}&visible_only=${opts.visible_only}&top_only=true`;
+        const response = await this.request({
+            method: "GET",
+            url
+        });
+        return {
+            ...response,
+            body: pickFieldsFromArray(response.body || [], ProjectAPI.releaseFields),
+        };
+    }
+    /**
+     * Retrieves a specific release by its ID.
+     * GET /release_groups/{release_id}
+     * @param releaseId The ID of the release to retrieve.
+     * @returns A promise that resolves to the release data.
+     */
+    async getRelease(releaseId) {
+        const url = `/release_groups/${releaseId}`;
+        return await this.request({
+            method: "GET",
+            url,
+        });
+    }
+    /**
+     * Lists builds associated with a specific release group.
+     * GET /release_groups/{release_id}/releases
+     * @param releaseId The ID of the release group.
+     * @return A promise that resolves to an array of `BuildResponse` objects.
+     */
+    async listBuildsInRelease(releaseId) {
+        const url = `/release_groups/${releaseId}/releases`;
+        return await this.request({
+            method: "GET",
+            url,
+        }, true);
+    }
+}

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

@@ -12,10 +12,30 @@ export function pickFields(obj, keys) {
 export function pickFieldsFromArray(arr, keys) {
     return arr.map(obj => pickFields(obj, keys));
 }
+// Utility to extract next URL path from Link header
+export function getNextUrlPathFromHeader(headers, basePath) {
+    if (!headers)
+        return null;
+    const link = headers.get("link") || headers.get("Link");
+    if (!link)
+        return null;
+    const match = link.match(/<([^>]+)>;\s*rel="next"/)?.[1];
+    if (!match)
+        return null;
+    return match.replace(basePath, "");
+}
+// Ensure URL is absolute
+// The MCP tools exposed use only the path for pagination
+// For making requests, we need to ensure the URL is absolute
+export function ensureFullUrl(url, basePath) {
+    return url.startsWith('http') ? url : `${basePath}${url}`;
+}
 export class BaseAPI {
     configuration;
-    constructor(configuration) {
+    filterFields;
+    constructor(configuration, filterFields) {
         this.configuration = configuration;
+        this.filterFields = filterFields || [];
     }
     async request(options, paginate = false) {
         const headers = {
@@ -28,11 +48,11 @@ export class BaseAPI {
             headers,
             body: options.body ? JSON.stringify(options.body) : undefined,
         };
-        const url = options.url.startsWith('http') ? options.url : `${this.configuration.basePath || ''}${options.url}`;
         let results = [];
-        let nextUrl = url;
+        let nextUrl = options.url;
         let apiResponse;
         do {
+            nextUrl = ensureFullUrl(nextUrl, this.configuration.basePath);
             const response = await fetch(nextUrl, fetchOptions);
             if (!response.ok) {
                 const errorText = await response.text();
@@ -45,14 +65,7 @@ export class BaseAPI {
             const data = await response.json();
             if (paginate) {
                 results = results.concat(data);
-                const link = response.headers.get('Link');
-                if (link) {
-                    const match = link.match(/<([^>]+)>;\s*rel="next"/);
-                    nextUrl = match ? match[1] : undefined;
-                }
-                else {
-                    nextUrl = undefined;
-                }
+                nextUrl = getNextUrlPathFromHeader(response.headers, this.configuration.basePath);
             }
             else {
                 apiResponse.body = data;
@@ -61,6 +74,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({