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)"),
},

Shortcut MCP Server