SlideX MCP Server v0.6

Local MCP server for SlideX MotionDoc decks. It lets MCP clients create and validate decks, edit slides and blocks, apply Paper Shader presets, export standalone HTML, and write editable PowerPoint files.

The public slidex_add_block surface is intentionally limited to Text, Image, Video, Icon, Table, and ShapeRectangle. Metric, Card, and Chart are not public MCP insertion types. Existing decks may still contain legacy block syntax, but MCP clients cannot add those legacy blocks.

The package also includes built-in slide layout presets matching the SlideX Pitch layout picker, such as Title & Photo, Title & Bullets, Agenda, Key Fact, Quote, Photos - 3 on a page, and Photo. Once installed, MCP clients can list layouts, fetch layout source, create a slide from a layout, append a layout slide, or replace an existing slide with a layout.

Quick Start

Run the server directly without installing:

npx -y @z7589xxz758/slidex-mcp-server

Use With MCP Clients

{
  "mcpServers": {
    "slidex": {
      "command": "npx",
      "args": ["-y", "@z7589xxz758/slidex-mcp-server"]
    }
  }
}

Local Development

From the SlideX repository root:

npm install
npm run mcp

When connecting through stdio, prefer the silent npm form:

{
  "mcpServers": {
    "slidex": {
      "command": "npm",
      "args": ["--silent", "run", "mcp"],
      "cwd": "/absolute/path/to/Animark"
    }
  }
}

Tools

• slidex_parse_motion_doc
• slidex_validate_motion_doc
• slidex_list_templates
• slidex_get_template
• slidex_create_deck
• slidex_create_from_template
• slidex_update_slide_props
• slidex_replace_slide
• slidex_add_block
• slidex_update_block
• slidex_delete_block
• slidex_duplicate_block
• slidex_reorder_block
• slidex_list_slide_layouts
• slidex_get_slide_layout
• slidex_create_slide_from_layout
• slidex_add_slide_from_layout
• slidex_replace_slide_with_layout
• slidex_delete_slide
• slidex_reorder_slide
• slidex_export_html
• slidex_export_pptx
• slidex_list_block_types
• slidex_get_motion_doc_schema
• slidex_list_shaders
• slidex_get_shader
• slidex_apply_shader_preset

