Skip to main content
This is the path an agent takes when a presenter hands it a slide deck. Five requests, and the presenter opens the result in the editor.
1

Create the deck

A title is enough. The deck opens with the join screen and one blank slide.
2

Attach the PDF

Send the file as base64 in pdf, with pages set to the page count. While no slide has a page yet, the blank slides are replaced by one slide per page, in order, after the join screen. Polls already in the deck are kept.A slide deck runs to megabytes, too big for a shell argument, so pipe the body in. This one uses jq to wrap the base64 in JSON.
PDF only for now, 24 MB at most, 60 pages at most. The editor renders the pages when the deck is opened.
3

Decide where a poll helps

Read the PDF yourself. Not every slide deserves a poll; three to five in a deck of ten to twenty slides is the usual rhythm. Good moments: a claim the room can vote on, a number to estimate before it is revealed, a choice between two directions, a word cloud at the end.
4

Put each poll on its slide

add_overlay drops a card on one slide. Leave rect and style out for the house card in the bottom-right quarter. When that corner holds text on the slide, give a rect that covers a picture or empty space instead. Never cover text.
Step 4 is the fourth page, since step 0 is the join screen. A full-screen question goes in with add_step instead.
5

Look at every slide you touched

get_screenshot returns the slide as the room will see it, with the numbers beside the picture. coversPageText lists each card that hides the page’s own words, with the first words it hides, and warnings name a card that is too small to read, cut off, or on top of another. Move a card with update_overlay, sending only its new rect.
A PDF slide titled Analytic budgeting, with a this-or-that card on the picture in the bottom-left and three bullet points on the right

The card from the step before, on the page's picture and clear of its text, as get_screenshot draws it.

6

Hand it over

Read the deck once more with get_outline and make sure ready is true and no step in it has warnings. Then give the presenter the editor url from the first step. They open it, the pages render, and they press Present. Or start the room yourself with start_room: the server draws the pages first, which adds a few seconds, and you hand the presenter its presentUrl.

​
The same flow over MCP

With the MCP server connected, the tools are create_deck, attach_pdf, get_outline, add_overlay, update_overlay and get_screenshot, and the screenshot comes back as an image the agent can see. The server’s instructions tell the agent this flow on connect.