targetprocess-mcp-server 2.2.11 → 2.2.13

package/README.md

@@ -63,6 +63,7 @@ Cards — Read
 
 Cards — Write
 - `add_comment` — Post a comment to any card (id, comment)
+- `add_comment_with_user` — Post a comment to any card and mention a specific user (id, comment, user object from `get_users`)
 - `update_bug` — Update an existing bug (id, optional title, optional bugContent, optional origin, optional projectId, optional teamId, optional entityStateId)
   > Resolve state name → ID via `get_bug_workflows` before passing `entityStateId`
 - `update_user_story` — Update an existing user story (id, optional title, optional description, optional projectId, optional teamId, optional entityStateId)
@@ -103,6 +104,8 @@ Teams
 
 User
 - `get_logged_in_user` — Get the currently logged-in user's info (no params needed)
+- `get_users` — Get all Targetprocess users (no params needed)
+- `get_user_by_id` — Get a single Targetprocess user by their ID (id)
 
 Developer Tools
 - `get_commit_message` — Returns a formatted commit message string for a task or bug ID (id, type: task | bug)

package/build/index.js

@@ -435,6 +435,113 @@ server.registerTool('get_bug_content', {
             }],
     };
 });
+server.registerTool('get_user_by_id', {
+    title: 'Get user by id',
+    description: 'Get user by id',
+    inputSchema: {
+        id: z.string()
+            .describe('User email'),
+    },
+}, async ({ id }) => {
+    const user = await tp.getUser(id);
+    if (!user) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to get user, id: ${id}\n JSON: ${JSON.stringify(user, null, 2)}`
+                }],
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(user)
+            }],
+    };
+});
+server.registerTool('get_users', {
+    title: 'Get users',
+    description: 'Get all users',
+}, async () => {
+    const response = await tp.getUsers();
+    if (!response) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to get users, JSON: ${JSON.stringify(response, null, 2)}`
+                }],
+        };
+    }
+    const items = response.Items || [];
+    if (items.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No users found`,
+                }],
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(items)
+            }],
+    };
+});
+server.registerTool('add_comment_with_user', {
+    title: 'Adds provided content to TP card (user story) as a comment',
+    description: `Adds provided content as a comment to the specified tp card by id, e.g. 145789 and mentions the user in the comment
+    CRITICAL WORKFLOW:
+      1) call 'get_users' to get list of available users
+      2) find the user by email, first name, or last name in the users list
+      `,
+    inputSchema: {
+        id: z.string()
+            .min(5)
+            .max(6)
+            .describe('TP card id, usually user story or bug ID (e.g. 145789)'),
+        comment: z.string()
+            .describe('Comment content to add'),
+        user: z.object({
+            Email: z.string()
+                .describe('User email'),
+            FirstName: z.string()
+                .describe('User first name'),
+            LastName: z.string()
+                .describe('User last name'),
+            IsActive: z.boolean()
+                .describe('User is active'),
+        })
+            .describe('User to add to the comment, from "get_users" tool'),
+    },
+}, async ({ id, comment, user }) => {
+    try {
+        const addCommentResponse = await tp.addCommentWithUser(id, comment, user);
+        if (!addCommentResponse) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Failed to add comment to user story id: ${id}`
+                    }]
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(addCommentResponse)
+                }],
+        };
+    }
+    catch (error) {
+        console.error("Error adding comment to user story:", error);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to add comment to user story id: ${id}`
+                }]
+        };
+    }
+});
 server.registerTool('add_comment', {
     title: 'Adds provided content to TP card (user story) as a comment',
     description: `Adds provided content as a comment to the specified tp card by id, e.g. 145789`,

package/build/tp.js

@@ -310,6 +310,35 @@ export class TpClient {
             param: { "format": "json" },
         }, testPlan);
     }
+    async getUser(userId) {
+        return this.get({
+            pathParam: ["Users", userId],
+            param: { "format": "json" },
+        });
+    }
+    async getUsers() {
+        return this.get({
+            pathParam: ["Users"],
+            param: { "format": "json" },
+        });
+    }
+    async addCommentWithUser(userStoryId, comment, user) {
+        const userAt = user ? `cc - <div>@user:${user.Email}[${user.FirstName} ${user.LastName}]&nbsp;</div>` : '';
+        const commentContent = `${comment}\nn${userAt}`;
+        const commentData = {
+            description: commentContent,
+            owner: {
+                id: config.tp.ownerId
+            },
+            general: {
+                id: userStoryId,
+            },
+        };
+        return this.post({
+            pathParam: ["comments"],
+            param: { "format": "json" },
+        }, commentData);
+    }
     async addComment(userStoryId, comment) {
         const commentData = {
             description: comment,

package/package.json

@@ -25,7 +25,7 @@
   "engines": {
     "node": ">=20.x"
   },
-  "version": "2.2.11",
+  "version": "2.2.13",
   "description": "MCP server for Tartget Process",
   "main": "build/index.js",
   "keywords": [