Call slidex_get_motion_doc_schema (or read slidex://schema/motion-doc) before editing an unfamiliar block. It returns current slide fields, the six public add-block types, their generated MotionDoc types, and default props.

Editable PowerPoint Export

slidex_export_pptx requires an absolute .pptx outputPath. It refuses to overwrite an existing file unless overwrite is explicitly true. Text, images, tables, icons, shapes, and other compatible content remain editable where possible. Slides that use Paper Shaders or unsupported visual effects receive a rasterized background while compatible foreground objects remain editable.

The package installs its matching Playwright Chromium runtime automatically. If Chromium was skipped during installation, run:

npx playwright install chromium

Example input:

{
  "source": "# Deck\n\n<Slide duration={5}><Text x={10} y={10} w={80} h={20}>Hello</Text></Slide>",
  "outputPath": "/absolute/path/to/deck.pptx",
  "overwrite": false
}

Shader Tools

Use slidex_list_shaders to read the current Paper Shader catalog, slidex_get_shader to inspect its presets and fields, and slidex_apply_shader_preset to apply a catalog preset to a specific slide. Shader IDs and preset names are validated against Animark's current catalog.

Remote MCP

Animark also exposes an authenticated Streamable HTTP endpoint at /mcp. Remote clients discover OAuth metadata through /.well-known/oauth-authorization-server and /.well-known/oauth-protected-resource/mcp, register as public PKCE clients, and request presentations:read, optionally presentations:write, and separately presentation-assets:write for private image uploads.

The Remote profile exposes only presentation-scoped tools:

• presentation discovery and source: slidex_list_presentations, slidex_get_presentation, slidex_save_presentation
• precise canvas nodes: slidex_get_canvas_nodes, slidex_update_canvas_node
• block source: slidex_add_block, slidex_update_block, slidex_delete_block, slidex_duplicate_block, slidex_reorder_block
• layout source: slidex_list_slide_layouts, slidex_get_slide_layout, slidex_add_slide_from_layout, slidex_replace_slide_with_layout
• shader source: slidex_list_shaders, slidex_get_shader, slidex_apply_shader_preset
• current schema: slidex_list_block_types, slidex_get_motion_doc_schema
• private image upload: slidex_prepare_presentation_image_upload, slidex_finalize_presentation_image_upload

Remote read tools automatically select the authenticated user's most recently opened SlideX presentation when presentationId is omitted, and always return the selected presentation ID. slidex_list_presentations can also discover recent decks. MCP clients should perform this discovery themselves and reuse the returned ID instead of asking the user to copy it.

Starting in v0.6, slidex_get_presentation returns presentation metadata by default. Pass includeSource: true only when a complete MotionDoc rewrite requires the raw MDX. Catalog reads, canvas reads, and successful writes return the selected presentation summary and current sourceRevision without repeating the complete document. When full source is explicitly requested, it is emitted once in the text result while structured content remains summary-only.

slidex_get_canvas_nodes returns each block's stable nodeId, type, text preview, percentage frame, and equivalent frame on SlideX's 1024 x 576 canvas. slidex_update_canvas_node moves or resizes a node by stable ID with percentage coordinates rounded to three decimal places and rejects frames outside the slide.

Every Remote write requires the automatically discovered presentationId plus expectedRevision, performs a compare-and-swap save, and triggers Animark's existing private presentation Realtime broadcast so an open Pitch page receives the new revision. Revision conflicts reject the save and require the client to read again. Ownership validation applies to both discovery and mutation.

Starting in v0.5, real Remote write and private-image tool operations also emit owner-private activity events. An open SlideX Workspace or Pitch editor renders these as non-interactive purple frames labelled with the authorized OAuth client name. The activity channel does not simulate a cursor or DOM clicks and never stores prompts, tokens, complete MotionDoc source, user-authored text, or raw errors. Activity summaries expire after seven days.

The canonical Remote MCP resource is https://slidexdeck.com/mcp; the legacy trailing-slash form remains accepted. Access tokens last one hour and compatible clients renew them automatically with rotating refresh tokens. Refresh rotation is atomic and retains the token-family relationship; replaying an invalidated refresh token revokes the active family and requires a new authorization grant.

Authorization consent is bound to the signed-in user, registered client, and complete OAuth request by a ten-minute, single-use server-side nonce. Registration, authorization, and token endpoints use persistent rate limits without adding a database round trip to normal /mcp calls. Sensitive OAuth responses are non-cacheable and the consent page cannot be framed. Successful authenticated MCP responses include aggregate Server-Timing metrics for auth, store, handler, and total; these metrics contain no presentation, user, client, or token data.

Remote MCP deliberately does not expose deck creation, template cloning, local HTML/PPTX export, workspace CRUD, presentation deletion, video/SVG upload, or public media URLs. Image upload requires a ten-minute single-use upload request, writes only normalized static WebP files to the private presentation-images bucket, and never exposes the service-role credential. The Animark server must configure SUPABASE_SERVICE_ROLE_KEY, MCP_OAUTH_RATE_LIMIT_SECRET, and a separate MCP_OAUTH_AUDIT_HMAC_SECRET; both HMAC values must contain at least 32 random bytes. These values are server-only and must never be placed in a browser, MCP client configuration, or any NEXT_PUBLIC_* variable. Deploy in this order: configure the server-only secrets, apply the Supabase migrations, deploy the application, then run the Remote MCP HTTP smoke test.

Built-in Slide Layouts

slidex_list_slide_layouts currently returns 16 installable layout presets:

• title
• title-photo
• title-alt-photo
• title-bullets
• bullets
• title-bullets-photo
• title-bullets-small-video
• title-bullets-large-video
• chapter
• only-title
• agenda
• statement
• key-fact
• quote
• photos-3
• photo

Layout resources are also available at slidex://slide-layouts and slidex://slide-layouts/{layoutId}.

Dynamic Workspace Skills

When the server starts, it dynamically scans the current working directory (process.cwd()) for a .agents/skills folder. If found, it reads the SKILL.md files and automatically registers them as:

• MCP Prompts: skill_<folder_name> (e.g., skill_high_end_visual_design)
• MCP Resources: workspace://skills/<folder_name>

This allows the AI to adapt to the specific design guidelines, tones, and automated workflows of the workspace it is running in!