Encelade

Stop a run started by generate_project. Pages already written stay in the deck. Returns the run's status; poll get_generation_run until its phase is failed (the run ends canceled). A run that has already finished cannot be canceled.

cancel_generation_run

Create a custom presentation theme in the user's Encelade workspace from brand colours, fonts and styles, e.g. when the user asks to send their brand or design system to Encelade. To change a theme the workspace already has, use update_theme instead. name and colors.accent are required; anything left out is derived from the given colours or kept from Encelade's default theme. Colours take hex (#1a2b3c, or #1a2b3c80 with alpha), rgb()/rgba() or oklch(). Accent and background are used at full opacity and see-through gradient colours are blended onto the slide background; every other colour may be see-through. cards.fill: { type: "none" } makes cards transparent. cards.fill also takes glass, liquid or dissolve (text cards only, not titleCard); glass and liquid only show over a busy page background such as an image or gradient. Card borderColor takes a colour or a gradient fill. Gradient colours can be { color, position } stops. For the logo pass exactly one of: logo.url, a public link to the logo file the source design uses; logo.svg, its SVG markup when it has no public link; or logo.brandDomain, the brand's website, to look up its published logo. Prefer the source design's own logo over brandDomain. If the source design has a version of the logo for the opposite light/dark background (e.g. a white logo for dark slides), pass it as logo.contrast with url or svg; contrast slides use it. For a font Encelade doesn't offer, pass a direct link to its file as fonts.heading.url or fonts.body.url. Pass a brand book's type scale (title sizes, weights, tracking, leading) as typography. pageBackground, contrast.pageBackground and each backgroundVariants fill also take an image: a public https link Encelade downloads. Generated decks cycle through pageBackground and the backgroundVariants. If the user has a brand-guidelines PDF or PPTX, the theme studio can instead create a theme from that file, including its backgrounds, at https://www.encelade.ai/brand/themes/new. The response lists what was derived and anything that could not be applied, so you can tell the user. Returns themeId: pass it as `theme` to generate_project.

create_theme

Permanently delete a deck by its pid. This action cannot be undone. By default also removes uploaded media exclusively owned by you and no longer referenced by any surviving deck; pass deleteAssets: false to keep those assets.

delete_project

Permanently delete a custom theme from the user's Encelade workspace, for everyone in it. Get its themeId from list_themes. There is no undo. If decks use the theme, the first call deletes nothing and returns confirmationRequired with decksUsingTheme: tell the user the theme's name and how many decks use it, and ask whether to delete it. Only if they agree, call again with confirmDecksUsingTheme set to that count. If the count changed in between, you get confirmationRequired again with the new count; ask the user again. Generated decks keep the look the theme had when they were created; new decks can no longer use it.

delete_theme

Edit an existing deck the way the editor's AI chat does: rewrite or translate text, restyle layers, add, reorder or delete pages, change the theme. Name the pages to change in the instruction, or pass pageId for a request about one page. Changes are saved unless dryRun is true. Returns status (applied, proposed, no_changes or truncated), the assistant's message, the changes made and anything skipped. A truncated run saves nothing: split the request. Uses AI credits, dry runs included.

edit_project

Generate a deck, proposal or one-pager from a brief. Put everything the deck should be built from in the brief: the topic, notes, data, or an outline with # headings. Returns a runId immediately; a run takes a few minutes, so poll get_generation_run with that runId about every 15 seconds until it is done or failed.

generate_project

Get a single presentation deck by its pid (public ID). Opens an interactive slide preview in hosts that support MCP Apps.

get_project

Poll a run started by generate_project. Returns a short status line (planning / generating / done / failed) with a link to the deck; the structured payload also carries the phase, the run's stage and its plan. A run takes a few minutes: re-poll with the same runId about every 15 seconds until the status line starts with `Done.` or the phase is failed. Once done, call get_project once with projectPid to open the interactive slide preview. This status tool does not open a preview.

get_generation_run

List presentation decks. Returns paginated results. Use the returned cursor to fetch the next page.

list_projects

List the custom presentation themes in the user's Encelade workspace, newest first. Pass a theme's themeId as `theme` to generate_project to build decks in it. Check this before create_theme so you don't recreate a brand theme the workspace already has; to change one, pass its themeId to update_theme, and to remove one, to delete_theme. fonts.uploaded names the theme's uploaded fonts, for update_theme's removeFonts. typography holds only the type settings the theme sets, in the form update_theme takes: headingCase when titles are in capitals, and the scale, weight, tracking, leadingPercent or font of each display, h1, h2, h3 or eyebrow level it sets. colors and contrast hold each theme's current colours in the form update_theme takes, so read them before changing a colour relative to what it is now.

list_themes