@shortcut/mcp 0.2.1 → 0.3.0

package/README.md

@@ -51,8 +51,38 @@ See the [official Cursor docs](https://docs.cursor.com/context/model-context-pro
 }
 ```
 
+### Claude Code
+
+See the [official Claude Code docs](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#set-up-model-context-protocol-mcp) for more information.
+
+_You can add a new MCP server from the Claude Code CLI. But modifying the json file directly is simpler!_
+
+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:
+
+```json
+{
+  "projects": {
+    "mcpServers": {
+      "shortcut": {
+        "command": "npx",
+        "args": [
+          "-y",
+          "@shortcut/mcp"
+        ],
+        "env": {
+          "SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
+        }
+      }
+    }
+  }
+}
+```
+
 ## Issues and Troubleshooting
 
+Before doing anything else, please make sure you are running the latest version!
+
 If you run into problems using this MCP server, you have a couple of options:
 
 - Open an issue on [GitHub](https://github.com/useshortcut/mcp-server-shortcut/issues)

package/dist/index.js

@@ -21304,7 +21304,7 @@ var import_client = __toESM(require_lib(), 1);
 
 // package.json
 var name = "@shortcut/mcp";
-var version = "0.2.1";
+var version = "0.3.0";
 
 // src/tools/base.ts
 class BaseTools {
@@ -21344,6 +21344,23 @@ var formatPullRequestList = (branches) => {
 var formatTaskList = (tasks) => {
   return formatAsUnorderedList((tasks || []).map((task) => `[${task.complete ? "X" : " "}] ${task.description}`), "Tasks");
 };
+var formatStats = (stats, showPoints) => {
+  const { num_stories_backlog, num_stories_unstarted, num_stories_started, num_stories_done } = stats;
+  const { num_points_backlog, num_points_unstarted, num_points_started, num_points_done } = stats;
+  const totalCount = num_stories_backlog + num_stories_unstarted + num_stories_started + num_stories_done;
+  const totalUnstarted = num_stories_backlog + num_stories_unstarted;
+  const totalPoints = (num_points_backlog || 0) + (num_points_unstarted || 0) + (num_points_started || 0) + (num_points_done || 0);
+  const totalUnstartedPoints = (num_points_backlog || 0) + (num_points_unstarted || 0);
+  const statsString = `Stats:
+- Total stories: ${totalCount}${showPoints ? ` (${totalPoints} points)` : ""}
+- Unstarted stories: ${totalUnstarted}${showPoints ? ` (${totalUnstartedPoints} points)` : ""}
+- Stories in progress: ${num_stories_started}${showPoints ? ` (${num_points_started || 0} points)` : ""}
+- Completed stories: ${num_stories_done}${showPoints ? ` (${num_points_done || 0} points)` : ""}`;
+  if (showPoints && stats.num_stories_unestimated)
+    return `${statsString}
+- (${stats.num_stories_unestimated} of the stories are unestimated)`;
+  return statsString;
+};
 
 // src/tools/utils/search.ts
 var getKey = (prop) => {
@@ -21442,6 +21459,8 @@ ${formatAsUnorderedList(epics.map((epic) => `${epic.id}: ${epic.name}`))}`);
     const epic = await this.client.getEpic(epicPublicId);
     if (!epic)
       throw new Error(`Failed to retrieve Shortcut epic with public ID: ${epicPublicId}`);
+    const currentUser = await this.client.getCurrentUser();
+    const showPoints = !!currentUser?.workspace2?.estimate_scale?.length;
     return this.toResult(`Epic: ${epicPublicId}
 URL: ${epic.app_url}
 Name: ${epic.name}
@@ -21452,6 +21471,8 @@ Due date: ${epic.deadline ? epic.deadline : "[Not set]"}
 Team: ${epic.group_id ? `${epic.group_id}` : "[None]"}
 Objective: ${epic.milestone_id ? `${epic.milestone_id}` : "[None]"}
 
+${formatStats(epic.stats, showPoints)}
+
 Description:
 ${epic.description}`);
   }
@@ -21501,6 +21522,8 @@ ${formatAsUnorderedList(iterations.map((iteration) => `${iteration.id}: ${iterat
     const iteration = await this.client.getIteration(iterationPublicId);
     if (!iteration)
       throw new Error(`Failed to retrieve Shortcut iteration with public ID: ${iterationPublicId}.`);
+    const currentUser = await this.client.getCurrentUser();
+    const showPoints = !!currentUser?.workspace2?.estimate_scale?.length;
     return this.toResult(`Iteration: ${iterationPublicId}
 Url: ${iteration.app_url}
 Name: ${iteration.name}
@@ -21510,6 +21533,8 @@ Completed: ${iteration.status === "completed" ? "Yes" : "No"}
 Started: ${iteration.status === "started" ? "Yes" : "No"}
 Team: ${iteration.group_ids?.length ? `${iteration.group_ids.join(", ")}` : "[None]"}
 
+${formatStats(iteration.stats, showPoints)}
+
 Description:
 ${iteration.description}`);
   }

package/package.json

@@ -8,7 +8,7 @@
 	},
 	"keywords": ["shortcut", "mcp", "modelcontextprotocol"],
 	"license": "MIT",
-	"version": "0.2.1",
+	"version": "0.3.0",
 	"type": "module",
 	"main": "dist/index.js",
 	"bin": {