genppt_account_status
Read onlyAccount status
Show the connected GenPPT account: plan, decks used this period, saved card, and upgrade options.
Parameters
No parameters.
A remote Streamable HTTP MCP server that lets Claude, Cursor, Codex, and your own agents create, revise, and export presentation decks and social slideshows. Add one URL and a Bearer key.
https://genppt.com/mcp
gppt_... key shows once, so copy it right away.https://genppt.com/mcp as a remote server and send the key in the header Authorization: Bearer gppt_YOUR_KEY.genppt_account_status. It returns the plan and the decks used this period.Run this once in a terminal. Add --scope user to make the server available in every project.
claude mcp add --transport http genppt https://genppt.com/mcp --header "Authorization: Bearer gppt_YOUR_KEY"
Save this as ~/.cursor/mcp.json for every project, or .cursor/mcp.json inside one repository.
{
"mcpServers": {
"genppt": {
"headers": {
"Authorization": "Bearer gppt_YOUR_KEY"
},
"url": "https://genppt.com/mcp"
}
}
}Claude Desktop starts local commands from its config file, so the mcp-remote bridge forwards the Bearer header to the remote server. Open Settings, Developer, Edit Config, paste this, and restart the app.
{
"mcpServers": {
"genppt": {
"args": [
"-y",
"mcp-remote",
"https://genppt.com/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"command": "npx",
"env": {
"AUTH_HEADER": "Bearer gppt_YOUR_KEY"
}
}
}
}Add the server to ~/.codex/config.toml and keep the key in an environment variable so it stays out of the file.
[mcp_servers.genppt] url = "https://genppt.com/mcp" bearer_token_env_var = "GENPPT_MCP_KEY"
export GENPPT_MCP_KEY="gppt_YOUR_KEY"
The server is stateless: send one JSON-RPC 2.0 request per POST with Content-Type: application/json. There is no SSE stream, so GET returns 405. The discovery documents list the server, version, and every tool schema without a key.
curl -s https://genppt.com/mcp \
-H "Content-Type: application/json" \
-d '{"id":1,"jsonrpc":"2.0","method":"tools/list"}'curl -s https://genppt.com/mcp \
-H "Content-Type: application/json" \
-H "Authorization: Bearer gppt_YOUR_KEY" \
-d '{"id":2,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"genppt_account_status"}}'curl -s https://genppt.com/.well-known/mcp curl -s https://genppt.com/.well-known/mcp/server-card.json
Server version 1.2.6, MCP protocol 2025-11-25 with older protocol versions negotiated on initialize. Discovery lives at /.well-known/mcp and /.well-known/mcp/server-card.json.
Pick workflow A when the agent already knows what each slide says. Pick workflow B when it only has a topic, notes, or source URLs and GenPPT should research and write the story.
genppt_create_slideshow, then genppt_get_deck
genppt_create_slideshow with a title and 1 to 25 slides, each with title, purpose, and visual. GenPPT designs exactly those slides and does not rewrite the outline.screenshotUrl for a live webpage screenshot in a browser frame, imageUrl for a logo, product UI, chart, or portrait, or unsplashQuery for a real stock photo.websiteUrls (up to 6 pages screenshotted before rendering) and referenceImageUrls (brand logos and style references, first 4 used).autoRender is true by default and renders full slides right after the concept. Pass false to stop at the concept preview. isPublic: true publishes a read-only page at /s/<slug>.genppt_get_deck with waitSeconds: 60 until phase is ready, then use slideImageUrls or call genppt_export_deck.genppt_create_deck, genppt_get_deck, then genppt_generate_slides
genppt_create_deck with a prompt (topic, audience, notes, or pasted text) and optional websiteUrl, attachmentUrls, and referenceImageUrls. Web research is on by default.genppt_get_deck with waitSeconds: 60 while phase is drafting_concepts. The concept is ready in about a minute.concepts_ready, show conceptPreviewUrl to the user. Once they approve, call genppt_generate_slides.genppt_get_deck again while phase is rendering_slides. At ready, show the slide images and share studioUrl.genppt_get_deck returns one of these in phase. With waitSeconds (up to 60) the call returns as soon as the phase changes, so there is no need for a tight polling loop.
| Phase | What it means |
|---|---|
| drafting_concepts | GenPPT is writing the outline and the concept preview. |
| concepts_ready | The concept preview is ready. Show conceptPreviewUrl, then call genppt_generate_slides. |
| rendering_slides | Full slides are rendering. Usually 1 to 4 minutes. |
| ready | slideImageUrls holds the finished slide images in order. |
| error | The run failed. Retry, or report it with genppt_submit_feedback. |
Both create tools take aspectRatio. Pick it for where the slides will be posted or presented.
| aspectRatio | Shape | Use it for |
|---|---|---|
| 4:5 | Portrait | X 20-image portrait posts, LinkedIn PDF carousels, Instagram feed carousels. Default for genppt_create_slideshow. |
| 9:16 | Tall portrait | TikTok Photo Mode, Instagram Reels and Stories. |
| 16:9 | Widescreen | Presentation decks. Default for genppt_create_deck. |
| 1:1 | Square | Square threads and posts. |
| 3:4 | Portrait | Taller poster style carousels on X, LinkedIn, and Instagram. |
| 2:3 | Portrait | Pinterest pins. |
| 4:3 | Landscape | Classic screens and projectors. |
| 3:2 | Landscape | Photo prints and classic screens. |
Authorization: Bearer gppt_... on every request. Create, replace, or revoke the key in Account. A revoked or wrong key gets HTTP 401.genppt_hot_topics works keyless, and so do initialize and tools/list. Every other tool returns status: "auth_required" with a link to connect the account.genppt_create_slideshow or genppt_create_deck call uses one deck from the monthly plan allowance. genppt_account_status shows what is left.limit_reached or upgrade_required, call genppt_upgrade_plan without confirmPaymentSpend to preview the price. Pass confirmPaymentSpend: true only after the user agrees to the price. Even then the tool returns a checkout link that the user completes in their browser.This reference is generated from the same tool list the server returns for tools/list, so names, descriptions, and parameters always match production (server version 1.2.6). Some clients add a prefix such as mcp__genppt__genppt_create_slideshow.
Account status
Show the connected GenPPT account: plan, decks used this period, saved card, and upgrade options.
No parameters.
List decks
List the user’s GenPPT decks, newest edits first.
limitinteger1 to 100Max decks to return (default 20).
searchstringup to 200 charactersFilter by title.
Get deck
Get one deck: its phase, concept preview, slides, and slideImageUrls (ordered, ready to post). Pass waitSeconds to wait for drafting or rendering to finish instead of polling.
deckIdstring (UUID)RequiredDeck id from genppt_list_decks, genppt_create_deck, or genppt_create_slideshow.
waitSecondsinteger0 to 60Wait up to this many seconds while the deck is drafting or rendering, and return when the phase changes. Default 0.
Hot topics
Today’s trending news, tech, and business topics, each with a short source-backed summary. Use them as ideas for slideshows and carousels. Works without a key.
limitinteger1 to 8Max topics to return (default 8).
tagstringup to 64 charactersKeep only topics with this tag or keyword (case-insensitive), such as "ai" or "crypto".
Create slideshow
Render slides you already wrote, 1-25 (X portrait posts take up to 20 images). Use when you have the content from the user’s files, images, or research. GenPPT skips its own outline and designs exactly your slides, then renders full-resolution images (paid plans; Free stops at the concept preview). Make every slide visual: pass websiteUrls or per-slide screenshotUrl to show live webpage screenshots, imageUrl for logos and product UI, unsplashQuery for a real photo, and name the brands to show as logos. Returns at once; call genppt_get_deck with waitSeconds. Uses one deck from the plan allowance.
slidesobject[]Required1 to 25 itemsThe slides in order. Slide 1 is the cover or hook.
purposestringRequiredup to 600 charactersWhat this slide must say: the claim, facts, numbers, and copy to show.
titlestringRequiredup to 200 charactersSlide headline.
visualstringRequiredup to 600 charactersLayout and imagery: the real proof on the slide. Framed webpage or app screenshot, recognizable brand logos and app icons, real photo, labeled chart, UI window, or one bold tactile object as a visual metaphor. Never a text-only card.
imageUrlstring (URL)Public image URL to show on this slide: a person portrait, brand logo, product UI screenshot, chart, or photo. Do not repeat it in referenceImageUrls. Ignored when screenshotUrl is set.
screenshotUrlstring (URL)Public webpage URL that GenPPT screenshots live and shows on this slide in a browser frame: a product page, article, dashboard, or tweet.
unsplashQuerystringup to 120 charactersShort search for one real stock photo for this slide: a real place, building, landscape, or generic setting, such as "trader at desk with monitors". Omit it for historical objects, metaphors, and data diagrams; GenPPT draws those. Used only when neither screenshotUrl nor imageUrl is set.
titlestringRequiredup to 160 charactersSlideshow title.
artDirectionstringup to 4000 charactersPalette, typography, layout, brand, safe zones, or poster style for every slide.
aspectRatio"16:9" | "9:16" | "4:5" | "3:4" | "1:1" | "4:3" | "3:2" | "2:3"Slide shape. Default '4:5'. '4:5' or '3:4' = X 20-image portrait posts, LinkedIn PDF carousels, Instagram feed carousels. '9:16' = TikTok Photo Mode, Instagram Reels and Stories. '2:3' = Pinterest. '1:1' = square threads and posts. '16:9' = widescreen decks. '4:3' and '3:2' = classic screens and photo prints.
attachmentUrlsstring (URL)[]0 to 20 itemsPublic URLs (up to 20) of PPTX, DOCX, XLSX, CSV, TXT, MD files, or YouTube videos whose text content the slides use (pass visual style/brand image URLs via referenceImageUrls instead).
autoRenderbooleanDefault true: render full slides right after the concept. false = stop at the concept preview.
isPublicbooleanOptional. Set true to publish a shareable read-only link at /s/<slug>. Defaults to false (or true on the GenPPT showcase account).
referenceImageUrlsstring (URL)[]0 to 20 itemsPublic image URLs (first 4 used) for the whole deck: brand logos, marks, or visual style exemplars. Put portraits and slide-specific images on slides[].imageUrl instead.
thesisstringup to 400 charactersThe core argument of the slideshow in one sentence.
websiteUrlsstring (URL)[]0 to 6 itemsPublic webpages (up to 6) that GenPPT screenshots live before rendering, so real product, article, or dashboard UI appears in the deck. A page goes on the slide that names its domain; the rest guide the whole deck.
{
"artDirection": "Warm off-white background, bold black grotesk headlines, one yellow accent.",
"aspectRatio": "4:5",
"autoRender": true,
"isPublic": false,
"referenceImageUrls": [
"https://example.com/brand/logo.png"
],
"slides": [
{
"purpose": "Hook: the new Acme dashboard cuts weekly reporting from 3 hours to 10 minutes.",
"title": "Reporting in 10 minutes",
"visual": "Bold cover headline over a framed screenshot of the live dashboard."
},
{
"purpose": "Show the real product page with the new report builder.",
"screenshotUrl": "https://example.com/product/reports",
"title": "One screen for every report",
"visual": "Live webpage screenshot in a browser frame, headline above it."
},
{
"imageUrl": "https://example.com/charts/time-saved.png",
"purpose": "Chart of hours saved per team across the first 30 days.",
"title": "Hours saved per team",
"visual": "The supplied chart large in the center with one short caption."
},
{
"purpose": "Close with the call to action: start the trial at example.com.",
"title": "Try it this week",
"unsplashQuery": "team reviewing dashboard on office monitor",
"visual": "Real office photo with a large headline and the URL."
}
],
"thesis": "Acme turns weekly reporting into a 10 minute job.",
"title": "Acme reporting launch",
"websiteUrls": [
"https://example.com"
]
}The call returns a deckId at once. Poll genppt_get_deck with waitSeconds: 60 until phase is ready.
Create deck
Generate a new AI presentation deck from a prompt, notes, or URLs. GenPPT researches and writes the outline. Returns at once; the concept is ready in about a minute. Uses one deck from the plan allowance.
promptstringRequiredup to 8000 charactersWhat the deck is about: topic, audience, notes, outline, or pasted text.
aspectRatio"16:9" | "9:16" | "4:5" | "3:4" | "1:1" | "4:3" | "3:2" | "2:3"Slide shape. Default '16:9'. '4:5' or '3:4' = X 20-image portrait posts, LinkedIn PDF carousels, Instagram feed carousels. '9:16' = TikTok Photo Mode, Instagram Reels and Stories. '2:3' = Pinterest. '1:1' = square threads and posts. '16:9' = widescreen decks. '4:3' and '3:2' = classic screens and photo prints.
attachmentUrlsstring (URL)[]0 to 20 itemsPublic URLs (up to 20) of files, images, or YouTube videos to use as sources.
referenceImageUrlsstring (URL)[]0 to 20 itemsPublic image URLs (up to 20): logos, products, screenshots, or style references to show or match.
webSearchEnabledbooleanLet the agent research the web. Default true.
websiteUrlstringCompany or product website to ground the deck in.
Generate slides
Render the full slides once genppt_get_deck shows phase concepts_ready. Same as the Generate button in the studio. Slides take 1-3 minutes.
deckIdstring (UUID)RequiredDeck id from genppt_list_decks, genppt_create_deck, or genppt_create_slideshow.
Revise slides
Edit rendered slides of a ready deck: pass revisions[] (one entry per slide number for new copy, a fixed number, a different layout, or imageUrl/screenshotUrl) and/or flat top-level placements[] ({ slideNumber, url?, screenshotUrl?, x, y, width, height, cover? }) to paste exact images into boxes with no redraw. Paid plans only. Up to 10 placement-only slides (no instructions, imageUrl, or screenshotUrl) finish before the call returns, with phase ready and the new slideImageUrls. Other edits return at once; call genppt_get_deck with waitSeconds to see the new images.
deckIdstring (UUID)RequiredDeck id from genppt_list_decks, genppt_create_deck, or genppt_create_slideshow.
placementsobject[]1 to 40 itemsFlat pixel-exact image placements ({ slideNumber, url?, screenshotUrl?, x, y, width, height, cover? }) merged by slideNumber with no redraw. Up to 4 boxes per slide. Match box aspect ratio to the source image and avoid half-frame Slide 1 pastes.
slideNumberintegerRequired1 to 25heightnumberRequired0.02 to 1widthnumberRequired0.02 to 1xnumberRequired0 to 0.98Left edge as a fraction of the slide width.
ynumberRequired0 to 0.98Top edge as a fraction of the slide height.
coverbooleanTrue when the box is over a drawn copy of this image: the box is filled with the surrounding color first. Match (width * slideW) / (height * slideH) to the source image aspect ratio to avoid letterbox bars.
screenshotUrlstring (URL)Public webpage to screenshot live and paste into the box.
urlstring (URL)Direct public image URL to paste into the box unchanged.
revisionsobject[]1 to 25 itemsslideNumberintegerRequired1 to 25imageUrlstring (URL)Public image URL (logo, product UI, chart, photo) for the redraw to feature on this slide.
instructionsstringup to 2000 charactersWhat to change on this slide. Optional when imageUrl, screenshotUrl, or placeImages is given. With placeImages it only describes the paste.
placeImagesobject[]1 to 4 itemsPaste exact images into boxes on the slide (fractions 0-1 of the slide) with no redraw. Prefer top-level placements[] in MCP clients that drop nested array objects. Keep nearby text outside each box. Not with imageUrl or screenshotUrl; make that change in a separate call.
heightnumberRequired0.02 to 1widthnumberRequired0.02 to 1xnumberRequired0 to 0.98Left edge as a fraction of the slide width.
ynumberRequired0 to 0.98Top edge as a fraction of the slide height.
coverbooleanTrue when the box is over a drawn copy of this image: the box is filled with the surrounding color first. Match (width * slideW) / (height * slideH) to the source image aspect ratio to avoid letterbox bars.
screenshotUrlstring (URL)Public webpage to screenshot live and paste into the box.
urlstring (URL)Direct public image URL to paste into the box unchanged.
screenshotUrlstring (URL)Public webpage URL to screenshot live and feature on this slide in the redraw.
{
"deckId": "3f2a9c1e-7b4d-4e8a-9f10-2c5d6e7f8a9b",
"revisions": [
{
"instructions": "Change the headline to \"Reporting in 5 minutes\" and remove the caption.",
"slideNumber": 1
},
{
"screenshotUrl": "https://example.com/pricing",
"slideNumber": 4
}
]
}Redraws return at once. Call genppt_get_deck with waitSeconds: 60 to get the new slideImageUrls.
{
"deckId": "3f2a9c1e-7b4d-4e8a-9f10-2c5d6e7f8a9b",
"placements": [
{
"cover": true,
"height": 0.16,
"slideNumber": 2,
"url": "https://example.com/brand/logo.png",
"width": 0.2,
"x": 0.06,
"y": 0.05
},
{
"height": 0.4,
"screenshotUrl": "https://example.com/product/reports",
"slideNumber": 3,
"width": 0.8,
"x": 0.1,
"y": 0.3
}
]
}x, y, width, and height are fractions of the slide. On a 4:5 slide a square logo needs width / height = 1.25 (0.20 by 0.16 here) so the box matches the image. Placement-only calls of up to 10 slides finish before the call returns.
Export deck
Export a ready deck to PowerPoint, PDF, or a ZIP of slide images. Waits until the file is built (up to 2 minutes) and returns a download URL. Paid plans only.
deckIdstring (UUID)RequiredDeck id from genppt_list_decks, genppt_create_deck, or genppt_create_slideshow.
format"pptx" | "pdf" | "images"Requiredpptx = PowerPoint, pdf = PDF, images = ZIP of slide images.
sendEmailbooleanEmail the download link to the account owner in addition to returning downloadUrl. Defaults to false for MCP calls.
{
"deckId": "3f2a9c1e-7b4d-4e8a-9f10-2c5d6e7f8a9b",
"format": "pptx",
"sendEmail": false
}Returns downloadUrl and filename. Use format "pdf" for a LinkedIn document post or "images" for a ZIP of slide images.
Upgrade plan
Preview the cost of a GenPPT plan. Never charges. Ask the user before passing confirmPaymentSpend: true; that returns the checkout link where the user pays.
plan"growth_monthly" | "growth_yearly" | "max_yearly"RequiredconfirmPaymentSpendbooleanfalse (default) = price preview only. true = the user agreed to pay; returns the checkout link.
Send feedback
Send a bug report, feature request, or question to the GenPPT team.
category"bug" | "missing_feature" | "question" | "other"RequiredmessagestringRequiredup to 4000 characterscontextobjectdeckIdstring (UUID)GenPPT renders each slide as one complete designed visual. Agents that also need native, editable PowerPoint files compiled on their own machine can pair this server with pptx-rs, the open-source Rust PowerPoint engine. A common split: GenPPT MCP makes the cover art and background plates, and pptx-rs layers editable text, tables, and charts on top.
npx skills add Illyism/pptx-rs
Read how pptx-rs works with GenPPT MCP, or send bugs and feature requests for this server through genppt_submit_feedback.
Stop stressing over formatting. Join 100,000+ professionals creating presentations worth presenting.