@testomatio/mcp 2.1.2 → 2.2.0-beta.1

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';
@@ -13,9 +14,11 @@ 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,
@@ -30,4 +33,4 @@ export const TOOL_DEFINITIONS = [
   ...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,14 +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 {
@@ -23,7 +50,7 @@ export class ToolRegistry {
   }
 
   asText(payload) {
-    return textResponse(formatJson(payload));
+    return textResponse(formatJson(withPagination(payload)));
   }
 
   buildHandlers() {
@@ -35,6 +62,7 @@ export class ToolRegistry {
           baseUrl: this.config.baseUrl,
           apiVersion: 'v2',
         }),
+      tql_help: async () => textResponse(TQL_FULL_REFERENCE),
     };
 
     this.registerEntityCrudHandlers(handlers);