Work with a live PowerPoint presentation through MCP

Deckary's live PowerPoint MCP tools let an external AI agent work with the presentation currently open in desktop PowerPoint. Access is opt-in: the Deckary task pane must be open, you must be signed in, and MCP sharing must be enabled. Changes are executed by the add-in inside the live Office document.

Start a live session#

1. Install and open the Deckary add-in in desktop PowerPoint.
2. Sign in with the same Deckary account used during MCP authorization.
3. Open the presentation you want the agent to access.
4. Turn on MCP sharing in the Deckary task pane.
5. Ask the agent to call list_live_presentations and select the returned session.

Only active, explicitly shared sessions appear. The server does not search your computer for PPTX files and cannot queue offline work for a closed presentation.

Read before writing#

read_live_presentation returns a versioned projection with opaque slide handles, the selected slide, slide dimensions, outline, layouts, theme information, and requested editable scenes. When the agent requests specific slide handles, the response also includes exact plain text for observed text shapes.

The agent should keep the latest values returned by a successful live call:

• sessionId identifies the current shared presentation session.
• connectionGeneration distinguishes a reconnected add-in session from an older connection.
• artifactVersion represents the observed presentation state and is supplied as expectedArtifactVersion on the next call.

These values are concurrency controls, not stable document IDs. The agent should use current handles and versions rather than inventing or caching them across disconnected sessions.

Inspect only when deeper object truth is needed#

Use inspect_live_objects for exact rich-text runs, fill and line appearance, text-frame state, native table structure, or Deckary chart configuration. An ordinary wording edit usually needs only a targeted read_live_presentation, because that read already returns exact plain text.

Large native tables may return rangeRequired. The agent must request a bounded zero-based table range rather than asking for the entire oversized table in one call.

Render exact Office pixels#

render_live_slides uses PowerPoint's native renderer and accepts up to four current slide handles. The default overview detail returns one PNG per slide. For one slide, visualDetail=atlas also returns an overlapping 3×2 close-up atlas with current shape and text locators.

Rendering is useful when the external agent needs to judge hierarchy, spacing, clipping, contrast, or the visual result of a change. The external agent makes that judgment; the MCP server does not invoke a model to review the image.

Create or patch one slide#

author_slide accepts one semantic Slide DSL program for exactly one slide. It can create a slide with an exact available layout or patch current shapes on an existing slide. Supported authoring includes text and shape changes, native tables and charts, and targeted deletions where the contract permits them.

The live MCP path does not expose protected slide replacement or nonempty source bindings. A create operation must satisfy the selected layout's editable placeholder obligations. A patch must use current slide and shape handles.

Immediately before mutation, the add-in captures fresh Office truth and compares it with expectedArtifactVersion:

• version_conflict means the presentation changed. No mutation occurred. Read the current presentation and prepare the edit again.
• Complete validationIssues mean preflight failed. No Office mutation occurred. Repair the program before retrying.
• applied: true is terminal success. The result already contains the next current state and exact committed Office pixels.
• settlement_unknown is not safe to retry automatically. Reconnect if required, read current presentation truth, and determine whether the change was already applied.

Do not immediately list, read, or render after applied: true only to refresh state; the successful result is already current.

Know when the session ends#

A live presentation disappears when you turn off sharing, sign out, close the Deckary task pane, or lose the add-in connection. Only one command can be in flight for a live session. If a session reconnects, use the newly returned generation and version.

For authorization and data-flow details, read Security and data handling. For recovery steps, see Troubleshooting.