@testomatio/mcp 1.0.8 → 1.0.11

package/README.md

@@ -2,6 +2,8 @@
 
 A Model Context Protocol (MCP) server for Testomat.io API integration with AI assistants like Cursor.
 
+<img width="1920" height="1085" alt="image" src="https://github.com/user-attachments/assets/cf823e8b-1305-4ed2-a7c5-712efec12ceb" />
+
 ## Installation
 
 ### Prerequisites
@@ -62,6 +64,17 @@ Your project ID can be found in the URL when you're viewing your project:
 https://app.testomat.io/projects/YOUR_PROJECT_ID
 ```
 
+### ID Formats
+
+Testomatio uses specific ID formats for different resources:
+
+- **Test IDs**: Start with `T` prefix followed by 7 alphanumeric characters (e.g., `Ta1b2c3d4`)
+- **Suite IDs**: Start with `S` prefix followed by 7 alphanumeric characters (e.g., `Sx9y8z7w6`)
+- **Total length**: 8 characters including the prefix
+- **Format**: `[Prefix][7 alphanumeric characters]`
+
+When working with tools that require specific IDs, ensure you use the correct format with the appropriate prefix.
+
 ## Integration with Cursor
 
 To use this MCP server with Cursor, add the following configuration to your Cursor settings:
@@ -111,6 +124,7 @@ Then add this to your Cursor MCP settings:
 
 #### Tests
 * `get_tests` – Get all tests (params: `plan`, `query`, `state`, `suite_id`, `tag`, `labels`) — api: GET `/tests`
+* `get_test` – Get a specific test by ID with all information including labels, tags, and metadata (params: `test_id`) — api: GET `/tests/{test_id}`
 * `search_tests` – Search tests (params: `query`, `tql`, `labels`, `state`, `priority`, `filter`, `page`) — api: GET `/tests`
 * `create_test` – Create a new test (params: `suite_id`, `title`, `description`, `code`, `file`, `state`, `tags`, `jira_issues`, `assigned_to`, `labels_ids`, `fields`) — api: POST `/tests`
 * `update_test` – Update an existing test (params: `test_id`, `suite_id`, `title`, `description`, `code`, `file`, `state`, `tags`, `jira_issues`, `assigned_to`, `labels_ids`, `fields`) — api: PUT `/tests/{test_id}`
@@ -123,7 +137,9 @@ Then add this to your Cursor MCP settings:
 * `create_folder` – Create a new folder (params: `title`, `description`, `parent_id`, `fields`) — api: POST `/suites`
 
 #### Labels
-* `create_label` – Create a new label with optional custom field (params: `title`, `color`, `scope`, `visibility`, `field`) — api: POST `/labels`
+* `get_labels` – Get all available labels with their IDs and configurations
+* `create_label` – Create a new label with optional custom field
+* `unlink_label` – Remove a label from a test or suite
 
 ### Custom Fields and Labels
 
@@ -200,15 +216,16 @@ The MCP server provides two distinct ways to assign values to tests, suites, and
 Once configured, you can ask your AI assistant questions like:
 
 - "Show me all the tests in the project"
-- "Get the test runs for test ID abc123"
+- "Get details for test ID Ta1b2c3d4"
+- "Get the test runs for test ID Ta1b2c3d4"
 - "What are the root suites in this project?"
 - "Show me details for test run xyz789"
 - "List all automated tests with the @smoke tag"
 - "Get all test plans for this project"
-- "Create a new test called 'Login validation' in suite suite-123"
-- "Update test test-456 to change its description and add @regression tag"
+- "Create a new test called 'Login validation' in suite Sx9y8z7w6"
+- "Update test Ta1b2c3d4 to change its description and add @regression tag"
 - "Create a test with custom fields: priority='high', severity='critical', team='backend'"
-- "Update test test-789 to set custom fields for risk score and assigned team"
+- "Update test Tb2c3d4e5 to set custom fields for risk score and assigned team"
 - "Create a new suite called 'Authentication Tests' with description 'All login and signup related tests'"
 - "Create a suite with custom fields for team ownership and priority level"
 - "Create a folder called 'API Tests' to organize API-related test suites with custom fields"
@@ -229,11 +246,11 @@ These queries retrieve general information without specific filtering:
 
 These queries allow creating and updating tests:
 
-- **"Create a new test called 'Login validation' in suite suite-123"** → `create_test` tool with `title: "Login validation"`, `suite_id: "suite-123"`
-- **"Update test test-456 to change its description"** → `update_test` tool with `test_id: "test-456"`, `description: "new description"`
+- **"Create a new test called 'Login validation' in suite Sx9y8z7w6"** → `create_test` tool with `title: "Login validation"`, `suite_id: "Sx9y8z7w6"`
+- **"Update test Ta1b2c3d4 to change its description"** → `update_test` tool with `test_id: "Ta1b2c3d4"`, `description: "new description"`
 - **"Create an automated test with @smoke tag"** → `create_test` tool with `state: "automated"`, `tags: ["smoke"]`
-- **"Create a test with custom fields: priority='high', severity='critical'"** → `create_test` tool with `title: "Test Title"`, `suite_id: "suite-123"`, `fields: { "priority": "high", "severity": "critical" }`
-- **"Update test test-789 to set custom fields for risk score and team"** → `update_test` tool with `test_id: "test-789"`, `fields: { "risk_score": "8.5", "team": "backend" }`
+- **"Create a test with custom fields: priority='high', severity='critical'"** → `create_test` tool with `title: "Test Title"`, `suite_id: "Sx9y8z7w6"`, `fields: { "priority": "high", "severity": "critical" }`
+- **"Update test Tb2c3d4e5 to set custom fields for risk score and team"** → `update_test` tool with `test_id: "Tb2c3d4e5"`, `fields: { "risk_score": "8.5", "team": "backend" }`
 
 ### Suite and Folder Management Queries
 
@@ -242,7 +259,7 @@ These queries help organize your test structure:
 - **"Create a new suite called 'Authentication Tests'"** → `create_suite` tool with `title: "Authentication Tests"`
 - **"Create a suite for login tests with description"** → `create_suite` tool with `title: "Login Tests"`, `description: "All login related test cases"`
 - **"Create a suite with custom fields for team ownership and priority level"** → `create_suite` tool with `title: "Backend Tests"`, `fields: { "team": "backend", "priority": "high" }`
-- **"Create a folder called 'API Tests' under parent suite-123"** → `create_folder` tool with `title: "API Tests"`, `parent_id: "suite-123"`
+- **"Create a folder called 'API Tests' under parent suite Sx9y8z7w6"** → `create_folder` tool with `title: "API Tests"`, `parent_id: "Sx9y8z7w6"`
 - **"Create a folder with custom fields for team and project"** → `create_folder` tool with `title: "Integration Tests"`, `fields: { "team": "qa", "project": "mobile-app" }`
 - **"Create a test suite for payment features"** → `create_suite` tool with `title: "Payment Features", description: "Tests covering payment processing"`
 - **"Create a folder to organize integration tests"** → `create_folder` tool with `title: "Integration Tests"`
@@ -262,9 +279,10 @@ These queries help create custom labels for better test categorization:
 
 These queries target specific entities by ID:
 
-- **"Get test runs for test ID abc123"** → `get_testruns` tool with `test_id: "abc123"`
+- **"Get details for test ID Ta1b2c3d4"** → `get_test` tool with `test_id: "Ta1b2c3d4"`
+- **"Get test runs for test ID Ta1b2c3d4"** → `get_testruns` tool with `test_id: "Ta1b2c3d4"`
 - **"Show me details for test run xyz789"** → `get_run` tool with `run_id: "xyz789"`
-- **"Get suite details for suite-456"** → `get_suite` tool with `suite_id: "suite-456"`
+- **"Get suite details for suite Sx9y8z7w6"** → `get_suite` tool with `suite_id: "Sx9y8z7w6"`
 
 ### Search and Filter Queries
 

package/index.js

@@ -116,6 +116,20 @@ class TestomatioMCPServer {
               },
             },
           },
+          {
+            name: 'get_test',
+            description: 'Get a specific test by its ID with all information including labels, tags, and metadata',
+            inputSchema: {
+              type: 'object',
+              properties: {
+                test_id: {
+                  type: 'string',
+                  description: 'The ID of the test to retrieve',
+                },
+              },
+              required: ['test_id'],
+            },
+          },
           {
             name: 'search_tests',
             description: 'Search tests by keywords, tags, labels, TQL queries, and other filters',
@@ -303,7 +317,7 @@ class TestomatioMCPServer {
                 },
                 title: {
                   type: 'string',
-                  description: 'Test title',
+                  description: 'Test title. @tags in the title (e.g., "@smoke test") will be automatically extracted as tags',
                 },
                 description: {
                   type: 'string',
@@ -325,7 +339,7 @@ class TestomatioMCPServer {
                 tags: {
                   type: 'array',
                   items: { type: 'string' },
-                  description: 'List of tags for the test',
+                  description: 'List of @tags for the test. Tags are automatically extracted from @ mentions in the title (e.g., @smoke, @regression). Can also be provided as an array of tag names (without @ prefix).',
                 },
                 jira_issues: {
                   type: 'array',
@@ -368,7 +382,7 @@ class TestomatioMCPServer {
                 },
                 title: {
                   type: 'string',
-                  description: 'Test title',
+                  description: 'Test title. @tags in the title (e.g., "@smoke test") will be automatically extracted as tags',
                 },
                 description: {
                   type: 'string',
@@ -395,7 +409,7 @@ class TestomatioMCPServer {
                 tags: {
                   type: 'array',
                   items: { type: 'string' },
-                  description: 'List of tags for the test',
+                  description: 'List of @tags for the test. Tags are automatically extracted from @ mentions in the title (e.g., @smoke, @regression). Can also be provided as an array of tag names (without @ prefix).',
                 },
                 jira_issues: {
                   type: 'array',
@@ -480,6 +494,57 @@ class TestomatioMCPServer {
               required: ['title'],
             },
           },
+          {
+            name: 'get_labels',
+            description: 'Get all available labels for the project with their IDs and configurations',
+            inputSchema: {
+              type: 'object',
+              properties: {
+                scope: {
+                  type: 'array',
+                  items: {
+                    type: 'string',
+                    enum: ['tests', 'suites']
+                  },
+                  description: 'Filter labels by scope (e.g., ["tests"], ["suites"], or ["tests", "suites"])',
+                },
+                page: {
+                  type: 'number',
+                  description: 'Page number for pagination',
+                },
+              },
+            },
+          },
+          {
+            name: 'unlink_label',
+            description: 'Remove a label from a test or suite. Can remove specific label values or all instances of the label',
+            inputSchema: {
+              type: 'object',
+              properties: {
+                label_id: {
+                  type: 'string',
+                  description: 'Label ID to remove (e.g., "priority", "severity")',
+                },
+                test_id: {
+                  type: 'string',
+                  description: 'Test ID to remove label from (use either test_id or suite_id)',
+                },
+                suite_id: {
+                  type: 'string',
+                  description: 'Suite ID to remove label from (use either test_id or suite_id)',
+                },
+                value: {
+                  type: 'string',
+                  description: 'Specific label value to remove (e.g., "high", "critical"). If omitted, all instances are removed',
+                },
+              },
+              required: ['label_id'],
+              oneOf: [
+                { required: ['test_id'] },
+                { required: ['suite_id'] }
+              ],
+            },
+          },
           {
             name: 'create_label',
             description: 'Create a new label with optional custom field configuration. Labels can be used to tag and categorize tests and suites',
@@ -543,6 +608,8 @@ class TestomatioMCPServer {
         switch (name) {
           case 'get_tests':
             return await this.getTests(args);
+          case 'get_test':
+            return await this.getTest(args.test_id);
           case 'search_tests':
             return await this.searchTests(args);
           case 'search_suites':
@@ -561,6 +628,10 @@ class TestomatioMCPServer {
             return await this.getPlans(args);
           case 'get_plan':
             return await this.getPlan(args.plan_id);
+          case 'get_labels':
+            return await this.getLabels(args);
+          case 'unlink_label':
+            return await this.unlinkLabel(args);
           case 'create_test':
             return await this.createTest(args);
           case 'update_test':
@@ -773,11 +844,16 @@ class TestomatioMCPServer {
 
   async getTests(filters = {}) {
     const params = this.buildSearchParams(filters);
+    // Add labels=true and detail=true for comprehensive test information
+    params.labels = 'true';
+    params.detail = 'true';
+
     const data = await this.makeRequest('/tests', params);
     const formattedTests = data.data.map(test =>
       this.formatModel(test, 'test', [
-        'title', 'description', 'code', 'priority',
-        'state', 'suite-id', 'tags', 'file'
+        'title', 'description', 'code', 'priority', 'state',
+        'suite-id', 'tags', 'file', 'jira-issues', 'assigned-to',
+        'created-at', 'updated-at', 'labels'
       ])
     ).join('\n\n');
 
@@ -791,6 +867,25 @@ class TestomatioMCPServer {
     };
   }
 
+  async getTest(testId) {
+    // Add labels=true and detail=true for comprehensive test information
+    const data = await this.makeRequest(`/tests/${testId}`, { labels: 'true', detail: 'true' });
+    const formattedTest = this.formatModel(data.data, 'test', [
+      'title', 'description', 'code', 'priority', 'state',
+      'suite-id', 'tags', 'file', 'jira-issues', 'assigned-to',
+      'created-at', 'updated-at', 'labels'
+    ]);
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Test ${testId}:\n\n${formattedTest}`,
+        },
+      ],
+    };
+  }
+
   buildSearchParams(filters = {}) {
     const params = {};
 
@@ -838,12 +933,17 @@ class TestomatioMCPServer {
 
   async searchTests(filters = {}) {
     const params = this.buildSearchParams(filters);
+    // Add labels=true and detail=true for comprehensive test information
+    params.labels = 'true';
+    params.detail = 'true';
+
     const data = await this.makeRequest('/tests', params);
 
     const formattedTests = data.data.map(test =>
       this.formatModel(test, 'test', [
-        'title', 'description', 'code', 'priority',
-        'state', 'suite-id', 'tags', 'file'
+        'title', 'description', 'code', 'priority', 'state',
+        'suite-id', 'tags', 'file', 'jira-issues', 'assigned-to',
+        'created-at', 'updated-at', 'labels'
       ])
     ).join('\n\n');
 
@@ -1072,9 +1172,91 @@ class TestomatioMCPServer {
     };
   }
 
+  async getLabels(filters = {}) {
+    const params = {};
+
+    // Handle scope filter
+    if (filters.scope && Array.isArray(filters.scope)) {
+      if (!params['scope[]']) {
+        params['scope[]'] = [];
+      }
+      filters.scope.forEach(scope => {
+        params['scope[]'].push(scope);
+      });
+    }
+
+    // Handle pagination
+    if (filters.page) {
+      params.page = filters.page;
+    }
+
+    const data = await this.makeRequest('/labels', params);
+    const formattedLabels = data.data.map(label =>
+      this.formatModel(label, 'label', [
+        'title', 'color', 'scope', 'visibility', 'field'
+      ])
+    ).join('\n\n');
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Available labels for project ${this.config.projectId}:\n\n${formattedLabels || 'No labels found matching the criteria.'}`,
+        },
+      ],
+    };
+  }
+
+  extractTagsFromTitle(title) {
+    if (!title) return [];
+
+    // Find all @tags in the title
+    const tagMatches = title.match(/@([a-zA-Z0-9_\-]+)/g);
+
+    if (!tagMatches) return [];
+
+    // Remove @ prefix and deduplicate
+    const tags = tagMatches
+      .map(tag => tag.substring(1)) // Remove @
+      .filter(tag => tag.length > 0); // Filter out empty tags
+
+    return [...new Set(tags)]; // Remove duplicates
+  }
+
+  mergeTags(explicitTags, titleTags) {
+    const allTags = [];
+
+    // Add explicit tags (remove @ prefix if present)
+    if (explicitTags && Array.isArray(explicitTags)) {
+      allTags.push(...explicitTags.map(tag => tag.replace(/^@/, '')));
+    }
+
+    // Add tags extracted from title
+    if (titleTags && Array.isArray(titleTags)) {
+      allTags.push(...titleTags);
+    }
+
+    // Remove duplicates while preserving order
+    const uniqueTags = [];
+    const seen = new Set();
+
+    for (const tag of allTags) {
+      if (!seen.has(tag) && tag.length > 0) {
+        seen.add(tag);
+        uniqueTags.push(tag);
+      }
+    }
+
+    return uniqueTags;
+  }
+
   async createTest(args) {
     const { suite_id, labels_ids, fields, ...attributes } = args;
 
+    // Extract tags from title if provided
+    const titleTags = this.extractTagsFromTitle(attributes.title);
+    const mergedTags = this.mergeTags(attributes.tags, titleTags);
+
     // Convert attributes to use hyphens instead of underscores for API compatibility
     const apiAttributes = Object.fromEntries(
       Object.entries(attributes).map(([k, v]) => [k.replace(/_/g, '-'), v])
@@ -1085,12 +1267,16 @@ class TestomatioMCPServer {
       apiAttributes['suite_id'] = suite_id;
     }
 
-    // Handle fields parameter for custom fields
+    // Build JSON-API request data
     const requestData = {
-      test: {
-        ...apiAttributes,
-        ...(labels_ids && { labels_ids: labels_ids }),
-        ...(fields && { custom_fields: fields })
+      data: {
+        type: 'tests',
+        attributes: {
+          ...apiAttributes,
+          ...(mergedTags.length > 0 && { tags: mergedTags }),
+          ...(labels_ids && { labels_ids: labels_ids }),
+          ...(fields && { 'custom-fields': fields })
+        }
       }
     };
 
@@ -1110,9 +1296,87 @@ class TestomatioMCPServer {
     };
   }
 
+  async linkLabels(testId, labelsIds) {
+    if (!labelsIds || labelsIds.length === 0) {
+      return;
+    }
+
+    // Process each label individually using the label linking API
+    for (const labelId of labelsIds) {
+      // Parse label:value format if present
+      let labelUid = labelId;
+      let value = null;
+
+      if (labelId.includes(':')) {
+        [labelUid, value] = labelId.split(':', 2);
+      }
+
+      // Build URL with test_id query parameter
+      let url = `/labels/${labelUid}/link?test_id=${testId}`;
+
+      // Add value as query parameter if present
+      if (value) {
+        url += `&value=${encodeURIComponent(value)}`;
+      }
+
+      await this.makePostRequest(url, {});
+    }
+  }
+
+  async unlinkLabel(args) {
+    const { label_id, test_id, suite_id, value } = args;
+
+    // Validate that either test_id or suite_id is provided
+    if (!test_id && !suite_id) {
+      throw new Error('Either test_id or suite_id must be provided');
+    }
+
+    if (test_id && suite_id) {
+      throw new Error('Cannot specify both test_id and suite_id. Use one or the other.');
+    }
+
+    // Build URL with base label link endpoint
+    let url = `/labels/${label_id}/link`;
+
+    // Add appropriate query parameters
+    if (test_id) {
+      url += `?test_id=${test_id}`;
+    } else if (suite_id) {
+      url += `?suite_id=${suite_id}`;
+    }
+
+    // Add event=remove parameter
+    url += `&event=remove`;
+
+    // Add value as query parameter if present
+    if (value) {
+      url += `&value=${encodeURIComponent(value)}`;
+    }
+
+    // Make the API request
+    await this.makePostRequest(url, {});
+
+    const itemType = test_id ? 'test' : 'suite';
+    const itemId = test_id || suite_id;
+    const removeDescription = value ? `value "${value}"` : 'all instances';
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Successfully removed label "${label_id}" (${removeDescription}) from ${itemType} "${itemId}"`,
+        },
+      ],
+    };
+  }
+
   async updateTest(args) {
     const { test_id, suite_id, labels_ids, fields, ...attributes } = args;
 
+    // Extract tags from title if provided
+    const titleTags = this.extractTagsFromTitle(attributes.title);
+    const mergedTags = this.mergeTags(attributes.tags, titleTags);
+
     // Convert attributes to use hyphens instead of underscores for API compatibility
     const apiAttributes = Object.fromEntries(
       Object.entries(attributes).map(([k, v]) => [k.replace(/_/g, '-'), v])
@@ -1125,29 +1389,27 @@ class TestomatioMCPServer {
 
     let data;
 
-    // Handle labels_ids using the bulk labels endpoint
-    if (labels_ids && labels_ids.length > 0) {
-      const labelsRequest = {
-        items: {
-          test: [test_id]
-        },
-        add_labels: labels_ids
-      };
-
-      await this.makePutRequest('/bulk/labels', labelsRequest);
-
-      // After updating labels, fetch the updated test
-      data = await this.makeRequest(`/tests/${test_id}`);
-    } else {
-      // Handle regular test attributes update
-      const requestData = {
-        test: {
+    // Handle regular test attributes update using JSON-API format
+    const requestData = {
+      data: {
+        id: test_id,
+        type: 'tests',
+        attributes: {
           ...apiAttributes,
-          ...(fields && { custom_fields: fields })
+          ...(mergedTags.length > 0 && { tags: mergedTags }),
+          ...(fields && { 'custom-fields': fields })
         }
-      };
+      }
+    };
 
-      data = await this.makePutRequest(`/tests/${test_id}`, requestData);
+    data = await this.makePutRequest(`/tests/${test_id}`, requestData);
+
+    // Handle labels_ids using the label linking API
+    if (labels_ids && labels_ids.length > 0) {
+      await this.linkLabels(test_id, labels_ids);
+
+      // After linking labels, fetch the updated test to reflect changes
+      data = await this.makeRequest(`/tests/${test_id}`);
     }
 
     const formattedTest = this.formatModel(data.data, 'test', [

package/package.json

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