@testomatio/mcp 2.1.1 → 2.2.0-beta

package/src/mcp/registry/listings.js

@@ -11,14 +11,6 @@ export const listingMethods = {
     });
   },
 
-  searchTests({ page, per_page: perPage, tql } = {}) {
-    return this.listTests({
-      page,
-      per_page: perPage,
-      tql,
-    });
-  },
-
   listSuites({ page, per_page: perPage, file_type: fileType, tag, labels, search_text: searchText } = {}) {
     return this.apiClient.list('suites', {
       page,
@@ -30,13 +22,6 @@ export const listingMethods = {
     });
   },
 
-  searchSuites({ search_text: searchText, ...rest } = {}) {
-    return this.listSuites({
-      ...rest,
-      search_text: searchText,
-    });
-  },
-
   listRuns({
     page,
     per_page: perPage,
@@ -49,10 +34,6 @@ export const listingMethods = {
     });
   },
 
-  searchRuns({ page, per_page: perPage, tql } = {}) {
-    return this.listRuns({ page, per_page: perPage, tql });
-  },
-
   listTestruns({
     page,
     per_page: perPage,
@@ -95,16 +76,6 @@ export const listingMethods = {
     });
   },
 
-  searchTestruns({ page, per_page: perPage, run_id: runId, filter_search: filterSearch, ...rest } = {}) {
-    return this.listTestruns({
-      page,
-      per_page: perPage,
-      run_id: runId,
-      filter_search: filterSearch,
-      ...rest,
-    });
-  },
-
   listRungroups({ page, per_page: perPage } = {}) {
     return this.apiClient.list('rungroups', { page, per_page: perPage });
   },
@@ -132,18 +103,10 @@ export const listingMethods = {
     });
   },
 
-  searchPlans({ page, per_page: perPage, search_text: searchText, ...rest } = {}) {
-    return this.listPlans({ page, per_page: perPage, search_text: searchText, ...rest });
-  },
-
   listRequirements({ page, per_page: perPage, source, scope } = {}) {
     return this.apiClient.list('requirements', { page, per_page: perPage, source, scope });
   },
 
-  searchRequirements({ page, per_page: perPage, source, scope } = {}) {
-    return this.listRequirements({ page, per_page: perPage, source, scope });
-  },
-
   listMilestones({ page, per_page: perPage, type, status } = {}) {
     return this.apiClient.list('milestones', { page, per_page: perPage, type, status });
   },

package/src/mcp/tool-definitions.js

@@ -1,4 +1,5 @@
 import { SYSTEM_TOOLS } from './definitions/system.js';
+import { PROJECT_TOOLS } from './definitions/projects.js';
 import { TESTS_TOOLS } from './definitions/tests.js';
 import { SUITES_TOOLS } from './definitions/suites.js';
 import { RUNS_TOOLS } from './definitions/runs.js';
@@ -12,9 +13,12 @@ import { MILESTONES_TOOLS } from './definitions/milestones.js';
 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';
 
-export const TOOL_DEFINITIONS = [
+export const TOOL_DEFINITIONS = withListOptions([
   ...SYSTEM_TOOLS,
+  ...PROJECT_TOOLS,
   ...TESTS_TOOLS,
   ...SUITES_TOOLS,
   ...RUNS_TOOLS,
@@ -26,6 +30,7 @@ export const TOOL_DEFINITIONS = [
   ...TAGS_TOOLS,
   ...MILESTONES_TOOLS,
   ...ISSUES_TOOLS,
+  ...ATTACHMENT_TOOLS,
   ...PLANS_TOOLS,
   ...REQUIREMENTS_TOOLS,
-];
+]);

package/src/mcp/tool-profiles.js

@@ -0,0 +1,37 @@
+const RARE_ENTITIES = new Set(['steps', 'snippets', 'labels', 'rungroups']);
+
+function entityOf(name) {
+  if (name === 'system_ping') return 'system';
+  return name
+    .split('_attachments_')[0]
+    .split('_issues_')[0]
+    .replace(/_(list|get|create|update|delete|search)$/, '');
+}
+
+function isAttachment(name) {
+  return name.includes('_attachments_');
+}
+
+function isReadOp(name) {
+  return name === 'system_ping' || /_(list|get)$/.test(name) || name.endsWith('_issues_list');
+}
+
+/**
+ * Whether a tool is visible under the given profile. Unknown profiles fall back to full
+ *
+ * @param {string} name     tool name
+ * @param {string} profile  'full' | 'core' | 'read'
+ */
+export function isToolInProfile(name, profile) {
+  if (!profile || profile === 'full') return true;
+  if (isAttachment(name)) return false;
+  const coreEntity = !RARE_ENTITIES.has(entityOf(name));
+  if (profile === 'core') return coreEntity;
+  if (profile === 'read') return coreEntity && isReadOp(name);
+  return true;
+}
+
+export function selectTools(allTools, profile) {
+  if (!profile || profile === 'full') return allTools;
+  return allTools.filter((tool) => tool && isToolInProfile(tool.name, profile));
+}

package/src/mcp/tool-registry.js

@@ -2,13 +2,41 @@ import { DEFAULT_TOOL_RESPONSE } from '../config/constants.js';
 import { ApiError, NotImplementedToolError } from '../core/errors.js';
 import { textResponse } from '../helpers/mcp-response.js';
 import { TOOL_DEFINITIONS } from './tool-definitions.js';
+import { TQL_FULL_REFERENCE } from './definitions/tql-reference.js';
 import { handlerMethods } from './registry/handlers.js';
+import { attachmentMethods } from './registry/attachments.js';
 import { issueMethods } from './registry/issues.js';
 import { listingMethods } from './registry/listings.js';
 import { payloadMethods } from './registry/payloads.js';
 
+function withPagination(payload) {
+  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
+    return payload;
+  }
+  const meta = payload.meta;
+  if (!Array.isArray(payload.data) || !meta || typeof meta !== 'object') {
+    return payload;
+  }
+  const { total, page, per_page: perPage } = meta;
+  if (
+    typeof total !== 'number' ||
+    typeof page !== 'number' ||
+    typeof perPage !== 'number' ||
+    perPage <= 0
+  ) {
+    return payload;
+  }
+  if (page * perPage < total) {
+    return {
+      ...payload,
+      _note: `Showing ${payload.data.length} of ${total} (page ${page}). More available — refine the filter or request the next page.`,
+    };
+  }
+  return payload;
+}
+
 function formatJson(payload) {
-  return JSON.stringify(payload, null, 2);
+  return JSON.stringify(payload);
 }
 
 export class ToolRegistry {
@@ -22,7 +50,7 @@ export class ToolRegistry {
   }
 
   asText(payload) {
-    return textResponse(formatJson(payload));
+    return textResponse(formatJson(withPagination(payload)));
   }
 
   buildHandlers() {
@@ -34,10 +62,12 @@ export class ToolRegistry {
           baseUrl: this.config.baseUrl,
           apiVersion: 'v2',
         }),
+      tql_help: async () => textResponse(TQL_FULL_REFERENCE),
     };
 
     this.registerEntityCrudHandlers(handlers);
     this.registerScopedIssueHandlers(handlers);
+    this.registerScopedAttachmentHandlers(handlers);
     this.registerGlobalHandlers(handlers);
     for (const registerHandlers of this.handlerRegistrars) {
       registerHandlers.call(this, handlers);
@@ -80,6 +110,7 @@ export class ToolRegistry {
 Object.assign(
   ToolRegistry.prototype,
   handlerMethods,
+  attachmentMethods,
   listingMethods,
   issueMethods,
   payloadMethods