targetprocess-mcp-server 2.2.5 → 2.2.7-a

package/README.md

@@ -56,8 +56,13 @@ Cards — Read
 
 Cards — Write
 - `add_comment` — Post a comment to any card (id, comment)
-- `create_bug` — Create a standalone bug (title, bugContent, optional origin, optional projectId, optional teamId, optional entityStateId)
+- `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)
+  > Resolve state name → ID via `get_user_story_workflows` before passing `entityStateId`
+- `create_bug` — Create a standalone bug (title, bugContent, optional origin, optional projectId, optional teamId, optional entityStateName)
   > `origin` accepted values: `Production - Customer`, `Production - Internal`, `Pre-Release - Customer`, `Pre-Release - Internal`, `Regression - Dev01`, `Regression - Team Env`, `Manual QA` *(default)*, `Developer Raised`, `Operations`
+  > `entityStateName` accepted values: `Backlog`, `In Triage`, `Ready for Dev`, `In Dev`, `Blocked`, `PR Raised`, `Ready for Feature PCH`, `Ready for Feature QA`, `In Feature QA`, `Failed Feature QA`, `Ready for Merge`, `Ready to Deploy to Dev01`, `Ready for Dev01 QA`, `In Dev01 QA`, `Failed Dev01 QA`, `Ready to Deploy to prod`, `Closed`
 > [!NOTE]  
 > `projectId` and `teamId` are optional — fall back to `TP_PROJECT_ID` and `TP_TEAM_ID` from config  
 - `create_bug_based_on_card` — Create a bug linked to an existing user story or bug card (card object with id+type, title, bugContent, optional origin, optional projectId, optional teamId)  
@@ -77,9 +82,11 @@ Test Case Workflows
 - `write_test_cases` — Fetch a card (UserStory, Bug, or Feature) by ID and trigger the full test case writing workflow: Claude analyzes the card, generates detailed test cases covering happy path, edge cases, and error scenarios, creates a linked test plan via `create_test_plan`, then calls `add_test_cases_to_test_plan`. Each test case description contains Preconditions and Test Type as HTML; steps are passed as a structured array (resourceId, optional resourceType)
 - `add_test_cases_to_test_plan` — Add pre-generated test cases to an existing test plan. Each test case has a `name`, an HTML `description` (Preconditions and Test Type only), and a `steps` array of `{ description, result }` objects — steps are created via the TP test step API rather than embedded in the description (testPlanId, testCases array of {name, description, steps})
 
-Processes
+Processes & Workflows
 - `get_processes` — Get all Targetprocess processes (no params needed)
 - `get_process_workflows` — Get workflows for a specific process (processId)
+- `get_bug_workflows` — Get all bug entity states/workflows for the configured process (no params needed)
+- `get_user_story_workflows` — Get all user story entity states/workflows for the configured process (no params needed)
 
 Projects
 - `get_projects` — Get all Targetprocess projects (no params needed)

package/build/config.js

@@ -6,7 +6,7 @@ export const config = {
         ownerId: process.env.TP_OWNER_ID || "1504",
         projectId: process.env.TP_PROJECT_ID || "",
         teamId: process.env.TP_TEAM_ID || "",
-        processId: process.env.TP_PROCESS_ID || "",
+        processId: process.env.TP_PROCESS_ID || "89",
         userStoryWorkflowId: process.env.TP_USER_STORY_WORKFLOW_ID || "",
         bugWorkflowId: process.env.TP_BUG_WORKFLOW_ID || "",
     }

package/build/index.js

@@ -603,7 +603,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 or bug card content, proceed to step 3 skipping step 2;
         2) ELSE call "get_user_story_content" tool or "get_bug_content" tool to get user story or bug card content;
-        3) format the new bug inside html <div> tags with Issue Description, Steps to Reproduce, Expected Behavior, Actual Behavior 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, 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`,
@@ -661,12 +661,117 @@ server.registerTool('create_bug_based_on_card', {
             }],
     };
 });
