@testomatio/mcp 1.0.2 → 1.0.4

package/README.md

@@ -119,6 +119,11 @@ Then add this to your Cursor MCP settings:
 * `search_suites` – Search suites (params: `query`, `labels`, `state`, `priority`, `page`) — api: GET `/suites`
 * `get_root_suites` – List root-level suites (no params) — api: GET `/suites`
 * `get_suite` – Get one suite (params: `suite_id`) — api: GET `/suites/{suite_id}`
+* `create_suite` – Create a new suite (params: `title`, `description`, `parent_id`) — api: POST `/suites`
+* `create_folder` – Create a new folder (params: `title`, `description`, `parent_id`) — api: POST `/suites`
+
+#### Labels
+* `create_label` – Create a new label with optional custom field (params: `title`, `color`, `scope`, `visibility`, `field`) — api: POST `/labels`
 
 #### Test Runs
 * `get_runs` – List all runs (no params) — api: GET `/runs`
@@ -141,6 +146,9 @@ Once configured, you can ask your AI assistant questions like:
 - "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 suite called 'Authentication Tests' with description 'All login and signup related tests'"
+- "Create a folder called 'API Tests' to organize API-related test suites"
+- "Create a label called 'Severity' with color '#ffe9ad' and predefined values like 'Blocker', 'Critical', 'Major', 'Minor', 'Normal', 'Trivial'"
 
 ## Query Patterns
 
@@ -161,6 +169,27 @@ These queries allow creating and updating tests:
 - **"Update test test-456 to change its description"** → `update_test` tool with `test_id: "test-456"`, `description: "new description"`
 - **"Create an automated test with @smoke tag"** → `create_test` tool with `state: "automated"`, `tags: ["smoke"]`
 
+### Suite and Folder Management Queries
+
+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 folder called 'API Tests' under parent suite-123"** → `create_folder` tool with `title: "API Tests"`, `parent_id: "suite-123"`
+- **"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"`
+
+**Note**: Suites can only contain other suites, while folders can contain both suites and folders (but no tests).
+
+### Label Creation Queries
+
+These queries help create custom labels for better test categorization:
+
+- **"Create a label called 'Severity' with red color"** → `create_label` tool with `title: "Severity"`, `color: "#ff6b6b"`
+- **"Create a severity label with predefined values"** → `create_label` tool with `title: "Severity"`, `color: "#ffe9ad"`, `field: { "type": "list", "short": true, "value": "Blocker\nCritical\nMajor\nNormal\nMinor\nTrivial" }`
+- **"Create a simple label for test types"** → `create_label` tool with `title: "Test Type"`, `scope: ["tests", "suites"]`
+- **"Create a label visible in test lists"** → `create_label` tool with `title: "Category"`, `visibility: ["list"]`
+
 ### Specific Item Queries
 
 These queries target specific entities by ID:
@@ -174,9 +203,8 @@ These queries target specific entities by ID:
 These queries use advanced filtering capabilities:
 
 - **"List all automated tests with the @smoke tag"** → `search_tests` tool with `query: "@smoke"`, `state: "automated"`
-- **"Find tests with priority high"** → `search_tests` tool with `priority: "high"`
 - **"Search for tests containing 'login'"** → `search_tests` tool with `query: "login"`
-- **"List tests tagged @critical or labelled 'ux' with high priority"** → `search_tests` tool with `tql: "tag == 'critical' or label == 'ux' and priority == 'high'"`
+- **"List tests tagged @critical or labelled 'ux' with critical severity"** → `search_tests` tool with `tql: "tag == 'critical' or label == 'ux' and severity == 'critical'"`
 - **"Find tests linked to JIRA-123"** → `search_tests` tool with `tql: jira == 'BDCP-2'`
 
 ### Advanced Query Syntax
@@ -187,7 +215,7 @@ The `search_tests` tool supports TQL for complex filtering:
 
 ```
 "tag == 'smoke' and state == 'manual'"
