Sideshow MCP

Publish agent-generated visual surfaces — diagrams, code, markdown, images — as shareable posts.

18 actions Integration catalog

Connect Sideshow MCP once you're in Boring.

01 · WHAT THE AGENT CAN DO

Actions

Every capability is a discrete, logged action the agent calls by name — scoped to what you authorize and recorded in the run trace.

Add surfaceSIDESHOW_MCP_ADD_SURFACE

Insert one publish_post-shaped surface into a post; before/after accepts an id or 0-based index. Read userFeedback.

Edit surfaceSIDESHOW_MCP_EDIT_SURFACE

Replace one surface by id/index, or pass content to preserve its kind-specific options. Read userFeedback.

Get design guideSIDESHOW_MCP_GET_DESIGN_GUIDE

Fetch HTML fragment, sizing, theme, kit, CDN, and interactivity guidance. Not needed for non-HTML kinds.

Get postSIDESHOW_MCP_GET_POST

Get one full post with surface ids/indexes, version, and history; use before targeted edits or after compaction.

List postsSIDESHOW_MCP_LIST_POSTS

List posts, optionally scoped by session. Returns surface id/kind/index metadata without bodies.

List surfacesSIDESHOW_MCP_LIST_SURFACES

Deprecated list_posts alias.

Publish postSIDESHOW_MCP_PUBLISH_POST

Publish ordered surfaces as one post. Returns post id, URL, sessionId, and surface ids; reuse sessionId later. Set sessionTitle on the first publish. Read userFeedback.

Publish snippetSIDESHOW_MCP_PUBLISH_SNIPPET

Deprecated HTML-only publish_post sugar. Send a body fragment in html. Read userFeedback.

Publish surfaceSIDESHOW_MCP_PUBLISH_SURFACE

Deprecated publish_post alias; pass the same surface shape as parts. Read userFeedback.

Remove surfaceSIDESHOW_MCP_REMOVE_SURFACE

Remove one surface by id/index; a post must retain at least one. Read userFeedback.

Reorder surfacesSIDESHOW_MCP_REORDER_SURFACES

Reorder every surface using ids or 0-based indexes; order length must match. Read userFeedback.

Reply to userSIDESHOW_MCP_REPLY_TO_USER

Post a short plain-text reply using postId (surfaceId is deprecated). Read userFeedback.

Send test postSIDESHOW_MCP_SEND_TEST_POST

Publish the idempotent built-in welcome post to test a connection or fresh workspace; returns the existing post if already sent.

Update postSIDESHOW_MCP_UPDATE_POST

Revise a post in place instead of publishing a duplicate. Pass title and/or full replacement surfaces using the publish_post shape. Returns new surface ids. Read userFeedback.

Update snippetSIDESHOW_MCP_UPDATE_SNIPPET

Deprecated HTML-only update_post sugar. Read userFeedback.

Update surfaceSIDESHOW_MCP_UPDATE_SURFACE

Deprecated update_post alias; pass replacement surfaces as parts. Read userFeedback.

Upload assetSIDESHOW_MCP_UPLOAD_ASSET

Upload base64 bytes and return id and URL. Reference id as image assetId; pass the publish session when available for grouping and cleanup.

Wait for feedbackSIDESHOW_MCP_WAIT_FOR_FEEDBACK

Wait up to 300 seconds for comments not yet delivered on any channel; 0 is a non-blocking check.