Work with saved Web Builder decks through MCP

Deckary's saved-deck MCP tools let an external AI agent work with presentations stored in your Deckary Web Builder account. PowerPoint does not need to be open. Access is owner-scoped, and each authoring request is checked against the current deck revision before Deckary commits it.

Discover a saved deck#

Call list_decks to retrieve the signed-in user's saved presentations. Results include stable deck IDs, current revisions, slide counts, and update times. The optional query is limited to 100 characters, and the result limit can be 1–100 with a default of 25.

An agent should always discover the deck instead of guessing a deckId.

Read only the slides you need#

Call read_deck with the chosen deckId. Without slideIds, the tool returns compact deck state and the first slide. With up to ten current slide IDs, it returns the current revision, outline, theme, and exact editable scene truth for those slides.

The returned revision is the concurrency boundary for later authoring. If another edit changes the deck, the agent must read the newer state before preparing a replacement program.

Prepare a consulting visual#

render_consulting_visual prepares a validated, theme-bound visual for a supported Deckary recipe. Artwork-backed preparation may idempotently add one reusable asset owned by the deck, but it does not change presentation content or advance the deck revision.

If the semantic configuration is invalid, the tool returns prepared: false with repair issues. The agent should correct those issues before using the visual in an authoring program.

Render slide images#

render_slides accepts one to four current slide IDs and returns exact 960×540 PNG images. Each image is bound to the current deck revision and an artifact fingerprint.

Use renders to inspect the deck before a material edit and to evaluate the visual result returned by authoring. A stale image should not be treated as evidence of the current deck.

Author against the current revision#

author_deck accepts the deckId and a semantic Deckary authoring program. The program can create, revise, reorder, or remove supported presentation content. Deckary validates the complete program and applies it against the expected revision.

A successful result returns current deck state and up to four images for committed changed slides. A stale revision is rejected rather than overwriting newer work. The external agent should use that returned state for its next decision instead of immediately repeating discovery calls.

Recommended saved-deck sequence#

1. list_decks to select the saved presentation.
2. read_deck for compact state and only the target slides.
3. render_slides if visual context is required.
4. render_consulting_visual only when a supported recipe is part of the edit.
5. author_deck with the current revision and complete semantic program.
6. Inspect the committed images and current state returned by authoring.

See the tool reference for the complete saved and live tool set, or Getting started for connection instructions.