@smartbear/mcp 0.1.0 → 0.2.0

package/README.md

@@ -10,30 +10,26 @@
 
 An [MCP](https://modelcontextprotocol.io) server for SmartBear's API Hub, Test Hub and Insight Hub.
 
-## Build
-
-Checkout this repository and run the following to build the server:
-
-```bash
-npm run build
-```
-
 ## Usage
 
 The server is started with the API key or auth token that you use with your product(s). They are optional and can be removed from your configuration if you aren't using the product.
 
 ### VS Code
 
-Add the following configuration to `.vscode/mcp.json`, replacing `<PATH_TO_SMARTBEAR_MCP>` with the location of this repo on your filesystem:
+Add the [`@smartbear/mcp`](https://www.npmjs.com/package/@smartbear/mcp) package to your project via NPM or via the "MCP: Add server…" command in VS Code.
+
+If setting up manually, add the following configuration to `.vscode/mcp.json`:
 
 ```json
 {
   "servers": {
     "smartbear": {
       "type": "stdio",
-      "command": "node",
-      "args": ["<PATH_TO_SMARTBEAR_MCP>/dist/index.js"],
-
+      "command": "npx",
+      "args": [
+        "-y",
+        "@smartbear/mcp@latest"
+      ],
       "env": {
         "INSIGHT_HUB_AUTH_TOKEN": "${input:insight_hub_auth_token}",
         "REFLECT_API_TOKEN": "${input:reflect_api_token}",
@@ -66,14 +62,23 @@ Add the following configuration to `.vscode/mcp.json`, replacing `<PATH_TO_SMART
 
 ### MCP Inspector
 
-To test the MCP server locally, you can use the following command (assuming a local build of the MCP server in the same location):
+To test the MCP server using the npm package, run:
 
 ```bash
-REFLECT_API_TOKEN=your_reflect_token INSIGHT_HUB_AUTH_TOKEN=your_insight_hub_token API_HUB_API_KEY=your_api_hub_api_key npx @modelcontextprotocol/inspector node dist/index.js
+REFLECT_API_TOKEN=your_reflect_token INSIGHT_HUB_AUTH_TOKEN=your_insight_hub_token API_HUB_API_KEY=your_api_hub_api_key npx @smartbear/mcp
 ```
 
 This will open an inspector window in your browser, where you can test the tools.
 
+## Supported Tools
+
+See individual guides for suggested prompts and supported tools and resources:
+
+- [Insight Hub](./insight-hub/README.md)\
+  Get your top events and invite your LLM to help you fix them.
+- [Reflect](./reflect/README.md)
+- [API Hub](./api-hub/README.md)
+
 ## Environment Variables
 
 - `INSIGHT_HUB_AUTH_TOKEN`: Required for Insight Hub tools. The Auth Token for Insight Hub.
@@ -81,14 +86,50 @@ This will open an inspector window in your browser, where you can test the tools
 - `API_HUB_API_KEY`: Required for API Hub tools. The API Key for API Hub tools.
 - `MCP_SERVER_INSIGHT_HUB_API_KEY`: Optional. If set, enables error reporting of the _MCP_server_ code via the BugSnag SDK. This is useful for debugging and monitoring of the MCP server itself and shouldn't be set to the same API key as your app.
 
-## Supported Tools
+See individual guides for product-specific configuration via environment variables.
 
-See individual guides for suggested prompts and supported tools and resources:
+## Local Development
 
-- [Insight Hub](./insight-hub/README.md)\
-  Get your top events and invite your LLM to help you fix them.
-- [Reflect](./reflect/README.md)
-- [API Hub](./api-hub/README.md)
+If you want to build and run the MCP server from source (for development or contribution):
+
+### Build
+
+Clone this repository and run:
+
+```bash
+npm install
+npm run build
+```
+
+### Usage (Local Build)
+
+Update your `.vscode/mcp.json` to point to your local build:
+
+```json
+{
+  "servers": {
+    "smartbear": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["<PATH_TO_SMARTBEAR_MCP>/dist/index.js"],
+      "env": {
+        "INSIGHT_HUB_AUTH_TOKEN": "${input:insight_hub_auth_token}",
+        "REFLECT_API_TOKEN": "${input:reflect_api_token}",
+        "API_HUB_API_KEY": "${input:api_hub_api_key}"
+      }
+    }
+  },
+  "inputs": [
+    // ...same as above...
+  ]
+}
+```
+
+Or run the server directly:
+
+```bash
+REFLECT_API_TOKEN=your_reflect_token INSIGHT_HUB_AUTH_TOKEN=your_insight_hub_token API_HUB_API_KEY=your_api_hub_api_key node dist/index.js
+```
 
 ## License
 

package/api-hub/README.md

@@ -0,0 +1,29 @@
+# API Hub
+
+## Environment Variables
+
+- `API_HUB_API_KEY`: Required. The API key for API Hub MCP tools.
+- `MCP_SERVER_INSIGHT_HUB_API_KEY`: Optional. If set, enables error reporting of the _MCP_server_ code via the BugSnag SDK. This is useful for debugging and monitoring of the MCP server itself and shouldn't be set to the same API key as your app.
+
+## Tools
+
+1. `list_portals`
+   - Search for available portals within API Hub. Only portals where you have at least a designer role, either at the product level or organization level, are returned.
+2. `create_portal`
+   - Create a new portal within API Hub.
+3. `get_portal`
+   - Retrieve information about a specific portal.
+4. `delete_portal`
+   - Delete a portal.
+5. `update_portal`
+   - Update a specific portal's configuration.
+6. `list_portal_products`
+   - Get products for a specific portal matching your criteria.
+7. `create_portal_product`
+   - Create a new product within a specific portal.
+8. `get_portal_product`
+   - Retrieve information about a specific product resource.
+9. `delete_portal_product`
+   - Delete a product from a specific portal.
+10. `update_portal_product`
+    - Update a product's settings within a specific portal.

package/assets/smartbear-logo-dark.svg

@@ -0,0 +1,17 @@
+<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" width="253.9" height="179.21" viewBox="0 0 253.9 179.21">
+  <title>SB_Logo_Vertical_BLK_RGB</title>
+  <g>
+    <path d="M146,115.56H108l-6.75,20.79h51.55Zm102,20.79-20-61.43L241,35.24,193,0.4,159.26,24.94H94.7L60.93,0.4,13,35.24,25.87,74.92l-20,61.43h63L64,121.28l63-45.76,63,45.76-4.89,15.07h63ZM108,115.56l-6.75,20.79h51.55L146,115.56H108Zm38.05,0H108l-6.75,20.79h51.55Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
+    <g>
+      <path d="M17.86,156.7s-5.4-.62-7.64-0.62c-3.24,0-4.9,1.16-4.9,3.43,0,2.47,1.39,3,5.9,4.28,5.55,1.54,7.56,3,7.56,7.52,0,5.78-3.62,8.29-8.83,8.29a56.2,56.2,0,0,1-8.64-1l0.42-3.43s5.21,0.69,7.94.69c3.28,0,4.78-1.47,4.78-4.24,0-2.24-1.2-3-5.24-4C3.52,166.14,1,164.41,1,159.82c0-5.32,3.51-7.52,8.79-7.52a58.55,58.55,0,0,1,8.37.92Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
+      <path d="M29.06,152.76H36.5l5.9,20.63,5.9-20.63h7.48v26.42H51.46V156.35H51.24l-6.6,21.75H40.16l-6.6-21.75H33.34v22.83H29.06V152.76Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
+      <path d="M122.08,152.76h19.28v3.82h-7.44v22.6H129.6v-22.6h-7.52v-3.82Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
+      <path d="M160,152.76c5.24,0,8.06,2,8.06,6.86,0,3.2-1,4.78-3.12,5.94,2.28,0.89,3.78,2.51,3.78,6.13,0,5.4-3.28,7.48-8.41,7.48H150V152.76h10Zm-5.75,3.7V164h5.67c2.62,0,3.78-1.31,3.78-3.9s-1.31-3.66-3.93-3.66h-5.52Zm0,11.18v7.83h5.82c2.66,0,4.24-.85,4.24-4,0-3-2.24-3.82-4.32-3.82h-5.75Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
+      <path d="M179.32,152.76H196v3.74H183.6V164h10.07v3.66H183.6v7.75H196v3.78H179.32V152.76Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
+      <path d="M211.33,152.76h8.52l6.56,26.42h-4.32l-2-7.75H211l-2,7.75h-4.28Zm0.57,14.89h7.41l-2.73-11.3h-1.93Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
+      <path d="M240.22,171.35v7.83h-4.28V152.76h10c5.82,0,8.95,3.34,8.95,9.2,0,3.74-1.5,7.12-4.32,8.43l4.36,8.79h-4.71l-3.82-7.83h-6.21ZM246,156.46h-5.75v11.18H246c3.24,0,4.47-2.91,4.47-5.65C250.51,159,249,156.46,246,156.46Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
+      <path d="M71.64,152.76h8.52l6.56,26.42H82.39l-2-7.75h-9.1l-2,7.75H65.12Zm0.57,14.89h7.41l-2.73-11.3H75Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
+      <path d="M100.52,171.35v7.83H96.24V152.76h10c5.82,0,8.95,3.34,8.95,9.2,0,3.74-1.5,7.12-4.32,8.43l4.36,8.79h-4.71l-3.82-7.83h-6.21Zm5.75-14.89h-5.75v11.18h5.82c3.24,0,4.47-2.91,4.47-5.65C110.82,159,109.35,156.46,106.27,156.46Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
+    </g>
+  </g>
+</svg>

package/assets/smartbear-logo-light.svg

@@ -0,0 +1,17 @@
+<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" width="253.9" height="179.21" viewBox="0 0 253.9 179.21">
+  <title>SB_Logo_Vertical_WT_RGB</title>
+  <g>
+    <path d="M146,115.56H108l-6.75,20.79h51.55Zm102,20.79-20-61.43L241,35.24,193,0.4,159.26,24.94H94.7L60.93,0.4,13,35.24,25.87,74.92l-20,61.43h63L64,121.28l63-45.76,63,45.76-4.89,15.07h63ZM108,115.56l-6.75,20.79h51.55L146,115.56H108Zm38.05,0H108l-6.75,20.79h51.55Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
+    <g>
+      <path d="M17.86,156.7s-5.4-.62-7.64-0.62c-3.24,0-4.9,1.16-4.9,3.43,0,2.47,1.39,3,5.9,4.28,5.55,1.54,7.56,3,7.56,7.52,0,5.78-3.62,8.29-8.83,8.29a56.2,56.2,0,0,1-8.64-1l0.42-3.43s5.21,0.69,7.94.69c3.28,0,4.78-1.47,4.78-4.24,0-2.24-1.2-3-5.24-4C3.52,166.14,1,164.41,1,159.82c0-5.32,3.51-7.52,8.79-7.52a58.55,58.55,0,0,1,8.37.92Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
+      <path d="M29.06,152.76H36.5l5.9,20.63,5.9-20.63h7.48v26.42H51.46V156.35H51.24l-6.6,21.75H40.16l-6.6-21.75H33.34v22.83H29.06V152.76Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
+      <path d="M122.08,152.76h19.28v3.82h-7.44v22.6H129.6v-22.6h-7.52v-3.82Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
+      <path d="M160,152.76c5.24,0,8.06,2,8.06,6.86,0,3.2-1,4.78-3.12,5.94,2.28,0.89,3.78,2.51,3.78,6.13,0,5.4-3.28,7.48-8.41,7.48H150V152.76h10Zm-5.75,3.7V164h5.67c2.62,0,3.78-1.31,3.78-3.9s-1.31-3.66-3.93-3.66h-5.52Zm0,11.18v7.83h5.82c2.66,0,4.24-.85,4.24-4,0-3-2.24-3.82-4.32-3.82h-5.75Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
+      <path d="M179.32,152.76H196v3.74H183.6V164h10.07v3.66H183.6v7.75H196v3.78H179.32V152.76Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
+      <path d="M211.33,152.76h8.52l6.56,26.42h-4.32l-2-7.75H211l-2,7.75h-4.28Zm0.57,14.89h7.41l-2.73-11.3h-1.93Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
+      <path d="M240.22,171.35v7.83h-4.28V152.76h10c5.82,0,8.95,3.34,8.95,9.2,0,3.74-1.5,7.12-4.32,8.43l4.36,8.79h-4.71l-3.82-7.83h-6.21ZM246,156.46h-5.75v11.18H246c3.24,0,4.47-2.91,4.47-5.65C250.51,159,249,156.46,246,156.46Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
+      <path d="M71.64,152.76h8.52l6.56,26.42H82.39l-2-7.75h-9.1l-2,7.75H65.12Zm0.57,14.89h7.41l-2.73-11.3H75Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
+      <path d="M100.52,171.35v7.83H96.24V152.76h10c5.82,0,8.95,3.34,8.95,9.2,0,3.74-1.5,7.12-4.32,8.43l4.36,8.79h-4.71l-3.82-7.83h-6.21Zm5.75-14.89h-5.75v11.18h5.82c3.24,0,4.47-2.91,4.47-5.65C110.82,159,109.35,156.46,106.27,156.46Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
+    </g>
+  </g>
+</svg>

package/dist/api-hub/client.js

@@ -114,7 +114,7 @@ export class ApiHubClient {
                 content: [{ type: "text", text: "Portal deleted successfully." }],
             };
         });
