@testomatio/mcp-enterprise 2.2.0-beta.3 → 2.2.0

package/README.md

@@ -6,6 +6,9 @@ This package includes all tools from `@testomatio/mcp` plus enterprise analytics
 
 - `analytics_tests`
 - `analytics_stats`
+- `analytics_charts_list`
+- `analytics_charts_get`
+- `analytics_charts_results`
 
 ## Installation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testomatio/mcp-enterprise",
-  "version": "2.2.0-beta.3",
+  "version": "2.2.0",
   "description": "Enterprise Model Context Protocol server for Testomat.io API with analytics tools",
   "main": "index.js",
   "bin": {
@@ -27,7 +27,7 @@
     "directory": "packages/enterprise"
   },
   "dependencies": {
-    "@testomatio/mcp": "2.2.0-beta.3",
+    "@testomatio/mcp": "2.2.0",
     "commander": "^12.0.0"
   },
   "files": [

package/src/analytics.js

@@ -130,7 +130,90 @@ export const ANALYTICS_TOOLS = withListOptions([
       additionalProperties: false,
     },
   },
-], { extraNames: ['analytics_tests'] });
+  {
+    name: 'analytics_charts_list',
+    description:
+      'Enterprise analytics: list saved analytics charts and queries (/api/v2/{project_id}/analytics/charts). Each item bundles one or more TQL queries under a single title, optionally rendered as a chart. Requires api_analytics subscription feature.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        has_chart: {
+          type: 'boolean',
+          description: 'When true, only items with a chart type set; when false, only plain saved queries with no chart.',
+        },
+        kind: {
+          type: 'string',
+          enum: ['tests', 'runs'],
+          description: 'Filter by context: charts over tests or over runs.',
+        },
+        my_charts: {
+          type: 'boolean',
+          description: 'When true, only items created by the authenticated user.',
+        },
+        only_widgets: {
+          type: 'boolean',
+          description: 'When true, only items marked as dashboard widgets.',
+        },
+        page: {
+          type: 'integer',
+          minimum: 1,
+        },
+        per_page: {
+          type: 'integer',
+          minimum: 1,
+          maximum: 100,
+        },
+      },
+      additionalProperties: false,
+    },
+  },
+  {
+    name: 'analytics_charts_get',
+    description:
+      'Enterprise analytics: get a saved chart or query definition — title, chart type, context, and the ordered TQL queries that make it up (/api/v2/{project_id}/analytics/charts/{id}). Requires api_analytics subscription feature.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        chart_id: {
+          type: 'string',
+          description: 'Chart public UID.',
+        },
+      },
+      required: ['chart_id'],
+      additionalProperties: false,
+    },
+  },
+  {
+    name: 'analytics_charts_results',
+    description:
+      'Enterprise analytics: current results of a saved chart (/api/v2/{project_id}/analytics/charts/{id}/result). Without `number`, returns the match count for every query in the chart; with `number` (zero-based query index), returns the matching tests or runs for that query, paginated. Requires api_analytics subscription feature.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        chart_id: {
+          type: 'string',
+          description: 'Chart public UID.',
+        },
+        number: {
+          type: 'integer',
+          minimum: 0,
+          description: 'Zero-based index of the query within the chart to fetch full results for. Omit to get totals for all queries instead.',
+        },
+        page: {
+          type: 'integer',
+          minimum: 1,
+        },
+        per_page: {
+          type: 'integer',
+          minimum: 1,
+          maximum: 100,
+        },
+      },
+      required: ['chart_id'],
+      additionalProperties: false,
+    },
+  },
+], { extraNames: ['analytics_tests', 'analytics_charts_results'] });
 
 export const ENTERPRISE_TOOL_DEFINITIONS = [
   ...TOOL_DEFINITIONS,
@@ -147,6 +230,34 @@ export function registerAnalyticsHandlers(handlers) {
       })
     );
   handlers.analytics_stats = async (args = {}) => this.asText(await analyticsStats.call(this, args));
+
+  handlers.analytics_charts_list = async (args = {}) => {
+    const { verbose, fields, ...listArgs } = args;
+    return this.asText(
+      slimList(await analyticsChartsList.call(this, listArgs), {
+        verbose,
+        fields,
+        entity: 'analytics_charts',
+      })
+    );
+  };
+
+  handlers.analytics_charts_get = async (args = {}) => {
+    const id = this.pickRequiredArg(args, 'chart_id');
+    return this.asText(await this.apiClient.get('analytics/charts', id));
+  };
+
+  handlers.analytics_charts_results = async (args = {}) => {
+    const { verbose, fields, ...restArgs } = args;
+    const payload = await analyticsChartResults.call(this, restArgs);
+    return this.asText(
+      slimList(payload, {
+        verbose,
+        fields,
+        entity: 'analytics_chart_results',
+      })
+    );
+  };
 }
 
 function analyticsTests({
@@ -191,3 +302,23 @@ function analyticsStats({ kind, q, days, from, to, envs } = {}) {
     envs,
   });
 }
+
+function analyticsChartsList({ has_chart, kind, my_charts, only_widgets, page, per_page: perPage } = {}) {
+  return this.apiClient.list('analytics/charts', {
+    has_chart,
+    kind,
+    my_charts,
+    only_widgets,
+    page,
+    per_page: perPage,
+  });
+}
+
+function analyticsChartResults({ chart_id, number, page, per_page: perPage } = {}) {
+  const id = this.pickRequiredArg({ chart_id }, 'chart_id');
+  return this.apiClient.list(`analytics/charts/${id}/result`, {
+    number,
+    page,
+    per_page: perPage,
+  });
+}