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
- Create an API key (
gppt_...) athttps://genppt.com/app/account. - Add the remote server:
- Claude Code:
claude mcp add --transport http genppt https://genppt.com/mcp --header "Authorization: Bearer gppt_YOUR_KEY" - Cursor (
mcp.json):{ "mcpServers": { "genppt": { "url": "https://genppt.com/mcp", "headers": { "Authorization": "Bearer gppt_YOUR_KEY" } } } }
- Claude Code:
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.
- Call
genppt_create_slideshowwith 1 to 3 text-free visual slides (aspectRatio: "16:9"). Specify in each slide'svisualandartDirection: text-free background plate or atmospheric hero illustration with clean negative space for overlaid typography, zero letters or numbers baked into the image. - Poll
genppt_get_deck(deckId, waitSeconds: 60)untilphaseis"ready", then download the finished plate image(s) fromslideImageUrlsinto a localassets/folder. - Author
deck.ir.jsonforpptx-rs:- Place the downloaded image on cover or section slides using a
plateelement with"scrim": "auto"sopptx-rsautomatically computes a WCAG contrast gradient behind your text. - Layer editable
text,shape,table, and live Excelchartelements on top (zIndex: 2+).
- Place the downloaded image on cover or section slides using a
- Compile, validate, and preview:
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 - Inspect every PNG in
previews/, fix any tight boxes or spacing indeck.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.
- Extract structured content and embedded images with
pptx-rs:pptx-rs import -i old-deck.pptx -o extracted.ir.json --assets-dir extracted-assets/ - Read
extracted.ir.jsonto capture exact slide titles, numbers, chart series, tables, and speaker notes. - Call
genppt_create_slideshowwith one structured{ title, purpose, visual }entry per slide, putting every verified metric fromextracted.ir.jsonintopurposeand uploading/referencing any logos or product photos fromextracted-assets/. - Poll
genppt_get_deck(deckId, waitSeconds: 60)untilready, inspect the rendered slides, and callgenppt_export_deck(deckId, format: "pptx")(or"pdf").