06ketan/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
| Host | Documentation | Typical wire-up |
|------|---------------|-----------------|
| **OpenCode** | OpenCode MCP servers | See OpenCode below |
| **Continue** | Continue | Add stdio MCP pointing at npx / slideshot-mcp per Continue docs |
| **Zed** | Zed | Stdio MCP per Zed |
| **Cline** | Cline | Extension MCP docs |
| **Goose** | Goose | MCP extensions per Goose |
Large commercial stacks
| Host | Documentation | Typical wire-up |
|------|---------------|-----------------|
| **Cursor** | Cursor MCP | .cursor/mcp.json — see MCP Server |
| **Claude** (Desktop / Code) | Claude Desktop, Claude Code | Claude Desktop JSON or claude mcp add |
| **GitHub Copilot** | Copilot | MCP in VS Code where enabled |
| **ChatGPT** | OpenAI | Prefer REST (/api/openapi.json) where MCP is unavailable |
| **Google Gemini** | Gemini | Gemini IDE / CLI MCP when supported — else REST |
Architecture
Quick Start
CLI
**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:
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):
Optional pin: "args": ["-y", "slideshot-mcp@4.4.0"] (replace with current npm version).
OpenCode
~/.config/opencode/opencode.json:
**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.