Shortcut MCP Server

Instructions

Implementation Reference

• src/tools/stories.ts:353-364 (registration)

  Registration of the 'stories-set-external-links' tool, including input schema validation using Zod and reference to the handler method.

  server.addToolWithWriteAccess(
  	"stories-set-external-links",
  	"Replace all external links on a story with a new set of links",
  	{
  		storyPublicId: z.number().positive().describe("The public ID of the story"),
  		externalLinks: z
  			.array(z.string().url().max(2048))
  			.describe("Array of external link URLs to set (replaces all existing links)"),
  	},
  	async ({ storyPublicId, externalLinks }) =>
  		await tools.setStoryExternalLinks(storyPublicId, externalLinks),
  );

• src/tools/stories.ts:806-819 (handler)

  The main handler function for the 'stories-set-external-links' tool. It validates inputs, calls the Shortcut client to set the external links on the story, and returns a success message with the story URL.

  async setStoryExternalLinks(storyPublicId: number, externalLinks: string[]) {
  	if (!storyPublicId) throw new Error("Story public ID is required");
  	if (!Array.isArray(externalLinks)) throw new Error("External links must be an array");
  
  	const updatedStory = await this.client.setStoryExternalLinks(storyPublicId, externalLinks);
  
  	const linkCount = externalLinks.length;
  	const message =
  		linkCount === 0
  			? `Removed all external links from story sc-${storyPublicId}`
  			: `Set ${linkCount} external link${linkCount === 1 ? "" : "s"} on story sc-${storyPublicId}`;
  
  	return this.toResult(`${message}. Story URL: ${updatedStory.app_url}`);
  }

• src/tools/stories.ts:356-361 (schema)

  Input schema for the 'stories-set-external-links' tool using Zod for validation of storyPublicId and externalLinks array.

  {
  	storyPublicId: z.number().positive().describe("The public ID of the story"),
  	externalLinks: z
  		.array(z.string().url().max(2048))
  		.describe("Array of external link URLs to set (replaces all existing links)"),
  },