developer-toolsapi_key

Sideshow

Sideshow is a collaborative visual workspace where agents publish, update, and discuss posts containing rich interactive surfaces.

Verdict

Sideshow is a collaborative documentation and design review platform that stores posts, comments, and sessions. When you @mention Sideshow in a Switchy Project, your AI can read posts with their version history, list comments by author or session, and create new comments directly from chat. This is most useful for teams doing design reviews or technical documentation sprints — your AI can summarize feedback threads, flag unresolved comments, or draft responses based on context from earlier versions. You'll need an API key from your Sideshow workspace settings. Note that the MCP can't edit post content or surfaces, only read them and manage comments.

Common use cases

  • Summarize design feedback from a review session
  • Flag unresolved comments before a milestone
  • Draft replies to technical questions in posts
  • Compare post versions to track scope changes
  • Generate a changelog from session activity

Integration

Vendor
Sideshow
Category
developer-tools
Auth
API_KEY
Tools
10
Composio slug
sideshow

Tools

  • Create Comment

    Create a text comment attached to a post.

  • Delete Comment
    destructive

    Permanently delete one comment by id.

  • Delete Post
    destructive

    Permanently delete one post by id.

  • Get Post

    Get one post with current surface content and retained version history.

  • List Comments

    List currently available comments, optionally filtered by session, post, author, or sequence number. This call never long-polls.

  • List Kits

    List the HTML style and behavior kits available to use in post surfaces.

  • List Posts

    List compact post summaries from one session, or the most recently updated posts across the workspace when session_id is omitted.

  • List Sessions

    List workspace sessions with their post and surface counts so a session can be selected for publishing or post filtering.

  • Publish Post

    Publish a post with one or more ordered typed surfaces, using an existing session or automatically creating one when session_id is omitted.

  • Update Post

    Update a post title and/or the primary content of one surface while preserving that surface's kind and metadata; creates a retained version.

Setup

Setup guide

  1. 11. Open your Switchy workspace and navigate to Settings > Integrations. 2. Click 'Add Integration' and select Sideshow from the developer tools category. 3. In a separate tab, log into your Sideshow workspace and go to Settings > API Keys. 4. Generate a new API key with read and comment permissions, then copy it. 5. Paste the key into Switchy's connection dialog and click 'Connect'. 6. Switchy will verify the key by listing your sessions — you'll see a green checkmark when it succeeds. 7. Open any Project and type '@Sideshow list sessions' to confirm the integration works. 8. If you see session names and post counts, you're ready to use Sideshow tools in any prompt.

What teammates see: by default, memories from Sideshow are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

Summarize Session Feedback

@Sideshow list comments from session 'Q1 Homepage Redesign' and summarize the feedback by category. Highlight any blocking issues mentioned more than once.

Draft Comment Responses

@Sideshow get post 'Navigation Spec v3' with comments, then draft responses to the three most recent unanswered questions. Keep replies under 50 words each.

Track Version Changes

@Sideshow get post 'API Authentication Flow' and list what changed between the last two versions. Note who made each change and any comments that explain why.

Flag Unresolved Items

@Sideshow list all comments from session 'Sprint 12 Review' and identify which ones have no replies or follow-up. Group them by post title.

Generate Session Changelog

@Sideshow list posts from session 'Feature Spec Archive' and create a changelog showing what was published, who commented, and key decisions made.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@sideshow list all posts from our last design review session and show me which ones have unresolved comments

Output

Found 7 posts in session 'Design Review - Q1 Navigation'. 3 posts have active comment threads: Post #142 'Mobile nav hierarchy' (4 comments, last by Sarah 2h ago), Post #139 'Icon system updates' (2 comments, awaiting designer response), Post #135 'Accessibility audit findings' (6 comments, marked for follow-up). The remaining 4 posts have no comments or all threads resolved. This represents a snapshot; comment counts reflect current state at query time.

Notes

This example demonstrates cross-tool coordination: listing posts filtered by session, then enriching with comment metadata. Requires read access to both posts and comments. Note that Sideshow sessions are workspace-scoped, so the user must specify or have context about which session to query.

Prompt

@sideshow create a new comment on post #142 summarizing the three accessibility concerns raised in the previous discussion

Output

Comment created successfully on post #142 'Mobile nav hierarchy'. The comment references keyboard navigation gaps, color contrast ratios below WCAG AA, and missing ARIA labels on icon buttons. Comment ID: cmt_8x2k9p, authored by AI assistant, timestamp 2024-01-15 14:32 UTC. This comment is now visible to all session participants and will appear in the post's comment thread chronologically.

Notes

