targetprocess-mcp-server 2.1.8 → 2.2.0

package/README.md

@@ -55,13 +55,16 @@ Cards — Read
 
 Cards — Write
 - `add_comment` — Post a comment to any card (id, comment)
-- `create_bug` — Create a standalone bug (title, bugContent, optional origin)
+- `create_bug` — Create a standalone bug (title, bugContent, optional origin, optional projectId, optional teamId)
   > `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]  
-> requires `TP_PROJECT_ID`, `TP_TEAM_ID`  
-- `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)  
+> `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)  
 > [!NOTE]  
-> requires `TP_PROJECT_ID`, `TP_TEAM_ID`  
+> `projectId` and `teamId` are optional — fall back to `TP_PROJECT_ID` and `TP_TEAM_ID` from config  
+- `create_user_story` — Create a new user story (title, optional description, optional featureId, optional releaseId, optional projectId, optional teamId)  
+> [!NOTE]  
+> `projectId` and `teamId` are optional — fall back to `TP_PROJECT_ID` and `TP_TEAM_ID` from config  
 - `create_test_plan` — Create a test plan linked to a UserStory, Bug, or Feature (title, resourceId, optional resourceType, optional description/startDate/endDate)  
 > [!NOTE]  
 > requires `TP_PROJECT_ID`, 

package/build/index.js

@@ -335,17 +335,21 @@ server.registerTool('get_release_open_user_stories', {
 server.registerTool('search_tp_cards', {
     title: 'Search TP cards by keyword or phrase in description',
     description: `Searches TP cards (UserStories or Bugs) by keyword or phrase or partial keyphrase in Card Description e.g. "Text Element", "Font field"