-        server.tool("update_portal", "Update a specifc portal's configuration", {
+        server.tool("update_portal", "Update a specific portal's configuration", {
             portalId: z.string().describe("Portal UUID or subdomain."),
             name: z.string().optional().describe("The portal name."),
             subdomain: z.string().optional().describe("The portal subdomain."),

package/dist/index.js

@@ -35,7 +35,8 @@ async function main() {
         reflectClient.registerResources(server);
     }
     if (insightHubToken) {
-        const insightHubClient = new InsightHubClient(insightHubToken);
+        const insightHubClient = new InsightHubClient(insightHubToken, process.env.INSIGHT_HUB_PROJECT_API_KEY, process.env.INSIGHT_HUB_ENDPOINT);
+        await insightHubClient.initialize();
         insightHubClient.registerTools(server);
         insightHubClient.registerResources(server);
     }

package/dist/insight-hub/client/api/CurrentUser.js

@@ -2,7 +2,7 @@ import { BaseAPI, pickFieldsFromArray } from './base.js';
 // --- API Class ---
 export class CurrentUserAPI extends BaseAPI {
     static organizationFields = ['id', 'name'];
-    static projectFields = ['id', 'name', 'slug'];
+    static projectFields = ['id', 'name', 'slug', 'api_key'];
     constructor(configuration) {
         super(configuration);
     }

package/dist/insight-hub/client/api/Error.js

@@ -1,4 +1,5 @@
 import { BaseAPI } from './base.js';
+import { toQueryString } from './filters.js';
 // --- API Class ---
 export class ErrorAPI extends BaseAPI {
     constructor(configuration) {
@@ -58,4 +59,17 @@ export class ErrorAPI extends BaseAPI {
             url,
         }));
     }
+    /**
+     * List the Errors on a Project
+     * GET /projects/{project_id}/errors
+     */
+    async listProjectErrors(projectId, options = {}) {
+        const url = options.filters
+            ? `/projects/${projectId}/errors?${toQueryString(options.filters)}`
+            : `/projects/${projectId}/errors`;
+        return (await this.request({
+            method: 'GET',
+            url,
+        }));
+    }
 }

package/dist/insight-hub/client/api/Project.js

@@ -0,0 +1,28 @@
+import { BaseAPI, pickFieldsFromArray } from "./base.js";
+// --- API Class ---
+export class ProjectAPI extends BaseAPI {
+    static eventFieldFields = [
+        'custom',
+        'display_id',
+        'filter_options',
+        'pivot_options'
+    ];
+    constructor(configuration) {
+        super(configuration);
+    }
+    /**
+     * 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 pickFieldsFromArray(data, ProjectAPI.eventFieldFields);
+    }
+}

package/dist/insight-hub/client/api/base.js

@@ -33,6 +33,10 @@ export class BaseAPI {
         let nextUrl = url;
         do {
             const response = await fetch(nextUrl, fetchOptions);
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Request failed with status ${response.status}: ${errorText}`);
+            }
             const data = await response.json();
             if (paginate) {
                 results = results.concat(data);

package/dist/insight-hub/client/api/filters.js

@@ -0,0 +1,167 @@
+/**
+ * Filters utility for Insight Hub API
+ *
+ * This file provides utility functions for creating filter URL parameters
+ * based on the Insight Hub filtering specification described in the Filtering.md document.
+ */
+import { z } from "zod";
+export const FilterValueSchema = z.object({
+    type: z.enum(['eq', 'ne', 'empty']),
+    value: z.union([z.string(), z.boolean(), z.number()]),
+});
+export const FilterObjectSchema = z.record(z.array(FilterValueSchema));
+/**
+ * Creates a filter value object for equality comparison
+ *
+ * @param value The value to compare against
+ * @returns FilterValue with type 'eq'
+ */
+export function equals(value) {
+    return {
+        type: 'eq',
+        value,
+    };
+}
+/**
+ * Creates a filter value object for inequality comparison
+ *
+ * @param value The value to compare against
+ * @returns FilterValue with type 'ne'
+ */
+export function notEquals(value) {
+    return {
+        type: 'ne',
+        value,
+    };
+}
+/**
+ * Creates a filter value object for checking if a field is empty or not
+ *
+ * @param isEmpty Whether the field should be empty (true) or not (false)
+ * @returns FilterValue with type 'empty'
+ */
+export function empty(isEmpty) {
+    return {
+        type: 'empty',
+        value: isEmpty.toString(),
+    };
+}
+/**
+ * Creates a relative time filter for event.since or event.before
+ *
+ * @param value The amount of time
+ * @param unit The time unit ('h' for hours, 'd' for days)
+ * @returns FilterValue for the relative time
+ */
+export function relativeTime(value, unit) {
+    return {
+        type: 'eq',
+        value: `${value}${unit}`,
+    };
+}
+/**
+ * Creates an ISO 8601 time filter (must be in UTC format like 2018-05-20T00:00:00Z)
+ *
+ * @param date The date object to convert to ISO string
+ * @returns FilterValue for the ISO time
+ */
+export function isoTime(date) {
+    return {
+        type: 'eq',
+        value: date.toISOString(),
+    };
+}
+/**
+ * Converts a FilterObject to URL search parameters
+ *
+ * @param filters The filter object to convert
+ * @returns URLSearchParams object with the encoded filters
+ */
+export function toUrlSearchParams(filters) {
+    const params = new URLSearchParams();
+    Object.entries(filters).forEach(([field, filterValues]) => {
+        filterValues.forEach((filterValue) => {
+            params.append(`filters[${field}][][type]`, filterValue.type);
+            params.append(`filters[${field}][][value]`, filterValue.value.toString());
+        });
+    });
+    return params;
+}
+/**
+ * Converts a FilterObject to a query string
+ *
+ * @param filters The filter object to convert
+ * @returns Query string representation of the filters
+ */
+export function toQueryString(filters) {
+    return toUrlSearchParams(filters).toString();
+}
+/**
+ * Helper to build a FilterObject with type safety
+ *
+ * @returns An empty FilterObject that can be built upon
+ */
+export function createFilter() {
+    return {};
+}
+/**
+ * Adds a field filter to an existing FilterObject
+ *
+ * @param filters The FilterObject to add to
+ * @param field The field name (e.g., 'error.status', 'event.since')
+ * @param filterValue The FilterValue to add
+ * @returns The updated FilterObject for chaining
+ */
+export function addFilter(filters, field, filterValue) {
+    if (!filters[field]) {
+        filters[field] = [];
+    }
+    filters[field].push(filterValue);
+    return filters;
+}
+/**
+ * Utility to create a time range filter between two dates
+ *
+ * @param filters The FilterObject to add to
+ * @param since Start date
+ * @param before End date
+ * @returns The updated FilterObject for chaining
+ */
+export function addTimeRange(filters, since, before) {
+    addFilter(filters, 'event.since', isoTime(since));
+    addFilter(filters, 'event.before', isoTime(before));
+    return filters;
+}
+/**
+ * Utility to create a relative time range filter
+ *
+ * @param filters The FilterObject to add to
+ * @param amount The amount of time (e.g., 7 for 7 days)
+ * @param unit The time unit ('h' for hours, 'd' for days)
+ * @returns The updated FilterObject for chaining
+ */
+export function addRelativeTimeRange(filters, amount, unit) {
+    addFilter(filters, 'event.since', relativeTime(amount, unit));
+    return filters;
+}
+/**
+ * Usage examples:
+ *
+ * // Example 1: Open errors with events in the last day
+ * const filters = createFilter();
+ * addRelativeTimeRange(filters, 1, 'd');
+ * addFilter(filters, 'error.status', equals('open'));
+ * const queryString = toQueryString(filters);
+ *
+ * // Example 2: Events affecting specific users on a specific day
+ * const filters = createFilter();
+ * addTimeRange(filters, new Date('2017-01-01'), new Date('2017-01-02'));
+ * addFilter(filters, 'user.email', equals('user1@example.com'));
+ * addFilter(filters, 'user.email', equals('user2@example.com'));
+ * const queryString = toQueryString(filters);
+ *
+ * // Example 3: Events that have user data
+ * const filters = createFilter();
+ * addFilter(filters, 'user.id', empty(false));
+ * const queryString = toQueryString(filters);
+ */

package/dist/insight-hub/client.js

@@ -3,20 +3,71 @@ import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "../common/info.js";
 import { CurrentUserAPI, ErrorAPI, Configuration } from "./client/index.js";
 import { z } from "zod";
 import Bugsnag from "../common/bugsnag.js";
+import NodeCache from "node-cache";
+import { ProjectAPI } from "./client/api/Project.js";
+import { FilterObjectSchema } from "./client/api/filters.js";
+const HUB_PREFIX = "00000";
+const HUB_API_ENDPOINT = "https://api.insighthub.smartbear.com";
+const DEFAULT_API_ENDPOINT = "https://api.bugsnag.com";
+const cacheKeys = {
+    ORG: "insight_hub_org",
+    PROJECTS: "insight_hub_projects",
+    CURRENT_PROJECT: "insight_hub_current_project",
+    PROJECT_EVENT_FILTERS: "insight_hub_project_event_filters",
+};
 export class InsightHubClient {
     currentUserApi;
     errorsApi;
-    constructor(token) {
+    cache;
+    projectApi;
+    projectApiKey;
+    constructor(token, projectApiKey, endpoint) {
+        if (!endpoint) {
+            if (projectApiKey && projectApiKey.startsWith(HUB_PREFIX)) {
+                endpoint = HUB_API_ENDPOINT;
+            }
+            else {
+                endpoint = DEFAULT_API_ENDPOINT;
+            }
+        }
         const config = new Configuration({
             authToken: token,
             headers: {
                 "User-Agent": `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`,
                 "Content-Type": "application/json",
             },
-            basePath: "https://api.bugsnag.com",
+            basePath: endpoint,
         });
         this.currentUserApi = new CurrentUserAPI(config);
         this.errorsApi = new ErrorAPI(config);
+        this.cache = new NodeCache();
+        this.projectApi = new ProjectAPI(config);
+        this.projectApiKey = projectApiKey;
+    }
+    async initialize() {
+        const orgs = await this.listOrgs();
+        if (!orgs || orgs.length === 0) {
+            throw new Error("No organizations found for the current user.");
+        }
+        // We should only have one org
+        this.cache.set(cacheKeys.ORG, orgs[0]);
+        const projects = await this.listProjects(orgs[0].id);
+        this.cache.set(cacheKeys.PROJECTS, projects);
+        if (this.projectApiKey) {
+            const project = projects.find((project) => project.api_key === this.projectApiKey);
+            if (!project) {
+                throw new Error(`Project with API key ${this.projectApiKey} not found in organization ${orgs[0].name}.`);
+            }
+            this.cache.set(cacheKeys.CURRENT_PROJECT, project);
+            const projectFields = await this.listProjectEventFields(project.id);
+            if (!projectFields || projectFields.length === 0) {
+                throw new Error(`No event fields found for project ${project.name}.`);
+            }
+            this.cache.set(cacheKeys.PROJECT_EVENT_FILTERS, projectFields);
+        }
+    }
+    async listProjectEventFields(projectId) {
+        return this.projectApi.listProjectEventFields(projectId);
     }
     async listOrgs() {
         return this.currentUserApi.listUserOrganizations();
@@ -28,6 +79,25 @@ export class InsightHubClient {
         };
         return this.currentUserApi.getOrganizationProjects(orgId, options);
     }
+    // This method retrieves all projects for the organization stored in the cache.
+    // If no projects are found in the cache, it fetches them from the API and
+    // stores them in the cache for future use.
+    // It throws an error if no organizations are found in the cache.
+    async getProjects() {
+        let projects = this.cache.get(cacheKeys.PROJECTS);
+        if (!projects) {
+            const org = this.cache.get(cacheKeys.ORG);
+            if (!org) {
+                throw new Error("No organization found in cache.");
+            }
+            projects = await this.listProjects(org.id);
+            this.cache.set(cacheKeys.PROJECTS, projects);
+        }
+        if (!projects) {
+            throw new Error("No projects found.");
+        }
+        return projects;
+    }
     async getErrorDetails(projectId, errorId) {
         return this.errorsApi.viewErrorOnProject(projectId, errorId);
     }
@@ -42,29 +112,46 @@ export class InsightHubClient {
         const eventDetails = await Promise.all(projects.map((p) => this.getProjectEvent(p.id, eventId).catch(_e => null)));
         return eventDetails.find(event => !!event);
     }
+    async listProjectErrors(projectId, filters) {
+        return this.errorsApi.listProjectErrors(projectId, { filters });
+    }
     registerTools(server) {
-        server.tool("list_insight_hub_projects", "List all projects in an organization", { orgId: z.string().describe("ID of the organization to list projects for") }, async (args, _extra) => {
-            try {
-                if (!args.orgId)
-                    throw new Error("orgId argument is required");
-                const response = await this.listProjects(args.orgId);
-                return {
-                    content: [{ type: "text", text: JSON.stringify(response) }],
-                };
-            }
-            catch (e) {
-                Bugsnag.notify(e);
-                throw e;
-            }
-        });
+        if (!this.projectApiKey) {
+            server.tool("list_insight_hub_projects", "List all projects in an organization.", {
+                page_size: z.number().optional().describe("Number of projects to return per page"),
+                page: z.number().optional().describe("Page number to return"),
+            }, async (args, _extra) => {
+                try {
+                    let projects = await this.getProjects();
+                    if (!projects || projects.length === 0) {
+                        return {
+                            content: [{ type: "text", text: "No projects found." }],
+                        };
+                    }
+                    if (args.page_size || args.page) {
+                        const pageSize = args.page_size || 10;
+                        const page = args.page || 1;
+                        projects = projects.slice((page - 1) * pageSize, page * pageSize);
+                    }
+                    return {
+                        content: [{ type: "text", text: JSON.stringify(projects) }],
+                    };
+                }
+                catch (e) {
+                    Bugsnag.notify(e);
+                    throw e;
+                }
+            });
+        }
         server.tool("get_insight_hub_error", "Get error details from a project", {
-            projectId: z.string().describe("ID of the project"),
             errorId: z.string().describe("ID of the error to fetch"),
+            ...(!this.projectApiKey ? { projectId: z.string().optional().describe("ID of the project") } : {}),
         }, async (args, _extra) => {
             try {
-                if (!args.projectId || !args.errorId)
+                const projectId = typeof args.projectId === 'string' ? args.projectId : this.cache.get(cacheKeys.CURRENT_PROJECT)?.id;
+                if (!projectId || !args.errorId)
                     throw new Error("Both projectId and errorId arguments are required");
-                const response = await this.getErrorDetails(args.projectId, args.errorId);
+                const response = await this.getErrorDetails(projectId, args.errorId);
                 return {
                     content: [{ type: "text", text: JSON.stringify(response) }],
                 };
@@ -102,9 +189,14 @@ export class InsightHubClient {
                 if (!projectSlug || !eventId)
                     throw new Error("Both projectSlug and eventId must be present in the link");
                 // get the project id from list of projects
-                // limitation: this assumes a single page of results, so will not work for orgs with >100 projects
-                const orgId = await this.currentUserApi.listUserOrganizations().then(orgs => orgs[0].id);
-                const projectId = await this.listProjects(orgId).then(projects => projects.find((p) => p.slug === projectSlug)?.id);
+                const projects = this.cache.get("insight_hub_projects");
+                if (!projects) {
+                    throw new Error("No projects found in cache.");
+                }
+                const projectId = projects.find((p) => p.slug === projectSlug)?.id;
+                if (!projectId) {
+                    throw new Error("Project with the specified slug not found.");
+                }
                 const response = await this.getProjectEvent(projectId, eventId);
                 return {
                     content: [{ type: "text", text: JSON.stringify(response) }],
@@ -115,15 +207,45 @@ export class InsightHubClient {
                 throw e;
             }
         });
-    }
-    registerResources(server) {
-        server.resource("insight_hub_orgs", "insighthub://orgs", { description: "List all organizations in Insight Hub", mimeType: "application/json" }, async (uri) => {
+        // Dynamically infer the filters schema from cached project event fields
+        server.tool("list_insight_hub_project_errors", "List errors in the current project based on a set of event filters. Use this tool to find or list errors based on user-provided search filters. You can use the `get_project_event_filters` tool to find valid filters for the current project.", {
+            filters: FilterObjectSchema.optional().describe("Filters to apply to the error list. Valid filters for a project can be found in the `get_project_event_filters` tool."),
+            // Conditionally add projectId only when no project API key is configured
+            ...(this.projectApiKey ? {} : {
+                projectId: z.string().describe("ID of the project"),
+            }),
+        }, async (args, _extra) => {
             try {
+                const projectId = typeof args.projectId === 'string' ? args.projectId : this.cache.get(cacheKeys.CURRENT_PROJECT)?.id;
+                if (!projectId)
+                    throw new Error("projectId argument is required");
+                // Optionally, validate filter keys against cached event fields
+                const eventFields = this.cache.get(cacheKeys.PROJECT_EVENT_FILTERS) || [];
+                if (args.filters) {
+                    const validKeys = new Set(eventFields.map(f => f.display_id));
+                    for (const key of Object.keys(args.filters)) {
+                        if (!validKeys.has(key)) {
+                            throw new Error(`Invalid filter key: ${key}`);
+                        }
+                    }
+                }
+                const response = await this.listProjectErrors(projectId, args.filters);
                 return {
-                    contents: [{
-                            uri: uri.href,
-                            text: JSON.stringify(await this.listOrgs())
-                        }]
+                    content: [{ type: "text", text: JSON.stringify(response) }],
+                };
+            }
+            catch (e) {
+                Bugsnag.notify(e);
+                throw e;
+            }
+        });
+        server.tool("get_project_event_filters", "Get the available event filters for the current project. Use this tool to find valid filters for the `list_insight_hub_project_errors` tool.", {}, async (_args, _extra) => {
+            try {
+                const eventFields = this.cache.get(cacheKeys.PROJECT_EVENT_FILTERS);
+                if (!eventFields)
+                    throw new Error("No event filters found in cache.");
+                return {
+                    content: [{ type: "text", text: JSON.stringify(eventFields) }],
                 };
             }
             catch (e) {
@@ -131,6 +253,8 @@ export class InsightHubClient {
                 throw e;
             }
         });
+    }
+    registerResources(server) {
         server.resource("insight_hub_event", new ResourceTemplate("insighthub://event/{id}", { list: undefined }), async (uri, { id }) => {
             try {
                 return {

package/dist/package.json

@@ -1,14 +1,28 @@
 {
     "name": "@smartbear/mcp",
-    "version": "0.1.0",
+    "version": "0.2.0",
     "description": "MCP server for interacting SmartBear Products",
+    "keywords": [
+        "smartbear",
+        "mcp",
+        "insight-hub",
+        "reflect",
+        "api-hub"
+    ],
+    "homepage": "https://developer.smartbear.com/smartbear-mcp",
+    "repository": {
+        "type": "git",
+        "url": "git@github.com:SmartBear/smartbear-mcp.git"
+    },
     "license": "MIT",
     "type": "module",
     "bin": {
-        "mcp-server-smartbear": "dist/index.js"
+        "mcp": "dist/index.js"
     },
     "files": [
-        "dist"
+        "dist",
+        "assets",
+        "**/README.md"
     ],
     "config": {
         "mcpServerName": "SmartBear MCP Server"
@@ -21,7 +35,8 @@
     },
     "dependencies": {
         "@bugsnag/js": "^8.2.0",
-        "@modelcontextprotocol/sdk": "1.12.1"
+        "@modelcontextprotocol/sdk": "1.12.1",
+        "node-cache": "^5.1.2"
     },
     "devDependencies": {
         "@eslint/js": "^9.29.0",

package/dist/reflect/client.js

@@ -8,7 +8,7 @@ export class ReflectClient {
             "Content-Type": "application/json",
         };
     }
-    async listReflectSuits() {
+    async listReflectSuites() {
         const response = await fetch("https://api.reflect.run/v1/suites", {
             method: "GET",
             headers: this.headers,
@@ -66,7 +66,7 @@ export class ReflectClient {
     }
     registerTools(server) {
         server.tool("list_reflect_suites", "List all reflect suites", {}, async (_args, _extra) => {
-            const response = await this.listReflectSuits();
+            const response = await this.listReflectSuites();
             return {
                 content: [{ type: "text", text: JSON.stringify(response) }],
             };

package/insight-hub/README.md

@@ -0,0 +1,39 @@
+# Insight Hub
+
+Fetch details of your app crashes and errors from your [Insight Hub](https://www.smartbear.com/insight-hub) dashboard for your LLM to help you diagnose and fix.
+
+To connect an MCP server, you will need to create a personal auth token from the user settings page on your Insight Hub dashboard. If you wish to interact with only one Insight Hub project, we also recommend setting `INSIGHT_HUB_PROJECT_API_KEY` to reduce the scope of the conversation.
+
+## Example prompts
+
+- "Help me fix this crash from Insight Hub: https://app.bugsnag.com/my-org/my-project/errors/1a2b3c4d5e6f7g8h9i0j1k2l?&event_id=1a2b3c4d5e6f7g8h9i0j1k2l"
+- "What are my top events for the 'example' project in insight hub?"
+
+## Environment Variables
+
+- `INSIGHT_HUB_AUTH_TOKEN`: (Required) The auth token for your account from your Insight Hub dashboard, under **Personal auth tokens** in user settings.
+- `INSIGHT_HUB_PROJECT_API_KEY`: (Optional) The API key for the Insight Hub project you wish to interact with. Use this to scope all operations to a single project.
+- `INSIGHT_HUB_ENDPOINT`: (Optional) The API server to connect to. Use this for on-premise installations to point to your own endpoint (e.g. `https://your.api.server`).
+
+## Tools
+
+1. `list_insight_hub_projects`
+   - List all projects in an organization.
+   - Multi-project mode only.
+2. `get_insight_hub_error`
+   - Get error details from a project.
+3. `get_insight_hub_error_latest_event`
+   - Get the latest event for an error.
+4. `get_insight_hub_event_details`
+   - Get details of a specific event.
+5. `get_project_event_filters`
+   - List the filters available for a project.
+6. `list_insight_hub_project_errors`
+   - List and filter the errors from a project.
+
+## Resources
+
+- **insight_hub_event**
+  - URI Template: `insighthub://event/{id}`
+  - Description: Fetches details for a specific event by its event ID. Returns the event details in JSON format.
+  - Example usage: Retrieve event details for debugging or analysis by referencing the event ID.

package/package.json

@@ -1,14 +1,28 @@
 {
   "name": "@smartbear/mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for interacting SmartBear Products",
+  "keywords": [
+    "smartbear",
+    "mcp",
+    "insight-hub",
+    "reflect",
+    "api-hub"
+  ],
+  "homepage": "https://developer.smartbear.com/smartbear-mcp",
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:SmartBear/smartbear-mcp.git"
+  },
   "license": "MIT",
   "type": "module",
   "bin": {
-    "mcp-server-smartbear": "dist/index.js"
+    "mcp": "dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "assets",
+    "**/README.md"
   ],
   "config": {
     "mcpServerName": "SmartBear MCP Server"
@@ -21,7 +35,8 @@
   },
   "dependencies": {
     "@bugsnag/js": "^8.2.0",
-    "@modelcontextprotocol/sdk": "1.12.1"
+    "@modelcontextprotocol/sdk": "1.12.1",
+    "node-cache": "^5.1.2"
   },
   "devDependencies": {
     "@eslint/js": "^9.29.0",

package/reflect/README.md

@@ -0,0 +1,25 @@
+# Reflect
+
+## Environment Variables
+
+- `REFLECT_API_TOKEN`: Required. The Reflect Account API Key.
+- `MCP_SERVER_INSIGHT_HUB_API_KEY`: Optional. If set, enables error reporting of the _MCP_server_ code via the BugSnag SDK. This is useful for debugging and monitoring of the MCP server itself and shouldn't be set to the same API key as your app.
+
+## Tools
+
+1. `list_reflect_suites`
+   - List all Reflect suites for your account.
+2. `list_reflect_suite_executions`
+   - List all executions for a given Reflect suite.
+3. `reflect_suite_execution_status`
+   - Get the status of a Reflect suite execution.
+4. `reflect_suite_execution`
+   - Execute a Reflect suite.
+5. `cancel_reflect_suite_execution`
+   - Cancel a Reflect suite execution.
+6. `list_reflect_tests`
+   - List all Reflect tests.
+7. `run_reflect_test`
+   - Run a Reflect test.
+8. `reflect_test_status`
+   - Get the status of a Reflect test execution.