@testomatio/mcp 2.2.0-beta.1 → 2.2.0-beta.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testomatio/mcp",
-  "version": "2.2.0-beta.1",
+  "version": "2.2.0-beta.2",
   "description": "Model Context Protocol server for Testomatio API",
   "main": "src/index.js",
   "bin": {

package/src/mcp/list-projection.js

@@ -98,9 +98,13 @@ export function slimList(payload, { verbose = false, fields, entity } = {}) {
 
 /**
  * Ask the API to omit heavy list fields only when MCP does not need them for a
- * full or custom projection.
+ * full or custom projection. When `count` is requested the response is meta only,
+ * so `slim` is irrelevant and must not be sent alongside `count`.
  */
-export function backendSlimQuery({ verbose = false, fields } = {}) {
+export function backendSlimQuery({ verbose = false, fields, count = false } = {}) {
+  if (count) {
+    return {};
+  }
   return !verbose && !(Array.isArray(fields) && fields.length) ? { slim: true } : {};
 }
 
@@ -146,3 +150,47 @@ export function withListOptions(tools, { extraNames = [] } = {}) {
     };
   });
 }
+
+// Scoped list tools (*_issues_list, *_attachments_list) are filtered to one entity,
+// so count/group_by aggregation does not apply there.
+const SCOPED_LIST_INFIXES = ['_issues_', '_attachments_'];
+
+function isPrimaryListToolName(name) {
+  return (
+    typeof name === 'string' &&
+    name.endsWith('_list') &&
+    !SCOPED_LIST_INFIXES.some((infix) => name.includes(infix))
+  );
+}
+
+const COUNT_PROPERTY = {
+  type: 'boolean',
+  description:
+    'Return only metadata with total counts instead of the entity list. Pair with group_by for an aggregated breakdown.',
+};
+
+const GROUP_BY_PROPERTY = {
+  type: 'string',
+  description:
+    'Aggregate counts by this field, e.g. status, state, priority, created_by (use with count=true). The backend validates supported fields per resource. For created_by, counts are keyed by user email, not ID.',
+};
+
+/**
+ * Inject `count` and `group_by` into every primary list tool. `group_by` is a
+ * free-form string — the backend is the source of truth for which fields each
+ * resource accepts. Scoped list tools (*_issues_list, *_attachments_list) are skipped.
+ *
+ * @param {Array} tools
+ */
+export function withCountGroupOptions(tools) {
+  return tools.map((tool) => {
+    if (!tool || !isPrimaryListToolName(tool.name)) return tool;
+    const inputSchema = tool.inputSchema || { type: 'object', properties: {} };
+    const properties = {
+      ...(inputSchema.properties || {}),
+      count: COUNT_PROPERTY,
+      group_by: GROUP_BY_PROPERTY,
+    };
+    return { ...tool, inputSchema: { ...inputSchema, properties } };
+  });
+}

package/src/mcp/registry/handlers.js

