Shortcut MCP Server

Instructions

Implementation Reference

• src/tools/stories.ts:289-298 (registration)

  Registers the 'remove-external-link-from-story' tool with MCP server, including description, Zod input schema (storyPublicId: positive number, externalLink: URL string max 2048 chars), and handler lambda delegating to StoryTools method.

  server.tool(
  	"remove-external-link-from-story",
  	"Remove an external link from a Shortcut story",
  	{
  		storyPublicId: z.number().positive().describe("The public ID of the story"),
  		externalLink: z.string().url().max(2048).describe("The external link URL to remove"),
  	},
  	async ({ storyPublicId, externalLink }) =>
  		await tools.removeExternalLinkFromStory(storyPublicId, externalLink),
  );

• src/tools/stories.ts:636-645 (handler)

  StoryTools.removeExternalLinkFromStory: Validates inputs, invokes client method to perform the removal, and returns a user-friendly success message with story URL.

  async removeExternalLinkFromStory(storyPublicId: number, externalLink: string) {
  	if (!storyPublicId) throw new Error("Story public ID is required");
  	if (!externalLink) throw new Error("External link is required");
  
  	const updatedStory = await this.client.removeExternalLinkFromStory(storyPublicId, externalLink);
  
  	return this.toResult(
  		`Removed external link from story sc-${storyPublicId}. Story URL: ${updatedStory.app_url}`,
  	);
  }

• src/client/shortcut.ts:450-460 (handler)

  ShortcutClientWrapper.removeExternalLinkFromStory: Fetches the story, filters external_links array to remove the matching link (case-insensitive match), then calls updateStory to persist the change via Shortcut API.

  async removeExternalLinkFromStory(storyPublicId: number, externalLink: string): Promise<Story> {
  	const story = await this.getStory(storyPublicId);
  	if (!story) throw new Error(`Story ${storyPublicId} not found`);
  
  	const currentLinks = story.external_links || [];
  	const updatedLinks = currentLinks.filter(
  		(link) => link.toLowerCase() !== externalLink.toLowerCase(),
  	);
  
  	return await this.updateStory(storyPublicId, { external_links: updatedLinks });
  }