targetprocess-mcp-server 2.6.7-a → 2.6.8

package/build/index.js

@@ -477,6 +477,34 @@ server.registerTool('update_user_story_state', {
             .describe('Team Assignment ID, resolve it via "get_user_story_content" first'),
     },
 }, async ({ id, teamId, teamAssignmentId, entityStateId }) => handleUpdateUserStorySubState(tp, { id, teamId, teamAssignmentId, entityStateId }));
+server.registerTool('set_business_value', {
+    title: 'Set Business Value on a TP card',
+    description: `Set the Business Value (Priority) on a Targetprocess User Story, Feature, or Epic.
+      Business Value in the TP UI maps to the Priority field in the API.
+      CRITICAL WORKFLOW: Call "get_priorities" first to retrieve the list of valid priority IDs and their names for this instance before calling this tool — do not guess priority IDs.`,
+    inputSchema: {
+        id: z.string()
+            .describe('ID of the card to update (e.g. "151282")'),
+        entityType: z.enum(['UserStories', 'Features', 'Epics'])
+            .describe('Entity type of the card'),
+        priorityId: z.string()
+            .describe('Priority ID — resolve via "get_priorities" first'),
+    },
+}, async ({ id, entityType, priorityId }) => {
+    const response = await tp.setBusinessValue({ id, entityType, priorityId });
+    if (!response) {
+        return { content: [{ type: 'text', text: `Failed to set business value on ${entityType} ${id}` }] };
+    }
+    return { content: [{ type: 'text', text: JSON.stringify(response) }] };
+});
+server.registerTool('get_priorities', {
+    title: 'Get available Business Value / Priority options',
+    description: `Returns the list of Priority options available in this Targetprocess instance. Use this before calling "set_business_value" to resolve a priority name (e.g. "Must Have", "Normal", "10") to its ID.`,
+    inputSchema: {},
+}, async () => {
+    const response = await tp.getPriorities();
+    return { content: [{ type: 'text', text: JSON.stringify(response) }] };
+});
 server.registerTool('update_user_story', {
     title: 'Update a user story card',
     description: `Update a user story card with data provided from user input.
@@ -826,7 +854,7 @@ server.registerTool('create_formatted_feature', {
 }, async ({ title, header, definitions, scope, nonFunctionalRequirements, crossCuttingScenarios, childStories, openQuestions, references, notes, epicId, releaseId, projectId, teamId }) => handleCreateFormattedFeature(tp, { title, header, definitions, scope, nonFunctionalRequirements, crossCuttingScenarios, childStories, openQuestions, references, notes, epicId, releaseId, projectId, teamId }));
 server.registerTool('create_feature', {
     title: 'Create a new feature',
-    description: `Create a new Feature in Targetprocess.`,
+    description: `DEPRECATED — use "create_formatted_feature" instead for all new features. Only call this tool when you have a fully pre-written HTML description and the user has explicitly opted out of the structured template.`,
     inputSchema: {
         title: z.string()
             .describe('Feature title'),

package/build/tp.js

@@ -260,6 +260,13 @@ export class TpClient {
             param: { "format": "json" },
         }, userStory);
     }
+    async setBusinessValue({ id, entityType, priorityId }) {
+        const entity = { "Id": id, "Priority": { "Id": priorityId } };
+        return this.post({
+            pathParam: [entityType, id],
+            param: { "format": "json" },
+        }, entity);
+    }
     async updateBug({ id, title, bugContent, origin, releaseId, projectId, teamId, entityStateId, tags, teamIterationId }) {
         const bug = { "Id": id };
         if (title)
@@ -884,6 +891,12 @@ export class TpClient {
             param: { "format": "json" },
         });
     }
+    async getPriorities() {
+        return this.get({
+            pathParam: ["Priorities"],
+            param: { "format": "json", "take": "200" },
+        });
+    }
     async getProcessWorkflows({ processId }) {
         return this.get({
             pathParam: ["Process"],

package/package.json

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