targetprocess-mcp-server 2.6.0 → 2.6.1

package/build/handlers/delete_card.js

@@ -0,0 +1,19 @@
+export async function handleDeleteCard(tp, params) {
+    const result = await tp.deleteCard(params);
+    if (!result.ok) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to delete ${params.type} id: ${params.id}\n` +
+                        `HTTP status: ${result.status}\n` +
+                        `Response body: ${result.body}`
+                }],
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({ deleted: true, id: Number(params.id), type: params.type, card: result.data })
+            }],
+    };
+}

package/build/handlers/get_team_iterations.js

@@ -0,0 +1,30 @@
+export async function handleGetTeamIterations(tp, params) {
+    const response = await tp.getTeamIterations(params);
+    if (!response) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to get team iterations, JSON: ${JSON.stringify(response, null, 2)}`
+                }],
+        };
+    }
+    const items = response.Items || [];
+    if (items.length === 0) {
+        return {
+            content: [{ type: 'text', text: 'No team iterations found' }],
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(items.map((i) => ({
+                    id: i.Id,
+                    name: i.Name,
+                    startDate: i.StartDate,
+                    endDate: i.EndDate,
+                    teamId: i.Team?.Id,
+                    teamName: i.Team?.Name,
+                }))),
+            }],
+    };
+}

package/build/index.js

@@ -20,6 +20,7 @@ import { handleGetReleaseOpenBugs } from "./handlers/get_release_open_bugs.js";
 import { handleGetReleaseOpenUserStories } from "./handlers/get_release_open_user_stories.js";
 import { handleGetUsers } from "./handlers/get_users.js";
 import { handleGetTeams, handleGetTeamsAndTeamAssignments } from "./handlers/get_teams.js";
+import { handleGetTeamIterations } from "./handlers/get_team_iterations.js";
 import { handleAddComment } from "./handlers/add_comment.js";
 import { handleGetUserStoryComments } from "./handlers/get_user_story_comments.js";
 import { handleGetBugComments } from "./handlers/get_bug_comments.js";
@@ -44,6 +45,7 @@ import { handleUpdateUserStorySubState } from "./handlers/update_user_story_sub_
 import { handleGetCardRelations } from "./handlers/get_card_relations.js";
 import { handleCreateCardRelation } from "./handlers/create_card_relation.js";
 import { handleDeleteCardRelation } from "./handlers/delete_card_relation.js";
+import { handleDeleteCard } from "./handlers/delete_card.js";
 import { handleGetTestPlanById } from "./handlers/get_test_plan_by_id.js";
 import { handleGetTestPlanTestCasesById } from "./handlers/get_test_plan_test_cases_by_id.js";
 import { handleGetTestPlanTestCasesWithStepsById } from "./handlers/get_test_plan_test_cases_with_steps_by_id.js";
