@shortcut/mcp 0.10.1 → 0.10.3

package/dist/index.js

@@ -53,11 +53,21 @@ var ShortcutClientWrapper = class {
 	userCache;
 	teamCache;
 	workflowCache;
+	customFieldCache;
 	constructor(client$1) {
 		this.client = client$1;
 		this.userCache = new Cache();
 		this.teamCache = new Cache();
 		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) {
@@ -80,6 +90,13 @@ var ShortcutClientWrapper = class {
 			if (workflows) this.workflowCache.setMany(workflows.map((workflow) => [workflow.id, workflow]));
 		}
 	}
+	async loadCustomFields() {
+		if (this.customFieldCache.isStale) {
+			const response = await this.client.listCustomFields();
+			const customFields = response?.data ?? null;
+			if (customFields) this.customFieldCache.setMany(customFields.map((customField) => [customField.id, customField]));
+		}
+	}
 	async getCurrentUser() {
 		if (this.currentUser) return this.currentUser;
 		const response = await this.client.getCurrentMemberInfo();
@@ -172,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) {
@@ -250,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) {
@@ -389,12 +422,20 @@ var ShortcutClientWrapper = class {
 		if (!doc) throw new Error(`Failed to create the document: ${response.status}`);
 		return doc;
 	}
+	async getCustomFieldMap(customFieldIds) {
+		await this.loadCustomFields();
+		return new Map(customFieldIds.map((id) => [id, this.customFieldCache.get(id)]).filter((customField) => customField[1] !== null));
+	}
+	async getCustomFields() {
+		await this.loadCustomFields();
+		return Array.from(this.customFieldCache.values());
+	}
 };
 
 //#endregion
 //#region package.json
 var name = "@shortcut/mcp";
-var version = "0.10.1";
+var version = "0.10.3";
 
 //#endregion
 //#region src/tools/base.ts
@@ -448,9 +489,33 @@ var BaseTools = class {
 			is_owner
 		};
 	}
