@slidev/cli 52.16.0 → 52.17.0

package/README.md

@@ -19,7 +19,7 @@ Presentation <b>slide</b>s for <b>dev</b>elopers 🧑‍💻👩‍💻👨‍
 </p>
 
 <p align="center">
-  <a href="https://twitter.com/antfu7/status/1389604687502995457">Video Preview</a> | <a href="https://sli.dev">Documentation</a>
+  <a href="https://x.com/antfu7/status/1389604687502995457">Video Preview</a> | <a href="https://sli.dev">Documentation</a>
 </p>
 
 <div align="center">

package/dist/{build-BtXN8hyb.mjs → build-Cszi5hDI.mjs}

@@ -1,4 +1,4 @@
-import { n as resolveViteConfigs } from "./serve-bnzg299W.mjs";
+import { n as resolveViteConfigs } from "./serve-CgOXLPUI.mjs";
 import { join, resolve } from "node:path";
 import { build as build$1 } from "vite";
 import { existsSync } from "node:fs";
@@ -51,7 +51,7 @@ async function build(options, viteConfig = {}, args) {
 				dev: true
 			}));
 			server.listen(port);
-			const { exportSlides } = await import("./export-BHxAO7pf.mjs");
+			const { exportSlides } = await import("./export-CU2GL9dm.mjs");
 			const tempDir = resolve(outDir, "temp");
 			await fs$1.mkdir(tempDir, { recursive: true });
 			await exportSlides({
@@ -64,7 +64,7 @@ async function build(options, viteConfig = {}, args) {
 				range: "1",
 				width: options.data.config.canvasWidth,
 				height: Math.round(options.data.config.canvasWidth / options.data.config.aspectRatio),
-				routerMode: options.data.config.routerMode,
+				routerMode: options.data.config.routerMode === "memory" ? "history" : options.data.config.routerMode,
 				waitUntil: "networkidle",
 				timeout: args.timeout || 3e4,
 				perSlide: true,
@@ -92,7 +92,7 @@ async function build(options, viteConfig = {}, args) {
 		"true",
 		"auto"
 	].includes(options.data.config.download)) {
-		const { exportSlides, getExportOptions } = await import("./export-BHxAO7pf.mjs");
+		const { exportSlides, getExportOptions } = await import("./export-CU2GL9dm.mjs");
 		const port = 12445;
 		const app = connect();
 		const server = http.createServer(app);

package/dist/cli.mjs

@@ -1,5 +1,5 @@
-import { i as resolveEntry, r as isInstalledGlobally } from "./resolver-CZx9LFrt.mjs";
-import { a as resolveOptions, c as resolveTheme, d as updateFrontmatterPatch, l as version, o as parser, s as getThemeMeta, t as createServer, u as loadSetups } from "./serve-bnzg299W.mjs";
+import { i as resolveEntry, r as isInstalledGlobally } from "./resolver-BBT539iz.mjs";
+import { c as getThemeMeta, d as loadSetups, f as updateFrontmatterPatch, l as resolveTheme, o as resolveOptions, s as parser, t as createServer, u as version } from "./serve-CgOXLPUI.mjs";
 import path from "node:path";
 import process from "node:process";
 import fs from "node:fs/promises";
@@ -288,15 +288,19 @@ cli.command("build [entry..]", "Build hostable SPA", (args) => exportOptions(com
 	describe: "exclude speaker notes from the built output"
 }).option("router-mode", {
 	type: "string",
-	choices: ["hash", "history"],
-	describe: "override routerMode in the built output (hash for subdirectory deploys like GitHub Pages)"
+	choices: [
+		"hash",
+		"history",
+		"memory"
+	],
+	describe: "override routerMode in the built output (hash for subdirectory deploys like GitHub Pages; memory keeps the slide number out of the URL, for kiosk/follower decks)"
 }).option("inspect", {
 	default: false,
 	type: "boolean",
 	describe: "enable the inspect plugin for debugging"
 }).strict().help(), async (args) => {
 	const { entry, theme, base, download, out, inspect, "without-notes": withoutNotes, "router-mode": routerMode } = args;
-	const { build } = await import("./build-BtXN8hyb.mjs");
+	const { build } = await import("./build-Cszi5hDI.mjs");
 	for (const entryFile of entry) {
 		const options = await resolveOptions({
 			entry: entryFile,
@@ -324,6 +328,10 @@ cli.command("format [entry..]", "Format the markdown file", (args) => commonOpti
 		await parser.save(md);
 	}
 });
+cli.command("mcp [entry]", "Start an MCP (Model Context Protocol) server over stdio for AI agents to inspect and edit the slides", (args) => commonOptions(args).strict().help(), async ({ entry }) => {
+	const { startMcpStdioServer } = await import("./stdio-LsewwOTO.mjs");
+	await startMcpStdioServer(await resolveEntry(entry));
+});
 cli.command("theme [subcommand]", "Theme related operations", (command) => {
 	return command.command("eject", "Eject current theme into local file system", (args) => commonOptions(args).option("dir", {
 		type: "string",
@@ -361,7 +369,7 @@ cli.command("theme [subcommand]", "Theme related operations", (command) => {
 });
 cli.command("export [entry..]", "Export slides to PDF", (args) => exportOptions(commonOptions(args)).strict().help(), async (args) => {
 	const { entry, theme } = args;
-	const { exportSlides, getExportOptions } = await import("./export-BHxAO7pf.mjs");
+	const { exportSlides, getExportOptions } = await import("./export-CU2GL9dm.mjs");
 	const candidatePort = await getPort(12445);
 	let warned = false;
 	for (const entryFile of entry) {
@@ -413,7 +421,7 @@ cli.command("export-notes [entry..]", "Export slide notes to PDF", (args) => arg
 	type: "number",
 	describe: "wait for the specified ms before exporting"
 }).strict().help(), async ({ entry, output, timeout, wait }) => {
-	const { exportNotes } = await import("./export-BHxAO7pf.mjs");
+	const { exportNotes } = await import("./export-CU2GL9dm.mjs");
 	const candidatePort = await getPort(12445);
 	for (const entryFile of entry) {
 		const options = await resolveOptions({ entry: entryFile }, "export");
@@ -539,6 +547,7 @@ function printInfo(options, port, base, remote, tunnelUrl, publicIp) {
 		if (options.utils.define.__SLIDEV_FEATURE_PRESENTER__) console.log(`${dim("  presenter mode ")}     > ${blue(`${baseUrl}${presenterPath}`)}`);
 		console.log(`${dim("  slides overview ")}    > ${blue(`${baseUrl}${overviewPath}`)}`);
 		if (options.utils.define.__SLIDEV_FEATURE_BROWSER_EXPORTER__) console.log(`${dim("  export slides")}       > ${blue(`${baseUrl}/export/`)}`);
+		if (options.mode === "dev" && options.data.config.mcp !== false) console.log(`${dim("  mcp server (ai)")}     > ${blue(`http://localhost:${bold(port)}/__mcp`)}`);
 		if (options.inspect) console.log(`${dim("  vite inspector")}      > ${yellow(`${baseUrl}/__inspect/`)}`);
 		let lastRemoteUrl = "";
 		if (remote !== void 0) {

package/dist/{export-BHxAO7pf.mjs → export-CU2GL9dm.mjs}

@@ -1,4 +1,4 @@
-import { n as getRoots } from "./resolver-CZx9LFrt.mjs";
+import { n as getRoots } from "./resolver-BBT539iz.mjs";
 import path, { dirname, relative } from "node:path";
 import process from "node:process";
 import fs from "node:fs/promises";
@@ -387,7 +387,7 @@ function getExportOptions(args, options, outFilename) {
 		wait: wait ?? 0,
 		waitUntil: waitUntil === "none" ? void 0 : waitUntil ?? "networkidle",
 		dark: dark || options.data.config.colorSchema === "dark",
-		routerMode: options.data.config.routerMode,
+		routerMode: options.data.config.routerMode === "memory" ? "history" : options.data.config.routerMode,
 		width: options.data.config.canvasWidth,
 		height: Math.round(options.data.config.canvasWidth / options.data.config.aspectRatio),
 		withClicks: withClicks ?? format === "pptx",

package/dist/index.d.mts

@@ -1,7 +1,6 @@
 import { InlineConfig, PluginOption } from "vite";
 import * as parser from "@slidev/parser/fs";
 import { ResolvedSlidevOptions, ResolvedSlidevUtils, SlidevEntryOptions, SlidevPluginOptions, SlidevServerOptions } from "@slidev/types";
-
 //#region node/commands/serve.d.ts
 declare function createServer(options: ResolvedSlidevOptions, viteConfig?: InlineConfig, serverOptions?: SlidevServerOptions): Promise<import("vite").ViteDevServer>;
 //#endregion

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { a as resolveOptions, i as createDataUtils, o as parser, r as ViteSlidevPlugin, t as createServer } from "./serve-bnzg299W.mjs";
+import { a as createDataUtils, o as resolveOptions, r as ViteSlidevPlugin, s as parser, t as createServer } from "./serve-CgOXLPUI.mjs";
 export { ViteSlidevPlugin, createDataUtils, createServer, parser, resolveOptions };

package/dist/{resolver-CZx9LFrt.mjs → resolver-BBT539iz.mjs}

@@ -229,12 +229,14 @@ async function getRoots(entry) {
 	isInstalledGlobally.value = slash(relative(userRoot, process.argv[1])).includes("/.pnpm/") || invocationNodeModules != null && slash(relative(userRoot, invocationNodeModules)).startsWith("..") || (await import("is-installed-globally")).default;
 	const clientRoot = await findPkgRoot("@slidev/client", cliRoot, true);
 	const closestPkgRoot = dirname(await findClosestPkgJsonPath(userRoot) || userRoot);
+	const userPkgJson = await getUserPkgJson(closestPkgRoot);
+	const userWorkspaceRoot = await searchForWorkspaceRoot(closestPkgRoot);
 	rootsInfo = {
 		cliRoot,
 		clientRoot,
 		userRoot,
-		userPkgJson: await getUserPkgJson(closestPkgRoot),
-		userWorkspaceRoot: await searchForWorkspaceRoot(closestPkgRoot)
+		userPkgJson,
+		userWorkspaceRoot
 	};
 	return rootsInfo;
 }

package/dist/{serve-bnzg299W.mjs → serve-CgOXLPUI.mjs}

@@ -1,4 +1,4 @@
-import { a as resolveImportPath, c as toAtFS, i as resolveEntry, n as getRoots, o as resolveImportUrl, r as isInstalledGlobally, s as resolveSourceFiles, t as createResolver } from "./resolver-CZx9LFrt.mjs";
+import { a as resolveImportPath, c as toAtFS, i as resolveEntry, n as getRoots, o as resolveImportUrl, r as isInstalledGlobally, s as resolveSourceFiles, t as createResolver } from "./resolver-BBT539iz.mjs";
 import { builtinModules } from "node:module";
 import path, { basename, dirname, join, relative, resolve, win32 } from "node:path";
 import process from "node:process";
@@ -40,7 +40,11 @@ import lz from "lz-string";
 import { encode } from "plantuml-encoder";
 import { SourceMapConsumer } from "source-map-js";
 import { fromAsyncCodeToHtml } from "@shikijs/markdown-it/async";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
 import ServerRef from "vite-plugin-vue-server-ref";
+import { VitePWA } from "vite-plugin-pwa";
 import UnoCSS from "unocss/vite";
 import { mergeConfigs, presetIcons } from "unocss";
 import Vue from "@vitejs/plugin-vue";
@@ -307,6 +311,7 @@ const RE_SLIDEV_CLIENT_SUBPATH = /^@slidev\/client\/(.*)/;
 const RE_SLIDEV_VIRTUAL = /^#slidev\/(.*)/;
 const RE_MONACO_EDITOR = /\/monaco-editor(?:-core)?\//;
 const INCLUDE_GLOBAL = [
+	"@fix-webm-duration/fix",
 	"@typescript/ata",
 	"file-saver",
 	"lz-string",
@@ -528,7 +533,7 @@ const templateTitleRenderer = {
 };
 //#endregion
 //#region node/vite/importGuard.ts
-const virtualSlideMarkdownIds = new Set([templateTitleRendererMd.id, templateLegacyTitles.id]);
+const virtualSlideMarkdownIds = /* @__PURE__ */ new Set([templateTitleRendererMd.id, templateLegacyTitles.id]);
 function createSlideImportGuardPlugin() {
 	let config;
 	let allowRoots = [];
@@ -685,7 +690,7 @@ function createLayoutWrapperPlugin({ data, utils }) {
 }
 //#endregion
 //#region package.json
-var version = "52.16.0";
+var version = "52.17.0";
 //#endregion
 //#region node/integrations/addons.ts
 async function resolveAddons(addonsInConfig) {
@@ -901,7 +906,7 @@ function resolveShikiOptions(options) {
 	if (mergedOptions.themes) {
 		for (const theme of Object.values(mergedOptions.themes)) if (typeof theme === "object" && theme?.name) themeInput[theme.name] = theme;
 	}
-	const languageNames = new Set([
+	const languageNames = /* @__PURE__ */ new Set([
 		"markdown",
 		"vue",
 		"javascript",
@@ -1071,6 +1076,7 @@ function getDefine(options) {
 		__DEV__: options.mode === "dev",
 		__SLIDEV_CLIENT_ROOT__: toAtFS(options.clientRoot),
 		__SLIDEV_HASH_ROUTE__: options.data.config.routerMode === "hash",
+		__SLIDEV_MEMORY_ROUTE__: options.data.config.routerMode === "memory" && options.mode !== "export",
 		__SLIDEV_FEATURE_DRAWINGS__: matchMode(options.data.config.drawings.enabled),
 		__SLIDEV_FEATURE_EDITOR__: options.mode === "dev" && options.data.config.editor !== false,
 		__SLIDEV_FEATURE_DRAWINGS_PERSIST__: !!options.data.config.drawings.persist,
@@ -1083,6 +1089,7 @@ function getDefine(options) {
 		].includes(options.data.config.download),
 		__SLIDEV_FEATURE_BROWSER_EXPORTER__: matchMode(options.data.config.browserExporter),
 		__SLIDEV_FEATURE_WAKE_LOCK__: matchMode(options.data.config.wakeLock),
+		__SLIDEV_FEATURE_PWA__: matchMode(options.data.config.pwa),
 		__SLIDEV_HAS_SERVER__: options.mode !== "build"
 	}, (v, k) => [v, JSON.stringify(k)]);
 }
@@ -1658,6 +1665,7 @@ function createSlidesLoader(options, serverOptions) {
 						frontmatter: void 0,
 						source: void 0,
 						importChain: void 0,
+						images: slide.images ?? slide.source?.images,
 						...mode === "build" ? {
 							raw: "",
 							content: "",
@@ -2579,6 +2587,491 @@ async function createMarkdownPlugin(options, { markdown: mdOptions }) {
 	});
 }
 //#endregion
+//#region node/mcp/operations.ts
+/**
+* Resolve a rendered slide (1-based, as displayed in the presentation) or
+* throw a descriptive error.
+*/
+function resolveSlide(data, no) {
+	const slide = data.slides[no - 1];
+	if (!slide) throw new Error(`Slide ${no} does not exist. The deck has ${data.slides.length} slides (1-${data.slides.length}).`);
+	return slide;
+}
+function getMarkdown(data, source) {
+	const md = data.markdownFiles[source.filepath];
+	if (!md) throw new Error(`Markdown file not loaded: ${source.filepath}`);
+	return md;
+}
+function assertNotEntryHeadmatter(data, source, action) {
+	if (source.filepath === data.entry.filepath && data.entry.slides.indexOf(source) === 0) throw new Error(`Cannot ${action} the first slide of the entry file: its frontmatter is the deck headmatter (global configuration). Edit its content with the update tool instead, or operate on the following slides.`);
+}
+/**
+* Apply a `SlidePatch` to the slide source and save the markdown file.
+*
+* Note this only mutates the *source* slide (`slide.source`), not the
+* rendered `SlideInfo`, so a running dev server will pick up the change from
+* disk like an external edit and push HMR updates to connected clients.
+*/
+async function applySlidePatch(data, no, patch) {
+	const slide = resolveSlide(data, no);
+	const source = slide.source;
+	if (patch.content != null) source.content = patch.content;
+	if (patch.frontmatterRaw != null) if (patch.frontmatterRaw.trim() === "") source.frontmatterDoc = source.frontmatterStyle = void 0;
+	else {
+		const parsed = YAML.parseDocument(patch.frontmatterRaw);
+		if (parsed.errors.length) throw new Error(`Invalid YAML frontmatter: ${parsed.errors.map((e) => e.message).join("; ")}`);
+		source.frontmatterDoc = parsed;
+	}
+	if (patch.note != null) source.note = patch.note;
+	if (patch.frontmatter) updateFrontmatterPatch(source, patch.frontmatter);
+	parser.prettifySlide(source);
+	return {
+		slide,
+		fileContent: await parser.save(getMarkdown(data, source))
+	};
+}
+/**
+* Insert a new slide after an existing one, in the same markdown file.
+*/
+async function insertSlide(data, options) {
+	const anchor = resolveSlide(data, options.after);
+	const md = getMarkdown(data, anchor.source);
+	const frontmatter = options.frontmatter ?? {};
+	const doc = Object.keys(frontmatter).length > 0 ? new YAML.Document(frontmatter) : void 0;
+	const source = {
+		filepath: anchor.source.filepath,
+		index: 0,
+		start: 0,
+		contentStart: 0,
+		end: 0,
+		raw: "",
+		revision: "",
+		content: options.content,
+		contentRaw: options.content,
+		frontmatter,
+		frontmatterDoc: doc,
+		frontmatterStyle: doc ? "frontmatter" : void 0,
+		frontmatterRaw: doc?.toString(),
+		note: options.note?.trim() || void 0
+	};
+	parser.prettifySlide(source);
+	const anchorIdx = md.slides.indexOf(anchor.source);
+	md.slides.splice(anchorIdx + 1, 0, source);
+	const fileContent = await parser.save(md);
+	return {
+		source,
+		filepath: md.filepath,
+		fileContent
+	};
+}
+/**
+* Remove a slide from its source markdown file.
+*/
+async function removeSlide(data, no) {
+	const slide = resolveSlide(data, no);
+	assertNotEntryHeadmatter(data, slide.source, "remove");
+	const md = getMarkdown(data, slide.source);
+	const idx = md.slides.indexOf(slide.source);
+	if (idx < 0) throw new Error(`Slide ${no} is out of sync with its source file. Try again.`);
+	md.slides.splice(idx, 1);
+	const fileContent = await parser.save(md);
+	return {
+		removed: slide,
+		filepath: md.filepath,
+		fileContent
+	};
+}
+/**
+* Move a slide before or after another slide within the same markdown file.
+*/
+async function moveSlide(data, options) {
+	const { from, before, after } = options;
+	if (before == null === (after == null)) throw new Error("Specify exactly one of `before` or `after`.");
+	const anchorNo = before ?? after;
+	if (anchorNo === from) throw new Error("The `before`/`after` anchor must be a different slide than `from`.");
+	const slide = resolveSlide(data, from);
+	const anchor = resolveSlide(data, anchorNo);
+	if (slide.source.filepath !== anchor.source.filepath) throw new Error(`Cannot move a slide across markdown files: slide ${from} is in "${slide.source.filepath}" but slide ${anchorNo} is in "${anchor.source.filepath}" (imported with \`src:\`). Move it within its own file, or edit the \`src:\` imports in the entry file manually.`);
+	assertNotEntryHeadmatter(data, slide.source, "move");
+	if (before != null) assertNotEntryHeadmatter(data, anchor.source, "insert a slide before");
+	const md = getMarkdown(data, slide.source);
+	const fromIdx = md.slides.indexOf(slide.source);
+	if (fromIdx < 0) throw new Error(`Slide ${from} is out of sync with its source file. Try again.`);
+	md.slides.splice(fromIdx, 1);
+	const anchorIdx = md.slides.indexOf(anchor.source);
+	if (anchorIdx < 0) throw new Error(`Slide ${anchorNo} is out of sync with its source file. Try again.`);
+	md.slides.splice(before != null ? anchorIdx : anchorIdx + 1, 0, slide.source);
+	const fileContent = await parser.save(md);
+	return {
+		moved: slide,
+		anchor,
+		filepath: md.filepath,
+		fileContent
+	};
+}
+//#endregion
+//#region node/mcp/server.ts
+function result(data) {
+	return { content: [{
+		type: "text",
+		text: typeof data === "string" ? data : JSON.stringify(data, null, 2)
+	}] };
+}
+function slideSummary(slide) {
+	return {
+		no: slide.index + 1,
+		title: slide.title ?? null,
+		...slide.frontmatter.layout ? { layout: slide.frontmatter.layout } : {},
+		file: slide.source.filepath,
+		hasNote: !!slide.source.note,
+		...slide.importChain?.length ? { importedBySrcDirective: true } : {}
+	};
+}
+const noSchema = z.number().int().min(1).describe("Slide number (1-based, as displayed in the presentation)");
+const frontmatterSchema = z.record(z.any()).optional().describe("Slide frontmatter (YAML headmatter of the slide) as an object, e.g. { \"layout\": \"two-cols\" }");
+/**
+* Create the Slidev MCP server exposing tools for agents to inspect, edit,
+* and (with a running dev server) navigate a slides deck.
+*
+* The same tool set is served over the dev server HTTP endpoint (`/__mcp`)
+* and the `slidev mcp` stdio command.
+*/
+function createSlidevMcpServer(ctx) {
+	const server = new McpServer({
+		name: "slidev",
+		version: ctx.version
+	}, { instructions: [
+		"Tools for working with a Slidev (https://sli.dev) slides deck.",
+		"A deck is a Markdown file where slides are separated by `---`; each slide can have YAML frontmatter, Markdown/Vue content, and a speaker note (trailing HTML comment).",
+		"Slides are addressed by their rendered 1-based number, matching the slide numbers shown in the presentation.",
+		"After editing tools run, a running dev server hot-reloads the presentation automatically."
+	].join("\n") });
+	server.registerTool("slidev-get-info", {
+		title: "Get deck info",
+		description: "Get an overview of the Slidev deck: entry file, title, slide count, markdown files, and (when a dev server is running) the server URL and current position of the live presentation.",
+		annotations: { readOnlyHint: true }
+	}, async () => {
+		const data = await ctx.getData();
+		const nav = ctx.nav?.getState();
+		return result({
+			slidevVersion: ctx.version,
+			entry: ctx.entry,
+			title: data.headmatter.title ?? data.slides[0]?.title ?? null,
+			theme: data.config?.theme ?? data.headmatter.theme ?? null,
+			totalSlides: data.slides.length,
+			markdownFiles: Object.keys(data.markdownFiles),
+			...ctx.getServerUrl?.() ? { server: {
+				url: ctx.getServerUrl(),
+				currentPage: nav?.page || null,
+				currentClicks: nav?.page ? nav.clicks : null
+			} } : {}
+		});
+	});
+	server.registerTool("slidev-list-slides", {
+		title: "List slides",
+		description: "List all slides of the deck with their number, title, layout, and source file. Slides hidden with `hide`/`disabled` frontmatter are not included.",
+		annotations: { readOnlyHint: true }
+	}, async () => {
+		return result((await ctx.getData()).slides.map(slideSummary));
+	});
+	server.registerTool("slidev-get-slide", {
+		title: "Get slide",
+		description: "Get the full source of one slide: frontmatter, Markdown content, and speaker note.",
+		inputSchema: { no: noSchema },
+		annotations: { readOnlyHint: true }
+	}, async ({ no }) => {
+		const slide = resolveSlide(await ctx.getData(), no);
+		return result({
+			...slideSummary(slide),
+			frontmatter: slide.source.frontmatter,
+			content: slide.source.content.trim(),
+			note: slide.source.note ?? null,
+			...slide.importChain?.length ? { importedBy: slide.importChain.map((s) => `${s.filepath}#${s.index + 1}`) } : {}
+		});
+	});
+	server.registerTool("slidev-update-slide", {
+		title: "Update slide",
+		description: "Update the content, speaker note, and/or frontmatter of a slide. Only the provided fields are changed. Pass an empty string to clear the content or note. In `frontmatter`, only the given keys are patched; pass `null` as a value to delete that key.",
+		inputSchema: {
+			no: noSchema,
+			content: z.string().optional().describe("New Markdown content of the slide (without frontmatter and note)"),
+			note: z.string().optional().describe("New speaker note (Markdown, stored as a trailing HTML comment)"),
+			frontmatter: frontmatterSchema
+		}
+	}, async ({ no, content, note, frontmatter }) => {
+		if (content == null && note == null && frontmatter == null) throw new Error("Nothing to update: provide at least one of `content`, `note`, or `frontmatter`.");
+		const { slide } = await applySlidePatch(await ctx.getData(), no, {
+			content,
+			note,
+			frontmatter
+		});
+		return result(`Updated slide ${no} in ${slide.source.filepath}.`);
+	});
+	server.registerTool("slidev-insert-slide", {
+		title: "Insert slide",
+		description: "Insert a new slide after an existing slide (into the same markdown file). To add a slide at the very end, pass the last slide number.",
+		inputSchema: {
+			after: z.number().int().min(1).describe("Slide number (1-based) after which the new slide is inserted"),
+			content: z.string().describe("Markdown content of the new slide"),
+			frontmatter: frontmatterSchema,
+			note: z.string().optional().describe("Speaker note of the new slide")
+		}
+	}, async ({ after, content, frontmatter, note }) => {
+		const { filepath } = await insertSlide(await ctx.getData(), {
+			after,
+			content,
+			frontmatter,
+			note
+		});
+		return result(`Inserted a new slide after slide ${after} in ${filepath}. Slide numbers after it have shifted; list the slides again if needed.`);
+	});
+	server.registerTool("slidev-remove-slide", {
+		title: "Remove slide",
+		description: "Remove a slide from the deck (deletes it from its source markdown file).",
+		inputSchema: { no: noSchema },
+		annotations: { destructiveHint: true }
+	}, async ({ no }) => {
+		const { removed, filepath } = await removeSlide(await ctx.getData(), no);
+		return result(`Removed slide ${no}${removed.title ? ` ("${removed.title}")` : ""} from ${filepath}. Slide numbers after it have shifted; list the slides again if needed.`);
+	});
+	server.registerTool("slidev-move-slide", {
+		title: "Move slide",
+		description: "Move a slide before or after another slide to reorder the deck. Both slides must be in the same markdown file. To swap two adjacent slides, move one after the other.",
+		inputSchema: {
+			from: z.number().int().min(1).describe("Slide number (1-based) of the slide to move"),
+			before: z.number().int().min(1).optional().describe("Move the slide right before this slide number"),
+			after: z.number().int().min(1).optional().describe("Move the slide right after this slide number")
+		}
+	}, async ({ from, before, after }) => {
+		const { filepath } = await moveSlide(await ctx.getData(), {
+			from,
+			before,
+			after
+		});
+		return result(`Moved slide ${from} ${before != null ? `before slide ${before}` : `after slide ${after}`} in ${filepath}. Slide numbers have shifted; list the slides again if needed.`);
+	});
+	if (ctx.nav) {
+		const nav = ctx.nav;
+		server.registerTool("slidev-goto-slide", {
+			title: "Go to slide",
+			description: "Navigate the live presentation (all connected browsers) to a given slide, e.g. to visually verify a slide after editing it.",
+			inputSchema: {
+				no: noSchema,
+				clicks: z.number().int().min(0).optional().describe("Click animation step to reveal (defaults to 0)")
+			},
+			annotations: { idempotentHint: true }
+		}, async ({ no, clicks }) => {
+			resolveSlide(await ctx.getData(), no);
+			nav.go(no, clicks ?? 0);
+			return result(`Navigated the presentation to slide ${no}${clicks ? ` (click ${clicks})` : ""}.`);
+		});
+	}
+	return server;
+}
+//#endregion
+//#region node/integrations/drawings.ts
+function resolveDrawingsDir(options) {
+	return options.data.config.drawings.persist ? resolve(dirname(options.entry), options.data.config.drawings.persist) : void 0;
+}
+async function loadDrawings(options) {
+	const dir = resolveDrawingsDir(options);
+	if (!dir || !existsSync(dir)) return {};
+	const files = await fg("*.svg", {
+		onlyFiles: true,
+		cwd: dir,
+		absolute: true,
+		suppressErrors: true
+	});
+	const obj = {};
+	await Promise.all(files.map(async (path) => {
+		const num = +basename(path, ".svg");
+		if (Number.isNaN(num)) return;
+		const lines = (await fs$1.readFile(path, "utf8")).split(/\n/g);
+		obj[num.toString()] = lines.slice(1, -1).join("\n");
+	}));
+	return obj;
+}
+async function writeDrawings(options, drawing) {
+	const dir = resolveDrawingsDir(options);
+	if (!dir) return;
+	const width = options.data.config.canvasWidth;
+	const SVG_HEAD = `<svg width="${width}" height="${Math.round(width / options.data.config.aspectRatio)}" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">`;
+	await fs$1.mkdir(dir, { recursive: true });
+	return Promise.all(Object.entries(drawing).map(async ([key, value]) => {
+		if (!value) return;
+		const svg = `${SVG_HEAD}\n${value}\n</svg>`;
+		await fs$1.writeFile(join(dir, `${key}.svg`), svg, "utf-8");
+	}));
+}
+//#endregion
+//#region node/integrations/snapshots.ts
+function resolveSnapshotsDir(options) {
+	return resolve(dirname(options.entry), ".slidev/snapshots");
+}
+async function loadSnapshots(options) {
+	const dir = resolveSnapshotsDir(options);
+	const file = join(dir, "snapshots.json");
+	if (!dir || !existsSync(file)) return {};
+	return JSON.parse(await fs$1.readFile(file, "utf8"));
+}
+async function writeSnapshots(options, data) {
+	const dir = resolveSnapshotsDir(options);
+	if (!dir) return;
+	await fs$1.mkdir(dir, { recursive: true });
+	await fs$1.writeFile(join(dir, "snapshots.json"), JSON.stringify(data, null, 2), "utf-8");
+}
+//#endregion
+//#region node/vite/serverRef.ts
+const serverRefStates = /* @__PURE__ */ new WeakMap();
+/**
+* Access the server-side state shared with the clients via
+* `vite-plugin-vue-server-ref` (e.g. `nav` holds the current position of the
+* live presentation).
+*/
+function getServerRefState(options) {
+	return serverRefStates.get(options);
+}
+async function createServerRefPlugin(options, pluginOptions) {
+	const state = {
+		sync: false,
+		nav: {
+			page: 0,
+			clicks: 0,
+			timer: {
+				status: "stopped",
+				slides: {},
+				startedAt: 0,
+				pausedAt: 0
+			}
+		},
+		drawings: await loadDrawings(options),
+		snapshots: await loadSnapshots(options),
+		...pluginOptions.serverRef?.state
+	};
+	serverRefStates.set(options, state);
+	return ServerRef({
+		debug: false,
+		state,
+		onChanged(key, data, patch, timestamp) {
+			pluginOptions.serverRef?.onChanged?.(key, data, patch, timestamp);
+			if (options.data.config.drawings.persist && key === "drawings") writeDrawings(options, patch ?? data);
+			if (key === "snapshots") writeSnapshots(options, data);
+		}
+	});
+}
+const SERVER_REF_WS_EVENT = "vue-server-ref";
+const SERVER_REF_NAV_MODULE_IDS = ["/@server-reactive/nav", "/@server-ref/nav"];
+/**
+* Serves the Slidev MCP (Model Context Protocol) server on the dev server at
+* `/__mcp` (streamable HTTP transport), so AI agents can inspect, edit, and
+* navigate the slides. Can be disabled with `mcp: false` in the headmatter.
+*/
+function createMcpPlugin(options) {
+	return {
+		name: "slidev:mcp",
+		apply: "serve",
+		configureServer(server) {
+			if (options.mode !== "dev") return;
+			const ctx = {
+				version,
+				entry: options.entry,
+				getData: () => options.data,
+				getServerUrl: () => server.resolvedUrls?.local[0],
+				nav: {
+					getState: () => {
+						const nav = getServerRefState(options)?.nav;
+						return {
+							page: nav?.page ?? 0,
+							clicks: nav?.clicks ?? 0
+						};
+					},
+					go: (page, clicks) => navigateClients(server, options, page, clicks)
+				}
+			};
+			server.middlewares.use(async (req, res, next) => {
+				if (req.url?.split("?")[0]?.replace(/\/$/, "") !== "/__mcp") return next();
+				if (options.data.config.mcp === false) {
+					res.statusCode = 403;
+					res.setHeader("Content-Type", "application/json");
+					res.end(JSON.stringify({
+						jsonrpc: "2.0",
+						error: {
+							code: -32e3,
+							message: "The Slidev MCP server is disabled (`mcp: false` in the headmatter)"
+						},
+						id: null
+					}));
+					return;
+				}
+				try {
+					const mcp = createSlidevMcpServer(ctx);
+					const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: void 0 });
+					res.on("close", () => {
+						transport.close();
+						mcp.close();
+					});
+					await mcp.connect(transport);
+					await transport.handleRequest(req, res);
+				} catch (e) {
+					console.error("[slidev] Error handling MCP request:", e);
+					if (!res.headersSent) {
+						res.statusCode = 500;
+						res.setHeader("Content-Type", "application/json");
+						res.end(JSON.stringify({
+							jsonrpc: "2.0",
+							error: {
+								code: -32603,
+								message: "Internal server error"
+							},
+							id: null
+						}));
+					}
+				}
+			});
+		}
+	};
+}
+/**
+* Drive all connected clients to the given slide by patching the shared
+* `nav` state, mimicking what `vite-plugin-vue-server-ref` does when a
+* presenter or remote-control client navigates.
+*/
+function navigateClients(server, options, page, clicks) {
+	const time = Date.now();
+	const nav = getServerRefState(options)?.nav;
+	if (nav) {
+		nav.page = page;
+		nav.clicks = clicks;
+		nav.lastUpdate = {
+			id: "slidev-mcp",
+			type: "presenter",
+			time
+		};
+	}
+	for (const id of SERVER_REF_NAV_MODULE_IDS) {
+		const module = server.moduleGraph.getModuleById(id);
+		if (module) server.moduleGraph.invalidateModule(module);
+	}
+	for (const type of ["presenter", "viewer"]) server.hot.send({
+		type: "custom",
+		event: SERVER_REF_WS_EVENT,
+		data: {
+			key: "nav",
+			source: "slidev-mcp",
+			patch: {
+				page,
+				clicks,
+				lastUpdate: {
+					id: "slidev-mcp",
+					type,
+					time
+				}
+			},
+			timestamp: time
+		}
+	});
+}
+//#endregion
 //#region node/vite/monacoTypes.ts
 function createMonacoTypesLoader({ userRoot, utils }) {
 	return {
@@ -2648,6 +3141,34 @@ function createPatchMonacoSourceMapPlugin() {
 	};
 }
 //#endregion
+//#region node/vite/pwa.ts
+function createPWAPlugin(options) {
+	const matchMode = (mode) => mode === true || mode === options.mode;
+	const enabled = matchMode(options.data.config.pwa);
+	const base = options.base ?? "/";
+	const title = options.data.config.title || "Slidev";
+	return VitePWA({
+		disable: !enabled,
+		registerType: "autoUpdate",
+		injectRegister: null,
+		base,
+		workbox: {
+			maximumFileSizeToCacheInBytes: 100 * 1024 * 1024,
+			globPatterns: ["**/*.{js,css,html,woff,woff2,ttf,png,jpg,jpeg,svg,gif,webp,avif,ico,mp4,webm,ogv,mov,m4v,mp3,wav,ogg,oga,m4a,aac,flac,opus,weba}"],
+			navigateFallback: "index.html",
+			navigateFallbackDenylist: [/^\/(presenter|notes|overview|print|export)/]
+		},
+		manifest: {
+			name: title,
+			short_name: "Slidev",
+			start_url: base,
+			display: "fullscreen",
+			theme_color: "#121212",
+			background_color: "#121212"
+		}
+	});
+}
+//#endregion
 //#region node/vite/remoteAssets.ts
 async function createRemoteAssetsPlugin({ data: { config }, mode }, pluginOptions) {
 	if (!(config.remoteAssets === true || config.remoteAssets === mode)) return;
@@ -2667,86 +3188,6 @@ async function createRemoteAssetsPlugin({ data: { config }, mode }, pluginOption
 	});
 }
 //#endregion
-//#region node/integrations/drawings.ts
-function resolveDrawingsDir(options) {
-	return options.data.config.drawings.persist ? resolve(dirname(options.entry), options.data.config.drawings.persist) : void 0;
-}
-async function loadDrawings(options) {
-	const dir = resolveDrawingsDir(options);
-	if (!dir || !existsSync(dir)) return {};
-	const files = await fg("*.svg", {
-		onlyFiles: true,
-		cwd: dir,
-		absolute: true,
-		suppressErrors: true
-	});
-	const obj = {};
-	await Promise.all(files.map(async (path) => {
-		const num = +basename(path, ".svg");
-		if (Number.isNaN(num)) return;
-		const lines = (await fs$1.readFile(path, "utf8")).split(/\n/g);
-		obj[num.toString()] = lines.slice(1, -1).join("\n");
-	}));
-	return obj;
-}
-async function writeDrawings(options, drawing) {
-	const dir = resolveDrawingsDir(options);
-	if (!dir) return;
-	const width = options.data.config.canvasWidth;
-	const SVG_HEAD = `<svg width="${width}" height="${Math.round(width / options.data.config.aspectRatio)}" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">`;
-	await fs$1.mkdir(dir, { recursive: true });
-	return Promise.all(Object.entries(drawing).map(async ([key, value]) => {
-		if (!value) return;
-		const svg = `${SVG_HEAD}\n${value}\n</svg>`;
-		await fs$1.writeFile(join(dir, `${key}.svg`), svg, "utf-8");
-	}));
-}
-//#endregion
-//#region node/integrations/snapshots.ts
-function resolveSnapshotsDir(options) {
-	return resolve(dirname(options.entry), ".slidev/snapshots");
-}
-async function loadSnapshots(options) {
-	const dir = resolveSnapshotsDir(options);
-	const file = join(dir, "snapshots.json");
-	if (!dir || !existsSync(file)) return {};
-	return JSON.parse(await fs$1.readFile(file, "utf8"));
-}
-async function writeSnapshots(options, data) {
-	const dir = resolveSnapshotsDir(options);
-	if (!dir) return;
-	await fs$1.mkdir(dir, { recursive: true });
-	await fs$1.writeFile(join(dir, "snapshots.json"), JSON.stringify(data, null, 2), "utf-8");
-}
-//#endregion
-//#region node/vite/serverRef.ts
-async function createServerRefPlugin(options, pluginOptions) {
-	return ServerRef({
-		debug: false,
-		state: {
-			sync: false,
-			nav: {
-				page: 0,
-				clicks: 0,
-				timer: {
-					status: "stopped",
-					slides: {},
-					startedAt: 0,
-					pausedAt: 0
-				}
-			},
-			drawings: await loadDrawings(options),
-			snapshots: await loadSnapshots(options),
-			...pluginOptions.serverRef?.state
-		},
-		onChanged(key, data, patch, timestamp) {
-			pluginOptions.serverRef?.onChanged?.(key, data, patch, timestamp);
-			if (options.data.config.drawings.persist && key === "drawings") writeDrawings(options, patch ?? data);
-			if (key === "snapshots") writeSnapshots(options, data);
-		}
-	});
-}
-//#endregion
 //#region node/vite/staticCopy.ts
 async function createStaticCopyPlugin({ themeRoots, addonRoots }, pluginOptions) {
 	const publicDirs = [...themeRoots, ...addonRoots].map((i) => join(i, "public")).filter(existsSync);
@@ -2805,7 +3246,7 @@ const RE_VUE_QUERY_VUE = /\.vue\?vue/;
 const RE_VUE_QUERY_V = /\.vue\?v=/;
 const RE_MD_EXT = /\.md$/;
 const RE_MD_QUERY_VUE = /\.md\?vue/;
-const customElements = new Set([
+const customElements = /* @__PURE__ */ new Set([
 	"annotation",
 	"math",
 	"menclose",
@@ -2863,6 +3304,7 @@ async function createVuePlugin(_options, pluginOptions) {
 function ViteSlidevPlugin(options, pluginOptions = {}, serverOptions = {}) {
 	return Promise.all([
 		createSlidesLoader(options, serverOptions),
+		createMcpPlugin(options),
 		createMarkdownPlugin(options, pluginOptions),
 		createLayoutWrapperPlugin(options),
 		createContextInjectionPlugin(),
@@ -2881,6 +3323,7 @@ function ViteSlidevPlugin(options, pluginOptions = {}, serverOptions = {}) {
 		createStaticCopyPlugin(options, pluginOptions),
 		createInspectPlugin(options, pluginOptions),
 		createPatchMonacoSourceMapPlugin(),
+		createPWAPlugin(options),
 		setupVitePlugins(options)
 	]);
 }
@@ -2920,4 +3363,4 @@ async function createServer$1(options, viteConfig = {}, serverOptions) {
 	return await createServer(await resolveViteConfigs(options, { optimizeDeps: { entries: [join(options.clientRoot, "main.ts")] } }, viteConfig, "serve", serverOptions));
 }
 //#endregion
-export { resolveOptions as a, resolveTheme as c, updateFrontmatterPatch as d, createDataUtils as i, version as l, resolveViteConfigs as n, parser as o, ViteSlidevPlugin as r, getThemeMeta as s, createServer$1 as t, loadSetups as u };
+export { createDataUtils as a, getThemeMeta as c, loadSetups as d, updateFrontmatterPatch as f, createSlidevMcpServer as i, resolveTheme as l, resolveViteConfigs as n, resolveOptions as o, ViteSlidevPlugin as r, parser as s, createServer$1 as t, version as u };

package/dist/stdio-LsewwOTO.mjs

@@ -0,0 +1,24 @@
+import { n as getRoots } from "./resolver-BBT539iz.mjs";
+import { i as createSlidevMcpServer, s as parser, u as version } from "./serve-CgOXLPUI.mjs";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+//#region node/mcp/stdio.ts
+/**
+* Start a Slidev MCP server over stdio, operating on the markdown files
+* directly (no dev server required, so no live-navigation tool).
+*
+* Note: in stdio mode, stdout is reserved for the MCP protocol — nothing
+* else may be printed to it.
+*/
+async function startMcpStdioServer(entry) {
+	const { userRoot } = await getRoots(entry);
+	await createSlidevMcpServer({
+		version,
+		entry,
+		getData: () => parser.load({
+			userRoot,
+			roots: [userRoot]
+		}, entry)
+	}).connect(new StdioServerTransport());
+}
+//#endregion
+export { startMcpStdioServer };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@slidev/cli",
   "type": "module",
-  "version": "52.16.0",
+  "version": "52.17.0",
   "description": "Presentation slides for developers",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -43,21 +43,22 @@
     }
   },
   "dependencies": {
-    "@antfu/ni": "^30.1.0",
+    "@antfu/ni": "^30.2.0",
     "@antfu/utils": "^9.3.0",
     "@comark/markdown-it": "^0.3.4",
-    "@iconify-json/carbon": "^1.2.22",
+    "@iconify-json/carbon": "^1.2.24",
     "@iconify-json/ph": "^1.2.2",
     "@iconify-json/svg-spinners": "^1.2.4",
     "@lillallol/outline-pdf": "^4.0.0",
-    "@shikijs/magic-move": "^4.2.0",
-    "@shikijs/markdown-it": "^4.2.0",
-    "@shikijs/twoslash": "^4.2.0",
-    "@shikijs/vitepress-twoslash": "^4.2.0",
-    "@unocss/extractor-mdc": "^66.7.0",
-    "@unocss/reset": "^66.7.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@shikijs/magic-move": "^4.3.1",
+    "@shikijs/markdown-it": "^4.3.1",
+    "@shikijs/twoslash": "^4.3.1",
+    "@shikijs/vitepress-twoslash": "^4.3.1",
+    "@unocss/extractor-mdc": "^66.7.5",
+    "@unocss/reset": "^66.7.5",
     "@vitejs/plugin-vue": "^6.0.7",
-    "@vitejs/plugin-vue-jsx": "^5.1.5",
+    "@vitejs/plugin-vue-jsx": "^5.1.6",
     "ansis": "^4.3.1",
     "chokidar": "^5.0.0",
     "cli-progress": "^3.12.0",
@@ -74,15 +75,15 @@
     "lz-string": "^1.5.0",
     "magic-string": "^0.30.21",
     "magic-string-stack": "^1.1.0",
-    "markdown-exit": "^1.0.0-beta.9",
+    "markdown-exit": "^1.1.0-beta.2",
     "markdown-it-footnote": "^4.0.0",
     "markdown-it-github-alerts": "^1.0.1",
     "mlly": "^1.8.2",
     "monaco-editor": "^0.55.1",
-    "obug": "^2.1.1",
+    "obug": "^2.1.3",
     "open": "^11.0.0",
     "pdf-lib": "^1.17.1",
-    "picomatch": "^4.0.4",
+    "picomatch": "^4.0.5",
     "plantuml-encoder": "^1.4.0",
     "postcss-nested": "^7.0.2",
     "pptxgenjs": "^4.0.1",
@@ -90,30 +91,32 @@
     "public-ip": "^8.0.0",
     "resolve-from": "^5.0.0",
     "resolve-global": "^2.0.0",
-    "semver": "^7.8.1",
-    "shiki": "^4.2.0",
+    "semver": "^7.8.5",
+    "shiki": "^4.3.1",
     "sirv": "^3.0.2",
     "source-map-js": "^1.2.1",
     "typescript": "^6.0.3",
-    "unhead": "^3.1.1",
-    "unocss": "^66.7.0",
+    "unhead": "^3.1.7",
+    "unocss": "^66.7.5",
     "unplugin-icons": "^23.0.1",
     "unplugin-vue-components": "^32.1.0",
     "unplugin-vue-markdown": "^32.0.0",
     "untun": "^0.1.3",
     "uqr": "^0.1.3",
-    "vite": "^8.0.16",
+    "vite": "^8.1.3",
     "vite-plugin-inspect": "^11.4.1",
+    "vite-plugin-pwa": "^1.3.0",
     "vite-plugin-remote-assets": "^2.1.0",
-    "vite-plugin-static-copy": "^4.1.0",
+    "vite-plugin-static-copy": "^4.1.1",
     "vite-plugin-vue-server-ref": "^1.0.0",
     "vitefu": "^1.1.3",
-    "vue": "^3.5.35",
+    "vue": "^3.5.39",
     "yaml": "^2.9.0",
     "yargs": "^18.0.0",
-    "@slidev/client": "52.16.0",
-    "@slidev/types": "52.16.0",
-    "@slidev/parser": "52.16.0"
+    "zod": "^3.25.76",
+    "@slidev/parser": "52.17.0",
+    "@slidev/client": "52.17.0",
+    "@slidev/types": "52.17.0"
   },
   "devDependencies": {
     "@hedgedoc/markdown-it-plugins": "^2.1.4",

package/skills/slidev/SKILL.md

@@ -158,6 +158,7 @@ Presenter notes go here
 | VS Code extension | Install `antfu.slidev` | [editor-vscode](references/editor-vscode.md) |
 | Prettier | `prettier-plugin-slidev` | [editor-prettier](references/editor-prettier.md) |
 | Eject theme | `slidev theme eject` | [tool-eject-theme](references/tool-eject-theme.md) |
+| MCP server (AI agents) | `http://localhost:<port>/__mcp` or `slidev mcp` | [tool-mcp](references/tool-mcp.md) |
 
 ### Lifecycle & API
 

package/skills/slidev/references/core-cli.md

@@ -93,6 +93,14 @@ slidev format [entry]
 
 Formats the slides markdown file.
 
+## MCP Server
+
+```bash
+slidev mcp [entry]
+```
+
+Starts an MCP (Model Context Protocol) server over stdio for AI agents to inspect and edit the slides. When a dev server is running, an HTTP MCP endpoint is also available at `http://localhost:<port>/__mcp`. See [tool-mcp](tool-mcp.md).
+
 ## Theme Eject
 
 ```bash

package/skills/slidev/references/tool-mcp.md

@@ -0,0 +1,48 @@
+---
+name: mcp
+description: Built-in MCP server for AI agents to inspect, edit, reorder, and navigate slides
+---
+
+# MCP Server
+
+Slidev ships a built-in MCP (Model Context Protocol) server exposing structured tools to read, edit, reorder, and navigate a deck. Prefer these tools over raw text edits for slide-level operations (update/insert/remove/move) — they handle Slidev's compound separators correctly and hot-reload the presentation.
+
+## Usage
+
+With a running dev server (streamable HTTP):
+
+```
+http://localhost:<port>/__mcp
+```
+
+```bash
+# e.g. for Claude Code
+claude mcp add --transport http slidev http://localhost:3030/__mcp
+```
+
+Standalone over stdio (no dev server, operates on files directly):
+
+```bash
+slidev mcp [entry]
+```
+
+## Tools
+
+| Tool | Description |
+| --- | --- |
+| `slidev-get-info` | Deck overview: entry, title, slide count, markdown files, server URL, current position |
+| `slidev-list-slides` | All slides with number, title, layout, source file |
+| `slidev-get-slide` | Full source of one slide: frontmatter, content, note |
+| `slidev-update-slide` | Update content, note, and/or frontmatter of a slide |
+| `slidev-insert-slide` | Insert a new slide after an existing one |
+| `slidev-remove-slide` | Remove a slide |
+| `slidev-move-slide` | Move a slide before/after another to reorder the deck |
+| `slidev-goto-slide` | Navigate the live presentation to a slide (dev server only) |
+
+## Behavior
+
+- Slides are addressed by rendered 1-based numbers (as shown in the presentation)
+- Edits are saved to the markdown files; a running dev server hot-reloads instantly
+- The first slide of the entry file cannot be removed/moved (its frontmatter is the deck headmatter)
+- Slides imported via `src:` are edited in their own file; moves cannot cross files
+- Disable with `mcp: false` in the headmatter