{
  "info": {
    "name": "Sideshow — mcp.ai",
    "description": "REST API for the Sideshow MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/sideshow",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "sideshow_create_comment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/comment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "comment"
          ]
        },
        "description": "Create a text comment attached to a post.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"text\": \"\",\n  \"author\": \"\",\n  \"post_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "sideshow_delete_comment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/comment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "comment"
          ]
        },
        "description": "Permanently delete one comment by id.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"comment_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "sideshow_delete_post",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/post",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "post"
          ]
        },
        "description": "Permanently delete one post by id.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"post_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "sideshow_get_post",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/post",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "post"
          ]
        },
        "description": "Get one post with current surface content and retained version history.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"post_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "sideshow_list_comments",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/comments",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "comments"
          ]
        },
        "description": "List currently available comments, optionally filtered by session, post, author, or sequence number. This call never long-polls.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"author\": \"\",\n  \"post_id\": \"\",\n  \"session_id\": \"\",\n  \"after_sequence\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "sideshow_list_kits",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/kits",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "kits"
          ]
        },
        "description": "List the HTML style and behavior kits available to use in post surfaces.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "sideshow_list_posts",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/posts",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "posts"
          ]
        },
        "description": "List compact post summaries from one session, or the most recently updated posts across the workspace when session_id is omitted.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"session_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "sideshow_list_sessions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/sessions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "sessions"
          ]
        },
        "description": "List workspace sessions with their post and surface counts so a session can be selected for publishing or post filtering.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "sideshow_publish_post",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/publish/post",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "publish",
            "post"
          ]
        },
        "description": "Publish a post with one or more ordered typed surfaces, using an existing session or automatically creating one when session_id is omitted.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"agent\": \"\",\n  \"title\": \"\",\n  \"surfaces\": \"\",\n  \"session_id\": \"\",\n  \"session_title\": \"\",\n  \"working_directory\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "sideshow_update_post",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/post",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "post"
          ]
        },
        "description": "Update a post title and/or the primary content of one surface while preserving that surface's kind and metadata; creates a retained version.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"kits\": \"\",\n  \"title\": \"\",\n  \"content\": \"\",\n  \"post_id\": \"\",\n  \"surface\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}