# 06ketan/slideshot [Health: Active]

**Category:** 🎥 Multimedia Process  
**Repository:** https://github.com/06ketan/slideshot  
**GitHub Stars:** 2  
**npm Downloads (last month):** 245  
**Views:** 9  
**Installs:** 0  
**Upvotes:** 1  
**Directory Page:** https://allmcps.com/mcp/06ketan-slideshot

## Description
Convert HTML to PDF/PNG/WebP/PPTX slide carousels with 11 themes (LinkedIn, Instagram, pitch decks, infographics). Pixel-perfect Puppeteer rendering, dimension-aware reflow for portrait/landscape, token-efficient JSON mode. npx slideshot-mcp.

## Tools
Capabilities this server exposes over MCP:

- **discover_themes** — MANDATORY first step — all other tools REJECT until this is called. Returns themes, orientation presets, token-usage modes, and output formats. Use ONLY the native selector prompts from the "ask" array — DO NOT render themes as a separate markdown list. DO NOT ask how many slides (you decide based on topic). After user picks options, show a data outline of proposed slides and WAIT for confirmation before calling create_slides.
- **create_slides** — Create slides. IMPORTANT: Use mode=default unless the user explicitly chose token_saver. mode=default = AI writes full HTML (best quality). mode=token_saver = AI sends JSON, server uses basic templates. REQUIRES discover_themes first AND user must have confirmed the data outline. After this tool saves the HTML, you MUST show the htmlPath as a code preview artifact. Then STOP and ask the user to confirm. DO NOT call render_slides until the user explicitly confirms.
- **render_slides** — Final render to PDF/WebP/PNG/PPTX. Accepts html string OR htmlPath. Supports width, height, selector, scale, webpQuality, orientation, pptxMode, pptxFilename, slideRange. NEVER call render_slides in the same turn as create_slides. When the user provides an existing HTML file path, pass it as htmlPath and call this tool directly — no discover_themes or create_slides needed. For the full slide-creation workflow, REQUIRES both discover_themes AND create_slides first, and ONLY call AFTER user confirms the preview. Returns file paths on disk.
- **list_themes** — Idempotent read-only listing of all available themes (8+). Unlike discover_themes, this does NOT start a slide-creation workflow — call it any time the user asks "what themes are there?" mid-conversation. Returns the same tiered theme catalog (primary/secondary). Models MUST present every theme returned, never truncate.
- **edit_slides** — Token-efficient partial edits on a previously-generated HTML deck. Use this INSTEAD of regenerating the whole deck for small changes — it saves 60-90% tokens vs a full rewrite. Operations: replace_slide (swap one slide block by 1-indexed slideIndex), patch_css (append CSS rules to <style>), swap_token (replace a CSS variable's value, e.g. {"--coral": "#FF0000"}), patch_class (add/remove a class on a specific slide, e.g. {"add": "dark"}). Reads from cache or htmlPath; saves the updated HTML and returns the new htmlPath. After editing, show the htmlPath as a preview artifact and STOP — do NOT call render_slides until the user confirms.
- **health_check** — Verify Puppeteer/Chromium can launch. Use when render fails.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What 06ketan/slideshot MCP server does

The 06ketan/slideshot MCP server renders HTML carousel pages into image, document, and presentation formats. Its output options include PNG, WebP, PDF, and PPTX. Rendering is handled through Puppeteer, allowing the HTML and CSS layout to be evaluated in a browser-like environment rather than converted from a limited text representation.

The project supports multiple ways to use the same rendering system: an npm CLI, an MCP stdio server, a web application, and a REST API. The MCP surface is intended for AI clients such as Claude Desktop and Cursor. The repository also includes prompt templates for producing slide HTML in several visual directions, including generic, branded, Instagram, infographic, pitch-deck, dark-modern, and editorial variants.

## How it works

An MCP client starts the local process with `npx` and communicates with it over standard input and output. The agent can then call a rendering tool with HTML slide content and choose the desired output formats. Slide elements are selected with a CSS selector; the documented default is `.slide`.

Rendering settings include slide width and height, device scale, WebP quality, and output formats. The CLI documentation lists a default size of 540 by 675 CSS pixels and a default scale of 4, producing higher-resolution output. The same general rendering workflow is exposed through the MCP package, while the web application provides live preview and export through a browser interface.

The project describes its layout handling as dimension-aware reflow for portrait and landscape designs. The MCP package also offers a JSON-oriented mode intended to reduce the amount of exchanged output when agents work with rendered results.

## Setup and configuration

Install the MCP process through the command shown in the repository's Claude Desktop and Cursor configuration example:

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

The package requires a local Puppeteer/Chromium environment for rendering. `health_check` can be used to verify whether that rendering dependency is available. No API key, OAuth flow, or external service credential is described for the local MCP setup.

## Tools and capabilities

The 06ketan/slideshot MCP server exposes these documented tools:

- `create_slides`: starts a guided creation workflow using themes and output presets.
- `render_html_to_images`: converts HTML slides to PNG, WebP, PDF, or PPTX.
- `get_slide_prompt`: retrieves a prompt template for a selected theme variant.
- `health_check`: checks Puppeteer and Chromium availability.

Seven MCP prompt variants are listed: generic, branded, Instagram carousel, infographic, pitch deck, dark modern, and editorial. They cover styles such as minimal layouts, vibrant social media designs, data-heavy charts, professional presentations, glassmorphism, and magazine-inspired slides.

## Limitations and notes

The material documents browser rendering and local Chromium availability but does not specify supported operating systems, exact Chromium versions, or resource requirements. PPTX appears among the MCP rendering outputs, while the REST API endpoint description specifically lists PNG, WebP, and PDF and says it returns a ZIP. The repository also contains a separate web application and REST API, but those are not required for the local MCP configuration.

Treat the seven listed variants as the explicitly documented MCP prompt set. The project is licensed under MIT.

_Full upstream README: https://allmcps.com/mcp/06ketan-slideshot/readme_