@k-system/tickr-mcp 0.2.0 → 0.4.0

package/dist/tools/list-project-members.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+export function registerListProjectMembers(server, api) {
+    server.tool("list_project_members", "List members of a project with their roles", {
+        project: z.string().describe("Project slug"),
+    }, async (params) => {
+        try {
+            const members = await api.get(`/api/projects/${params.project}/members`);
+            if (!members || members.length === 0) {
+                return {
+                    content: [{ type: "text", text: "No members found." }],
+                };
+            }
+            const header = "| User | Email | Role | Added |";
+            const separator = "|------|-------|------|-------|";
+            const rows = members.map((m) => `| ${m.userName} | ${m.email} | ${m.role} | ${m.addedAt?.substring(0, 10) ?? "—"} |`);
+            const text = [header, separator, ...rows].join("\n");
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=list-project-members.js.map

package/dist/tools/list-relations.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function registerListRelations(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=list-relations.d.ts.map

package/dist/tools/list-relations.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+export function registerListRelations(server, api) {
+    server.tool("list_relations", "List all relations for a ticket", {
+        number: z.string().describe("Ticket display number, e.g. 'TKR-42' or 'TKR-BUG-0042'"),
+    }, async (params) => {
+        try {
+            const relations = await api.get(`/api/tickets/${params.number}/relations`);
+            if (relations.length === 0) {
+                return {
+                    content: [{ type: "text", text: `No relations for ${params.number}` }],
+                };
+            }
+            const lines = [
+                "| # | Direction | Type | Ticket | Title | Status |",
+                "|---|-----------|------|--------|-------|--------|",
+                ...relations.map((r, i) => `| ${i + 1} | ${r.direction} | ${r.type} | ${r.displayNumber} | ${r.title} | ${r.status} |`),
+            ];
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=list-relations.js.map

package/dist/tools/list-workflow-presets.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function registerListWorkflowPresets(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=list-workflow-presets.d.ts.map

package/dist/tools/list-workflow-presets.js

@@ -0,0 +1,22 @@
+export function registerListWorkflowPresets(server, api) {
+    server.tool("list_workflow_presets", "List all available workflow presets", {}, async () => {
+        try {
+            const presets = await api.get("/api/workflow-presets");
+            const lines = [
+                "| # | Name | Description | Statuses | Transitions |",
+                "|---|------|-------------|----------|-------------|",
+                ...presets.map((p, i) => `| ${i + 1} | ${p.name} | ${p.description || "-"} | ${p.statusCount} | ${p.transitionCount} |`),
+            ];
+            return {
+                content: [{ type: "text", text: lines.join("\n") || "No presets found." }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=list-workflow-presets.js.map

package/dist/tools/remove-project-member.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function registerRemoveProjectMember(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=remove-project-member.d.ts.map

package/dist/tools/remove-project-member.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export function registerRemoveProjectMember(server, api) {
+    server.tool("remove_project_member", "Remove a member from a project", {
+        project: z.string().describe("Project slug"),
+        user_id: z.string().describe("UUID of the user to remove"),
+    }, async (params) => {
+        try {
+            await api.delete(`/api/projects/${params.project}/members/${params.user_id}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Member ${params.user_id} removed from project "${params.project}"`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=remove-project-member.js.map

package/dist/tools/update-comment.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function registerUpdateComment(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=update-comment.d.ts.map

package/dist/tools/update-comment.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+export function registerUpdateComment(server, api) {
+    server.tool("update_comment", "Update the text of an existing comment", {
+        comment_id: z.string().describe("UUID of the comment to update"),
+        text: z.string().describe("New comment text (markdown)"),
+    }, async (params) => {
+        try {
+            const text = params.text.replace(/\\n/g, "\n");
+            await api.put(`/api/comments/${params.comment_id}`, { text });
+            return {
+                content: [
+                    { type: "text", text: `Comment ${params.comment_id} updated` },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=update-comment.js.map

package/dist/tools/update-cycle.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function registerUpdateCycle(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=update-cycle.d.ts.map

package/dist/tools/update-cycle.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+export function registerUpdateCycle(server, api) {
+    server.tool("update_cycle", "Update a cycle (sprint) in a project", {
+        project: z.string().describe("Project slug"),
+        cycle_id: z.string().describe("UUID of the cycle to update"),
+        name: z.string().optional().describe("New cycle name"),
+        startDate: z.string().optional().describe("New start date (ISO 8601, e.g. '2026-03-15')"),
+        endDate: z.string().optional().describe("New end date (ISO 8601, e.g. '2026-03-29')"),
+        status: z.string().optional().describe("New status: planned, active, completed"),
+    }, async (params) => {
+        try {
+            const body = {};
+            if (params.name !== undefined)
+                body.name = params.name;
+            if (params.startDate !== undefined)
+                body.startDate = params.startDate;
+            if (params.endDate !== undefined)
+                body.endDate = params.endDate;
+            if (params.status !== undefined)
+                body.status = params.status;
+            await api.put(`/api/projects/${params.project}/cycles/${params.cycle_id}`, body);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Cycle ${params.cycle_id} updated in project ${params.project}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=update-cycle.js.map

package/dist/tools/update-epic.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function registerUpdateEpic(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=update-epic.d.ts.map

package/dist/tools/update-epic.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+export function registerUpdateEpic(server, api) {
+    server.tool("update_epic", "Update an epic in a project", {
+        project: z.string().describe("Project slug"),
+        epic_id: z.string().describe("UUID of the epic to update"),
+        name: z.string().optional().describe("New epic name"),
+        description: z.string().optional().describe("New epic description"),
+        color: z.string().optional().describe("New hex color code, e.g. '#6366f1'"),
+        startDate: z.string().optional().describe("New start date (YYYY-MM-DD)"),
+        targetDate: z.string().optional().describe("New target date (YYYY-MM-DD)"),
+    }, async (params) => {
+        try {
+            const body = {};
+            if (params.name !== undefined)
+                body.name = params.name;
+            if (params.description !== undefined)
+                body.description = params.description.replace(/\\n/g, "\n");
+            if (params.color !== undefined)
+                body.color = params.color;
+            if (params.startDate !== undefined)
+                body.startDate = params.startDate;
+            if (params.targetDate !== undefined)
+                body.targetDate = params.targetDate;
+            await api.put(`/api/projects/${params.project}/epics/${params.epic_id}`, body);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Epic ${params.epic_id} updated in project ${params.project}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=update-epic.js.map

package/dist/tools/update-label.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function registerUpdateLabel(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=update-label.d.ts.map

package/dist/tools/update-label.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+export function registerUpdateLabel(server, api) {
+    server.tool("update_label", "Update a label in a project", {
+        project: z.string().describe("Project slug"),
+        label_id: z.string().describe("UUID of the label to update"),
+        name: z.string().optional().describe("New label name"),
+        color: z.string().optional().describe("New hex color code, e.g. '#ef4444'"),
+    }, async (params) => {
+        try {
+            const body = {};
+            if (params.name !== undefined)
+                body.name = params.name;
+            if (params.color !== undefined)
+                body.color = params.color;
+            await api.put(`/api/projects/${params.project}/labels/${params.label_id}`, body);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Label ${params.label_id} updated in project ${params.project}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=update-label.js.map

package/dist/tools/update-project-member-role.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function registerUpdateProjectMemberRole(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=update-project-member-role.d.ts.map

package/dist/tools/update-project-member-role.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+export function registerUpdateProjectMemberRole(server, api) {
+    server.tool("update_project_member_role", "Update the role of a project member", {
+        project: z.string().describe("Project slug"),
+        user_id: z.string().describe("UUID of the user"),
+        role: z
+            .enum(["Viewer", "Developer", "Analytic", "Editor", "ProjectAdmin"])
+            .describe("New project role"),
+    }, async (params) => {
+        try {
+            await api.put(`/api/projects/${params.project}/members/${params.user_id}/role`, { role: params.role });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Role updated to ${params.role} for user ${params.user_id} in project "${params.project}"`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=update-project-member-role.js.map

package/dist/tools/update-status.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function registerUpdateStatus(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=update-status.d.ts.map

package/dist/tools/update-status.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+export function registerUpdateStatus(server, api) {
+    server.tool("update_status", "Update a workflow status in a project", {
+        project: z.string().describe("Project slug"),
+        status_id: z.string().describe("Status ID to update"),
+        name: z.string().optional().describe("New display name"),
+        emoji: z.string().optional().describe("New emoji icon"),
+        color: z.string().optional().describe("New hex color code, e.g. '#3b82f6'"),
+        category: z.string().optional().describe("New category: backlog, active, done, cancelled"),
+    }, async (params) => {
+        try {
+            const body = {};
+            if (params.name !== undefined)
+                body.name = params.name;
+            if (params.emoji !== undefined)
+                body.emoji = params.emoji;
+            if (params.color !== undefined)
+                body.color = params.color;
+            if (params.category !== undefined)
+                body.category = params.category;
+            await api.put(`/api/projects/${params.project}/statuses/${params.status_id}`, body);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Status ${params.status_id} updated in project ${params.project}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=update-status.js.map

package/dist/tools/update-ticket.js

@@ -8,13 +8,21 @@ export function registerUpdateTicket(server, api) {
         priority: z.string().optional(),
         assignee: z.string().optional().describe("Username or 'unassigned'"),
         scope: z.string().optional(),
+        due_date: z.string().optional().describe("Due date in YYYY-MM-DD format, or 'clear' to remove"),
     }, async (params) => {
         try {
-            const { number, ...updates } = params;
+            const { number, due_date, ...rest } = params;
             // Unescapovat double-escaped newlines z MCP tool parametrů
-            if (updates.content)
-                updates.content = updates.content.replace(/\\n/g, "\n");
-            const ticket = await api.put(`/api/tickets/${number}`, updates);
+            if (rest.content)
+                rest.content = rest.content.replace(/\\n/g, "\n");
+            const body = { ...rest };
+            if (due_date === "clear") {
+                body.clearDueDate = true;
+            }
+            else if (due_date) {
+                body.dueDate = due_date;
+            }
+            const ticket = await api.put(`/api/tickets/${number}`, body);
             return {
                 content: [
                     {

package/dist/tools/update-transitions.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function registerUpdateTransitions(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=update-transitions.d.ts.map

package/dist/tools/update-transitions.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+export function registerUpdateTransitions(server, api) {
+    server.tool("update_transitions", "Replace all workflow transitions for a project", {
+        project: z.string().describe("Project slug"),
+        transitions: z
+            .array(z.object({
+            fromStatusId: z.string().describe("Source status ID"),
+            toStatusId: z.string().describe("Target status ID"),
+            allowedRoles: z
+                .array(z.string())
+                .optional()
+                .describe("Roles allowed to perform this transition"),
+        }))
+            .describe("Array of transition definitions"),
+    }, async (params) => {
+        try {
+            await api.put(`/api/projects/${params.project}/transitions`, {
+                transitions: params.transitions,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Updated ${params.transitions.length} transitions for project ${params.project}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=update-transitions.js.map

package/package.json

@@ -1,16 +1,18 @@
 {
   "name": "@k-system/tickr-mcp",
-  "version": "0.2.0",
-  "description": "MCP server for Tickr project management — 40 tools for ticket CRUD, workflow, projects, attachments, triage, labels, cycles, epics",
+  "version": "0.4.0",
+  "description": "MCP server for Tickr project management — 56 tools + setup CLI wizard",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {
     "tickr-mcp": "./dist/index.js",
-    "k-system-tickr-mcp": "./dist/index.js"
+    "k-system-tickr-mcp": "./dist/index.js",
+    "tickr-setup": "./dist/cli/setup.js"
   },
   "files": [
     "dist/**/*.js",
     "dist/**/*.d.ts",
+    "dist/cli/**/*",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -43,6 +45,7 @@
     "prepublishOnly": "npm run test && npm run build"
   },
   "dependencies": {
+    "@inquirer/prompts": "^7.5.0",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "zod": "^3.24.4"
   },