Ghostfeed MCPSlideshows
List and review TikTok photo slideshows: every variant, its slides, texts, and background provenance. Agents build decks with the Studio tools; these read them back.
GET /api/v2/slideshows
READMCP twin: list_slideshows
List slideshow projects in the active workspace, latest activity first: id, name, variant count, whether one is still generating, and the dashboard url.
{
"type": "object",
"properties": {
"workspace": {
"description": "Target workspace: a slug, id, or exact name from list_workspaces. Omit to use this connection's default workspace. Must be inside the credential's grant and your current access; overrides the connection-level X-Workspace-Id header.",
"type": "string"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"description": "Per page (max 100). Each tool documents its own default.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}{
"success": true,
"data": {
"workspace": {
"id": "6a18c36ee586c7e44e4ece67",
"name": "Client A",
"slug": "client-a"
},
"slideshows": [
{
"id": "64f1c2a1b2c3d4e5f6072000",
"name": "5 Morning Habits That Changed My Skin",
"variants": 2,
"processing": false,
"updatedAt": "2026-07-18T11:42:30.000Z",
"dashboardUrl": "https://ghostfeed.ai/w/client-a/slideshows/64f1c2a1b2c3d4e5f6072000?ref=agent"
}
],
"total": 9,
"pages": 1,
"page": 1
}
}GET /api/v2/slideshows/:id
READMCP twin: get_slideshow
Read a slideshow's full anatomy: every variant with status, caption, and per-slide texts + background image url + provenance (backgroundSource: ai | pinterest | collection | avatar | image). Variant status is pending | processing | ready | failed (the generation ledger maps ready to succeeded, pending to queued, processing to running). Use it to review what was generated; for the visually composed slides (text on image), send the user the dashboardUrl.
Path parameters: id (from the URL).
{
"type": "object",
"properties": {
"slideshowId": {
"type": "string",
"description": "The slideshow (project) id from list_slideshows or create_blank_slideshow."
},
"variant": {
"description": "Read only this variant index (1 = the base deck). Omit for the first page of all.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"description": "Per page (max 100). Each tool documents its own default.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"workspace": {
"description": "Target workspace: a slug, id, or exact name from list_workspaces. Omit to use this connection's default workspace. Must be inside the credential's grant and your current access; overrides the connection-level X-Workspace-Id header.",
"type": "string"
}
},
"required": [
"slideshowId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}{
"success": true,
"data": {
"workspace": {
"id": "6a18c36ee586c7e44e4ece67",
"name": "Client A",
"slug": "client-a"
},
"slideshow": {
"id": "64f1c2a1b2c3d4e5f6072000",
"name": "5 Morning Habits That Changed My Skin",
"dashboardUrl": "https://ghostfeed.ai/w/client-a/slideshows/64f1c2a1b2c3d4e5f6072000?ref=agent",
"createdVia": "mcp",
"variants": [
{
"id": "64f1c2a1b2c3d4e5f6072100",
"index": 1,
"status": "ready",
"statusMessage": "Composed successfully",
"caption": "the 5 habits that finally fixed my skin ✨ #skincare",
"slides": [
{
"position": 0,
"texts": [
"5 morning habits",
"that changed my skin"
],
"backgroundImageUrl": "https://cdn.ghostfeed.ai/slideshows/64f1/slide0.jpg",
"backgroundSource": "pinterest",
"isProductSlide": false
},
{
"position": 1,
"texts": [
"1. Ice roll for 60 seconds"
],
"backgroundImageUrl": "https://cdn.ghostfeed.ai/slideshows/64f1/slide1.jpg",
"backgroundSource": "ai"
}
]
}
],
"variantsTotal": 1,
"variantPage": 1,
"variantPages": 1
}
}
}