@shortcut/mcp 0.10.0 → 0.10.2

package/dist/index.js

@@ -53,11 +53,13 @@ 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();
 	}
 	async loadMembers() {
 		if (this.userCache.isStale) {
@@ -80,6 +82,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();
@@ -389,12 +398,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.0";
+var version = "0.10.2";
 
 //#endregion
 //#region src/tools/base.ts
@@ -448,9 +465,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 +503,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 +546,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 +566,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 +590,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 +619,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 +641,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 +682,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) {
 		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>` : ""}`
 		}] };
 	}
 };
@@ -745,7 +825,7 @@ const variations = [
 	})
 ];
 const DATE_REGEXP = /* @__PURE__ */ new RegExp(`^(${variations.join("|")})$`);
-const date = z.string().regex(DATE_REGEXP).optional().describe("The date in \"YYYY-MM-DD\" format, or one of the keywords: \"yesterday\", \"today\", \"tomorrow\", or a date range in the format \"YYYY-MM-DD..YYYY-MM-DD\". The date range can also be open ended by using \"*\" for one of the bounds. Examples: \"2023-01-01\", \"today\", \"2023-01-01..*\" (from Jan 1, 2023 to any future date), \"*.2023-01-31\" (any date up to Jan 31, 2023), \"today..*\" (from today onwards), \"*.yesterday\" (any date up to yesterday). The keywords cannot be used to calculate relative dates (e.g. the following are not valid: \"today-1\" or \"tomorrow+1\").");
+const date = () => z.string().regex(DATE_REGEXP).optional().describe("The date in \"YYYY-MM-DD\" format, or one of the keywords: \"yesterday\", \"today\", \"tomorrow\", or a date range in the format \"YYYY-MM-DD..YYYY-MM-DD\". The date range can also be open ended by using \"*\" for one of the bounds. Examples: \"2023-01-01\", \"today\", \"2023-01-01..*\" (from Jan 1, 2023 to any future date), \"*.2023-01-31\" (any date up to Jan 31, 2023), \"today..*\" (from today onwards), \"*.yesterday\" (any date up to yesterday). The keywords cannot be used to calculate relative dates (e.g. the following are not valid: \"today-1\" or \"tomorrow+1\").");
 const is = (field) => z.boolean().optional().describe(`Find only entities that are ${field} when true, or only entities that are not ${field} when false.`);
 const has = (field) => z.boolean().optional().describe(`Find only entities that have ${field} when true, or only entities that do not have ${field} when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.`);
 const user = (field) => z.string().optional().describe(`Find entities where the ${field} match the specified user. This must either be the user\'s mention name or the keyword "me" for the current user.`);
@@ -755,7 +835,10 @@ 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.", {
 			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"),
@@ -779,10 +862,10 @@ var EpicTools = class EpicTools extends BaseTools {
 			hasComment: has("a comment"),
 			hasDeadline: has("a deadline"),
 			hasLabel: has("a label"),
-			created: date,
-			updated: date,
-			completed: date,
-			due: date
+			created: date(),
+			updated: date(),
+			completed: date(),
+			due: date()
 		}, async (params) => await tools.searchEpics(params));
 		server$1.tool("create-epic", "Create a new Shortcut epic.", {
 			name: z.string().describe("The name of the epic"),
@@ -800,10 +883,10 @@ var EpicTools = class EpicTools extends BaseTools {
 		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"));
 	}
-	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,7 +908,10 @@ 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.", {
 			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"),
@@ -836,10 +922,10 @@ var IterationTools = class IterationTools extends BaseTools {
 				"done"
 			]).optional().describe("Find only iterations matching the specified state"),
 			team: z.string().optional().describe("Find only iterations matching the specified team. This can be a team ID or mention name."),
-			created: date,
-			updated: date,
-			startDate: date,
-			endDate: date
+			created: date(),
+			updated: date(),
+			startDate: date(),
+			endDate: date()
 		}, async (params) => await tools.searchIterations(params));
 		server$1.tool("create-iteration", "Create a new Shortcut iteration", {
 			name: z.string().describe("The name of the iteration"),
@@ -865,10 +951,10 @@ var IterationTools = class IterationTools extends BaseTools {
 		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"));
 	}
-	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,7 +1014,10 @@ 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.", {
 			id: z.number().optional().describe("Find objectives matching the specified id"),
 			name: z.string().optional().describe("Find objectives matching the specified name"),
@@ -946,9 +1035,9 @@ var ObjectiveTools = class ObjectiveTools extends BaseTools {
 			isDone: is("completed"),
 			isArchived: is("archived"),
 			hasOwner: has("an owner"),
-			created: date,
-			updated: date,
-			completed: date
+			created: date(),
+			updated: date(),
+			completed: date()
 		}, async (params) => await tools.searchObjectives(params));
 		return tools;
 	}
@@ -960,10 +1049,10 @@ var ObjectiveTools = class ObjectiveTools extends BaseTools {
 		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"));
 	}
-	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));
 	}
 };
 
@@ -973,7 +1062,10 @@ 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.", {
 			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"),
@@ -1019,10 +1111,10 @@ var StoryTools = class StoryTools extends BaseTools {
 			hasEpic: has("an epic"),
 			hasTask: has("a task"),
 			hasAttachment: has("an attachment"),
-			created: date,
-			updated: date,
-			completed: date,
-			due: date
+			created: date(),
+			updated: date(),
+			completed: date(),
+			due: date()
 		}, async (params) => await tools.searchStories(params));
 		server$1.tool("create-story", `Create a new Shortcut story. 
 Name is required, and either a Team or Workflow must be specified:
@@ -1174,10 +1266,10 @@ The story will be added to the default state for the workflow.
 		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"));
 	}
-	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 +1377,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 +1421,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.0",
+	"version": "0.10.2",
 	"type": "module",
 	"main": "dist/index.js",
 	"bin": {