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

package/package.json

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

package/src/mcp/definitions/shares.js

@@ -0,0 +1,110 @@
+export const SHARES_TOOLS = [
+  {
+    "name": "tests_share",
+    "description": "Share tests into a suite of another project (/api/v2/{project_id}/shares/tests). Select tests by test_ids, labels, or both (combined). The source project stays the single source of truth; shared copies in the target project are read-only until unlinked. Re-sharing into the same target project does not duplicate. Requests are processed asynchronously: status 'queued' means accepted, not completed. Matched tests that are themselves shared copies are skipped and listed in skipped_test_ids. Source and target projects must be of the same type (Classic/BDD).",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "test_ids": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Test IDs to share. At least one of test_ids/labels is required. Max 1000 tests per request."
+        },
+        "labels": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Label slugs or titles; every test carrying any of these labels is shared, in addition to test_ids."
+        },
+        "target_project_id": {
+          "type": "string",
+          "description": "Project ID (slug) of the destination project. Must be accessible to the current user."
+        },
+        "target_suite_id": {
+          "type": "string",
+          "description": "Suite ID in the target project to place the shared tests into. Must be a file-type suite, not a folder."
+        }
+      },
+      "required": [
+        "target_project_id",
+        "target_suite_id"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "suites_share",
+    "description": "Share suites (with their tests) into one or more other projects (/api/v2/{project_id}/shares/suites). Select suites by suite_ids, labels, or both (combined). File-type suites are linked (read-only copies that stay in sync); folder suites are deep-copied as regular editable copies. Re-sharing a linked suite into a project that already has it does not duplicate. Suites that are themselves shared copies link to their original source. Omit destination_folder_id to share into the root of the target project(s). Requests are processed asynchronously: status 'queued' means accepted, not completed. Source and target projects must be of the same type (Classic/BDD).",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "suite_ids": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Suite IDs to share. At least one of suite_ids/labels is required. Max 200 suites per request."
+        },
+        "labels": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Label slugs or titles; every suite carrying any of these labels is shared, in addition to suite_ids."
+        },
+        "target_project_ids": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Project IDs (slugs) of the destination projects. Must be accessible to the current user."
+        },
+        "destination_folder_id": {
+          "type": "string",
+          "description": "Folder suite ID in the target project to place the shared suites into. Only allowed when sharing to a single target project."
+        }
+      },
+      "required": [
+        "target_project_ids"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "tests_unshare",
+    "description": "Remove a test's share, converting the shared copy back into a regular, editable test (/api/v2/{project_id}/shares/tests/{id}). Only the shared copy can be targeted — the original source test is untouched. Must be called against the project that holds the shared copy.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "test_id": {
+          "type": "string",
+          "description": "ID of the shared test copy to unlink."
+        }
+      },
+      "required": [
+        "test_id"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "suites_unshare",
+    "description": "Remove a suite's share, converting the shared copy back into a regular, editable suite (/api/v2/{project_id}/shares/suites/{id}). Only the shared (linked) copy can be targeted — the original source suite is untouched. Must be called against the project that holds the shared copy.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "suite_id": {
+          "type": "string",
+          "description": "ID of the shared suite copy to unlink."
+        }
+      },
+      "required": [
+        "suite_id"
+      ],
+      "additionalProperties": false
+    }
+  }
+];

package/src/mcp/registry/shares.js

@@ -0,0 +1,53 @@
+export const shareMethods = {
+  registerShareHandlers(handlers) {
+    handlers.tests_share = async (args = {}) => {
+      const payload = {
+        target_project_id: this.pickRequiredArg(args, 'target_project_id'),
+        target_suite_id: this.pickRequiredArg(args, 'target_suite_id'),
+      };
+      this.pickSelectionArgs(args, ['test_ids', 'labels'], payload);
+      return this.asText(await this.apiClient.create('shares/tests', payload));
+    };
+
+    handlers.suites_share = async (args = {}) => {
+      const payload = {
+        target_project_ids: this.pickRequiredArg(args, 'target_project_ids'),
+      };
+      this.pickSelectionArgs(args, ['suite_ids', 'labels'], payload);
+      if (args.destination_folder_id !== undefined) {
+        payload.destination_folder_id = args.destination_folder_id;
+      }
+      return this.asText(await this.apiClient.create('shares/suites', payload));
+    };
+
+    handlers.tests_unshare = async (args = {}) =>
+      this.asText(await this.apiClient.delete('shares/tests', this.pickRequiredArg(args, 'test_id')));
+
+    handlers.suites_unshare = async (args = {}) =>
+      this.asText(
+        await this.apiClient.delete('shares/suites', this.pickRequiredArg(args, 'suite_id'))
+      );
+  },
+
+  /**
+   * Copy the selection args (e.g. test_ids/labels) into the payload, requiring at least
+   * one of them — the API rejects a share request without a selection.
+   */
+  pickSelectionArgs(args = {}, keys, payload) {
+    const provided = keys.filter((key) => {
+      const value = args[key];
+      if (value === undefined || value === null || value === '') return false;
+      if (Array.isArray(value) && value.length === 0) return false;
+      return true;
+    });
+
+    if (provided.length === 0) {
+      throw new Error(`Provide at least one selection argument: ${keys.join(', ')}.`);
+    }
+
+    for (const key of provided) {
+      payload[key] = args[key];
+    }
+    return provided;
+  },
+};

package/src/mcp/tool-definitions.js

@@ -2,6 +2,7 @@ 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 { SHARES_TOOLS } from './definitions/shares.js';
 import { RUNS_TOOLS } from './definitions/runs.js';
 import { TESTRUNS_TOOLS } from './definitions/testruns.js';
 import { RUNGROUPS_TOOLS } from './definitions/rungroups.js';
@@ -22,6 +23,7 @@ export const TOOL_DEFINITIONS = withCountGroupOptions(withListOptions([
   ...PROJECT_TOOLS,
   ...TESTS_TOOLS,
   ...SUITES_TOOLS,
+  ...SHARES_TOOLS,
   ...RUNS_TOOLS,
   ...TESTRUNS_TOOLS,
   ...RUNGROUPS_TOOLS,

package/src/mcp/tool-registry.js

@@ -8,6 +8,7 @@ import { attachmentMethods } from './registry/attachments.js';
 import { issueMethods } from './registry/issues.js';
 import { listingMethods } from './registry/listings.js';
 import { payloadMethods } from './registry/payloads.js';
+import { shareMethods } from './registry/shares.js';
 
 function withPagination(payload) {
   if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
@@ -72,6 +73,7 @@ export class ToolRegistry {
     this.registerScopedIssueHandlers(handlers);
     this.registerScopedAttachmentHandlers(handlers);
     this.registerGlobalHandlers(handlers);
+    this.registerShareHandlers(handlers);
     for (const registerHandlers of this.handlerRegistrars) {
       registerHandlers.call(this, handlers);
     }
@@ -116,5 +118,6 @@ Object.assign(
   attachmentMethods,
   listingMethods,
   issueMethods,
-  payloadMethods
+  payloadMethods,
+  shareMethods
 );