@shortcut/mcp 0.10.2 → 0.11.0

package/dist/index.js

@@ -61,6 +61,14 @@ var ShortcutClientWrapper = class {
 		this.workflowCache = new Cache();
 		this.customFieldCache = new Cache();
 	}
+	getNextPageToken(next) {
+		let next_page_token = null;
+		if (next) try {
+			const [, t] = /next=(.+)(?:&|$)/.exec(next) || [];
+			if (t) next_page_token = t;
+		} catch {}
+		return next_page_token;
+	}
 	async loadMembers() {
 		if (this.userCache.isStale) {
 			const response = await this.client.listMembers({});
@@ -181,38 +189,46 @@ var ShortcutClientWrapper = class {
 		if (!milestone) return null;
 		return milestone;
 	}
-	async searchStories(query) {
+	async searchStories(query, nextToken) {
 		const response = await this.client.searchStories({
 			query,
 			page_size: 25,
-			detail: "full"
+			detail: "full",
+			next: nextToken
 		});
 		const stories = response?.data?.data;
 		const total = response?.data?.total;
+		const next = response?.data?.next;
 		if (!stories) return {
 			stories: null,
-			total: null
+			total: null,
+			next_page_token: null
 		};
 		return {
 			stories,
-			total
+			total,
+			next_page_token: this.getNextPageToken(next)
 		};
 	}
-	async searchIterations(query) {
+	async searchIterations(query, nextToken) {
 		const response = await this.client.searchIterations({
 			query,
 			page_size: 25,
-			detail: "full"
+			detail: "full",
+			next: nextToken
 		});
 		const iterations = response?.data?.data;
 		const total = response?.data?.total;
+		const next = response?.data?.next;
 		if (!iterations) return {
 			iterations: null,
-			total: null
+			total: null,
+			next_page_token: null
 		};
 		return {
 			iterations,
-			total
+			total,
+			next_page_token: this.getNextPageToken(next)
 		};
 	}
 	async getActiveIteration(teamIds) {
@@ -259,38 +275,46 @@ var ShortcutClientWrapper = class {
 		}, /* @__PURE__ */ new Map());
 		return upcomingIterationByTeam;
 	}
-	async searchEpics(query) {
+	async searchEpics(query, nextToken) {
 		const response = await this.client.searchEpics({
 			query,
 			page_size: 25,
-			detail: "full"
+			detail: "full",
+			next: nextToken
 		});
 		const epics = response?.data?.data;
 		const total = response?.data?.total;
+		const next = response?.data?.next;
 		if (!epics) return {
 			epics: null,
-			total: null
+			total: null,
+			next_page_token: null
 		};
 		return {
 			epics,
-			total
+			total,
+			next_page_token: this.getNextPageToken(next)
 		};
 	}
-	async searchMilestones(query) {
+	async searchMilestones(query, nextToken) {
 		const response = await this.client.searchMilestones({
 			query,
 			page_size: 25,
-			detail: "full"
+			detail: "full",
+			next: nextToken
 		});
 		const milestones = response?.data?.data;
 		const total = response?.data?.total;
+		const next = response?.data?.next;
 		if (!milestones) return {
 			milestones: null,
-			total: null
+			total: null,
+			next_page_token: null
 		};
 		return {
 			milestones,
-			total
+			total,
+			next_page_token: this.getNextPageToken(next)
 		};
 	}
 	async listIterationStories(iterationPublicId, includeDescription = false) {
@@ -411,7 +435,7 @@ var ShortcutClientWrapper = class {
 //#endregion
 //#region package.json
 var name = "@shortcut/mcp";
-var version = "0.10.2";
+var version = "0.11.0";
 
 //#endregion
 //#region src/tools/base.ts
@@ -524,14 +548,15 @@ var BaseTools = class {
 	}
 	getSimplifiedTeam(entity) {
 		if (!entity) return null;
-		const { archived, id, name: name$1, mention_name, member_ids, workflow_ids } = entity;
+		const { archived, id, name: name$1, mention_name, member_ids, workflow_ids, default_workflow_id } = entity;
 		return {
 			id,
 			name: name$1,
 			archived,
 			mention_name,
 			member_ids,
-			workflow_ids
+			workflow_ids,
+			default_workflow_id: default_workflow_id ?? null
 		};
 	}
 	getSimplifiedObjective(entity) {
@@ -675,10 +700,11 @@ var BaseTools = class {
 			workflowsForEpic,
 			workflowForStory ? { [workflowForStory.id]: workflowForStory } : {}
 		]);
+		const simplifiedStoryTeam = this.getSimplifiedTeam(teamForStory);
 		const teams = this.mergeRelatedEntities([
 			teamsForIteration,
 			teamsForEpic,
-			teamForStory ? { [teamForStory.id]: teamForStory } : {}
+			simplifiedStoryTeam ? { [simplifiedStoryTeam.id]: simplifiedStoryTeam } : {}
 		]);
 		const epics = simplifiedEpic ? { [simplifiedEpic.id]: simplifiedEpic } : {};
 		const iterations = simplifiedIteration ? { [simplifiedIteration.id]: simplifiedIteration } : {};
@@ -739,10 +765,10 @@ var BaseTools = class {
 			relatedEntities: this.mergeRelatedEntities(relatedEntities)
 		};
 	}
-	toResult(message, data) {
+	toResult(message, data, paginationToken) {
 		return { content: [{
 			type: "text",
-			text: `${message}${data !== void 0 ? `\n\n<json>\n${JSON.stringify(data, null, 2)}\n</json>` : ""}`
+			text: `${message}${data !== void 0 ? `\n\n<json>\n${JSON.stringify(data, null, 2)}\n</json>${paginationToken ? `\n\n<next-page-token>${paginationToken}</next-page-token>` : ""}` : ""}`
 		}] };
 	}
 };
@@ -840,6 +866,7 @@ var EpicTools = class EpicTools extends BaseTools {
 			full: z.boolean().optional().default(false).describe("True to return all epic fields from the API. False to return a slim version that excludes uncommon fields")
 		}, async ({ epicPublicId, full }) => await tools.getEpic(epicPublicId, full));
 		server$1.tool("search-epics", "Find Shortcut epics.", {
+			nextPageToken: z.string().optional().describe("If a next_page_token was returned from the search result, pass it in to get the next page of results.  Should be combined with the original search parameters."),
 			id: z.number().optional().describe("Find only epics with the specified public ID"),
 			name: z.string().optional().describe("Find only epics matching the specified name"),
 			description: z.string().optional().describe("Find only epics matching the specified description"),
@@ -866,7 +893,7 @@ var EpicTools = class EpicTools extends BaseTools {
 			updated: date(),
 			completed: date(),
 			due: date()
-		}, async (params) => await tools.searchEpics(params));
+		}, async ({ nextPageToken,...params }) => await tools.searchEpics(params, nextPageToken));
 		server$1.tool("create-epic", "Create a new Shortcut epic.", {
 			name: z.string().describe("The name of the epic"),
 			owner: z.string().optional().describe("The user ID of the owner of the epic"),
@@ -875,13 +902,13 @@ var EpicTools = class EpicTools extends BaseTools {
 		}, async (params) => await tools.createEpic(params));
 		return tools;
 	}
-	async searchEpics(params) {
+	async searchEpics(params, nextToken) {
 		const currentUser = await this.client.getCurrentUser();
 		const query = await buildSearchQuery(params, currentUser);
-		const { epics, total } = await this.client.searchEpics(query);
+		const { epics, total, next_page_token } = await this.client.searchEpics(query, nextToken);
 		if (!epics) throw new Error(`Failed to search for epics matching your query: "${query}"`);
 		if (!epics.length) return this.toResult(`Result: No epics found.`);
-		return this.toResult(`Result (first ${epics.length} shown of ${total} total epics found):`, await this.entitiesWithRelatedEntities(epics, "epics"));
+		return this.toResult(`Result (${epics.length} shown of ${total} total epics found):`, await this.entitiesWithRelatedEntities(epics, "epics"), next_page_token);
 	}
 	async getEpic(epicPublicId, full = false) {
 		const epic = await this.client.getEpic(epicPublicId);
@@ -913,6 +940,7 @@ var IterationTools = class IterationTools extends BaseTools {
 			full: z.boolean().optional().default(false).describe("True to return all iteration fields from the API. False to return a slim version that excludes uncommon fields")
 		}, async ({ iterationPublicId, full }) => await tools.getIteration(iterationPublicId, full));
 		server$1.tool("search-iterations", "Find Shortcut iterations.", {
+			nextPageToken: z.string().optional().describe("If a next_page_token was returned from the search result, pass it in to get the next page of results. Should be combined with the original search parameters."),
 			id: z.number().optional().describe("Find only iterations with the specified public ID"),
 			name: z.string().optional().describe("Find only iterations matching the specified name"),
 			description: z.string().optional().describe("Find only iterations matching the specified description"),
@@ -926,7 +954,7 @@ var IterationTools = class IterationTools extends BaseTools {
 			updated: date(),
 			startDate: date(),
 			endDate: date()
-		}, async (params) => await tools.searchIterations(params));
+		}, async ({ nextPageToken,...params }) => await tools.searchIterations(params, nextPageToken));
 		server$1.tool("create-iteration", "Create a new Shortcut iteration", {
 			name: z.string().describe("The name of the iteration"),
 			startDate: z.string().describe("The start date of the iteration in YYYY-MM-DD format"),
@@ -943,13 +971,13 @@ var IterationTools = class IterationTools extends BaseTools {
 		if (!stories) throw new Error(`Failed to retrieve Shortcut stories in iteration with public ID: ${iterationPublicId}.`);
 		return this.toResult(`Result (${stories.length} stories found):`, await this.entitiesWithRelatedEntities(stories, "stories"));
 	}
-	async searchIterations(params) {
+	async searchIterations(params, nextToken) {
 		const currentUser = await this.client.getCurrentUser();
 		const query = await buildSearchQuery(params, currentUser);
-		const { iterations, total } = await this.client.searchIterations(query);
+		const { iterations, total, next_page_token } = await this.client.searchIterations(query, nextToken);
 		if (!iterations) throw new Error(`Failed to search for iterations matching your query: "${query}".`);
 		if (!iterations.length) return this.toResult(`Result: No iterations found.`);
-		return this.toResult(`Result (first ${iterations.length} shown of ${total} total iterations found):`, await this.entitiesWithRelatedEntities(iterations, "iterations"));
+		return this.toResult(`Result (${iterations.length} shown of ${total} total iterations found):`, await this.entitiesWithRelatedEntities(iterations, "iterations"), next_page_token);
 	}
 	async getIteration(iterationPublicId, full = false) {
 		const iteration = await this.client.getIteration(iterationPublicId);
@@ -1019,6 +1047,7 @@ var ObjectiveTools = class ObjectiveTools extends BaseTools {
 			full: z.boolean().optional().default(false).describe("True to return all objective fields from the API. False to return a slim version that excludes uncommon fields")
 		}, async ({ objectivePublicId, full }) => await tools.getObjective(objectivePublicId, full));
 		server$1.tool("search-objectives", "Find Shortcut objectives.", {
+			nextPageToken: z.string().optional().describe("If a next_page_token was returned from the search result, pass it in to get the next page of results. Should be combined with the original search parameters."),
 			id: z.number().optional().describe("Find objectives matching the specified id"),
 			name: z.string().optional().describe("Find objectives matching the specified name"),
 			description: z.string().optional().describe("Find objectives matching the specified description"),
@@ -1038,16 +1067,16 @@ var ObjectiveTools = class ObjectiveTools extends BaseTools {
 			created: date(),
 			updated: date(),
 			completed: date()
-		}, async (params) => await tools.searchObjectives(params));
+		}, async ({ nextPageToken,...params }) => await tools.searchObjectives(params, nextPageToken));
 		return tools;
 	}
-	async searchObjectives(params) {
+	async searchObjectives(params, nextToken) {
 		const currentUser = await this.client.getCurrentUser();
 		const query = await buildSearchQuery(params, currentUser);
-		const { milestones, total } = await this.client.searchMilestones(query);
+		const { milestones, total, next_page_token } = await this.client.searchMilestones(query, nextToken);
 		if (!milestones) throw new Error(`Failed to search for milestones matching your query: "${query}"`);
 		if (!milestones.length) return this.toResult(`Result: No milestones found.`);
-		return this.toResult(`Result (first ${milestones.length} shown of ${total} total milestones found):`, await this.entitiesWithRelatedEntities(milestones, "objectives"));
+		return this.toResult(`Result (${milestones.length} shown of ${total} total milestones found):`, await this.entitiesWithRelatedEntities(milestones, "objectives"), next_page_token);
 	}
 	async getObjective(objectivePublicId, full = false) {
 		const objective = await this.client.getMilestone(objectivePublicId);
@@ -1061,12 +1090,12 @@ var ObjectiveTools = class ObjectiveTools extends BaseTools {
 var StoryTools = class StoryTools extends BaseTools {
 	static create(client$1, server$1) {
 		const tools = new StoryTools(client$1);
-		server$1.tool("get-story-branch-name", "Get a valid branch name for a specific story.", { storyPublicId: z.number().positive().describe("The public Id of the story") }, async ({ storyPublicId }) => await tools.getStoryBranchName(storyPublicId));
 		server$1.tool("get-story", "Get a Shortcut story by public ID", {
 			storyPublicId: z.number().positive().describe("The public ID of the story to get"),
 			full: z.boolean().optional().default(false).describe("True to return all story fields from the API. False to return a slim version that excludes uncommon fields")
 		}, async ({ storyPublicId, full }) => await tools.getStory(storyPublicId, full));
 		server$1.tool("search-stories", "Find Shortcut stories.", {
+			nextPageToken: z.string().optional().describe("If a next_page_token was returned from the search result, pass it in to get the next page of results. Should be combined with the original search parameters."),
 			id: z.number().optional().describe("Find only stories with the specified public ID"),
 			name: z.string().optional().describe("Find only stories matching the specified name"),
 			description: z.string().optional().describe("Find only stories matching the specified description"),
@@ -1115,7 +1144,8 @@ var StoryTools = class StoryTools extends BaseTools {
 			updated: date(),
 			completed: date(),
 			due: date()
-		}, async (params) => await tools.searchStories(params));
+		}, async ({ nextPageToken,...params }) => await tools.searchStories(params, nextPageToken));
+		server$1.tool("get-story-branch-name", "Get a valid branch name for a specific story.", { storyPublicId: z.number().positive().describe("The public Id of the story") }, async ({ storyPublicId }) => await tools.getStoryBranchName(storyPublicId));
 		server$1.tool("create-story", `Create a new Shortcut story. 
 Name is required, and either a Team or Workflow must be specified:
 - If only Team is specified, we will use the default workflow for that team.
@@ -1258,13 +1288,13 @@ The story will be added to the default state for the workflow.
 		});
 		return this.toResult(`Created story: ${story.id}`);
 	}
-	async searchStories(params) {
+	async searchStories(params, nextToken) {
 		const currentUser = await this.client.getCurrentUser();
 		const query = await buildSearchQuery(params, currentUser);
-		const { stories, total } = await this.client.searchStories(query);
+		const { stories, total, next_page_token } = await this.client.searchStories(query, nextToken);
 		if (!stories) throw new Error(`Failed to search for stories matching your query: "${query}".`);
 		if (!stories.length) return this.toResult(`Result: No stories found.`);
-		return this.toResult(`Result (first ${stories.length} shown of ${total} total stories found):`, await this.entitiesWithRelatedEntities(stories, "stories"));
+		return this.toResult(`Result (${stories.length} shown of ${total} total stories found):`, await this.entitiesWithRelatedEntities(stories, "stories"), next_page_token);
 	}
 	async getStory(storyPublicId, full = false) {
 		const story = await this.client.getStory(storyPublicId);
@@ -1402,6 +1432,7 @@ var UserTools = class UserTools extends BaseTools {
 	static create(client$1, server$1) {
 		const tools = new UserTools(client$1);
 		server$1.tool("get-current-user", "Get the current user", async () => await tools.getCurrentUser());
+		server$1.tool("get-current-user-teams", "Get a list of teams where the current user is a member", async () => await tools.getCurrentUserTeams());
 		server$1.tool("list-members", "Get all members", async () => await tools.listMembers());
 		return tools;
 	}
@@ -1410,6 +1441,14 @@ var UserTools = class UserTools extends BaseTools {
 		if (!user$1) throw new Error("Failed to retrieve current user.");
 		return this.toResult(`Current user:`, user$1);
 	}
+	async getCurrentUserTeams() {
+		const teams = await this.client.getTeams();
+		const currentUser = await this.client.getCurrentUser();
+		if (!currentUser) throw new Error("Failed to get current user.");
+		const userTeams = teams.filter((team) => team.member_ids.includes(currentUser.id));
+		if (!userTeams.length) return this.toResult(`Current user is not a member of any teams.`);
+		return this.toResult(`Current user is a member of ${userTeams.length} teams:`, await this.entitiesWithRelatedEntities(userTeams, "teams"));
+	}
 	async listMembers() {
 		const members = await this.client.listMembers();
 		return this.toResult(`Found ${members.length} members:`, members);
@@ -1421,6 +1460,7 @@ var UserTools = class UserTools extends BaseTools {
 var WorkflowTools = class WorkflowTools extends BaseTools {
 	static create(client$1, server$1) {
 		const tools = new WorkflowTools(client$1);
+		server$1.tool("get-default-workflow", "Get the default workflow for a specific team or the global default if no team is specified.", { teamPublicId: z.string().optional().describe("The public ID of the team to get the default workflow for.") }, async ({ teamPublicId }) => await tools.getDefaultWorkflow(teamPublicId));
 		server$1.tool("get-workflow", "Get a Shortcut workflow by public ID", {
 			workflowPublicId: z.number().positive().describe("The public ID of the workflow to get"),
 			full: z.boolean().optional().default(false).describe("True to return all workflow fields from the API. False to return a slim version that excludes uncommon fields")
@@ -1428,6 +1468,21 @@ var WorkflowTools = class WorkflowTools extends BaseTools {
 		server$1.tool("list-workflows", "List all Shortcut workflows", async () => await tools.listWorkflows());
 		return tools;
 	}
+	async getDefaultWorkflow(teamPublicId) {
+		if (teamPublicId) try {
+			const teamDefaultWorkflowId = await this.client.getTeam(teamPublicId).then((t) => t?.default_workflow_id);
+			if (teamDefaultWorkflowId) {
+				const teamDefaultWorkflow = await this.client.getWorkflow(teamDefaultWorkflowId);
+				if (teamDefaultWorkflow) return this.toResult(`Default workflow for team "${teamPublicId}" has id ${teamDefaultWorkflow.id}.`, await this.entityWithRelatedEntities(teamDefaultWorkflow, "workflow"));
+			}
+		} catch {}
+		const currentUser = await this.client.getCurrentUser();
+		if (!currentUser) throw new Error("Failed to retrieve current user.");
+		const workspaceDefaultWorkflowId = currentUser.workspace2.default_workflow_id;
+		const workspaceDefaultWorkflow = await this.client.getWorkflow(workspaceDefaultWorkflowId);
+		if (workspaceDefaultWorkflow) return this.toResult(`${teamPublicId ? `No default workflow found for team with public ID "${teamPublicId}". The general default workflow has id ` : "Default workflow has id "}${workspaceDefaultWorkflow.id}.`, await this.entityWithRelatedEntities(workspaceDefaultWorkflow, "workflow"));
+		return this.toResult("No default workflow found.");
+	}
 	async getWorkflow(workflowPublicId, full = false) {
 		const workflow = await this.client.getWorkflow(workflowPublicId);
 		if (!workflow) return this.toResult(`Workflow with public ID: ${workflowPublicId} not found.`);

package/package.json

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