---
name: pptx-rs-genppt
description: Pair the local pure-Rust pptx-rs CLI with the remote GenPPT MCP server (https://genppt.com/mcp) to route between art-directed visual slides, hybrid editable PowerPoint decks with live Excel charts, and legacy .pptx redesigns. Use when a user wants both strong visual art direction and editable PowerPoint exports, or wants to import an existing .pptx and redesign it in GenPPT.
---

# Using `pptx-rs` with GenPPT MCP

Combine local `pptx-rs` compilation with the remote GenPPT MCP server (`https://genppt.com/mcp`) so each part of a deck uses the right engine.

## When to use which

| Need | Use |
| --- | --- |
| Art-directed 16:9 decks, brand-heavy covers, illustrations, or 4:5 / 9:16 social carousels | **GenPPT MCP** (`genppt_create_slideshow` or `genppt_create_deck`) |
| 100% editable PowerPoint text boxes, tables, and live embedded Excel charts | **`pptx-rs`** (`compile` + `render`) |
| Designer cover art paired with editable data slides and live Excel charts | **Hybrid**: GenPPT art plate + `pptx-rs` native slides |
| Redesigning an existing `.pptx` without losing exact numbers or tables | **Hybrid**: `pptx-rs import` -> GenPPT MCP |

## Connect GenPPT MCP

1. Create an API key (`gppt_...`) at `https://genppt.com/app/account`.
2. Add the remote server:
   - Claude Code:
     ```bash
     claude mcp add --transport http genppt https://genppt.com/mcp --header "Authorization: Bearer gppt_YOUR_KEY"
     ```
   - Cursor (`mcp.json`):
     ```json
     {
       "mcpServers": {
         "genppt": {
           "url": "https://genppt.com/mcp",
           "headers": {
             "Authorization": "Bearer gppt_YOUR_KEY"
           }
         }
       }
     }
     ```

Full MCP tool instructions live at `https://genppt.com/SKILL.md`.

## Workflow 1: Hybrid editable `.pptx` (GenPPT art + `pptx-rs` data)

Use this when the user wants editable text and live Excel charts in PowerPoint without settling for plain white slides.

1. Call `genppt_create_slideshow` with 1 to 3 text-free visual slides (`aspectRatio: "16:9"`). Specify in each slide's `visual` and `artDirection`: text-free background plate or atmospheric hero illustration with clean negative space for overlaid typography, zero letters or numbers baked into the image.
2. Poll `genppt_get_deck(deckId, waitSeconds: 60)` until `phase` is `"ready"`, then download the finished plate image(s) from `slideImageUrls` into a local `assets/` folder.
3. Author `deck.ir.json` for `pptx-rs`:
   - Place the downloaded image on cover or section slides using a `plate` element with `"scrim": "auto"` so `pptx-rs` automatically computes a WCAG contrast gradient behind your text.
   - Layer editable `text`, `shape`, `table`, and live Excel `chart` elements on top (`zIndex: 2+`).
4. Compile, validate, and preview:
   ```bash
   pptx-rs compile -i deck.ir.json -o deck.pptx --report report.json
   pptx-rs render -i deck.ir.json --out-dir previews --width 1280
   ```
5. Inspect every PNG in `previews/`, fix any tight boxes or spacing in `deck.ir.json`, and recompile.

## Workflow 2: Redesign an existing `.pptx` in GenPPT

Use this when a user hands you an ugly legacy PowerPoint file and wants a visual upgrade with every metric preserved verbatim.

1. Extract structured content and embedded images with `pptx-rs`:
   ```bash
   pptx-rs import -i old-deck.pptx -o extracted.ir.json --assets-dir extracted-assets/
   ```
2. Read `extracted.ir.json` to capture exact slide titles, numbers, chart series, tables, and speaker notes.
3. Call `genppt_create_slideshow` with one structured `{ title, purpose, visual }` entry per slide, putting every verified metric from `extracted.ir.json` into `purpose` and uploading/referencing any logos or product photos from `extracted-assets/`.
4. Poll `genppt_get_deck(deckId, waitSeconds: 60)` until `ready`, inspect the rendered slides, and call `genppt_export_deck(deckId, format: "pptx")` (or `"pdf"`).
