slideshot

Convert AI-generated HTML carousels into high-res PNG, WebP, PDF, and PPTX — via CLI, Web App, MCP Server (Cursor MCP, Claude MCP, OpenCode MCP), or REST API.

Web App · npm CLI · npm MCP · API Spec

Wrong install?

The MCP package name is slideshot-mcp on npm (canonical Glama listing). Use npx -y slideshot-mcp — not unrelated html-to-slides or third-party scoped copies from generic searches.

Works with (MCP)

Discovery-oriented table — verify each host’s current MCP docs before upgrading.

Open source–oriented hosts

Large commercial stacks

Architecture

slideshot/
  packages/
    cli/           ← Core Puppeteer rendering engine + CLI
    mcp-server/    ← MCP stdio server for AI tools
    webapp/        ← Next.js web app with live preview
  prompts/
    generic.md           ← Clean minimal
    branded.md           ← Ketan Slides design system
    instagram-carousel.md ← Bold vibrant IG style
    infographic.md       ← Data-heavy charts
    pitch-deck.md        ← Professional presentations
    dark-modern.md       ← Neon glassmorphism
    editorial.md         ← Magazine serif

Quick Start

CLI

npx slideshot ./my-carousel.html --formats png,webp,pdf --scale 4

Options:

Web App

Live: slideshot.vercel.app

Or run locally:

cd packages/webapp && npm install && npm run dev

Open http://localhost:3000 — paste HTML, preview, export.

MCP Server

Add to Cursor, Claude Desktop, Claude Code, or any stdio MCP host. Published as slideshot-mcp on npm.

Cursor / Claude Desktop (mcpServers):

{
  "mcpServers": {
    "slideshot": {
      "command": "npx",
      "args": ["-y", "slideshot-mcp"]
    }
  }
}

Optional pin: "args": ["-y", "slideshot-mcp@4.4.0"] (replace with current npm version).

OpenCode

~/.config/opencode/opencode.json:

{
  "mcp": {
    "slideshot": {
      "type": "local",
      "command": ["npx", "-y", "slideshot-mcp"],
      "enabled": true
    }
  }
}

Tools:

• create_slides — guided creation workflow with 7 themes and output presets
• render_html_to_images — render HTML to PNG/WebP/PDF/PPTX
• get_slide_prompt — get AI prompt template for any theme variant
• health_check — verify Puppeteer/Chromium availability

Prompts (7 themes):

• generic-slides — clean minimal
• branded-slides — Ketan Slides design system
• instagram-carousel-slides — bold vibrant IG style
• infographic-slides — data-heavy charts and stats
• pitch-deck-slides — professional presentations
• dark-modern-slides — neon glassmorphism
• editorial-slides — magazine serif with gold accents

REST API (ChatGPT Actions / OpenWebUI)

The web app exposes an OpenAPI-compatible REST API at https://slideshot.vercel.app.

Endpoints:

Platform support:

AI Prompt Templates

7 prompt variants in prompts/ — copy-paste or use via get_slide_prompt tool:

Build All

npm install   # from root — installs all workspaces
npm run build # builds cli → mcp-server
cd packages/webapp && npm run build  # builds webapp separately

Links

Related MCPs

• medium-ops — Medium CLI + MCP (PyPI).
• substack-ops — Substack CLI + MCP (PyPI).

License