This write operation shows the MCP's ability to contribute structured feedback into a design workflow. The comment persists in Sideshow's system and triggers any configured notifications. Users should verify the AI has sufficient context about 'previous discussion' before creating comments that reference prior work.

Prompt

@sideshow review the version history of post #135 and explain what changed between the initial draft and the current surface content

Output

Post #135 'Accessibility audit findings' has 4 retained versions. Initial draft (v1, Jan 12) outlined 8 high-priority issues with placeholder severity ratings. Version 2 (Jan 13) added WCAG criterion references and updated 3 issues to 'resolved' status. Version 3 (same day) restructured content using a table kit for better scanability. Current version (v4, Jan 14) incorporated team feedback: downgraded 2 issues to medium priority, added remediation timelines, and linked to related posts #139 and #142. The surface content reflects this final state.

Notes

This synthesis example highlights Sideshow's version retention feature, which the AI can parse to explain content evolution. Useful for understanding how design decisions progressed. The MCP returns structured version data; the AI interprets changes. Not all posts retain full history depending on workspace settings.

Use-case deep-dives

Design review with async feedback

When Sideshow beats Figma comments for engineering handoff

A 6-person product team ships weekly and needs design reviews that don't bottleneck on Zoom calls. Sideshow wins here because posts hold version history and comments thread across iterations—engineers see what changed between v2 and v3 without hunting Slack. The HTML kit tools let designers embed live prototypes that update without re-uploading. The trade-off: if your team already lives in Figma and rarely needs to reference old versions, the context switch to Sideshow adds friction. But if you're juggling Figma, Notion, and Linear for one handoff, consolidating review state in Sideshow cuts the median feedback loop from 36 hours to same-day. Worth the API key if your design-to-dev cycle is the sprint bottleneck.

Customer onboarding documentation

Sideshow for support teams managing versioned help content

A 3-person support team at a SaaS startup maintains onboarding docs that change every release. Sideshow's post versioning and comment threading make it viable for this—support can update a post, tag engineering in a comment, and the old version stays linked for customers on legacy plans. List Sessions and List Posts let you organize by product area or release cycle. The limitation: 10 tools means no native search or bulk export, so if you need full-text search across 200+ docs, you'll hit the API ceiling fast. Sideshow works when your knowledge base is under 50 posts and the value is in tracking what changed and why. If your docs are static and search-heavy, stick with Notion or Confluence.

Sprint retrospective action tracking

When Sideshow replaces your retro Miro board

A 5-person engineering team runs biweekly retros and loses action items in Miro exports or Slack threads. Sideshow's session-based posts and comment threading give each retro a permanent URL where action items live as comments, not screenshots. The HTML kits mean you can embed a burndown chart or incident timeline directly in the post surface. The catch: if your retro format is heavily visual (dot voting, affinity mapping), Sideshow's text-first model feels limiting—you'll still sketch in Miro and paste a link. But if your retros are mostly typed themes and follow-ups, Sideshow keeps the context in one place without the Notion tax of reformatting notes. Best fit for teams who treat retros as living documents, not one-time events.

Frequently asked

What does the Sideshow MCP do in Switchy?

The Sideshow MCP lets your AI agents read and write content in Sideshow sessions — posts, comments, and version history. Agents can list sessions, create or delete posts, attach comments, and retrieve HTML kits for styling. It's designed for teams using Sideshow as a collaborative workspace where AI needs to contribute or fetch context.

Do I need admin access to connect Sideshow MCP?

You need an API key from Sideshow, which typically requires workspace admin or developer permissions to generate. The key determines which sessions and posts the MCP can access. If your Sideshow workspace restricts API key creation, ask your admin to provision one with the scopes your team needs.

Can the Sideshow MCP edit existing posts or only create new ones?

The MCP can retrieve a post's current surface content and version history with Get Post, but the tool list doesn't include an explicit update or patch endpoint. To modify a post, you'd likely delete the old one and create a new version, or use Sideshow's native UI for in-place edits.

How does this compare to using Sideshow's web interface directly?

The MCP is faster for bulk operations — listing hundreds of posts, batch-creating comments, or pulling version history into an AI workflow. The web UI is better for rich formatting, real-time collaboration, and visual layout. Use the MCP when your agent needs programmatic access; use the UI when humans are drafting or reviewing.

Who on the team should connect the Sideshow MCP?

Whoever owns your Sideshow workspace's API keys — usually a developer or ops lead. They'll generate the key, paste it into Switchy's MCP config, and decide which sessions the AI can touch. Non-technical teammates can then invoke the MCP through Switchy's chat without handling credentials.

More developer tools MCPs

See all developer tools MCPs →

Data last verified 61 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.