-    NOTE: after results are returned, try analyze and filter results by most relevant to what user is looking for in the description text`,
+    NOTE: after results are returned, try analyze and filter results by most relevant to what user is looking for in the description text
+    FALLBACK: if no results are found, try spliting phrase by spaces and searching for each word and with "Generals" entity type`,
     inputSchema: {
         keyword: z.string()
             .describe('Keyword or partial name or keyphrase to search for in description'),
-        entityType: z.enum(["UserStories", "Bugs"])
+        entityType: z.enum(["UserStories", "Bugs", "Generals"])
             .default("UserStories")
             .optional()
             .describe('Type of TP entity to search — UserStories or Bugs (default: UserStories)'),
     },
 }, async ({ keyword, entityType = "UserStories" }) => {
-    const results = await tp.searchContainsDescriptionText({ text: keyword, entityType });
+    const results = await Promise.all([
+        tp.searchContainsNameText({ text: keyword, entityType }),
+        tp.searchContainsDescriptionText({ text: keyword, entityType })
+    ]);
     if (!results) {
         return {
             content: [{
@@ -354,7 +358,7 @@ server.registerTool('search_tp_cards', {
                 }],
         };
     }
-    const items = results.Items || [];
+    const items = results.map((item) => item.Items).flat();
     if (items.length == 0) {
         return {
             content: [{
@@ -629,9 +633,15 @@ server.registerTool('create_bug_based_on_card', {
             .default("Manual QA")
             .optional()
             .describe('Where the bug was found, defaults to "Manual QA"'),
+        projectId: z.string()
+            .optional()
+            .describe('Optional Project ID — defaults to TP_PROJECT_ID from config'),
+        teamId: z.string()
+            .optional()
+            .describe('Optional Team ID — defaults to TP_TEAM_ID from config'),
     },
-}, async ({ title, card, bugContent, origin }) => {
-    const bugResponse = await tp.createBug({ title, card, bugContent, origin });
+}, async ({ title, card, bugContent, origin, projectId, teamId }) => {
+    const bugResponse = await tp.createBug({ title, card, bugContent, origin, projectId, teamId });
     if (!bugResponse) {
         return {
             content: [{
@@ -672,9 +682,15 @@ server.registerTool('create_bug', {
             .default("Manual QA")
             .optional()
             .describe('Where the bug was found, defaults to "Manual QA"'),
+        projectId: z.string()
+            .optional()
+            .describe('Optional Project ID — defaults to TP_PROJECT_ID from config'),
+        teamId: z.string()
+            .optional()
+            .describe('Optional Team ID — defaults to TP_TEAM_ID from config'),
     },
-}, async ({ title, bugContent, origin }) => {
-    const bugResponse = await tp.createBugOnly({ title, bugContent, origin });
+}, async ({ title, bugContent, origin, projectId, teamId }) => {
+    const bugResponse = await tp.createBugOnly({ title, bugContent, origin, projectId, teamId });
     if (!bugResponse) {
         return {
             content: [{
@@ -690,6 +706,49 @@ server.registerTool('create_bug', {
             }],
     };
 });
+server.registerTool('create_user_story', {
+    title: 'Create a new user story',
+    description: `Create a new user story in Targetprocess.`,
+    inputSchema: {
+        title: z.string()
+            .describe('User story title'),
+        description: z.string()
+            .optional()
+            .describe('Optional user story description (when provided, format as HTML)'),
+        featureId: z.string()
+            .min(5)
+            .max(6)
+            .optional()
+            .describe('Optional Feature ID to link this user story to (e.g. 145636)'),
+        releaseId: z.string()
+            .min(5)
+            .max(6)
+            .optional()
+            .describe('Optional Release ID to link this user story to (e.g. 145200)'),
+        projectId: z.string()
+            .optional()
+            .describe('Optional Project ID — defaults to TP_PROJECT_ID from config'),
+        teamId: z.string()
+            .optional()
+            .describe('Optional Team ID — defaults to TP_TEAM_ID from config'),
+    },
+}, async ({ title, description, featureId, releaseId, projectId, teamId }) => {
+    const userStoryResponse = await tp.createUserStory({ title, description, featureId, releaseId, projectId, teamId });
+    if (!userStoryResponse) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to create user story "${title}"\n JSON: ${JSON.stringify(userStoryResponse, null, 2)}`
+                }]
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(userStoryResponse)
+            }],
+    };
+});
 server.registerTool('create_test_plan', {
     title: 'Create a new test plan linked to a TP card',
     description: `Create a new test plan linked to a UserStory, Bug, or Feature. Name and Project are required by the API; Description, StartDate, and EndDate are optional.`,

package/build/tp.js

@@ -100,11 +100,11 @@ export class TpClient {
         });
         return response;
     }
-    async createBug({ title, card, bugContent, origin = "Manual QA" }) {
+    async createBug({ title, card, bugContent, origin = "Manual QA", projectId, teamId }) {
         const bug = {
             "Name": title,
             "Project": {
-                "Id": config.tp.projectId
+                "Id": projectId || config.tp.projectId
             },
             "customFields": [{
                     "name": "Origin",
@@ -113,7 +113,7 @@ export class TpClient {
                 }],
             "assignedTeams": [{
                     "team": {
-                        "id": config.tp.teamId
+                        "id": teamId || config.tp.teamId
                     }
                 }],
             "Description": bugContent,
@@ -128,11 +128,11 @@ export class TpClient {
             param: { "format": "json" },
         }, bug);
     }
-    async createBugOnly({ title, bugContent, origin = "Manual QA" }) {
+    async createBugOnly({ title, bugContent, origin = "Manual QA", projectId, teamId }) {
         const bug = {
             "Name": title,
             "Project": {
-                "Id": config.tp.projectId
+                "Id": projectId || config.tp.projectId
             },
             "customFields": [{
                     "name": "Origin",
@@ -141,7 +141,7 @@ export class TpClient {
                 }],
             "assignedTeams": [{
                     "team": {
-                        "id": config.tp.teamId
+                        "id": teamId || config.tp.teamId
                     }
                 }],
             "Description": bugContent,
@@ -151,6 +151,23 @@ export class TpClient {
             param: { "format": "json" },
         }, bug);
     }
+    async createUserStory({ title, description, featureId, releaseId, projectId, teamId }) {
+        const userStory = {
+            "Name": title,
+            "Project": { "Id": projectId || config.tp.projectId },
+            "assignedTeams": [{ "team": { "id": teamId || config.tp.teamId } }],
+        };
+        if (description)
+            userStory["Description"] = description;
+        if (featureId)
+            userStory["Feature"] = { "Id": featureId };
+        if (releaseId)
+            userStory["Release"] = { "Id": releaseId };
+        return this.post({
+            pathParam: { "UserStories": '' },
+            param: { "format": "json" },
+        }, userStory);
+    }
     async createBugBasedOnUserStory(title, userStoryId, bugContent) {
         const bug = {
             "Name": title,

package/package.json

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