Shortcut MCP Server

Instructions

Implementation Reference

• src/tools/stories.ts:520-543 (handler)

  Handler function that implements the logic for adding an existing story as a subtask to a parent story by fetching both stories and updating the subtask's parent_story_id via the client.

  async addStoryAsSubTask({
  	parentStoryPublicId,
  	subTaskPublicId,
  }: {
  	parentStoryPublicId: number;
  	subTaskPublicId: number;
  }) {
  	if (!parentStoryPublicId) throw new Error("ID of parent story is required");
  	if (!subTaskPublicId) throw new Error("ID of sub-task story is required");
  
  	const subTask = await this.client.getStory(subTaskPublicId);
  	if (!subTask) throw new Error(`Failed to retrieve story with public ID: ${subTaskPublicId}`);
  	const parentStory = await this.client.getStory(parentStoryPublicId);
  	if (!parentStory)
  		throw new Error(`Failed to retrieve parent story with public ID: ${parentStoryPublicId}`);
  
  	await this.client.updateStory(subTaskPublicId, {
  		parent_story_id: parentStoryPublicId,
  	});
  
  	return this.toResult(
  		`Added story sc-${subTaskPublicId} as a sub-task of sc-${parentStoryPublicId}`,
  	);
  }

• src/tools/stories.ts:267-275 (registration)

  Tool registration call that registers 'stories-add-subtask' with input schema using Zod and links to the addStoryAsSubTask handler.

  server.addToolWithWriteAccess(
  	"stories-add-subtask",
  	"Add an existing story as a sub-task",
  	{
  		parentStoryPublicId: z.number().positive().describe("The public ID of the parent story"),
  		subTaskPublicId: z.number().positive().describe("The public ID of the sub-task story"),
  	},
  	async (params) => await tools.addStoryAsSubTask(params),
  );

• src/tools/stories.ts:270-273 (schema)

  Zod input schema defining parameters for the 'stories-add-subtask' tool: parentStoryPublicId and subTaskPublicId.

  {
  	parentStoryPublicId: z.number().positive().describe("The public ID of the parent story"),
  	subTaskPublicId: z.number().positive().describe("The public ID of the sub-task story"),
  },