06ketan/slideshot

npm npm downloads npm mcp GitHub stars license MCP compatible MCP Registry Anthropic DXT Glama MCP server MCP Badge

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

Web App · npm CLI · npm MCP · API Spec

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:

Flag	Default	Description
-s, --selector	.slide	CSS selector for slide elements
-W, --width	540	Slide width (CSS px)
-H, --height	675	Slide height (CSS px)
--scale	4	Device scale (4x = 2160x2700)
-f, --formats	png,webp,pdf	Output formats (png, webp, pdf, pptx)
-q, --quality	95	WebP quality (0-100)
-o, --out	./slides	Output directory

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 Claude Desktop or Cursor config:

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

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:

Method	Path	Description
POST	/api/render	Render HTML slides to PNG/WebP/PDF (returns ZIP)
GET	/api/prompt?variant=generic	Get AI prompt template
GET	/api/openapi.json	OpenAPI 3.1.0 spec

Platform support:

Platform	Method	Setup
Cursor	MCP	npx slideshot-mcp in .cursor/mcp.json
Claude Desktop	MCP	npx slideshot-mcp in config
ChatGPT	OpenAPI Action	Import /api/openapi.json
OpenWebUI	OpenAPI Tool	Import /api/openapi.json

AI Prompt Templates

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

Variant	File	Style
Generic	prompts/generic.md	Clean minimal, Inter font
Branded	prompts/branded.md	Space Mono, teal/coral accents
Instagram	prompts/instagram-carousel.md	Bold gradients, Poppins
Infographic	prompts/infographic.md	DM Sans, stat cards
Pitch Deck	prompts/pitch-deck.md	Professional, KPI cards
Dark Modern	prompts/dark-modern.md	Neon, glassmorphism
Editorial	prompts/editorial.md	Playfair Display, gold

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

Surface	URL
Web App	slideshot.vercel.app
npm CLI	npmjs.com/package/slideshot
npm MCP	npmjs.com/package/slideshot-mcp
GitHub	github.com/06ketan/slideshot
API Spec	slideshot.vercel.app/api/openapi.json

License

MIT