targetprocess-mcp-server 2.2.4 → 2.2.5

package/README.md

@@ -46,7 +46,7 @@ Features
 - `get_not_covered_user_stories_in_feature` — Get user stories in a feature not yet covered by tests, includes `covered` field based on "Test Automation" custom field (id)
 
 Cards — Read
-- `get_card_status` — Get EntityState, TeamState, and assigned teams for a card (id, optional resourceType: UserStory | Bug | Feature, default: UserStory)
+- `get_card_current_status` — Get EntityState, TeamState, and assigned teams for a card (id, optional resourceType: UserStory | Bug | Feature, default: UserStory)
 - `get_bug_content` — Fetch full content of a bug by ID (id)
 - `get_user_story_content` — Fetch full content of a user story by ID (id)
 - `get_bug_comments` — Get comments on a bug (id, optional results)
@@ -56,7 +56,7 @@ 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)
+- `create_bug` — Create a standalone bug (title, bugContent, optional origin, optional projectId, optional teamId, optional entityStateId)
   > `origin` accepted values: `Production - Customer`, `Production - Internal`, `Pre-Release - Customer`, `Pre-Release - Internal`, `Regression - Dev01`, `Regression - Team Env`, `Manual QA` *(default)*, `Developer Raised`, `Operations`
 > [!NOTE]  
 > `projectId` and `teamId` are optional — fall back to `TP_PROJECT_ID` and `TP_TEAM_ID` from config  
@@ -77,6 +77,10 @@ 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
+- `get_processes` — Get all Targetprocess processes (no params needed)
+- `get_process_workflows` — Get workflows for a specific process (processId)
+
 Projects
 - `get_projects` — Get all Targetprocess projects (no params needed)
 

package/build/config.js

@@ -6,5 +6,8 @@ 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 || "",
+        userStoryWorkflowId: process.env.TP_USER_STORY_WORKFLOW_ID || "",
+        bugWorkflowId: process.env.TP_BUG_WORKFLOW_ID || "",
     }
 };

package/build/index.js

@@ -1244,7 +1244,69 @@ server.registerTool('add_test_cases_to_test_plan', {
             }]
     };
 });
-server.registerTool('get_card_status', {
+server.registerTool('get_process_workflows', {
+    title: 'Get process workflows',
+    description: 'Get all Targetprocess process workflows',
+    inputSchema: {
+        processId: z.string()
+            .describe('Process ID (e.g. 145636)'),
+    },
+}, async ({ processId }) => {
+    const response = await tp.getProcessWorkflows({ processId });
+    if (!response) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to get process workflows, JSON: ${JSON.stringify(response, null, 2)}`
+                }],
+        };
+    }
+    const items = response.items || [];
+    if (items.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No process workflows found`,
+                }],
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(items)
+            }],
+    };
+});
+server.registerTool('get_processes', {
+    title: 'Get processes',
+    description: 'Get all Targetprocess processes',
+}, async ({}) => {
+    const response = await tp.getProcesses();
+    if (!response) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to get processes, JSON: ${JSON.stringify(response, null, 2)}`
+                }],
+        };
+    }
+    const items = response.items || [];
+    if (items.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No processes found`,
+                }],
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(items)
+            }],
+    };
+});
+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',
     inputSchema: {

package/build/tp.js

@@ -130,6 +130,30 @@ 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,
+                    "team": {
+                        "id": teamId || config.tp.teamId
+                    }
+                }
+            ]
+        };
+        return this.post({
+            pathParam: ["UserStories"],
+            param: { "format": "json" },
+        }, userStory);
+    }
     async createBugOnly({ title, bugContent, origin = "Manual QA", projectId, teamId }) {
         const bug = {
             "Name": title,
@@ -460,6 +484,33 @@ export class TpClient {
             param: { "format": "json" },
         });
     }
+    async getProcessWorkflows({ processId }) {
+        return this.get({
+            pathParam: ["Process"],
+            param: {
+                "format": "json",
+                "where": `id=(${processId})`,
+                "select": `{Workflows}`
+            },
+            apiVersion: this.v2
+        });
+    }
+    async getUserStories({ take = 100 }) {
+        return this.get({
+            pathParam: ["userStories"],
+            param: {
+                "format": "json",
+                "take": take,
+            },
+            apiVersion: this.v2
+        });
+    }
+    async getProcesses() {
+        return this.get({
+            pathParam: ["Processes"],
+            param: { "format": "json" },
+        });
+    }
     async getTeams() {
         return this.get({
             pathParam: ["Teams"],

package/package.json

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