-"priority == 'high' or label == 'ux'"
+"severity == 'critical' or label == 'ux'"
 ```
 
 #### Tag-Based Searches
@@ -247,6 +275,74 @@ For detailed information about the underlying Testomat.io API, refer to the [Tes
 
 Contributions are welcome! Please feel free to submit a Pull Request.
 
+### Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/testomatio/mcp.git
+cd mcp
+
+# Install dependencies
+npm install
+
+# Run unit tests
+npm test
+
+# Run integration tests (requires environment variables)
+npm run test:integration
+
+# Run all tests
+npm run test:all
+```
+
+### Testing
+
+The project includes comprehensive test coverage:
+
+- **Unit Tests**: Fast tests with mocked dependencies
+- **Integration Tests**: Real API tests against Testomat.io
+
+#### Running Tests Locally
+
+```bash
+# Unit tests only
+npm run test:unit
+
+# Integration tests (requires .env file)
+npm run test:integration
+
+# With coverage
+npm run test:coverage
+npm run test:coverage:integration
+```
+
+#### Environment Setup for Integration Tests
+
+Create a `.env` file:
+
+```bash
+TESTOMATIO_API_TOKEN=testomat_your_token_here
+TESTOMATIO_PROJECT_ID=your_project_id
+TESTOMATIO_BASE_URL=https://app.testomat.io  # optional
+```
+
+### CI/CD
+
+This project uses GitHub Actions for continuous integration:
+
+- ✅ **Unit Tests**: Run on every push/PR across Node.js 18, 20, 22
+- ✅ **Integration Tests**: Run daily and on main branch merges
+- ✅ **Coverage Reports**: Automatic upload to Codecov
+- ✅ **Security**: Secrets management for API credentials
+
+
+### Code Quality
+
+- Follow existing code style patterns
+- Add tests for new functionality
+- Update documentation when needed
+- Ensure all tests pass before submitting PRs
+
 ## License
 
 This project is licensed under the MIT License - see the LICENSE file for details.

package/index.js

@@ -41,17 +41,18 @@ class TestomatioMCPServer {
     });
 
     if (!response.ok) {
-      throw new Error(`Authentication failed: HTTP ${response.status}: ${response.statusText}`);
+      const errorText = await response.text();
+      throw new Error(`Authentication failed: HTTP ${response.status}: ${response.statusText}. Response: ${errorText}`);
     }
 
     const data = await response.json();
-    
+
     if (!data.jwt) {
       throw new Error('Authentication failed: No JWT token received in response');
     }
 
     this.jwtToken = data.jwt;
-    
+
     return this.jwtToken;
   }
 
@@ -358,6 +359,11 @@ class TestomatioMCPServer {
                   enum: ['manual', 'automated'],
                   description: 'State of the test',
                 },
+                priority: {
+                  type: 'string',
+                  enum: ['low', 'normal', 'high', 'critical'],
+                  description: 'Priority level of the test',
+                },
                 tags: {
                   type: 'array',
                   items: { type: 'string' },
@@ -381,6 +387,102 @@ class TestomatioMCPServer {
               required: ['test_id'],
             },
           },
+          {
+            name: 'create_suite',
+            description: 'Create a new suite. Suites can only contain other suites (no tests or folders)',
+            inputSchema: {
+              type: 'object',
+              properties: {
+                title: {
+                  type: 'string',
+                  description: 'Suite title',
+                },
+                description: {
+                  type: 'string',
+                  description: 'Suite description',
+                },
+                parent_id: {
+                  type: 'string',
+                  description: 'Parent suite ID to create this suite under',
+                },
+              },
+              required: ['title'],
+            },
+          },
+          {
+            name: 'create_folder',
+            description: 'Create a new folder. Folders can contain suites and folders (but no tests)',
+            inputSchema: {
+              type: 'object',
+              properties: {
+                title: {
+                  type: 'string',
+                  description: 'Folder title',
+                },
+                description: {
+                  type: 'string',
+                  description: 'Folder description',
+                },
+                parent_id: {
+                  type: 'string',
+                  description: 'Parent folder or suite ID to create this folder under',
+                },
+              },
+              required: ['title'],
+            },
+          },
+          {
+            name: 'create_label',
+            description: 'Create a new label with optional custom field configuration. Labels can be used to tag and categorize tests and suites',
+            inputSchema: {
+              type: 'object',
+              properties: {
+                title: {
+                  type: 'string',
+                  description: 'Label title (e.g., "Severity", "Priority", "Type")',
+                },
+                color: {
+                  type: 'string',
+                  description: 'Label color in hex format (e.g., "#ffe9ad")',
+                },
+                scope: {
+                  type: 'array',
+                  items: {
+                    type: 'string',
+                    enum: ['tests', 'suites']
+                  },
+                  description: 'Where this label can be used (e.g., ["tests", "suites"])',
+                },
+                visibility: {
+                  type: 'array',
+                  items: {
+                    type: 'string'
+                  },
+                  description: 'Where the label is visible (e.g., ["list"])',
+                },
+                field: {
+                  type: 'object',
+                  description: 'Custom field configuration for labels with predefined values',
+                  properties: {
+                    type: {
+                      type: 'string',
+                      description: 'Field type (e.g., "list", "string", "number")',
+                    },
+                    short: {
+                      type: 'boolean',
+                      description: 'Whether to display short version',
+                    },
+                    value: {
+                      type: 'string',
+                      description: 'Predefined values for the field (newline separated for list type)',
+                    },
+                  },
+                  required: ['type'],
+                },
+              },
+              required: ['title'],
+            },
+          },
         ],
       };
     });