-	getSimplifiedStory(entity) {
+	getSimplifiedStory(entity, kind) {
 		if (!entity) return null;
-		const { id, name: name$1, app_url, archived, group_id, epic_id, iteration_id, workflow_id, workflow_state_id, owner_ids, requested_by_id } = entity;
+		const { id, name: name$1, app_url, archived, group_id, epic_id, iteration_id, workflow_id, workflow_state_id, owner_ids, requested_by_id, estimate, labels, comments, description, external_links, story_links, pull_requests, formatted_vcs_branch_name, branches, parent_story_id, sub_task_story_ids, tasks, custom_fields, blocked, blocker } = entity;
+		const additionalFields = {};
+		if (kind === "simple") {
+			additionalFields.description = description;
+			additionalFields.estimate = estimate ?? null;
+			additionalFields.comments = (comments || []).filter((c) => !c.deleted).map(({ id: id$1, author_id, text }) => ({
+				id: id$1,
+				author_id: author_id ?? null,
+				text: text ?? ""
+			}));
+			additionalFields.labels = (labels || []).map((l) => l.name);
+			additionalFields.external_links = external_links || [];
+			additionalFields.suggested_branch_name = formatted_vcs_branch_name ?? null;
+			additionalFields.pull_requests = (pull_requests || []).map((pr) => pr.url);
+			additionalFields.branches = (branches || []).map((b) => b.name);
+			additionalFields.related_stories = (story_links || []).map((sl) => sl.type === "object" ? sl.subject_id : sl.object_id);
+			additionalFields.tasks = (tasks || []).map((t) => ({
+				id: t.id,
+				description: t.description,
+				complete: t.complete
+			}));
+			additionalFields.custom_fields = (custom_fields || []).map((field) => field.value_id);
+			additionalFields.blocked = blocked;
+			additionalFields.blocker = blocker;
+		}
 		return {
 			id,
 			name: name$1,
@@ -462,7 +527,10 @@ var BaseTools = class {
 			workflow_id,
 			workflow_state_id,
 			owner_ids,
-			requested_by_id
+			requested_by_id,
+			parent_story_id: parent_story_id ?? null,
+			sub_task_ids: sub_task_story_ids ?? [],
+			...additionalFields
 		};
 	}
 	getSimplifiedWorkflow(entity) {
@@ -502,9 +570,19 @@ var BaseTools = class {
 			categories: categories.map((cat) => cat.name)
 		};
 	}
-	getSimplifiedEpic(entity) {
+	getSimplifiedEpic(entity, kind) {
 		if (!entity) return null;
-		const { id, name: name$1, app_url, archived, group_id, state, milestone_id } = entity;
+		const { id, name: name$1, app_url, archived, group_id, state, milestone_id, comments, description, deadline, owner_ids } = entity;
+		const additionalFields = {};
+		if (kind === "simple") {
+			additionalFields.comments = (comments || []).filter((comment) => !comment.deleted).map(({ id: id$1, author_id, text }) => ({
+				id: id$1,
+				author_id,
+				text
+			}));
+			additionalFields.description = description;
+			additionalFields.deadline = deadline ?? null;
+		}
 		return {
 			id,
 			name: name$1,
@@ -512,7 +590,9 @@ var BaseTools = class {
 			archived,
 			state,
 			team_id: group_id || null,
-			objective_id: milestone_id || null
+			objective_id: milestone_id || null,
+			owner_ids,
+			...additionalFields
 		};
 	}
 	getSimplifiedIteration(entity) {
@@ -534,8 +614,7 @@ var BaseTools = class {
 			workflows: {}
 		};
 		const { member_ids, workflow_ids } = entity;
-		const users = await this.client.getUserMap(member_ids);
-		const workflows = await this.client.getWorkflowMap(workflow_ids);
+		const [users, workflows] = await Promise.all([this.client.getUserMap(member_ids), this.client.getWorkflowMap(workflow_ids)]);
 		return {
 			users: Object.fromEntries(member_ids.map((id) => this.getSimplifiedMember(users.get(id))).filter((member) => member !== null).map((member) => [member.id, member])),
 			workflows: Object.fromEntries(workflow_ids.map((id) => this.getSimplifiedWorkflow(workflows.get(id))).filter((workflow) => workflow !== null).map((workflow) => [workflow.id, workflow]))
@@ -564,17 +643,21 @@ var BaseTools = class {
 			teams: {},
 			objectives: {}
 		};
-		const { group_id, owner_ids, milestone_id, requested_by_id, follower_ids } = entity;
-		const usersForEpicMap = await this.client.getUserMap([...new Set([
-			...owner_ids || [],
-			requested_by_id,
-			...follower_ids || []
-		].filter(Boolean))]);
+		const { group_id, owner_ids, milestone_id, requested_by_id, follower_ids, comments } = entity;
+		const [usersForEpicMap, teams, fullMilestone] = await Promise.all([
+			this.client.getUserMap([...new Set([
+				...owner_ids || [],
+				requested_by_id,
+				...follower_ids || [],
+				...(comments || []).map((comment) => comment.author_id)
+			].filter(Boolean))]),
+			this.client.getTeamMap(group_id ? [group_id] : []),
+			milestone_id ? this.client.getMilestone(milestone_id) : null
+		]);
 		const usersForEpic = Object.fromEntries([...usersForEpicMap.entries()].filter(([_, user$1]) => !!user$1).map(([id, user$1]) => [id, this.getSimplifiedMember(user$1)]));
-		const teams = await this.client.getTeamMap(group_id ? [group_id] : []);
 		const team = this.getSimplifiedTeam(teams.get(group_id || ""));
 		const { users, workflows } = await this.getRelatedEntitiesForTeam(teams.get(group_id || ""));
-		const milestone = this.getSimplifiedObjective(milestone_id ? await this.client.getMilestone(milestone_id) : null);
+		const milestone = this.getSimplifiedObjective(fullMilestone);
 		return {
 			users: this.mergeRelatedEntities([usersForEpic, users]),
 			teams: team ? { [team.id]: team } : {},
@@ -582,20 +665,23 @@ var BaseTools = class {
 			workflows
 		};
 	}
-	async getRelatedEntitiesForStory(entity) {
-		const { group_id, iteration_id, epic_id, owner_ids, requested_by_id, follower_ids, workflow_id } = entity;
-		const fullUsersForStory = await this.client.getUserMap([...new Set([
-			...owner_ids || [],
-			requested_by_id,
-			...follower_ids || []
-		].filter(Boolean))]);
+	async getRelatedEntitiesForStory(entity, kind) {
+		const { group_id, iteration_id, epic_id, owner_ids, requested_by_id, follower_ids, workflow_id, comments, custom_fields } = entity;
+		const [fullUsersForStory, teamsForStory, workflowsForStory, iteration, epic] = await Promise.all([
+			this.client.getUserMap([...new Set([
+				...owner_ids || [],
+				requested_by_id,
+				...follower_ids || [],
+				...(comments || []).map((comment) => comment.author_id || "")
+			].filter(Boolean))]),
+			this.client.getTeamMap(group_id ? [group_id] : []),
+			this.client.getWorkflowMap(workflow_id ? [workflow_id] : []),
+			iteration_id ? this.client.getIteration(iteration_id) : null,
+			epic_id ? this.client.getEpic(epic_id) : null
+		]);
 		const usersForStory = Object.fromEntries([...fullUsersForStory.entries()].filter(([_, user$1]) => !!user$1).map(([id, user$1]) => [id, this.getSimplifiedMember(user$1)]));
-		const teamsForStory = await this.client.getTeamMap(group_id ? [group_id] : []);
-		const workflowsForStory = await this.client.getWorkflowMap(workflow_id ? [workflow_id] : []);
-		const iteration = iteration_id ? await this.client.getIteration(iteration_id) : null;
 		const simplifiedIteration = this.getSimplifiedIteration(iteration);
-		const epic = epic_id ? await this.client.getEpic(epic_id) : null;
-		const simplifiedEpic = this.getSimplifiedEpic(epic);
+		const simplifiedEpic = this.getSimplifiedEpic(epic, kind);
 		const teamForStory = teamsForStory.get(group_id || "");
 		const workflowForStory = this.getSimplifiedWorkflow(workflowsForStory.get(workflow_id));
 		const { users: usersForTeam, workflows: workflowsForTeam } = await this.getRelatedEntitiesForTeam(teamForStory);
@@ -620,49 +706,67 @@ var BaseTools = class {
 		]);
 		const epics = simplifiedEpic ? { [simplifiedEpic.id]: simplifiedEpic } : {};
 		const iterations = simplifiedIteration ? { [simplifiedIteration.id]: simplifiedIteration } : {};
+		const relatedCustomFields = {};
+		if (custom_fields?.length) {
+			const customFieldMap = await this.client.getCustomFieldMap(custom_fields.map((cf) => cf.field_id));
+			custom_fields.forEach((cf) => {
+				const field = customFieldMap.get(cf.field_id);
+				if (!field) return;
+				const value = field.values?.find((v) => v.id === cf.value_id);
+				if (!value) return;
+				relatedCustomFields[cf.value_id] = {
+					field_id: cf.field_id,
+					value_id: cf.value_id,
+					field_name: field.name,
+					value_name: value.value
+				};
+			});
+		}
 		return {
 			users,
 			epics,
 			iterations,
 			workflows,
 			teams,
-			objectives
+			objectives,
+			custom_fields: relatedCustomFields
 		};
 	}
-	async getRelatedEntities(entity) {
+	async getRelatedEntities(entity, kind) {
 		if (entity.entity_type === "group") return this.getRelatedEntitiesForTeam(entity);
 		if (entity.entity_type === "iteration") return this.getRelatedEntitiesForIteration(entity);
 		if (entity.entity_type === "epic") return this.getRelatedEntitiesForEpic(entity);
-		if (entity.entity_type === "story") return this.getRelatedEntitiesForStory(entity);
+		if (entity.entity_type === "story") return this.getRelatedEntitiesForStory(entity, kind);
 		return {};
 	}
-	getSimplifiedEntity(entity) {
+	getSimplifiedEntity(entity, kind) {
 		if (entity.entity_type === "group") return this.getSimplifiedTeam(entity);
 		if (entity.entity_type === "iteration") return this.getSimplifiedIteration(entity);
-		if (entity.entity_type === "epic") return this.getSimplifiedEpic(entity);
-		if (entity.entity_type === "story") return this.getSimplifiedStory(entity);
+		if (entity.entity_type === "epic") return this.getSimplifiedEpic(entity, kind);
+		if (entity.entity_type === "story") return this.getSimplifiedStory(entity, kind);
 		if (entity.entity_type === "milestone") return this.getSimplifiedObjective(entity);
 		if (entity.entity_type === "workflow") return this.getSimplifiedWorkflow(entity);
 		return entity;
 	}
-	async entityWithRelatedEntities(entity, entityType = "entity") {
-		const relatedEntities = await this.getRelatedEntities(entity);
+	async entityWithRelatedEntities(entity, entityType = "entity", full = false) {
+		const finalEntity = full ? entity : this.getSimplifiedEntity(entity, "simple");
+		const relatedEntities = await this.getRelatedEntities(entity, full ? "full" : "simple");
 		return {
-			[entityType]: this.renameEntityProps(entity),
+			[entityType]: this.renameEntityProps(finalEntity),
 			relatedEntities
 		};
 	}
 	async entitiesWithRelatedEntities(entities, entityType = "entities") {
-		const relatedEntities = await Promise.all(entities.map((entity) => this.getRelatedEntities(entity)));
+		const relatedEntities = await Promise.all(entities.map((entity) => this.getRelatedEntities(entity, "list")));
 		return {
-			[entityType]: entities.map((entity) => this.getSimplifiedEntity(entity)),
+			[entityType]: entities.map((entity) => this.getSimplifiedEntity(entity, "list")),
 			relatedEntities: this.mergeRelatedEntities(relatedEntities)
 		};
 	}
-	toResult(message, data) {
+	toResult(message, data, paginationToken) {
 		return { content: [{
 			type: "text",
-			text: `${message}${data !== void 0 ? `\n\n${JSON.stringify(data, null, 2)}` : ""}`
+			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>` : ""}` : ""}`
 		}] };
 	}
 };
@@ -755,8 +859,12 @@ const user = (field) => z.string().optional().describe(`Find entities where the
 var EpicTools = class EpicTools extends BaseTools {
 	static create(client$1, server$1) {
 		const tools = new EpicTools(client$1);
-		server$1.tool("get-epic", "Get a Shortcut epic by public ID", { epicPublicId: z.number().positive().describe("The public ID of the epic to get") }, async ({ epicPublicId }) => await tools.getEpic(epicPublicId));
+		server$1.tool("get-epic", "Get a Shortcut epic by public ID", {
+			epicPublicId: z.number().positive().describe("The public ID of the epic to get"),
+			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"),
@@ -783,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"),
@@ -792,18 +900,18 @@ 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) {
+	async getEpic(epicPublicId, full = false) {
 		const epic = await this.client.getEpic(epicPublicId);
 		if (!epic) throw new Error(`Failed to retrieve Shortcut epic with public ID: ${epicPublicId}`);
-		return this.toResult(`Epic: ${epicPublicId}`, await this.entityWithRelatedEntities(epic, "epic"));
+		return this.toResult(`Epic: ${epicPublicId}`, await this.entityWithRelatedEntities(epic, "epic", full));
 	}
 	async createEpic({ name: name$1, owner, teamId: group_id, description }) {
 		const epic = await this.client.createEpic({
@@ -825,8 +933,12 @@ var IterationTools = class IterationTools extends BaseTools {
 			iterationPublicId: z.number().positive().describe("The public ID of the iteration"),
 			includeStoryDescriptions: z.boolean().optional().default(false).describe("Indicate whether story descriptions should be included. Including descriptions may take longer and will increase the size of the response.")
 		}, async ({ iterationPublicId, includeStoryDescriptions }) => await tools.getIterationStories(iterationPublicId, includeStoryDescriptions));
-		server$1.tool("get-iteration", "Get a Shortcut iteration by public ID", { iterationPublicId: z.number().positive().describe("The public ID of the iteration to get") }, async ({ iterationPublicId }) => await tools.getIteration(iterationPublicId));
+		server$1.tool("get-iteration", "Get a Shortcut iteration by public ID", {
+			iterationPublicId: z.number().positive().describe("The public ID of the iteration to get"),
+			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"),
@@ -840,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"),
@@ -857,18 +969,18 @@ 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) {
+	async getIteration(iterationPublicId, full = false) {
 		const iteration = await this.client.getIteration(iterationPublicId);
 		if (!iteration) throw new Error(`Failed to retrieve Shortcut iteration with public ID: ${iterationPublicId}.`);
-		return this.toResult(`Iteration: ${iterationPublicId}`, await this.entityWithRelatedEntities(iteration, "iteration"));
+		return this.toResult(`Iteration: ${iterationPublicId}`, await this.entityWithRelatedEntities(iteration, "iteration", full));
 	}
 	async createIteration({ name: name$1, startDate, endDate, teamId, description }) {
 		const iteration = await this.client.createIteration({
@@ -928,8 +1040,12 @@ var IterationTools = class IterationTools extends BaseTools {
 var ObjectiveTools = class ObjectiveTools extends BaseTools {
 	static create(client$1, server$1) {
 		const tools = new ObjectiveTools(client$1);
-		server$1.tool("get-objective", "Get a Shortcut objective by public ID", { objectivePublicId: z.number().positive().describe("The public ID of the objective to get") }, async ({ objectivePublicId }) => await tools.getObjective(objectivePublicId));
+		server$1.tool("get-objective", "Get a Shortcut objective by public ID", {
+			objectivePublicId: z.number().positive().describe("The public ID of the objective to get"),
+			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"),
@@ -949,21 +1065,21 @@ 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) {
+	async getObjective(objectivePublicId, full = false) {
 		const objective = await this.client.getMilestone(objectivePublicId);
 		if (!objective) throw new Error(`Failed to retrieve Shortcut objective with public ID: ${objectivePublicId}`);
-		return this.toResult(`Objective: ${objectivePublicId}`, await this.entityWithRelatedEntities(objective, "objective"));
+		return this.toResult(`Objective: ${objectivePublicId}`, await this.entityWithRelatedEntities(objective, "objective", full));
 	}
 };
 
@@ -972,9 +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") }, async ({ storyPublicId }) => await tools.getStory(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"),
@@ -1023,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.
@@ -1166,18 +1286,18 @@ 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) {
+	async getStory(storyPublicId, full = false) {
 		const story = await this.client.getStory(storyPublicId);
 		if (!story) throw new Error(`Failed to retrieve Shortcut story with public ID: ${storyPublicId}.`);
-		return this.toResult(`Story: sc-${storyPublicId}`, await this.entityWithRelatedEntities(story, "story"));
+		return this.toResult(`Story: sc-${storyPublicId}`, await this.entityWithRelatedEntities(story, "story", full));
 	}
 	async createStoryComment({ storyPublicId, text }) {
 		if (!storyPublicId) throw new Error("Story public ID is required");
@@ -1285,14 +1405,17 @@ The story will be added to the default state for the workflow.
 var TeamTools = class TeamTools extends BaseTools {
 	static create(client$1, server$1) {
 		const tools = new TeamTools(client$1);
-		server$1.tool("get-team", "Get a Shortcut team by public ID", { teamPublicId: z.string().describe("The public ID of the team to get") }, async ({ teamPublicId }) => await tools.getTeam(teamPublicId));
+		server$1.tool("get-team", "Get a Shortcut team by public ID", {
+			teamPublicId: z.string().describe("The public ID of the team to get"),
+			full: z.boolean().optional().default(false).describe("True to return all team fields from the API. False to return a slim version that excludes uncommon fields")
+		}, async ({ teamPublicId, full }) => await tools.getTeam(teamPublicId, full));
 		server$1.tool("list-teams", "List all Shortcut teams", async () => await tools.getTeams());
 		return tools;
 	}
-	async getTeam(teamPublicId) {
+	async getTeam(teamPublicId, full = false) {
 		const team = await this.client.getTeam(teamPublicId);
 		if (!team) return this.toResult(`Team with public ID: ${teamPublicId} not found.`);
-		return this.toResult(`Team: ${team.id}`, await this.entityWithRelatedEntities(team, "team"));
+		return this.toResult(`Team: ${team.id}`, await this.entityWithRelatedEntities(team, "team", full));
 	}
 	async getTeams() {
 		const teams = await this.client.getTeams();
@@ -1326,14 +1449,17 @@ 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-workflow", "Get a Shortcut workflow by public ID", { workflowPublicId: z.number().positive().describe("The public ID of the workflow to get") }, async ({ workflowPublicId }) => await tools.getWorkflow(workflowPublicId));
+		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")
+		}, async ({ workflowPublicId, full }) => await tools.getWorkflow(workflowPublicId, full));
 		server$1.tool("list-workflows", "List all Shortcut workflows", async () => await tools.listWorkflows());
 		return tools;
 	}
-	async getWorkflow(workflowPublicId) {
+	async getWorkflow(workflowPublicId, full = false) {
 		const workflow = await this.client.getWorkflow(workflowPublicId);
 		if (!workflow) return this.toResult(`Workflow with public ID: ${workflowPublicId} not found.`);
-		return this.toResult(`Workflow: ${workflow.id}`, await this.entityWithRelatedEntities(workflow, "workflow"));
+		return this.toResult(`Workflow: ${workflow.id}`, await this.entityWithRelatedEntities(workflow, "workflow", full));
 	}
 	async listWorkflows() {
 		const workflows = await this.client.getWorkflows();

package/package.json

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