@shortcut/mcp 0.10.2 → 0.10.3

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.10.3";
 
 //#endregion
 //#region src/tools/base.ts
@@ -739,10 +763,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 +864,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 +891,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 +900,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 +938,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 +952,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 +969,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 +1045,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 +1065,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 +1088,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 +1142,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 +1286,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);

package/package.json

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