MCP Docs · Server v1.2.6

GenPPT MCP server

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.

Server URL
https://genppt.com/mcp

Connect a client

  1. Sign in and open Account. Under MCP key, click Create key. The gppt_... key shows once, so copy it right away.
  2. Add https://genppt.com/mcp as a remote server and send the key in the header Authorization: Bearer gppt_YOUR_KEY.
  3. Ask your agent to call 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.

Terminal
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.

mcp.json
{
  "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.

claude_desktop_config.json
{
  "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.

config.toml
[mcp_servers.genppt]
url = "https://genppt.com/mcp"
bearer_token_env_var = "GENPPT_MCP_KEY"
Shell profile
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.

List tools
curl -s https://genppt.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"id":1,"jsonrpc":"2.0","method":"tools/list"}'
Call a tool
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"}}'
Discovery
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.

Two workflows

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.

Workflow A: direct slideshow

genppt_create_slideshow, then genppt_get_deck

  1. Call 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.
  2. Give each slide real visual proof: 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.
  3. Set deck-wide inputs: websiteUrls (up to 6 pages screenshotted before rendering) and referenceImageUrls (brand logos and style references, first 4 used).
  4. 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>.
  5. Poll genppt_get_deck with waitSeconds: 60 until phase is ready, then use slideImageUrls or call genppt_export_deck.

Workflow B: prompt to deck

genppt_create_deck, genppt_get_deck, then genppt_generate_slides

  1. Call genppt_create_deck with a prompt (topic, audience, notes, or pasted text) and optional websiteUrl, attachmentUrls, and referenceImageUrls. Web research is on by default.
  2. Poll genppt_get_deck with waitSeconds: 60 while phase is drafting_concepts. The concept is ready in about a minute.
  3. At concepts_ready, show conceptPreviewUrl to the user. Once they approve, call genppt_generate_slides.
  4. Poll genppt_get_deck again while phase is rendering_slides. At ready, show the slide images and share studioUrl.

Deck phases

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.

PhaseWhat it means
drafting_conceptsGenPPT is writing the outline and the concept preview.
concepts_readyThe concept preview is ready. Show conceptPreviewUrl, then call genppt_generate_slides.
rendering_slidesFull slides are rendering. Usually 1 to 4 minutes.
readyslideImageUrls holds the finished slide images in order.
errorThe run failed. Retry, or report it with genppt_submit_feedback.

Aspect ratios

Both create tools take aspectRatio. Pick it for where the slides will be posted or presented.

aspectRatioShapeUse it for
4:5PortraitX 20-image portrait posts, LinkedIn PDF carousels, Instagram feed carousels. Default for genppt_create_slideshow.
9:16Tall portraitTikTok Photo Mode, Instagram Reels and Stories.
16:9WidescreenPresentation decks. Default for genppt_create_deck.
1:1SquareSquare threads and posts.
3:4PortraitTaller poster style carousels on X, LinkedIn, and Instagram.
2:3PortraitPinterest pins.
4:3LandscapeClassic screens and projectors.
3:2LandscapePhoto prints and classic screens.

Authentication and billing

  • Bearer key. Send Authorization: Bearer gppt_... on every request. Create, replace, or revoke the key in Account. A revoked or wrong key gets HTTP 401.
  • Without a key. 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.
  • A paid plan is required for finished decks. Full slide renders, slide revisions, and exports need GenPPT Studio, which starts with a $1 3-day trial and then costs $25 per month or $99 per year. See pricing. Accounts without a plan stop at the concept preview.
  • Deck allowance. Each genppt_create_slideshow or genppt_create_deck call uses one deck from the monthly plan allowance. genppt_account_status shows what is left.
  • Upgrades never charge from the agent. When a tool returns 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.
  • Limits. Requests are rate limited per IP and per account. On HTTP 429, wait a minute and retry. All URLs passed to tools must be public http(s) addresses.

Tool reference

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.

genppt_account_status

Read only

Account status

Show the connected GenPPT account: plan, decks used this period, saved card, and upgrade options.

Parameters

No parameters.

genppt_list_decks

Read only

List decks

List the user’s GenPPT decks, newest edits first.

Parameters

  • limitinteger1 to 100

    Max decks to return (default 20).

  • searchstringup to 200 characters

    Filter by title.

genppt_get_deck

Read only

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.

Parameters

  • deckIdstring (UUID)Required

    Deck id from genppt_list_decks, genppt_create_deck, or genppt_create_slideshow.

  • waitSecondsinteger0 to 60

    Wait up to this many seconds while the deck is drafting or rendering, and return when the phase changes. Default 0.

genppt_hot_topics

Read only

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.

Parameters

  • limitinteger1 to 8

    Max topics to return (default 8).

  • tagstringup to 64 characters

    Keep only topics with this tag or keyword (case-insensitive), such as "ai" or "crypto".

genppt_create_slideshow

Changes data

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.

Parameters

  • slidesobject[]Required1 to 25 items

    The slides in order. Slide 1 is the cover or hook.

    • purposestringRequiredup to 600 characters

      What this slide must say: the claim, facts, numbers, and copy to show.

    • titlestringRequiredup to 200 characters

      Slide headline.

    • visualstringRequiredup to 600 characters

      Layout 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 characters

      Short 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 characters

    Slideshow title.

  • artDirectionstringup to 4000 characters

    Palette, 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 items

    Public 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).

  • autoRenderboolean

    Default true: render full slides right after the concept. false = stop at the concept preview.

  • isPublicboolean

    Optional. 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 items

    Public 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 characters

    The core argument of the slideshow in one sentence.

  • websiteUrlsstring (URL)[]0 to 6 items

    Public 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.

Example: Four slide portrait carousel with real visuals

genppt_create_slideshow arguments
{
  "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.

genppt_create_deck

Changes data

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.

Parameters

  • promptstringRequiredup to 8000 characters

    What 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 items

    Public URLs (up to 20) of files, images, or YouTube videos to use as sources.

  • referenceImageUrlsstring (URL)[]0 to 20 items

    Public image URLs (up to 20): logos, products, screenshots, or style references to show or match.

  • webSearchEnabledboolean

    Let the agent research the web. Default true.

  • websiteUrlstring

    Company or product website to ground the deck in.

genppt_generate_slides

Changes data

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.

Parameters

  • deckIdstring (UUID)Required

    Deck id from genppt_list_decks, genppt_create_deck, or genppt_create_slideshow.

genppt_revise_slides

Changes data

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.

Parameters

  • deckIdstring (UUID)Required

    Deck id from genppt_list_decks, genppt_create_deck, or genppt_create_slideshow.

  • placementsobject[]1 to 40 items

    Flat 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 25
    • heightnumberRequired0.02 to 1
    • widthnumberRequired0.02 to 1
    • xnumberRequired0 to 0.98

      Left edge as a fraction of the slide width.

    • ynumberRequired0 to 0.98

      Top edge as a fraction of the slide height.

    • coverboolean

      True 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 items
    • slideNumberintegerRequired1 to 25
    • imageUrlstring (URL)

      Public image URL (logo, product UI, chart, photo) for the redraw to feature on this slide.

    • instructionsstringup to 2000 characters

      What to change on this slide. Optional when imageUrl, screenshotUrl, or placeImages is given. With placeImages it only describes the paste.

    • placeImagesobject[]1 to 4 items

      Paste 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 1
      • widthnumberRequired0.02 to 1
      • xnumberRequired0 to 0.98

        Left edge as a fraction of the slide width.

      • ynumberRequired0 to 0.98

        Top edge as a fraction of the slide height.

      • coverboolean

        True 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.

Example: Redraw two slides

genppt_revise_slides arguments
{
  "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.

Example: Paste exact pixels with placements

genppt_revise_slides arguments
{
  "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.

genppt_export_deck

Changes data

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.

Parameters

  • deckIdstring (UUID)Required

    Deck id from genppt_list_decks, genppt_create_deck, or genppt_create_slideshow.

  • format"pptx" | "pdf" | "images"Required

    pptx = PowerPoint, pdf = PDF, images = ZIP of slide images.

  • sendEmailboolean

    Email the download link to the account owner in addition to returning downloadUrl. Defaults to false for MCP calls.

Example: Export a ready deck to PowerPoint

genppt_export_deck arguments
{
  "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.

genppt_upgrade_plan

Read only

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.

Parameters

  • plan"growth_monthly" | "growth_yearly" | "max_yearly"Required
  • confirmPaymentSpendboolean

    false (default) = price preview only. true = the user agreed to pay; returns the checkout link.

genppt_submit_feedback

Changes data

Send feedback

Send a bug report, feature request, or question to the GenPPT team.

Parameters

  • category"bug" | "missing_feature" | "question" | "other"Required
  • messagestringRequiredup to 4000 characters
  • contextobject
  • deckIdstring (UUID)

Local editable .pptx with pptx-rs

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.

Terminal
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.

AI presentations

Stop stressing over formatting. Join 100,000+ professionals creating presentations worth presenting.