create_project
ChatGPTCreate a new blank project. Returns the projectSlug and editorUrl. The project starts empty: plan the full deck up front, then add all slides in a single create_slides call before writing their content with update_slide. Use this as the first step when building a new presentation. Pass teamId to create the project under a specific team; omit to use the user's personal team (call list_teams to see available teams).
create_slides
ChatGPTCreate one or more empty slides in a project, IN THE ORDER you list them. Always pass the full set of slides you want to add in a single call instead of calling this tool multiple times in parallel — a single call is atomic, preserves order, and avoids race conditions. The slides are created with placeholder files; use update_slide on each returned slideId to write the real content. Pass editing: true to immediately show the loading gradient on every new slide (saves separate start_slide_editing calls). IMPORTANT: You must call get_slide_guide and read the authoring reference before writing any slide code.
duplicate_project
ChatGPTCreate a full copy of a project, including all slides. The copy is named '<original> (Clone)' and gets its own projectSlug, editorUrl, and a fresh unpublished URL. The duplicate is created under the same team as the authenticated request.
finish_slide_editing
ChatGPTSignal that you are done editing a slide. Clears the loading indicator from the editor. Always call this after update_slide completes, even if the edit failed.
get_plugin_docs
ChatGPTFetch the full markdown docs for a plugin: its config schema, the functions it exposes with input/output, and code examples showing how the slide's face.tsx calls it (e.g. useFormPlugin / usePresenterPlugin). Call this before setup_plugin so you know how to configure it and how to wire it into the slide code.
get_project
ChatGPTGet detailed information about a specific project, including its latest version and URLs.
get_project_config
ChatGPTRead project.config.json, including layout settings and the shared design system tokens (palette colors and fonts) used across slides. Call this before defining or updating the project design system.
get_project_url
ChatGPTGet the project's current live URL configuration: whether it is hosted on a subdomain or a custom domain, the hostname, and the path. Use this to tell the user where a published project is served.
get_slide
ChatGPTRead a slide's source files. Returns face.tsx (React component), face.content.json (content blocks), face.controls.json (control settings), and — if any plugins are configured — face.plugins.json (plugin instances). Always read before editing so you understand the current structure, including which plugins are already set up. See the instructions for the full file format reference.
get_slide_guide
ChatGPTGet the full slide authoring reference. Covers face.tsx structure, face.content.json block types, face.controls.json control types, typography guidelines, Google Fonts, CSS, and code examples. Call this before writing slide code for the first time. Pass projectSlug when editing an existing project so the guide matches that project's mobile canvas; omit it for new projects to get the default guide.
get_user_state
ChatGPTGet the authenticated user's live editor state across all their open browser tabs. Returns an array of active tabs, each with the project slug they're viewing, the currently selected slide (faceId), and whether agent mode is enabled. Tabs with no activity in the last ~60 seconds are not included. Useful for understanding which project the user is currently working on before suggesting actions or calling other tools that need a projectSlug.
list_plugins
ChatGPTList the face plugins available to attach to a slide (id and one-line description). Plugins add runtime behaviors a slide's React code can't express on its own — e.g. collecting form submissions, or embedding a live AI video presenter. Call this to discover what's available, then get_plugin_docs for the full config schema and code examples before setup_plugin.
list_projects
ChatGPTList the authenticated user's projects. Returns project IDs, names, and metadata. Use cursor for pagination.
list_slides
ChatGPTList all slides in a project. Returns slide IDs and names. Use the slide ID with get_slide and update_slide.
list_teams
ChatGPTList the teams the authenticated user belongs to. Returns team IDs, slugs, names, and the user's role in each. The personal team is flagged with isPersonal: true and is the default when creating a project without teamId.
publish_project
ChatGPTPublish a project's latest version, making it publicly accessible at its live URL. Returns the publishedUrl. Call this after the user is happy with the slides. Re-publishing an already-published project pushes the current latest version live.
rename_project
ChatGPTRename a project. Changes only the display name — the projectSlug and URLs stay the same.
reorder_slides
ChatGPTReorder ALL slides in a project to the order you specify. Pass the complete list of existing slideIds in the order you want them to appear. Missing or extra IDs return 400. The order is applied atomically; both the persisted project state and the live editor view end up in the same order. Use this to restructure an existing deck (e.g. move the intro to the end, swap sections). For creating new slides in a specific order, use create_slides instead — do NOT delete and recreate just to reorder.
setup_plugin
ChatGPTConfigure a plugin instance on a specific slide. Validates config against the plugin's schema and writes it to the slide's face.plugins.json. Other plugin instances already on the slide are preserved — only the instance with this localName is added or changed. By default this REFUSES to overwrite an existing instance with the same localName (returns 409). To tweak an existing instance's config, pass overwrite: true. Use a fresh localName to add a second instance alongside existing ones. After setup, the slide's face.tsx can call the plugin via its hook (e.g. useFormPlugin(localName) / usePresenterPlugin(localName)) — see get_plugin_docs for the exact API. Read the current face.plugins.json from get_slide first if you need to see what's already configured.
start_agent_mode
ChatGPTEnable 'agent mode' on a specific project in the user's browser. This hides the right sidebar (chat, content, controls) and shows a black floating bar at the bottom indicating that an agent is driving the session. The user can still deactivate it manually. Pair with get_user_state to discover which projectSlug the user currently has open. Set enabled=false to remotely deactivate agent mode. The signal is broadcast to all of the user's browser tabs that have the project open.
start_slide_editing
ChatGPTSignal that you are about to edit a slide. This shows a loading gradient in the editor so viewers know the slide is being modified. Call this BEFORE making changes with update_slide. Always call finish_slide_editing when done, even if the edit fails.
unpublish_project
ChatGPTUnpublish a project, taking it offline so its live URL no longer serves the project. The project and its slides are not deleted — it can be re-published later with publish_project.
update_project_config
ChatGPTUpdate project.config.json. Only keys present in config are changed; other keys are preserved. Use this to define or update the project-wide design system under tokens before styling slides. Example tokens block: { "tokens": { "palette": [ { "name": "--background", "value": "#0D0D0D" }, { "name": "--foreground", "value": "#F7F2EA" }, { "name": "--brand", "value": "#FF5A36" } ], "fonts": [ { "name": "--font-display", "family": "Space Grotesk" }, { "name": "--font-body", "family": "Inter" } ] } } Color names must start with --; font names with --font-. See get_slide_guide for the full design token reference.
update_slide
ChatGPTUpdate a slide's source files. File contents go INSIDE the files object, not at the top level. Only keys present in files are changed — omit keys for files you don't want to modify. The code is compiled and validated before saving — returns 400 with detailed errors if it doesn't compile. If face.tsx imports a sibling file (e.g. import "./face.css"), create that file FIRST in a separate update_slide call before adding the import to face.tsx. Missing sibling files cause the artifact to fail compilation in the browser. IMPORTANT: You must call get_slide_guide and read the authoring reference before writing any slide code. See the instructions for the full file format reference, workflows, and examples.
view_slide
ChatGPTTake a screenshot of a slide as it currently renders, and return it as an image so you can see the slide visually. Use this to verify layout, spacing, colors, typography, image placement, or whether a recent edit produced the intended result. The screenshot is captured headlessly in the cloud against the latest saved version of the project. Call this AFTER finishing any edits so the rendering reflects current state. Pass isMobile=true to capture the mobile layout.
