@testomatio/mcp 2.1.1 → 2.1.2

package/README.md

@@ -8,6 +8,7 @@ Model Context Protocol (MCP) server that enables AI assistants (Claude, Cursor,
   - Tests, Suites, Plans, Runs, TestRuns, RunGroups, Steps, Snippets, Labels
   - Tags and Milestones (read-only access)
   - Issues (global + scoped helpers for tests/suites/runs/testruns/plans)
+  - Attachments (scoped helpers for tests/suites/testruns)
   - Requirements (including file uploads from local file paths)
 - **Smart Search** - delegates to list endpoints with OpenAPI-aligned query/filter forwarding
 - **Issue Linking** - link/unlink issues to any resource
@@ -178,6 +179,17 @@ Add this config to `opencode.json` in your project root, or to `~/.config/openco
 }
 ```
 
+**Upload attachment to a test:**
+```json
+{
+  "name": "tests_attachments_upload",
+  "arguments": {
+    "test_id": "123",
+    "file_path": "/path/to/screenshot.png"
+  }
+}
+```
+
 ## Documentation
 
 Complete tool reference: [docs/tools.md](./docs/tools.md)
@@ -247,6 +259,7 @@ NODE_EXTRA_CA_CERTS=/path/to/company-root-ca.pem testomatio-mcp --token <TOKEN>
 - **TQL Syntax** - For user-facing syntax details and more examples, see the official TQL docs: https://docs.testomat.io/advanced/tql/
 - **TQL Scope** - The full agent-oriented whitelist of documented fields lives inside MCP tool descriptions for `tests` and `runs`
 - **Issue Linking** - Scoped helpers available: `{entity}_issues_link/unlink`
+- **Attachments** - Scoped helpers available for tests, suites, and testruns: `{entity}_attachments_list/upload/delete`. Upload sends one local file path as multipart field `file`.
 - **Enterprise Package** - Analytics tools are intentionally exposed only by `@testomatio/mcp-enterprise`, not by the standard `@testomatio/mcp` package
 - **API Sessions** - The server automatically starts a Testomat.io session before the first `POST`, `PUT`, or `DELETE` request, sends the returned session hash as `X-Session-Hash` on later mutating requests, and stops the session when the MCP server shuts down. `GET` requests do not start or use sessions.
 

package/package.json

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

package/src/api/testomatio-client.js

@@ -31,8 +31,8 @@ export class TestomatioApiClient {
     return this.mutate('POST', this.buildPath(resource), { body });
   }
 
-  async createMultipart(resource, formData) {
-    return this.mutate('POST', this.buildPath(resource), { body: formData });
+  async createMultipart(resource, formData, query = {}) {
+    return this.mutate('POST', this.buildPath(resource), { query, body: formData });
   }
 
   async createWithQuery(resource, { query = {}, body = {} } = {}) {

package/src/mcp/configs/attachments-config.js

@@ -0,0 +1,7 @@
+export const ATTACHMENT_RESOURCE_KEYS = ['test_id', 'suite_id', 'testrun_id'];
+
+export const ATTACHMENT_SCOPED_TOOL_CONFIGS = [
+  { toolPrefix: 'tests', resourceKey: 'test_id' },
+  { toolPrefix: 'suites', resourceKey: 'suite_id' },
+  { toolPrefix: 'testruns', resourceKey: 'testrun_id' },
+];

package/src/mcp/definitions/attachments.js

@@ -0,0 +1,70 @@
+function buildAttachmentTools({ toolPrefix, entityName, idKey, idType = 'string' }) {
+  const entityId = {
+    type: idType,
+  };
+
+  return [
+    {
+      name: `${toolPrefix}_attachments_list`,
+      description: `List attachments for a ${entityName} (/api/v2/{project_id}/attachments?${idKey}=...)`,
+      inputSchema: {
+        type: 'object',
+        properties: {
+          [idKey]: entityId,
+        },
+        required: [idKey],
+        additionalProperties: false,
+      },
+    },
+    {
+      name: `${toolPrefix}_attachments_upload`,
+      description: `Upload one attachment to a ${entityName} (/api/v2/{project_id}/attachments?${idKey}=...)`,
+      inputSchema: {
+        type: 'object',
+        properties: {
+          [idKey]: entityId,
+          file_path: {
+            type: 'string',
+            description: 'Local path to the file that will be sent as multipart/form-data field "file".',
+          },
+        },
+        required: [idKey, 'file_path'],
+        additionalProperties: false,
+      },
+    },
+    {
+      name: `${toolPrefix}_attachments_delete`,
+      description: `Delete attachment from a ${entityName} (/api/v2/{project_id}/attachments/{id}?${idKey}=...)`,
+      inputSchema: {
+        type: 'object',
+        properties: {
+          [idKey]: entityId,
+          attachment_id: {
+            type: 'string',
+          },
+        },
+        required: [idKey, 'attachment_id'],
+        additionalProperties: false,
+      },
+    },
+  ];
+}
+
+export const ATTACHMENT_TOOLS = [
+  ...buildAttachmentTools({
+    toolPrefix: 'tests',
+    entityName: 'test',
+    idKey: 'test_id',
+  }),
+  ...buildAttachmentTools({
+    toolPrefix: 'suites',
+    entityName: 'suite',
+    idKey: 'suite_id',
+  }),
+  ...buildAttachmentTools({
+    toolPrefix: 'testruns',
+    entityName: 'testrun',
+    idKey: 'testrun_id',
+    idType: 'integer',
+  }),
+];

package/src/mcp/registry/attachments.js

@@ -0,0 +1,40 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+import { ATTACHMENT_RESOURCE_KEYS } from '../configs/attachments-config.js';
+
+export const attachmentMethods = {
+  listAttachmentsForKey({ resourceKey, resourceId }) {
+    this.assertSupportedAttachmentResourceKey(resourceKey);
+    return this.apiClient.list('attachments', { [resourceKey]: resourceId });
+  },
+
+  async uploadAttachmentForKey({ resourceKey, resourceId, filePath }) {
+    this.assertSupportedAttachmentResourceKey(resourceKey);
+    const formData = await this.buildAttachmentFormData(filePath);
+
+    return this.apiClient.createMultipart('attachments', formData, {
+      [resourceKey]: resourceId,
+    });
+  },
+
+  deleteAttachmentForKey({ resourceKey, resourceId, attachmentId }) {
+    this.assertSupportedAttachmentResourceKey(resourceKey);
+    return this.apiClient.delete('attachments', attachmentId, { [resourceKey]: resourceId });
+  },
+
+  async buildAttachmentFormData(filePath) {
+    const resolvedPath = path.resolve(String(filePath));
+    const data = await fs.readFile(resolvedPath);
+    const formData = new FormData();
+
+    formData.append('file', new Blob([data]), path.basename(resolvedPath));
+    return formData;
+  },
+
+  assertSupportedAttachmentResourceKey(resourceKey) {
+    if (!ATTACHMENT_RESOURCE_KEYS.includes(resourceKey)) {
+      throw new Error(`Unsupported attachment resource key: ${resourceKey}`);
+    }
+  },
+};

package/src/mcp/registry/handlers.js

@@ -1,4 +1,5 @@
 import { ENTITY_CRUD_CONFIGS } from '../configs/entity-crud-config.js';
+import { ATTACHMENT_SCOPED_TOOL_CONFIGS } from '../configs/attachments-config.js';
 import { ISSUE_SCOPED_TOOL_CONFIGS } from '../configs/issues-config.js';
 
 export const handlerMethods = {
@@ -54,6 +55,36 @@ export const handlerMethods = {
     }
   },
 
+  registerScopedAttachmentHandlers(handlers) {
+    for (const { toolPrefix, resourceKey } of ATTACHMENT_SCOPED_TOOL_CONFIGS) {
+      handlers[`${toolPrefix}_attachments_list`] = async (args = {}) =>
+        this.asText(
+          await this.listAttachmentsForKey({
+            resourceKey,
+            resourceId: this.pickRequiredArg(args, resourceKey),
+          })
+        );
+
+      handlers[`${toolPrefix}_attachments_upload`] = async (args = {}) =>
+        this.asText(
+          await this.uploadAttachmentForKey({
+            resourceKey,
+            resourceId: this.pickRequiredArg(args, resourceKey),
+            filePath: this.pickRequiredArg(args, 'file_path'),
+          })
+        );
+
+      handlers[`${toolPrefix}_attachments_delete`] = async (args = {}) =>
+        this.asText(
+          await this.deleteAttachmentForKey({
+            resourceKey,
+            resourceId: this.pickRequiredArg(args, resourceKey),
+            attachmentId: this.pickRequiredArg(args, 'attachment_id'),
+          })
+        );
+    }
+  },
+
   registerGlobalHandlers(handlers) {
     handlers.tags_list = async () => this.asText(await this.listTags());
     handlers.tags_get = async ({ tag_id: tagId }) => this.asText(await this.getTagByTitle(tagId));

package/src/mcp/tool-definitions.js

@@ -12,6 +12,7 @@ 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';
 
 export const TOOL_DEFINITIONS = [
   ...SYSTEM_TOOLS,
@@ -26,6 +27,7 @@ export const TOOL_DEFINITIONS = [
   ...TAGS_TOOLS,
   ...MILESTONES_TOOLS,
   ...ISSUES_TOOLS,
+  ...ATTACHMENT_TOOLS,
   ...PLANS_TOOLS,
   ...REQUIREMENTS_TOOLS,
 ];

package/src/mcp/tool-registry.js

@@ -3,6 +3,7 @@ import { ApiError, NotImplementedToolError } from '../core/errors.js';
 import { textResponse } from '../helpers/mcp-response.js';
 import { TOOL_DEFINITIONS } from './tool-definitions.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';
@@ -38,6 +39,7 @@ export class ToolRegistry {
 
     this.registerEntityCrudHandlers(handlers);
     this.registerScopedIssueHandlers(handlers);
+    this.registerScopedAttachmentHandlers(handlers);
     this.registerGlobalHandlers(handlers);
     for (const registerHandlers of this.handlerRegistrars) {
       registerHandlers.call(this, handlers);
@@ -80,6 +82,7 @@ export class ToolRegistry {
 Object.assign(
   ToolRegistry.prototype,
   handlerMethods,
+  attachmentMethods,
   listingMethods,
   issueMethods,
   payloadMethods