+server.registerTool('update_bug', {
+    title: 'Update a bug card',
+    description: `Update a bug card with data proded from user input.
+      NOTE: pass only the fields that user wants to update.
+      CRITICAL WORKFLOW: Before calling this tool, you MUST follow these steps:
+        1) IF the user specified a team by name (not ID), call "get_teams" to find the matching team and use its ID as teamId;
+        2) IF the user specified a project by name (not ID), call "get_projects" to find the matching project and use its ID as projectId;
+        3) IF the user specified a state by name (not ID), call "get_bug_workflows" to find the matching state and use its ID as entityStateId;`,
+    inputSchema: {
+        id: z.string()
+            .min(5)
+            .max(6)
+            .describe('Bug card ID (e.g. 145789)'),
+        title: z.string()
+            .optional()
+            .describe('Bug card title that summarizes the problem in concise, descriptive, and actionable manner, enabling a developer to understand the issue without opening the report'),
+        bugContent: z.string()
+            .optional()
+            .describe(`Bug description content, explain what happened in detail. Include expected behaviour and what actually occurred. Be specific and avoid assumptions. Clearly outline the actions needed to trigger the bug. Number each step so anyone can follow them easily`),
+        origin: z.enum([
+            "Production - Customer",
+            "Production - Internal",
+            "Pre-Release - Customer",
+            "Pre-Release - Internal",
+            "Regression - Dev01",
+            "Regression - Team Env",
+            "Manual QA",
+            "Developer Raised",
+            "Operations",
+        ])
+            .optional()
+            .describe('Where the bug was found, defaults to "Manual QA"'),
+        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'),
+        teamId: z.string()
+            .optional()
+            .describe('Optional Team ID — if user gave a team name, resolve it via "get_teams" first; defaults to TP_TEAM_ID from config'),
+        entityStateId: z.string()
+            .optional()
+            .describe('Optional Entity State ID — if user gave a state name, resolve it via "get_bug_workflows" first; defaults to "Done"'),
+    },
+}, async ({ id, title, bugContent, origin, projectId, teamId, entityStateId }) => {
+    const bugResponse = await tp.updateBug({ id, title, bugContent, origin, projectId, teamId, entityStateId });
+    if (!bugResponse) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to update bug "${title}"\n JSON: ${JSON.stringify(bugResponse, null, 2)}`
+                }]
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(bugResponse)
+            }],
+    };
+});
+server.registerTool('update_user_story', {
+    title: 'Update a user story card',
+    description: `Update a user story card with data provided from user input.
+      NOTE: pass only the fields that user wants to update.
+      CRITICAL WORKFLOW: Before calling this tool, you MUST follow these steps:
+        1) IF the user specified a team by name (not ID), call "get_teams" to find the matching team and use its ID as teamId;
+        2) IF the user specified a project by name (not ID), call "get_projects" to find the matching project and use its ID as projectId;
+        3) IF the user specified a state by name (not ID), call "get_user_story_workflows" to find the matching state and use its ID as entityStateId;`,
+    inputSchema: {
+        id: z.string()
+            .min(5)
+            .max(6)
+            .describe('User story card ID (e.g. 145789)'),
+        title: z.string()
+            .optional()
+            .describe('Updated user story title'),
+        description: z.string()
+            .optional()
+            .describe('Updated user story description (format as HTML)'),
+        projectId: z.string()
+            .optional()
+            .describe('Optional Project ID — if user gave a project name, resolve it via "get_projects" first'),
+        teamId: z.string()
+            .optional()
+            .describe('Optional Team ID — if user gave a team name, resolve it via "get_teams" first'),
+        entityStateId: z.string()
+            .optional()
+            .describe('Optional Entity State ID — if user gave a state name, resolve it via "get_user_story_workflows" first'),
+    },
+}, async ({ id, title, description, projectId, teamId, entityStateId }) => {
+    const response = await tp.updateUserStory({ id, title, description, projectId, teamId, entityStateId });
+    if (!response) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to update user story id: ${id}\n JSON: ${JSON.stringify(response, null, 2)}`
+                }]
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(response)
+            }],
+    };
+});
 server.registerTool('create_bug', {
     title: 'Create a new bug card',
     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 Issue Description, Steps to Reproduce, Expected Behavior, Actual Behavior 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, 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: {
@@ -694,9 +799,12 @@ server.registerTool('create_bug', {
         teamId: z.string()
             .optional()
             .describe('Optional Team ID — if user gave a team name, resolve it via "get_teams" first; defaults to TP_TEAM_ID from config'),
+        entityStateId: z.string()
+            .optional()
+            .describe('Optional Entity State ID — if user gave a state name, resolve it via "get_bug_workflows" first; defaults to "Done"'),
     },
-}, async ({ title, bugContent, origin, projectId, teamId }) => {
-    const bugResponse = await tp.createBugOnly({ title, bugContent, origin, projectId, teamId });
+}, async ({ title, bugContent, origin, projectId, teamId, entityStateId }) => {
+    const bugResponse = await tp.createBugOnly({ title, bugContent, origin, projectId, teamId, entityStateId });
     if (!bugResponse) {
         return {
             content: [{
@@ -1306,6 +1414,84 @@ server.registerTool('get_processes', {
             }],
     };
 });
+server.registerTool('get_bug_workflows', {
+    title: 'Get bug workflows',
+    description: 'Get all Targetprocess bug workflows',
+}, async ({}) => {
+    const response = await tp.getBugWorkflows();
+    if (!response) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to get bug entity statuses, JSON: ${JSON.stringify(response, null, 2)}`
+                }],
+        };
+    }
+    const items = response.items || [];
+    if (items.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No status data found for workflows`
+                }],
+        };
+    }
+    const workflows = items.map((w) => ({
+        id: w.id,
+        name: w.name,
+        processId: w.process,
+        entityType: w.entityType,
+        entityStates: w.entityStates.map((es) => ({
+            id: es.id,
+            name: es.name,
+        })),
+    }));
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(workflows)
+            }],
+    };
+});
+server.registerTool('get_user_story_workflows', {
+    title: 'Get User Story workflows',
+    description: 'Get all Targetprocess user story workflows',
+}, async ({}) => {
+    const response = await tp.getUserStoryWorkflows();
+    if (!response) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to get user story entity statuses, JSON: ${JSON.stringify(response, null, 2)}`
+                }],
+        };
+    }
+    const items = response.items || [];
+    if (items.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No status data found for workflows`
+                }],
+        };
+    }
+    const workflows = items.map((w) => ({
+        id: w.id,
+        name: w.name,
+        processId: w.process,
+        entityType: w.entityType,
+        entityStates: w.entityStates.map((es) => ({
+            id: es.id,
+            name: es.name,
+        })),
+    }));
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(workflows)
+            }],
+    };
+});
 server.registerTool('get_card_current_status', {
     title: 'Get card status',
     description: 'Get the EntityState, TeamState, and assigned teams for a TP card (UserStory, Bug, or Feature) by ID',

package/build/tp.js

@@ -130,31 +130,51 @@ export class TpClient {
             param: { "format": "json" },
         }, bug);
     }
