targetprocess-mcp-server 2.2.10 → 2.2.12

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,7 @@ 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)
 
 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,89 @@ server.registerTool('get_bug_content', {
             }],
     };
 });
+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`,
@@ -603,7 +686,7 @@ server.registerTool('create_bug_based_on_card', {
       CRITICAL WORKFLOW: Before calling this tool, you MUST follow these steps:
         1) IF you already have user story, bug, or feature card content, proceed to step 3 skipping step 2;
         2) ELSE call "get_user_story_content" tool, "get_bug_content" tool, or fetch the feature to get card content;
-        3) format the new bug inside html <div> tags with Environment, Issue Description, Steps to Reproduce, Expected Behavior, Actual Behavior and Attachments sections (note: section titles should be wrapped in <h3> tags, e.g. <h3>Issue Description</h3>);
+        3) format the new bug inside html <div> tags with Environment (describes where bug was found, dev, feature, review or uat Environment), Issue Description, Steps to Reproduce, Expected Behavior, Actual Behavior and Attachments sections (note: section titles should be wrapped in <h3> tags, e.g. <h3>Issue Description</h3>);
         4) IF the user specified a team by name (not ID), call "get_teams" to find the matching team and use its ID as teamId;
         5) IF the user specified a project by name (not ID), call "get_projects" to find the matching project and use its ID as projectId;
         6) add a comment to the card with created bug Id and its Title`,
@@ -636,7 +719,7 @@ server.registerTool('create_bug_based_on_card', {
         ])
             .default("Manual QA")
             .optional()
-            .describe('Where the bug was found, defaults to "Manual QA"'),
+            .describe('Where the bug was found, defaults to "Manual QA" if no origin was specified'),
         projectId: z.string()
             .optional()
             .describe('Optional Project ID — if user gave a project name, resolve it via "get_projects" first; defaults to TP_PROJECT_ID from config'),
@@ -771,7 +854,7 @@ server.registerTool('create_bug', {
     description: `Create a new bug card that summarizes the problem in concise, descriptive manner answering questions "What? Where? When?" and content explaining what happened in detail.
       NOTE: this tool does not require a user story or bug card reference.
       CRITICAL WORKFLOW: Before calling this tool, you MUST follow these steps:
-        1) format the new bug inside html <div> tags with Environment, Issue Description, Steps to Reproduce, Expected Behavior, Actual Behavior and Attachments sections (note: section titles should be wrapped in <h3> tags, e.g. <h3>Issue Description</h3>, step to reproduce should be wrapped in <ol>);
+        1) format the new bug inside html <div> tags with Environment(describes where bug was found, dev, feature, review or uat Environment), Issue Description, Steps to Reproduce, Expected Behavior, Actual Behavior and Attachments sections (note: section titles should be wrapped in <h3> tags, e.g. <h3>Issue Description</h3>, step to reproduce should be wrapped in <ol>);
         2) IF the user specified a team by name (not ID), call "get_teams" to find the matching team and use its ID as teamId;
         3) IF the user specified a project by name (not ID), call "get_projects" to find the matching project and use its ID as projectId;`,
     inputSchema: {
@@ -792,7 +875,7 @@ server.registerTool('create_bug', {
         ])
             .default("Manual QA")
             .optional()
-            .describe('Where the bug was found, defaults to "Manual QA"'),
+            .describe('Where the bug was found, defaults to "Manual QA" if no origin was specified'),
         projectId: z.string()
             .optional()
             .describe('Optional Project ID — if user gave a project name, resolve it via "get_projects" first; defaults to TP_PROJECT_ID from config'),
@@ -1481,9 +1564,9 @@ server.registerTool('get_bug_workflows', {
 });
 server.registerTool('get_user_story_workflows', {
     title: 'Get User Story workflows',
-    description: 'Get all Targetprocess user story workflows',
+    description: 'Get all Targetprocess user story workflows, with sub-states',
 }, async ({}) => {
-    const response = await tp.getUserStoryWorkflows();
+    const response = await tp.getUserStoryWorkflowsWithSubStates();
     if (!response) {
         return {
             content: [{
@@ -1501,12 +1584,13 @@ server.registerTool('get_user_story_workflows', {
                 }],
         };
     }
-    const workflows = items.map((w) => ({
+    const userStoryWorkflows = items.filter((w) => w.entityType.name === "UserStory");
+    const workflows = userStoryWorkflows.map((w) => ({
         id: w.id,
-        name: w.name,
-        processId: w.process,
-        entityType: w.entityType,
-        entityStates: w.entityStates.map((es) => ({
+        processId: w.workflow.process.id,
+        entityType: w.entityType.name,
+        entityState: w.name,
+        entitySubStates: w.subEntityStates.map((es) => ({
             id: es.id,
             name: es.name,
         })),

package/build/tp.js

@@ -310,6 +310,29 @@ export class TpClient {
             param: { "format": "json" },
         }, testPlan);
     }
+    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,
@@ -562,6 +585,18 @@ export class TpClient {
             apiVersion: this.v2
         });
     }
+    async getUserStoryWorkflowsWithSubStates() {
+        return this.get({
+            pathParam: ["EntityState"],
+            param: {
+                "format": "json",
+                "select": `{id,name,isInitial,isFinal,isDefaultFinal,isPlanned,workflow:{workflow.id,process:{workflow.process.id}},entityType:{entityType.name},subEntityStates:subEntityStates.Select({id,name,entityType:{entityType.name},isInitial,isFinal,isDefaultFinal,isPlanned})}`,
+                "where": `(parentEntityState==null and workflow.process.id in [${config.tp.processId}])`,
+                "take": "1000",
+            },
+            apiVersion: this.v2
+        });
+    }
     async getBugWorkflows() {
         return this.get({
             pathParam: ["workflow"],

package/package.json

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