@@ -414,6 +516,12 @@ class TestomatioMCPServer {
             return await this.createTest(args);
           case 'update_test':
             return await this.updateTest(args);
+          case 'create_suite':
+            return await this.createSuite(args);
+          case 'create_folder':
+            return await this.createFolder(args);
+          case 'create_label':
+            return await this.createLabel(args);
           default:
             throw new Error(`Unknown tool: ${name}`);
         }
@@ -433,9 +541,9 @@ class TestomatioMCPServer {
   async makeRequest(path, params = {}) {
     // Ensure we have a valid JWT token
     const jwt = await this.authenticate();
-    
+
     const url = new URL(`${this.config.baseUrl}/api/${this.config.projectId}${path}`);
-    
+
     // Add query parameters with proper array handling
     Object.entries(params).forEach(([key, value]) => {
       if (value !== undefined && value !== null) {
@@ -486,7 +594,7 @@ class TestomatioMCPServer {
         this.jwtToken = null;
         return this.makePostRequest(path, data);
       }
-      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+      throw new Error(`HTTP ${response.status}: ${response.statusText}; ${await response.text()}`);
     }
 
     return await response.json();
@@ -580,10 +688,10 @@ class TestomatioMCPServer {
   formatModel(model, tagName, fields) {
     const attributes = model.attributes || {};
     const lines = [`<${tagName}>`];
-    
+
     // Always include ID from root level
     lines.push(`  <id>${model.id || ''}</id>`);
-    
+
     // Process specified fields
     fields.forEach(field => {
       let value;
@@ -599,7 +707,7 @@ class TestomatioMCPServer {
       }
 
       const formattedValue = this.formatValue(value, field);
-      
+
       if (field === 'test' && typeof value === 'object') {
         // Special case for nested test objects
         lines.push(`  <test>${formattedValue}\n  </test>`);
@@ -607,7 +715,7 @@ class TestomatioMCPServer {
         lines.push(`  <${xmlFieldName}>${formattedValue}</${xmlFieldName}>`);
       }
     });
-    
+
     lines.push(`</${tagName}>`);
     return lines.join('\n');
   }
@@ -615,13 +723,13 @@ class TestomatioMCPServer {
   async getTests(filters = {}) {
     const params = this.buildSearchParams(filters);
     const data = await this.makeRequest('/tests', params);
-    const formattedTests = data.data.map(test => 
+    const formattedTests = data.data.map(test =>
       this.formatModel(test, 'test', [
-        'title', 'description', 'code', 'priority', 
+        'title', 'description', 'code', 'priority',
         'state', 'suite-id', 'tags', 'file'
       ])
     ).join('\n\n');
-    
+
     return {
       content: [
         {
@@ -634,7 +742,7 @@ class TestomatioMCPServer {
 
   buildSearchParams(filters = {}) {
     const params = {};
-    
+
     // Handle basic filters
     Object.entries(filters).forEach(([key, value]) => {
       if (value !== undefined && value !== null) {
@@ -680,16 +788,16 @@ class TestomatioMCPServer {
   async searchTests(filters = {}) {
     const params = this.buildSearchParams(filters);
     const data = await this.makeRequest('/tests', params);
-    
-    const formattedTests = data.data.map(test => 
+
+    const formattedTests = data.data.map(test =>
       this.formatModel(test, 'test', [
-        'title', 'description', 'code', 'priority', 
+        'title', 'description', 'code', 'priority',
         'state', 'suite-id', 'tags', 'file'
       ])
     ).join('\n\n');
-    
+
     const searchDescription = this.buildSearchDescription(filters);
-    
+
     return {
       content: [
         {
@@ -704,15 +812,15 @@ class TestomatioMCPServer {
     // Add filter=true for suites search to include tests
     const params = this.buildSearchParams({ ...filters, filter: true });
     const data = await this.makeRequest('/suites', params);
-    
-    const formattedSuites = data.data.map(suite => 
+
+    const formattedSuites = data.data.map(suite =>
       this.formatModel(suite, 'suite', [
         'title', 'description', 'test-count', 'is-root', 'file-type'
       ])
     ).join('\n\n');
-    
+
     const searchDescription = this.buildSearchDescription(filters);
-    
+
     return {
       content: [
         {
@@ -725,7 +833,7 @@ class TestomatioMCPServer {
 
   buildSearchDescription(filters) {
     const descriptions = [];
-    
+
     if (filters.query) {
       if (filters.query.startsWith('@')) {
         descriptions.push(`tagged with "${filters.query}"`);
@@ -735,41 +843,41 @@ class TestomatioMCPServer {
         descriptions.push(`containing "${filters.query}"`);
       }
     }
-    
+
     if (filters.tql) {
       descriptions.push(`matching TQL: "${filters.tql}"`);
     }
-    
+
     if (filters.labels && filters.labels.length > 0) {
       descriptions.push(`with labels: ${filters.labels.join(', ')}`);
     }
-    
+
     if (filters.state) {
       descriptions.push(`state: ${filters.state}`);
     }
-    
+
     if (filters.priority) {
       descriptions.push(`priority: ${filters.priority}`);
     }
-    
+
     if (filters.filter && typeof filters.filter === 'object') {
       const filterDesc = Object.entries(filters.filter)
         .map(([key, value]) => `${key}: ${value}`)
         .join(', ');
       descriptions.push(`filtered by: ${filterDesc}`);
     }
-    
+
     return descriptions.length > 0 ? ` (${descriptions.join(', ')})` : '';
   }
 
   async getRootSuites() {
     const data = await this.makeRequest('/suites');
-    const formattedSuites = data.data.map(suite => 
+    const formattedSuites = data.data.map(suite =>
       this.formatModel(suite, 'suite', [
         'title', 'description', 'test-count', 'is-root', 'file-type'
       ])
     ).join('\n\n');
-    
+
     return {
       content: [
         {
@@ -785,7 +893,7 @@ class TestomatioMCPServer {
     const formattedSuite = this.formatModel(data.data, 'suite', [
       'title', 'description', 'test-count', 'is-root', 'file-type'
     ]);
-    
+
     // Format child suites and tests if they exist
     let childContent = '';
     if (data.data.relationships?.children?.data) {
@@ -797,18 +905,18 @@ class TestomatioMCPServer {
         childContent += `\n\nChild Suites:\n${childSuites}`;
       }
     }
-    
+
     if (data.data.relationships?.tests?.data) {
       const tests = data.data.relationships.tests.data
         .map(test => this.formatModel(test, 'test', [
-          'title', 'description', 'code', 'priority', 
+          'title', 'description', 'code', 'priority',
           'state', 'suite-id', 'tags', 'file'
         ])).join('\n\n');
       if (tests) {
         childContent += `\n\nTests:\n${tests}`;
       }
     }
-    
+
     return {
       content: [
         {
@@ -821,13 +929,13 @@ class TestomatioMCPServer {
 
   async getRuns() {
     const data = await this.makeRequest('/runs');
-    const formattedRuns = data.data.map(run => 
+    const formattedRuns = data.data.map(run =>
       this.formatModel(run, 'run', [
         'status', 'title', 'tests-count', 'automated', 'duration',
         'passed', 'failed', 'skipped', 'created-at', 'finished-at'
       ])
     ).join('\n\n');
-    
+
     return {
       content: [
         {
@@ -845,7 +953,7 @@ class TestomatioMCPServer {
       'status', 'title', 'tests-count', 'automated', 'duration',
       'passed', 'failed', 'skipped', 'created-at', 'finished-at'
     ]);
-    
+
     return {
       content: [
         {
@@ -861,14 +969,14 @@ class TestomatioMCPServer {
     if (dateRange) {
       params.finished_at_date_range = dateRange;
     }
-    
+
     const data = await this.makeRequest('/testruns', params);
-    const formattedTestruns = data.data.map(testrun => 
+    const formattedTestruns = data.data.map(testrun =>
       this.formatModel(testrun, 'testrun', [
         'status', 'run-time', 'message', 'run-id', 'test'
       ])
     ).join('\n\n');
-    
+
     return {
       content: [
         {
@@ -881,12 +989,12 @@ class TestomatioMCPServer {
 
   async getPlans(filters = {}) {
     const data = await this.makeRequest('/plans', filters);
-    const formattedPlans = data.data.map(plan => 
+    const formattedPlans = data.data.map(plan =>
       this.formatModel(plan, 'plan', [
         'title', 'test-count', 'kind', 'created-at', 'tests-ids', 'labels'
       ])
     ).join('\n\n');
-    
+
     return {
       content: [
         {
@@ -902,7 +1010,7 @@ class TestomatioMCPServer {
     const formattedPlan = this.formatModel(data.data, 'plan', [
       'title', 'test-count', 'kind', 'created-at', 'tests-ids', 'labels'
     ]);
-    
+
     return {
       content: [
         {
@@ -914,19 +1022,33 @@ class TestomatioMCPServer {
   }
 
   async createTest(args) {
-    const { test_id, labels_ids, ...attributes } = args;
+    const { suite_id, labels_ids, ...attributes } = args;
     const requestData = {
-      type: 'test',
-      attributes: Object.fromEntries(Object.entries(attributes).map(([k, v]) => [k.replace(/_/g, '-'), v])),
+      data: {
+        type: 'tests',
+        attributes: Object.fromEntries(Object.entries(attributes).map(([k, v]) => [k.replace(/_/g, '-'), v]))
+      }
     };
+    
+    if (suite_id) {
+      requestData.data.relationships = {
+        suite: {
+          data: {
+            type: 'suites',
+            id: suite_id
+          }
+        }
+      };
+    }
+    
     if (labels_ids) requestData.labels_ids = labels_ids;
 
     const data = await this.makePostRequest('/tests', requestData);
     const formattedTest = this.formatModel(data.data, 'test', [
-      'title', 'description', 'code', 'priority', 
+      'title', 'description', 'code', 'priority',
       'state', 'suite-id', 'tags', 'file'
     ]);
-    
+
     return {
       content: [
         {
@@ -938,19 +1060,33 @@ class TestomatioMCPServer {
   }
 
   async updateTest(args) {
-    const { test_id, labels_ids, ...attributes } = args;
+    const { test_id, suite_id, labels_ids, ...attributes } = args;
     const requestData = {
-      type: 'test',
-      attributes: Object.fromEntries(Object.entries(attributes).map(([k, v]) => [k.replace(/_/g, '-'), v])),
+      data: {
+        type: 'tests',
+        attributes: Object.fromEntries(Object.entries(attributes).map(([k, v]) => [k.replace(/_/g, '-'), v]))
+      }
     };
+    
+    if (suite_id) {
+      requestData.data.relationships = {
+        suite: {
+          data: {
+            type: 'suites',
+            id: suite_id
+          }
+        }
+      };
+    }
+    
     if (labels_ids) requestData.labels_ids = labels_ids;
 
-    const data = await this.makePutRequest(`/tests/${args.test_id}`, requestData);
+    const data = await this.makePutRequest(`/tests/${test_id}`, requestData);
     const formattedTest = this.formatModel(data.data, 'test', [
-      'title', 'description', 'code', 'priority', 
+      'title', 'description', 'code', 'priority',
       'state', 'suite-id', 'tags', 'file'
     ]);
-    
+
     return {
       content: [
         {
@@ -961,6 +1097,122 @@ class TestomatioMCPServer {
     };
   }
 
+  async createSuite(args) {
+    const { parent_id, ...attributes } = args;
+    const requestData = {
+      data: {
+        type: 'suites',
+        attributes: {
+          ...Object.fromEntries(Object.entries(attributes).map(([k, v]) => [k.replace(/_/g, '-'), v])),
+          'file-type': 'file'
+        }
+      }
+    };
+
+    if (parent_id) {
+      requestData.data.relationships = {
+        parent: {
+          data: {
+            type: 'suites',
+            id: parent_id
+          }
+        }
+      };
+    }
+
+    const data = await this.makePostRequest('/suites', requestData);
+    const formattedSuite = this.formatModel(data.data, 'suite', [
+      'title', 'description', 'test-count', 'is-root', 'file-type'
+    ]);
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Successfully created suite:\n\n${formattedSuite}`,
+        },
+      ],
+    };
+  }
+
+  async createFolder(args) {
+    const { parent_id, ...attributes } = args;
+    const requestData = {
+      data: {
+        type: 'suites',
+        attributes: {
+          ...Object.fromEntries(Object.entries(attributes).map(([k, v]) => [k.replace(/_/g, '-'), v])),
+          'file-type': 'folder'
+        }
+      }
+    };
+
+    if (parent_id) {
+      requestData.data.relationships = {
+        parent: {
+          data: {
+            type: 'suites',
+            id: parent_id
+          }
+        }
+      };
+    }
+
+    const data = await this.makePostRequest('/suites', requestData);
+    const formattedSuite = this.formatModel(data.data, 'suite', [
+      'title', 'description', 'test-count', 'is-root', 'file-type'
+    ]);
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Successfully created folder:\n\n${formattedSuite}`,
+        },
+      ],
+    };
+  }
+
+  async createLabel(args) {
+    const { title, color, scope, visibility, field, ...otherAttributes } = args;
+
+    const requestData = {
+      data: {
+        type: 'labels',
+        attributes: {
+          ...Object.fromEntries(Object.entries(otherAttributes).map(([k, v]) => [k.replace(/_/g, '-'), v])),
+          title,
+          color,
+          scope,
+          visibility
+        }
+      }
+    };
+
+    // Add field configuration if provided
+    if (field) {
+      requestData.data.attributes.field = {
+        type: field.type,
+        ...(field.short !== undefined && { short: field.short }),
+        ...(field.value && { value: field.value })
+      };
+    }
+
+    const data = await this.makePostRequest('/labels', requestData);
+    const formattedLabel = this.formatModel(data.data, 'label', [
+      'title', 'color', 'scope', 'visibility', 'field'
+    ]);
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Successfully created label:\n\n${formattedLabel}`,
+        },
+      ],
+    };
+  }
+
   async run() {
     // Test authentication on startup
     try {
@@ -977,6 +1229,9 @@ class TestomatioMCPServer {
   }
 }
 
+// Export the class for testing
+export { TestomatioMCPServer };
+
 // Parse command line arguments using commander
 function parseArgs() {
   program
@@ -989,9 +1244,9 @@ function parseArgs() {
     .parse();
 
   const options = program.opts();
-  
+
   const token = options.token || process.env.TESTOMATIO_API_TOKEN;
-  const projectId = options.project;
+  const projectId = options.project || process.env.TESTOMATIO_PROJECT_ID;
   const baseUrl = options.baseUrl || process.env.TESTOMATIO_BASE_URL || 'https://app.testomat.io';
 
   if (!token) {
@@ -1000,7 +1255,7 @@ function parseArgs() {
   }
 
   if (!projectId) {
-    console.error('Error: Project ID is required. Use --project <project_id>');
+    console.error('Error: Project ID is required. Use --project <project_id> or set TESTOMATIO_PROJECT_ID environment variable');
     process.exit(1);
   }
 
@@ -1019,4 +1274,7 @@ async function main() {
   }
 }
 
-main().catch(console.error);
+// Only run main() if this file is executed directly (not imported)
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main().catch(console.error);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testomatio/mcp",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Model Context Protocol server for Testomatio API",
   "main": "index.js",
   "bin": {
@@ -10,7 +10,14 @@
   "scripts": {
     "start": "node index.js",
     "dev": "node index.js",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "node --experimental-vm-modules node_modules/.bin/jest",
+    "test:unit": "node --experimental-vm-modules node_modules/.bin/jest",
+    "test:integration": "node --experimental-vm-modules node_modules/.bin/jest --config jest.integration.config.js",
+    "test:watch": "node --experimental-vm-modules node_modules/.bin/jest --watch",
+    "test:integration:watch": "node --experimental-vm-modules node_modules/.bin/jest --config jest.integration.config.js --watch",
+    "test:coverage": "node --experimental-vm-modules node_modules/.bin/jest --coverage",
+    "test:coverage:integration": "node --experimental-vm-modules node_modules/.bin/jest --config jest.integration.config.js --coverage",
+    "test:all": "node --experimental-vm-modules node_modules/.bin/jest --config jest.integration.config.js"
   },
   "keywords": [
     "testomatio",
@@ -24,7 +31,8 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^0.4.0",
-    "commander": "^12.0.0"
+    "commander": "^12.0.0",
+    "dotenv": "^17.2.3"
   },
   "files": [
     "index.js",
@@ -32,5 +40,8 @@
   ],
   "engines": {
     "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "jest": "^30.2.0"
   }
 }