-    async updateUserStory({ title, description, projectId, teamId }) {
-        const userStory = {
-            "Name": title,
-            "Description": description,
-            "Project": {
-                "Id": projectId || config.tp.projectId
-            },
-            "assignedTeams": [
-                {
-                    "entityState": {
-                        "id": 7407
-                    },
-                    "id": 84252,
+    async updateUserStory({ id, title, description, projectId, teamId, entityStateId }) {
+        const userStory = { "Id": id };
+        if (title)
+            userStory["Name"] = title;
+        if (description)
+            userStory["Description"] = description;
+        if (projectId)
+            userStory["Project"] = { "Id": projectId };
+        if (teamId)
+            userStory["assignedTeams"] = [{ "team": { "id": teamId } }];
+        if (entityStateId)
+            userStory["EntityState"] = { "Id": entityStateId };
+        return this.post({
+            pathParam: ["UserStories"],
+            param: { "format": "json" },
+        }, userStory);
+    }
+    async updateBug({ id, title, bugContent, origin, projectId, teamId, entityStateId }) {
+        const bug = { "Id": id };
+        if (title)
+            bug["Name"] = title;
+        if (bugContent)
+            bug["Description"] = bugContent;
+        if (origin)
+            bug["customFields"] = [{
+                    "name": "Origin",
+                    "type": "DropDown",
+                    "value": origin
+                }];
+        if (projectId)
+            bug["Project"] = { "Id": projectId };
+        if (teamId)
+            bug["assignedTeams"] = [{
                     "team": {
                         "id": teamId || config.tp.teamId
                     }
-                }
-            ]
-        };
+                }];
+        if (entityStateId)
+            bug["entityState"] = { "id": entityStateId };
         return this.post({
-            pathParam: ["UserStories"],
+            pathParam: ["bugs"],
             param: { "format": "json" },
-        }, userStory);
+        }, bug);
     }
-    async createBugOnly({ title, bugContent, origin = "Manual QA", projectId, teamId }) {
+    async createBugOnly({ title, bugContent, origin = "Manual QA", projectId, teamId, entityStateId }) {
         const bug = {
             "Name": title,
             "Project": {
@@ -172,6 +192,8 @@ export class TpClient {
                 }],
             "Description": bugContent,
         };
+        if (entityStateId)
+            bug["EntityState"] = { "Id": entityStateId };
         return this.post({
             pathParam: ["bugs"],
             param: { "format": "json" },
@@ -517,6 +539,30 @@ export class TpClient {
             param: { "format": "json" },
         });
     }
+    async getUserStoryWorkflows() {
+        return this.get({
+            pathParam: ["workflow"],
+            param: {
+                "format": "json",
+                "select": `{Id,Name,Process,EntityType,EntityStates.Select({Id,Name}) as EntityStates}`,
+                "where": `(process.id=${config.tp.processId} and entityType.name="userStory" and parentWorkflow=null)`,
+                "take": "1",
+            },
+            apiVersion: this.v2
+        });
+    }
+    async getBugWorkflows() {
+        return this.get({
+            pathParam: ["workflow"],
+            param: {
+                "format": "json",
+                "select": `{Id,Name,Process,EntityType,EntityStates.Select({Id,Name}) as EntityStates}`,
+                "where": `(process.id=${config.tp.processId} and entityType.name="bug" and parentWorkflow=null)`,
+                "take": "1",
+            },
+            apiVersion: this.v2
+        });
+    }
     async getCardStatus(cardId, resourceType = 'UserStory') {
         const pathMap = { UserStory: 'userStory', Bug: 'bug', Feature: 'feature' };
         return this.get({

package/package.json

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