> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Sideshow MCP

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

![Sideshow MCP logo](https://mintcdn.com/composio-preview/B09iGux45A5cYDuO/images/toolkits/sideshow_mcp.svg?fit=max\&auto=format\&n=B09iGux45A5cYDuO\&q=85\&s=3e88700f0f44205fd6a7d8c982715cc6)

* **Category:** model context protocol
* **Auth:** DCR\_OAUTH
* **Composio-managed OAuth available?** No
* **Tools:** 18
* **Triggers:** 0
* **Slug:** `SIDESHOW_MCP`
* **Version:** 20261030\_00

## Tools

> [accordion] Add surface
>
> **Slug:** `SIDESHOW_MCP_ADD_SURFACE`
>
> Insert one publish\_post-shaped surface into a post; before/after accepts an id or 0-based index. Read userFeedback.
>
> #### Input Parameters
>
> **after** `string`
>
> Surface id or 0-based index
>
> **before** `string`
>
> Surface id or 0-based index
>
> **postId** `string` *required*
>
> Post id returned by publish\_post
>
> **surface** `object` *required*

> [accordion] Edit surface
>
> **Slug:** `SIDESHOW_MCP_EDIT_SURFACE`
>
> Replace one surface by id/index, or pass content to preserve its kind-specific options. Read userFeedback.
>
> #### Input Parameters
>
> **kits** `array`
>
> **postId** `string` *required*
>
> Post id returned by publish\_post
>
> **target** `string` *required*
>
> Surface id or 0-based index
>
> **content** `string`
>
> New content for the existing kind
>
> **surface** `object`

> [accordion] Get design guide
>
> **Slug:** `SIDESHOW_MCP_GET_DESIGN_GUIDE`
>
> Fetch HTML fragment, sizing, theme, kit, CDN, and interactivity guidance. Not needed for non-HTML kinds.

> [accordion] Get post
>
> **Slug:** `SIDESHOW_MCP_GET_POST`
>
> Get one full post with surface ids/indexes, version, and history; use before targeted edits or after compaction.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Post id returned by publish\_post

> [accordion] List posts
>
> **Slug:** `SIDESHOW_MCP_LIST_POSTS`
>
> List posts, optionally scoped by session. Returns surface id/kind/index metadata without bodies.
>
> #### Input Parameters
>
> **session** `string`
>
> Optional session scope

> [accordion] List surfaces
>
> **Slug:** `SIDESHOW_MCP_LIST_SURFACES`
>
> Deprecated list\_posts alias.
>
> #### Input Parameters
>
> **session** `string`

> [accordion] Publish post
>
> **Slug:** `SIDESHOW_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.
>
> #### Input Parameters
>
> **agent** `string`
>
> Agent name for a new session
>
> **title** `string` *required*
>
> Short card title
>
> **session** `string`
>
> Session id from a previous publish; omit on the first
>
> **surfaces** `array` *required*
>
> Ordered surfaces; combine kinds in one card
>
> **sessionTitle** `string`
>
> Task name for a new session; honored only when the publish creates it

> [accordion] Publish snippet
>
> **Slug:** `SIDESHOW_MCP_PUBLISH_SNIPPET`
>
> Deprecated HTML-only publish\_post sugar. Send a body fragment in html. Read userFeedback.
>
> #### Input Parameters
>
> **html** `string` *required*
>
> **kits** `array`
>
> **agent** `string`
>
> **title** `string` *required*
>
> **session** `string`
>
> **sessionTitle** `string`

> [accordion] Publish surface
>
> **Slug:** `SIDESHOW_MCP_PUBLISH_SURFACE`
>
> Deprecated publish\_post alias; pass the same surface shape as parts. Read userFeedback.
>
> #### Input Parameters
>
> **agent** `string`
>
> **parts** `array` *required*
>
> **title** `string` *required*
>
> **session** `string`
>
> **sessionTitle** `string`

> [accordion] Remove surface
>
> **Slug:** `SIDESHOW_MCP_REMOVE_SURFACE`
>
> Remove one surface by id/index; a post must retain at least one. Read userFeedback.
>
> #### Input Parameters
>
> **postId** `string` *required*
>
> Post id returned by publish\_post
>
> **target** `string` *required*
>
> Surface id or 0-based index

> [accordion] Reorder surfaces
>
> **Slug:** `SIDESHOW_MCP_REORDER_SURFACES`
>
> Reorder every surface using ids or 0-based indexes; order length must match. Read userFeedback.
>
> #### Input Parameters
>
> **order** `array` *required*
>
> All surface ids or 0-based indexes in desired order
>
> **postId** `string` *required*
>
> Post id returned by publish\_post

> [accordion] Reply to user
>
> **Slug:** `SIDESHOW_MCP_REPLY_TO_USER`
>
> Post a short plain-text reply using postId (surfaceId is deprecated). Read userFeedback.
>
> #### Input Parameters
>
> **author** `string`
>
> Agent name; "user" is reserved
>
> **postId** `string`
>
> Post id returned by publish\_post
>
> **message** `string` *required*
>
> Plain-text reply
>
> **surfaceId** `string`
>
> Deprecated alias of postId

> [accordion] Send test post
>
> **Slug:** `SIDESHOW_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.
>
> #### Input Parameters
>
> **agent** `string`
>
> Agent name for a new session

> [accordion] Update post
>
> **Slug:** `SIDESHOW_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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Post id returned by publish\_post
>
> **title** `string`
>
> Replacement card title
>
> **surfaces** `array`

> [accordion] Update snippet
>
> **Slug:** `SIDESHOW_MCP_UPDATE_SNIPPET`
>
> Deprecated HTML-only update\_post sugar. Read userFeedback.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **html** `string`
>
> **kits** `array`
>
> **title** `string`

> [accordion] Update surface
>
> **Slug:** `SIDESHOW_MCP_UPDATE_SURFACE`
>
> Deprecated update\_post alias; pass replacement surfaces as parts. Read userFeedback.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **parts** `array`
>
> **title** `string`

> [accordion] Upload asset
>
> **Slug:** `SIDESHOW_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.
>
> #### Input Parameters
>
> **data** `string` *required*
>
> Base64 file bytes
>
> **kind** `string ("image" | "trace" | "file")`
>
> **session** `string`
>
> Session to own the asset
>
> **filename** `string`
>
> Original download filename
>
> **contentType** `string` *required*
>
> MIME type, e.g. image/png

> [accordion] Wait for feedback
>
> **Slug:** `SIDESHOW_MCP_WAIT_FOR_FEEDBACK`
>
> Wait up to 300 seconds for comments not yet delivered on any channel; 0 is a non-blocking check.
>
> #### Input Parameters
>
> **session** `string` *required*
>
> Session id returned by publish\_post
>
> **afterSeq** `number`
>
> Explicit shared-cursor override; usually omit
>
> **timeoutSeconds** `number`
>
> Seconds to wait; 0 checks only
