@shortcut/mcp 0.17.0 → 0.18.0

package/README.md

@@ -148,6 +148,10 @@ Or you can edit the local JSON file directly:
 - **stories-set-external-links** - Replace all external links on a story with a new set of links
 - **stories-get-by-external-link** - Find all stories that contain a specific external link
 
+### Labels
+- **labels-list** - List all labels in the Shortcut workspace.
+- **labels-create** - Create a new label in Shortcut.
+
 ### Epics
 
 - **epics-get-by-id** - Get a Shortcut epic by ID
@@ -227,6 +231,7 @@ The following values are accepted in addition to the full tool names listed abov
 - `stories`
 - `epics`
 - `iterations`
+- `labels`
 - `objectives`
 - `teams`
 - `workflows`

package/dist/index.js

@@ -1,8 +1,51 @@
 #!/usr/bin/env node
-import { CustomMcpServer, DocumentTools, EpicTools, IterationTools, ObjectiveTools, ShortcutClientWrapper, StoryTools, TeamTools, UserTools, WorkflowTools } from "./workflows-TjriXV16.js";
+import { BaseTools, CustomMcpServer, DocumentTools, EpicTools, IterationTools, ObjectiveTools, ShortcutClientWrapper, StoryTools, TeamTools, UserTools, WorkflowTools } from "./workflows-Dko3ibgz.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { ShortcutClient } from "@shortcut/client";
+import { z } from "zod";
 
+//#region src/tools/labels.ts
+/**
+* Tools for managing Shortcut labels.
+*/
+var LabelTools = class LabelTools extends BaseTools {
+	static create(client$1, server$1) {
+		const tools = new LabelTools(client$1);
+		server$1.addToolWithReadAccess("labels-list", "List all labels in the Shortcut workspace.", { includeArchived: z.boolean().optional().describe("Whether to include archived labels in the list.").default(false) }, async (params) => await tools.listLabels(params));
+		server$1.addToolWithWriteAccess("labels-create", "Create a new label in Shortcut.", {
+			name: z.string().min(1).max(128).describe("The name of the new label. Required."),
+			color: z.string().regex(/^#[a-fA-F0-9]{6}$/).optional().describe("The hex color to be displayed with the label (e.g., \"#ff0000\")."),
+			description: z.string().max(1024).optional().describe("A description of the label.")
+		}, async (params) => await tools.createLabel(params));
+		return tools;
+	}
+	formatLabel(label, { includeDescription = false, includeArchived = false } = {}) {
+		return {
+			id: label.id,
+			name: label.name,
+			app_url: label.app_url,
+			...includeDescription ? { description: label.description ?? null } : {},
+			...includeArchived ? { archived: label.archived } : {},
+			stats: Object.fromEntries(Object.entries(label.stats || {}).filter(([key, value]) => !key.match(/(unestimated|total)$/) && !!value))
+		};
+	}
+	async listLabels({ includeArchived = false }) {
+		const labels = await this.client.listLabels({ includeArchived });
+		if (!labels.length) return this.toResult("Result: No labels found.");
+		const formattedLabels = labels.map((label) => this.formatLabel(label, { includeArchived }));
+		return this.toResult(`Result (${labels.length} labels found):`, { labels: formattedLabels });
+	}
+	async createLabel({ name, color, description }) {
+		const label = await this.client.createLabel({
+			name,
+			color,
+			description
+		});
+		return this.toResult(`Label created with ID: ${label.id}.`, { label: this.formatLabel(label, { includeDescription: true }) });
+	}
+};
+
+//#endregion
 //#region src/server.ts
 let apiToken = process.env.SHORTCUT_API_TOKEN;
 let isReadonly = process.env.SHORTCUT_READONLY === "true";
@@ -29,6 +72,7 @@ ObjectiveTools.create(client, server);
 TeamTools.create(client, server);
 WorkflowTools.create(client, server);
 DocumentTools.create(client, server);
+LabelTools.create(client, server);
 async function startServer() {
 	try {
 		const transport = new StdioServerTransport();

package/dist/server-http.js

@@ -1,4 +1,4 @@
-import { CustomMcpServer, DocumentTools, EpicTools, IterationTools, ObjectiveTools, ShortcutClientWrapper, StoryTools, TeamTools, UserTools, WorkflowTools } from "./workflows-TjriXV16.js";
+import { CustomMcpServer, DocumentTools, EpicTools, IterationTools, ObjectiveTools, ShortcutClientWrapper, StoryTools, TeamTools, UserTools, WorkflowTools } from "./workflows-Dko3ibgz.js";
 import { ShortcutClient } from "@shortcut/client";
 import { randomUUID } from "node:crypto";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";

package/dist/{workflows-TjriXV16.js → workflows-Dko3ibgz.js}

@@ -476,12 +476,24 @@ var ShortcutClientWrapper = class {
 		await this.loadCustomFields();
 		return Array.from(this.customFieldCache.values());
 	}
+	async listLabels({ includeArchived = false }) {
+		const response = await this.client.listLabels({ slim: false });
+		const allLabels = response?.data ?? [];
+		if (includeArchived) return allLabels;
+		return allLabels.filter((label) => !label.archived);
+	}
+	async createLabel(params) {
+		const response = await this.client.createLabel(params);
+		const label = response?.data ?? null;
+		if (!label) throw new Error(`Failed to create the label: ${response.status}`);
+		return label;
+	}
 };
 
 //#endregion
 //#region package.json
 var name = "@shortcut/mcp";
-var version = "0.17.0";
+var version = "0.18.0";
 
 //#endregion
 //#region src/mcp/CustomMcpServer.ts
@@ -1688,4 +1700,4 @@ var WorkflowTools = class WorkflowTools extends BaseTools {
 };
 
 //#endregion
-export { CustomMcpServer, DocumentTools, EpicTools, IterationTools, ObjectiveTools, ShortcutClientWrapper, StoryTools, TeamTools, UserTools, WorkflowTools };
+export { BaseTools, CustomMcpServer, DocumentTools, EpicTools, IterationTools, ObjectiveTools, ShortcutClientWrapper, StoryTools, TeamTools, UserTools, WorkflowTools };

package/package.json

@@ -12,7 +12,7 @@
 		"modelcontextprotocol"
 	],
 	"license": "MIT",
-	"version": "0.17.0",
+	"version": "0.18.0",
 	"type": "module",
 	"main": "dist/index.js",
 	"bin": {