@@ -10,7 +10,7 @@ export const handlerMethods = {
 
       handlers[`${toolPrefix}_list`] = async (args = {}) => {
         const { verbose, fields, ...listArgs } = args;
-        Object.assign(listArgs, backendSlimQuery({ verbose, fields }));
+        Object.assign(listArgs, backendSlimQuery({ verbose, fields, count: listArgs.count }));
         return this.asText(
           slimList(await this[listMethod](listArgs), {
             verbose,
@@ -102,15 +102,16 @@ export const handlerMethods = {
   registerGlobalHandlers(handlers) {
     handlers.project_info = async () => this.asText(await this.apiClient.get('info'));
 
-    handlers.tags_list = async (args = {}) =>
-      this.asText(
-        slimList(await this.listTags(backendSlimQuery(args)), { ...args, entity: 'tags' })
-      );
+    handlers.tags_list = async (args = {}) => {
+      const { verbose, fields, ...listArgs } = args;
+      Object.assign(listArgs, backendSlimQuery({ verbose, fields, count: listArgs.count }));
+      return this.asText(slimList(await this.listTags(listArgs), { ...args, entity: 'tags' }));
+    };
     handlers.tags_get = async ({ tag_id: tagId }) => this.asText(await this.getTagByTitle(tagId));
 
     handlers.milestones_list = async (args = {}) => {
       const { verbose, fields, ...listArgs } = args;
-      Object.assign(listArgs, backendSlimQuery({ verbose, fields }));
+      Object.assign(listArgs, backendSlimQuery({ verbose, fields, count: listArgs.count }));
       return this.asText(
         slimList(await this.listMilestones(listArgs), { verbose, fields, entity: 'milestones' })
       );
@@ -120,7 +121,7 @@ export const handlerMethods = {
 
     handlers.issues_list = async (args = {}) => {
       const { verbose, fields, ...listArgs } = args;
-      Object.assign(listArgs, backendSlimQuery({ verbose, fields }));
+      Object.assign(listArgs, backendSlimQuery({ verbose, fields, count: listArgs.count }));
       return this.asText(
         slimList(await this.listIssues(listArgs), { verbose, fields, entity: 'issues' })
       );

package/src/mcp/registry/listings.js

@@ -3,17 +3,21 @@ export const listingMethods = {
     page,
     per_page: perPage,
     tql,
+    count,
+    group_by: groupBy,
     slim,
   } = {}) {
     return this.apiClient.list('tests', {
       page,
       per_page: perPage,
       tql,
+      count,
+      group_by: groupBy,
       slim,
     });
   },
 
-  listSuites({ page, per_page: perPage, file_type: fileType, tag, labels, search_text: searchText, slim } = {}) {
+  listSuites({ page, per_page: perPage, file_type: fileType, tag, labels, search_text: searchText, count, group_by: groupBy, slim } = {}) {
     return this.apiClient.list('suites', {
       page,
       per_page: perPage,
@@ -21,6 +25,8 @@ export const listingMethods = {
       tag,
       labels,
       search_text: searchText,
+      count,
+      group_by: groupBy,
       slim,
     });
   },
@@ -29,12 +35,16 @@ export const listingMethods = {
     page,
     per_page: perPage,
     tql,
+    count,
+    group_by: groupBy,
     slim,
   } = {}) {
     return this.apiClient.list('runs', {
       page,
       per_page: perPage,
       tql,
+      count,
+      group_by: groupBy,
       slim,
     });
   },
@@ -58,6 +68,8 @@ export const listingMethods = {
     envs,
     rungroups,
     defects,
+    count,
+    group_by: groupBy,
     slim,
   } = {}) {
     return this.apiClient.list('testruns', {
@@ -79,27 +91,29 @@ export const listingMethods = {
       envs: Array.isArray(envs) ? envs.join(',') : envs,
       rungroups: Array.isArray(rungroups) ? rungroups.join(',') : rungroups,
       defects,
+      count,
+      group_by: groupBy,
       slim,
     });
   },
 
-  listRungroups({ page, per_page: perPage, slim } = {}) {
-    return this.apiClient.list('rungroups', { page, per_page: perPage, slim });
+  listRungroups({ page, per_page: perPage, count, group_by: groupBy, slim } = {}) {
+    return this.apiClient.list('rungroups', { page, per_page: perPage, count, group_by: groupBy, slim });
   },
 
-  listSteps({ page, per_page: perPage, slim } = {}) {
-    return this.apiClient.list('steps', { page, per_page: perPage, slim });
+  listSteps({ page, per_page: perPage, count, group_by: groupBy, slim } = {}) {
+    return this.apiClient.list('steps', { page, per_page: perPage, count, group_by: groupBy, slim });
   },
 
-  listSnippets({ page, per_page: perPage, slim } = {}) {
-    return this.apiClient.list('snippets', { page, per_page: perPage, slim });
+  listSnippets({ page, per_page: perPage, count, group_by: groupBy, slim } = {}) {
+    return this.apiClient.list('snippets', { page, per_page: perPage, count, group_by: groupBy, slim });
   },
 
-  listLabels({ page, per_page: perPage, slim } = {}) {
-    return this.apiClient.list('labels', { page, per_page: perPage, slim });
+  listLabels({ page, per_page: perPage, count, group_by: groupBy, slim } = {}) {
+    return this.apiClient.list('labels', { page, per_page: perPage, count, group_by: groupBy, slim });
   },
 
-  listPlans({ page, per_page: perPage, kind, hidden, labels, search_text: searchText, slim } = {}) {
+  listPlans({ page, per_page: perPage, kind, hidden, labels, search_text: searchText, count, group_by: groupBy, slim } = {}) {
     return this.apiClient.list('plans', {
       page,
       per_page: perPage,
@@ -107,20 +121,22 @@ export const listingMethods = {
       hidden,
       'labels[]': labels,
       search_text: searchText,
+      count,
+      group_by: groupBy,
       slim,
     });
   },
 
-  listRequirements({ page, per_page: perPage, source, scope, slim } = {}) {
-    return this.apiClient.list('requirements', { page, per_page: perPage, source, scope, slim });
+  listRequirements({ page, per_page: perPage, source, scope, count, group_by: groupBy, slim } = {}) {
+    return this.apiClient.list('requirements', { page, per_page: perPage, source, scope, count, group_by: groupBy, slim });
   },
 
-  listMilestones({ page, per_page: perPage, type, status, slim } = {}) {
-    return this.apiClient.list('milestones', { page, per_page: perPage, type, status, slim });
+  listMilestones({ page, per_page: perPage, type, status, count, group_by: groupBy, slim } = {}) {
+    return this.apiClient.list('milestones', { page, per_page: perPage, type, status, count, group_by: groupBy, slim });
   },
 
-  listTags({ slim } = {}) {
-    return this.apiClient.list('tags', { slim });
+  listTags({ count, group_by: groupBy, slim } = {}) {
+    return this.apiClient.list('tags', { count, group_by: groupBy, slim });
   },
 
   getTagByTitle(tagId) {

package/src/mcp/tool-definitions.js

@@ -14,9 +14,9 @@ import { ISSUES_TOOLS } from './definitions/issues.js';
 import { PLANS_TOOLS } from './definitions/plans.js';
 import { REQUIREMENTS_TOOLS } from './definitions/requirements.js';
 import { ATTACHMENT_TOOLS } from './definitions/attachments.js';
-import { withListOptions } from './list-projection.js';
+import { withListOptions, withCountGroupOptions } from './list-projection.js';
 
-export const TOOL_DEFINITIONS = withListOptions([
+export const TOOL_DEFINITIONS = withCountGroupOptions(withListOptions([
   ...SYSTEM_TOOLS,
   ...PROJECT_TOOLS,
   ...TESTS_TOOLS,
@@ -33,4 +33,4 @@ export const TOOL_DEFINITIONS = withListOptions([
   ...ATTACHMENT_TOOLS,
   ...PLANS_TOOLS,
   ...REQUIREMENTS_TOOLS,
-]);
+]));