compose_deck
ChatGPTBuild ONE .pptx from templates with your content, slides in order (mixed masters fine). Keys are get_template shapeIds. text replaces a shape's text keeping its formatting: a string (one paragraph per line) or paragraphs [{text, like}] where like = n copies template paragraph n's format; bold for bold runs. remove deletes shapes. images puts an uploaded PNG/JPEG into a picture or shape. layoutOf instead adds a new slide on that template's layout, keyed by its layout.placeholders shapeIds. Returns a link, previews and the validator result: check every preview against the request and call again with the whole deck to fix.
convert_image_to_slide
ChatGPTRebuild a picture of a slide (screenshot, photo, generated image) as ONE editable PowerPoint slide: native text, shapes, tables and charts on a real master. imageUploadId = an upload_presentation PNG/JPEG. Frame: pptxUploadId (an uploaded .pptx; its masters/layouts are used), else designSystemId (list_design_systems), else the organization's default design system. A designSystemId with a pptx also applies its styling. Takes 1-3 min: waits up to 55 s, then call again with only jobId while pollAgain. Repeating the same inputs recovers a running or finished job; after a failed, cancelled or slide-less one it starts a new paid attempt (at most 3 in all).
create_deck
ChatGPTCall list_workflows first: if a workflow fits, use generate_presentation instead; create_deck is for requests no workflow covers. Create a new PowerPoint deck from a brief, in one of your organization's design systems (its master, layouts, colours, fonts), built by offgen's slide-creation engine. Runs asynchronously: returns a runId right away; then call get_result with it (each call waits up to 55 s; repeat while pollAgain) for progress and, when done, the download link and slide previews. A deck takes about 2-5 minutes and calls models (about $1-3). designSystemId: from list_design_systems; omitted = the organization's default. material: source text to build from (notes, data, an article), passed to the engine as is. Repeating the same inputs recovers the running or finished run; after a failed one it starts a new paid attempt (at most 3). idempotencyKey (optional): your own key for this request; reusing it with different inputs is refused.
describe_workflow
ChatGPTDescribe a single workflow's required and optional inputs. Pass a workflowId obtained from list_workflows. Returns the workflow's name, its inputs (name, label, type, whether required, and allowed values for choice fields), and a JSON Schema (inputSchema) for those inputs. Date inputs take a calendar day as a "YYYY-MM-DD" string (e.g. "2026-09-18"). Validate the values you intend to send against this schema before calling generate_presentation.
download_presentation
ChatGPTGet a ready-to-open download link for a completed PowerPoint run. Pass the runId from generate_presentation. This returns the signed URL as an MCP resource_link, a clickable Markdown fallback, and structured download metadata. It never returns the PowerPoint bytes or a base64 blob inline. Only works once the run's status is "completed" (check with get_result first); otherwise this returns an actionable error. Clients using an MCP version older than 2025-06-18 receive the same URL metadata as JSON text.
generate_presentation
ChatGPTStart generating a presentation from a workflow. Runs asynchronously. Pass the workflowId and an "inputs" object whose keys match the workflow's inputSchema (see describe_workflow). Required fields must be present. This does NOT wait for the deck to finish — it returns immediately with a runId and a status of "queued". Poll get_result with that runId to retrieve the finished .pptx. If the workflow or inputs are invalid, this returns an actionable error and no run is started.
get_result
ChatGPTCheck the status of a presentation run and, once finished, get the .pptx. Pass the runId returned by generate_presentation. This call waits up to 55 seconds while a run is "queued" or "running", checking progress internally. When pollAgain is true, call get_result again with the same runId; do not search for or read unrelated tools or skills between status calls. slidesEmitted shows progress. When "failed", error explains why. When "completed", return the presentation resource to the user. The result includes an MCP resource_link, a clickable Markdown fallback, and structured download metadata. Its URL carries a short-lived, single-deck access token, so a browser can download the PowerPoint without an API key or sign-in. The link expires and only works for this one deck. download_presentation remains available as a compatibility alias. Clients using an MCP version older than 2025-06-18 receive the same URL metadata as JSON text; neither tool returns file bytes inline.
get_template
ChatGPTTemplate details: offgen's analysis, slots (shapeId, kind, role, guidance, currentText or numbered paragraphs, locked), its layout's placeholders (for compose_deck layoutOf), a preview image and pptxUrl.
list_design_systems
ChatGPTYour organization's ready design systems (id, name, layout count) and the default one, for the designSystemId of convert_image_to_slide and create_deck.
list_workflows
ChatGPTList the presentation workflows available to your organization. Call this first, with no arguments, to discover what you can generate. Each workflow is a reusable, branded presentation template (e.g. a sales proposal or an information memorandum). Returns an array of { id, name, description }. Pick the workflow whose description best matches the user's request; names are free-form display names, so always address a workflow by its id. Next step: pass a returned id to describe_workflow to learn the exact inputs it needs before calling generate_presentation.
onboard_templates
ChatGPTTurn slides of an uploaded .pptx into Library templates, one per slide. Retry-safe. offgen's analysis then names them (1-3 min): wait with get_template waitForAnalysis.
search_templates
ChatGPTSearch the Library templates you can use by what the slide should show (any language). No query lists the newest.
upload_presentation
ChatGPTStage a file: a .pptx for onboard_templates, or a PNG/JPEG for compose_deck images. Pass base64 (under 4 MB), or no base64 to get uploadUrl + a curl PUT line for kind.