@shortcut/mcp 0.11.1 → 0.12.0

package/README.md

@@ -71,6 +71,15 @@ See the [official Claude Code docs](https://docs.anthropic.com/en/docs/agents-an
 
 _You can add a new MCP server from the Claude Code CLI. But modifying the json file directly is simpler!_
 
+You can either add a new MCP server from the command line:
+
+```shell
+# Grab your Shortcut token here: https://app.shortcut.com/settings/account/api-tokens
+claude mcp add shortcut --transport=stdio -e API_KEY=$SHORTCUT_API_TOKEN -- npx -y @shortcut/mcp@latest
+```
+
+Or you can edit the local JSON file directly:
+
 1. Open the Claude Code configuration file (it should be in `~/.claude.json`).
 2. Find the `projects` > `mcpServers` section and add the following details and save the file:
 

package/dist/index.js

@@ -2,6 +2,9 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { ShortcutClient } from "@shortcut/client";
+import { File } from "node:buffer";
+import { readFileSync } from "node:fs";
+import { basename } from "node:path";
 import { z } from "zod";
 
 //#region src/client/cache.ts
@@ -422,6 +425,18 @@ var ShortcutClientWrapper = class {
 		if (!doc) throw new Error(`Failed to create the document: ${response.status}`);
 		return doc;
 	}
+	async uploadFile(storyId, filePath) {
+		const fileContent = readFileSync(filePath);
+		const fileName = basename(filePath);
+		const file = new File([fileContent], fileName);
+		const response = await this.client.uploadFiles({
+			story_id: storyId,
+			file0: file
+		});
+		const uploadedFile = response?.data ?? null;
+		if (!uploadedFile?.length) throw new Error(`Failed to upload the file: ${response.status}`);
+		return uploadedFile[0];
+	}
 	async getCustomFieldMap(customFieldIds) {
 		await this.loadCustomFields();
 		return new Map(customFieldIds.map((id) => [id, this.customFieldCache.get(id)]).filter((customField) => customField[1] !== null));
@@ -435,7 +450,7 @@ var ShortcutClientWrapper = class {
 //#endregion
 //#region package.json
 var name = "@shortcut/mcp";
-var version = "0.11.1";
+var version = "0.12.0";
 
 //#endregion
 //#region src/tools/base.ts
@@ -1194,6 +1209,10 @@ The story will be added to the default state for the workflow.
 				description: z.string().optional().describe("The description of the label")
 			})).optional().describe("Labels to assign to the story")
 		}, async (params) => await tools.updateStory(params));
+		server$1.tool("upload-file-to-story", "Upload a file and link it to a story.", {
+			storyPublicId: z.number().positive().describe("The public ID of the story"),
+			filePath: z.string().describe("The path to the file to upload")
+		}, async ({ storyPublicId, filePath }) => await tools.uploadFileToStory(storyPublicId, filePath));
 		server$1.tool("assign-current-user-as-owner", "Assign the current user as the owner of a story", { storyPublicId: z.number().positive().describe("The public ID of the story") }, async ({ storyPublicId }) => await tools.assignCurrentUserAsOwner(storyPublicId));
 		server$1.tool("unassign-current-user-as-owner", "Unassign the current user as the owner of a story", { storyPublicId: z.number().positive().describe("The public ID of the story") }, async ({ storyPublicId }) => await tools.unassignCurrentUserAsOwner(storyPublicId));
 		server$1.tool("create-story-comment", "Create a comment on a story", {
@@ -1326,6 +1345,15 @@ The story will be added to the default state for the workflow.
 		const updatedStory = await this.client.updateStory(storyPublicId, updateParams);
 		return this.toResult(`Updated story sc-${storyPublicId}. Story URL: ${updatedStory.app_url}`);
 	}
+	async uploadFileToStory(storyPublicId, filePath) {
+		if (!storyPublicId) throw new Error("Story public ID is required");
+		if (!filePath) throw new Error("File path is required");
+		const story = await this.client.getStory(storyPublicId);
+		if (!story) throw new Error(`Failed to retrieve Shortcut story with public ID: ${storyPublicId}`);
+		const uploadedFile = await this.client.uploadFile(storyPublicId, filePath);
+		if (!uploadedFile) throw new Error(`Failed to upload file to story sc-${storyPublicId}`);
+		return this.toResult(`Uploaded file "${uploadedFile.name}" to story sc-${storyPublicId}. File ID is: ${uploadedFile.id}`);
+	}
 	async addTaskToStory({ storyPublicId, taskDescription, taskOwnerIds }) {
 		if (!storyPublicId) throw new Error("Story public ID is required");
 		if (!taskDescription) throw new Error("Task description is required");

package/package.json

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