set-story-external-links
Replace all external links on a Shortcut story with new URLs to update references and attachments.
Instructions
Replace all external links on a story with a new set of links
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| storyPublicId | Yes | The public ID of the story | |
| externalLinks | Yes | Array of external link URLs to set (replaces all existing links) |
Implementation Reference
- src/tools/stories.ts:662-675 (handler)Main handler for the tool: validates parameters, delegates to client wrapper, formats MCP response.
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/client/shortcut.ts:473-475 (helper)Client wrapper method that implements the external links update by calling the base updateStory API.
async setStoryExternalLinks(storyPublicId: number, externalLinks: string[]): Promise<Story> { return await this.updateStory(storyPublicId, { external_links: externalLinks }); } - src/tools/stories.ts:309-320 (registration)Registers the MCP tool with server, defines input schema using Zod, and wires to handler method.
server.tool( "set-story-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:312-317 (schema)Input schema for the tool using Zod validation.
{ 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)"), },