@@ -409,7 +411,8 @@ server.registerTool('update_bug', {
       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;`,
+        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;
+        4) IF the user specified a sprint/iteration by name, call "get_team_iterations" to find the matching iteration and use its ID as teamIterationId;`,
     inputSchema: {
         id: z.string()
             .min(5)
@@ -443,8 +446,14 @@ server.registerTool('update_bug', {
         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"'),
+        tags: z.string()
+            .optional()
+            .describe('Optional comma-separated tags to apply, e.g. "regression, mobile"'),
+        teamIterationId: z.string()
+            .optional()
+            .describe('Optional Team Iteration (sprint) ID — resolve it via "get_team_iterations" first'),
     },
-}, async ({ id, title, bugContent, origin, projectId, teamId, entityStateId }) => handleUpdateBug(tp, { id, title, bugContent, origin, projectId, teamId, entityStateId }));
+}, async ({ id, title, bugContent, origin, projectId, teamId, entityStateId, tags, teamIterationId }) => handleUpdateBug(tp, { id, title, bugContent, origin, projectId, teamId, entityStateId, tags, teamIterationId }));
 server.registerTool('update_user_story_state', {
     title: 'Update a user story card sub state',
     description: `Update a user story card sub state with data provided from user input.
@@ -474,7 +483,8 @@ server.registerTool('update_user_story', {
       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;`,
+        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;
+        4) IF the user specified a sprint/iteration by name, call "get_team_iterations" to find the matching iteration and use its ID as teamIterationId;`,
     inputSchema: {
         id: z.string()
             .min(5)
@@ -498,9 +508,15 @@ server.registerTool('update_user_story', {
         featureId: z.string()
             .optional()
             .describe('Optional Feature ID — moves this user story to the specified feature'),
+        tags: z.string()
+            .optional()
+            .describe('Optional comma-separated tags to apply, e.g. "regression, mobile"'),
+        teamIterationId: z.string()
+            .optional()
+            .describe('Optional Team Iteration (sprint) ID — resolve it via "get_team_iterations" first'),
     },
-}, async ({ id, title, description, projectId, teamId, entityStateId, featureId }) => {
-    const response = await tp.updateUserStory({ id, title, description, projectId, teamId, entityStateId, featureId });
+}, async ({ id, title, description, projectId, teamId, entityStateId, featureId, tags, teamIterationId }) => {
+    const response = await tp.updateUserStory({ id, title, description, projectId, teamId, entityStateId, featureId, tags, teamIterationId });
     if (!response) {
         return {
             content: [{
@@ -523,7 +539,8 @@ server.registerTool('create_bug', {
       CRITICAL WORKFLOW: Before calling this tool, you MUST follow these steps:
         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;`,
+        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;
+        4) IF the user specified a sprint/iteration by name, call "get_team_iterations" to find the matching iteration and use its ID as teamIterationId;`,
     inputSchema: {
         title: z.string()
             .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'),
@@ -552,11 +569,18 @@ server.registerTool('create_bug', {
         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"'),
+        tags: z.string()
+            .optional()
+            .describe('Optional comma-separated tags to apply, e.g. "regression, mobile"'),
+        teamIterationId: z.string()
+            .optional()
+            .describe('Optional Team Iteration (sprint) ID — resolve it via "get_team_iterations" first'),
     },
-}, async ({ title, bugContent, origin, projectId, teamId, entityStateId }) => handleCreateBug(tp, { title, bugContent, origin, projectId, teamId, entityStateId }));
+}, async ({ title, bugContent, origin, projectId, teamId, entityStateId, tags, teamIterationId }) => handleCreateBug(tp, { title, bugContent, origin, projectId, teamId, entityStateId, tags, teamIterationId }));
 server.registerTool('create_user_story', {
     title: 'Create a new user story',
-    description: `Create a new user story in Targetprocess.`,
+    description: `Create a new user story in Targetprocess.
+      CRITICAL WORKFLOW: Before calling this tool, IF the user specified a sprint/iteration by name, call "get_team_iterations" to find the matching iteration and use its ID as teamIterationId.`,
     inputSchema: {
         title: z.string()
             .describe('User story title'),
@@ -579,8 +603,14 @@ server.registerTool('create_user_story', {
         teamId: z.string()
             .optional()
             .describe('Optional Team ID — defaults to TP_TEAM_ID from config'),
+        tags: z.string()
+            .optional()
+            .describe('Optional comma-separated tags to apply, e.g. "regression, mobile"'),
+        teamIterationId: z.string()
+            .optional()
+            .describe('Optional Team Iteration (sprint) ID — resolve it via "get_team_iterations" first'),
     },
-}, async ({ title, description, featureId, releaseId, projectId, teamId }) => handleCreateUserStory(tp, { title, description, featureId, releaseId, projectId, teamId }));
+}, async ({ title, description, featureId, releaseId, projectId, teamId, tags, teamIterationId }) => handleCreateUserStory(tp, { title, description, featureId, releaseId, projectId, teamId, tags, teamIterationId }));
 server.registerTool('create_formatted_user_story', {
     title: 'Create a formatted user story',
     description: `Create a new user story in Targetprocess with a structured, template-driven description.
@@ -589,7 +619,8 @@ server.registerTool('create_formatted_user_story', {
         1) IF the user specified a feature by name (not ID), call "get_feature_user_stories" or "search_tp_cards" to resolve the feature ID;
         2) IF the user specified a release by name (not ID), call "get_current_releases" to resolve the release ID;
         3) IF the user specified a team by name (not ID), call "get_teams" to find the matching team and use its ID as teamId;
