remove-external-link-from-story
Remove external URLs from Shortcut stories to maintain clean project documentation and prevent broken references in your workflow.
Instructions
Remove an external link from a Shortcut story
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| storyPublicId | Yes | The public ID of the story | |
| externalLink | Yes | The external link URL to remove |
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 }); }