-        4) IF the user specified a project by name (not ID), call "get_projects" to find the matching project and use its ID as projectId;`,
+        4) IF the user specified a project by name (not ID), call "get_projects" to find the matching project and use its ID as projectId;
+        5) IF the user specified a sprint/iteration by name, call "get_team_iterations" to find the matching iteration and use its ID as teamIterationId;`,
     inputSchema: {
         title: z.string()
             .describe('User story title'),
@@ -657,8 +688,14 @@ server.registerTool('create_formatted_user_story', {
         teamId: z.string()
             .optional()
             .describe('Optional Team ID — defaults to TP_TEAM_ID from config'),
+        tags: z.string()
+            .optional()
+            .describe('Optional comma-separated tags to apply, e.g. "regression, mobile"'),
+        teamIterationId: z.string()
+            .optional()
+            .describe('Optional Team Iteration (sprint) ID — resolve it via "get_team_iterations" first'),
     },
-}, async ({ title, header, definitions, acceptanceCriteria, scenarios, examplesTable, edgeCases, references, notes, featureId, releaseId, projectId, teamId }) => {
+}, async ({ title, header, definitions, acceptanceCriteria, scenarios, examplesTable, edgeCases, references, notes, featureId, releaseId, projectId, teamId, tags, teamIterationId }) => {
     const gherkinBlock = (items) => items.map((s, indx) => `<div><strong>Scenario ${indx + 1} - ${s.name}:</strong></div><div>${s.steps.map(step => `<div>\t${step}</div>`).join('\n')}</div>`).join('<br>');
     const parts = ['<div>'];
     parts.push('<h3>Header</h3>');
@@ -699,7 +736,7 @@ server.registerTool('create_formatted_user_story', {
     }
     parts.push('</div>');
     const description = parts.join('\n');
-    const userStoryResponse = await tp.createUserStory({ title, description, featureId, releaseId, projectId, teamId });
+    const userStoryResponse = await tp.createUserStory({ title, description, featureId, releaseId, projectId, teamId, tags, teamIterationId });
     if (!userStoryResponse) {
         return {
             content: [{
@@ -961,6 +998,16 @@ server.registerTool('get_teams', {
     title: 'Get teams',
     description: 'Get all Targetprocess teams',
 }, async () => handleGetTeams(tp));
+server.registerTool('get_team_iterations', {
+    title: 'Get team iterations',
+    description: `Get Targetprocess team iterations (sprints), optionally filtered by team. Use this to resolve a sprint/iteration name to an ID before calling create_user_story, create_bug, update_user_story, or update_bug with teamIterationId.
+      CRITICAL WORKFLOW: IF the user specified a team by name (not ID), call "get_teams" first to find the matching team and use its ID as teamId.`,
+    inputSchema: {
+        teamId: z.string()
+            .optional()
+            .describe('Optional Team ID to filter iterations by — resolve it via "get_teams" first'),
+    },
+}, async ({ teamId }) => handleGetTeamIterations(tp, { teamId }));
 server.registerTool('get_logged_in_user', {
     title: 'Get logged in user',
     description: 'Get logged in user',
@@ -1235,6 +1282,17 @@ server.registerTool('delete_card_relation', {
             .describe('The relation ID to delete (the "relationId" field from "get_card_relations", e.g. 20748)'),
     },
 }, async ({ relationId }) => handleDeleteCardRelation(tp, relationId));
+server.registerTool('delete_card', {
+    title: 'Delete a card (Bug, User Story, Feature, or Epic)',
+    description: `Delete (remove) a Targetprocess card by its ID. Works on Bugs, User Stories, Features, and Epics.
+      IF the type is uncertain, resolve it first via "search_tp_cards" or by fetching the card.`,
+    inputSchema: {
+        id: z.string()
+            .describe('The card ID to delete (e.g. 148980)'),
+        type: z.enum(["Bug", "UserStory", "Feature", "Epic"])
+            .describe('The entity type of the card being deleted'),
+    },
+}, async ({ id, type }) => handleDeleteCard(tp, { id, type }));
 server.registerTool('get_in_progress_tasks_and_bugs', {
     title: 'Get in-progress tasks and bugs for a user',
     description: 'Get all Tasks and Bugs currently in "In Progress" state assigned to a given user ID',

package/build/tp.js

@@ -24,6 +24,11 @@ export class TpClient {
         }
         return _url + "/?" + _urlParams.join("&");
     }
+    // Strips the access_token value out of a URL before it's logged, so the
+    // live TP credential never ends up in stderr/log files.
+    redact(url) {
+        return url.replace(this.token, "***");
+    }
     // @ts-ignore
     async getAll(params) {
         const allItems = [];
@@ -58,14 +63,14 @@ export class TpClient {
         }
         catch (error) {
             console.error("Error making TP request:", error);
-            console.error("Request URL:", _url);
+            console.error("Request URL:", this.redact(_url));
             return null;
         }
     }
     async post(params, data) {
         params.param["access_token"] = this.token;
         let _url = this.params(params);
-        console.error(JSON.stringify({ "TP_POST_URL": _url }));
+        console.error(JSON.stringify({ "TP_POST_URL": this.redact(_url) }));
         console.error(JSON.stringify({ "TP_POST_BODY": data }));
         try {
             const response = await fetch(_url, {
@@ -88,7 +93,7 @@ export class TpClient {
     async postRaw(params, data) {
         params.param["access_token"] = this.token;
         let _url = this.params(params);
-        console.error(JSON.stringify({ "TP_POST_URL": _url }));
+        console.error(JSON.stringify({ "TP_POST_URL": this.redact(_url) }));
         console.error(JSON.stringify({ "TP_POST_BODY": data }));
         try {
             const response = await fetch(_url, {
@@ -113,7 +118,7 @@ export class TpClient {
     async del(params) {
         params.param["access_token"] = this.token;
         let _url = this.params(params);
-        console.error(JSON.stringify({ "TP_DELETE_URL": _url }));
+        console.error(JSON.stringify({ "TP_DELETE_URL": this.redact(_url) }));
         try {
             const response = await fetch(_url, {
                 method: "DELETE",
@@ -227,7 +232,7 @@ export class TpClient {
             param: { "format": "json" },
         }, userStory);
     }
-    async updateUserStory({ id, title, description, projectId, teamId, entityStateId, featureId }) {
+    async updateUserStory({ id, title, description, projectId, teamId, entityStateId, featureId, tags, teamIterationId }) {
         const userStory = { "Id": id };
         if (title)
             userStory["Name"] = title;
@@ -241,12 +246,16 @@ export class TpClient {
             userStory["EntityState"] = { "Id": entityStateId };
         if (featureId)
             userStory["Feature"] = { "Id": featureId };
+        if (tags)
+            userStory["Tags"] = tags;
+        if (teamIterationId)
+            userStory["TeamIteration"] = { "Id": teamIterationId };
         return this.post({
             pathParam: ["UserStories"],
             param: { "format": "json" },
         }, userStory);
     }
-    async updateBug({ id, title, bugContent, origin, projectId, teamId, entityStateId }) {
+    async updateBug({ id, title, bugContent, origin, projectId, teamId, entityStateId, tags, teamIterationId }) {
         const bug = { "Id": id };
         if (title)
             bug["Name"] = title;
@@ -268,12 +277,16 @@ export class TpClient {
                 }];
         if (entityStateId)
             bug["entityState"] = { "id": entityStateId };
+        if (tags)
+            bug["Tags"] = tags;
+        if (teamIterationId)
+            bug["TeamIteration"] = { "Id": teamIterationId };
         return this.post({
             pathParam: ["bugs"],
             param: { "format": "json" },
         }, bug);
     }
-    async createBugOnly({ title, bugContent, origin = "Manual QA", projectId, teamId, entityStateId }) {
+    async createBugOnly({ title, bugContent, origin = "Manual QA", projectId, teamId, entityStateId, tags, teamIterationId }) {
         const bug = {
             "Name": title,
             "Project": {
@@ -293,12 +306,16 @@ export class TpClient {
         };
         if (entityStateId)
             bug["EntityState"] = { "Id": entityStateId };
+        if (tags)
+            bug["Tags"] = tags;
+        if (teamIterationId)
+            bug["TeamIteration"] = { "Id": teamIterationId };
         return this.post({
             pathParam: ["bugs"],
             param: { "format": "json" },
         }, bug);
     }
-    async createUserStory({ title, description, featureId, releaseId, projectId, teamId }) {
+    async createUserStory({ title, description, featureId, releaseId, projectId, teamId, tags, teamIterationId }) {
         const userStory = {
             "Name": title,
             "Project": { "Id": projectId || config.tp.projectId },
@@ -310,11 +327,25 @@ export class TpClient {
             userStory["Feature"] = { "Id": featureId };
         if (releaseId)
             userStory["Release"] = { "Id": releaseId };
+        if (tags)
+            userStory["Tags"] = tags;
+        if (teamIterationId)
+            userStory["TeamIteration"] = { "Id": teamIterationId };
         return this.post({
             pathParam: ["UserStories"],
             param: { "format": "json" },
         }, userStory);
     }
+    async getTeamIterations({ teamId } = {}) {
+        return this.get({
+            pathParam: ["TeamIterations"],
+            param: {
+                "format": "json",
+                ...(teamId ? { "where": `Team.Id eq ${teamId}` } : {}),
+                "include": "[Id,Name,StartDate,EndDate,Team[Id,Name]]",
+            },
+        });
+    }
     async getEpic(epicId) {
         return this.get({
             pathParam: ["Epics", epicId],
@@ -798,6 +829,18 @@ export class TpClient {
             param: { "format": "json" },
         });
     }
+    async deleteCard({ id, type }) {
+        const pathSegment = {
+            "Bug": "bugs",
+            "UserStory": "userStories",
+            "Feature": "features",
+            "Epic": "Epics",
+        };
+        return this.del({
+            pathParam: [pathSegment[type], id],
+            param: { "format": "json" },
+        });
+    }
     async getProjects() {
         return this.get({
             pathParam: ["Projects"],
@@ -1106,7 +1149,7 @@ export class TpClient {
         formData.append("generalId", generalId);
         formData.append("file", blob, fileName);
         const url = `${this.baseUrl}/UploadFile.ashx?access_token=${this.token}`;
-        console.error(JSON.stringify({ "UPLOAD_URL": url.replace(this.token, "***") }, null, 2));
+        console.error(JSON.stringify({ "UPLOAD_URL": this.redact(url) }, null, 2));
         try {
             const response = await fetch(url, {
                 method: "POST",

package/package.json

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