Ghostfeed MCPLibrary
Image collections and registered products, the workspace's own reusable assets. Discover ids here to mention collections or weave products into slideshows.
GET /api/v2/collections
READMCP twin: list_collections
List the workspace's image collections (the user's own saved images): id, name, image count, dashboardUrl, and summary, one line saying what the images actually show. Read the summary to pick which collection is worth opening rather than guessing from its name, then browse that one with list_collection_images and cast the images you want with set_slide_background (type collection). Call this BEFORE building a deck that should feature the user's own images.
{
"type": "object",
"properties": {
"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"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}{
"success": true,
"data": {
"workspace": {
"id": "6a18c36ee586c7e44e4ece67",
"name": "Client A",
"slug": "client-a"
},
"collections": [
{
"id": "64f1c2a1b2c3d4e5f6073000",
"name": "Skincare UGC",
"imageCount": 24,
"summary": "24 close-up product shots of skincare bottles and droppers on clean neutral backgrounds.",
"dashboardUrl": "https://ghostfeed.ai/w/client-a/collections/64f1c2a1b2c3d4e5f6073000?ref=agent"
}
],
"total": 1,
"page": 1,
"pages": 1,
"nextSteps": "To feature a collection's images in a deck, browse it with list_collection_images and cast the ones you want with set_slide_background (type collection)."
}
}GET /api/v2/products
READMCP twin: list_products
List the workspace's registered products: id, name, description, url, dashboardUrl, and linkedCollections (the product's OWN photo collections, each with its own dashboardUrl). To plug a product, weave it into ONE slide in a soft peer-recommendation voice: browse a linked collection with list_collection_images and cast a real product image on that slide with set_slide_background. Call this BEFORE building a deck that should plug a product.
{
"type": "object",
"properties": {
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"description": "Per page (max 40; lower than other tools because these rows carry long descriptions). Each tool documents its own default.",
"type": "integer",
"minimum": 1,
"maximum": 40
},
"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"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}{
"success": true,
"data": {
"workspace": {
"id": "6a18c36ee586c7e44e4ece67",
"name": "Client A",
"slug": "client-a"
},
"products": [
{
"id": "64f1c2a1b2c3d4e5f6074000",
"name": "GlowSerum Vitamin C",
"description": "A brightening vitamin C serum for daily use.",
"dashboardUrl": "https://ghostfeed.ai/w/client-a/products/64f1c2a1b2c3d4e5f6074000?ref=agent",
"url": "https://client-a-store.com/products/glowserum-vitamin-c",
"linkedCollections": [
{
"id": "64f1c2a1b2c3d4e5f6073000",
"name": "Skincare UGC",
"dashboardUrl": "https://ghostfeed.ai/w/client-a/collections/64f1c2a1b2c3d4e5f6073000?ref=agent"
}
]
}
],
"total": 1,
"page": 1,
"pages": 1,
"nextSteps": "To plug a product, weave it into ONE slide in a soft peer-recommendation voice: a product's linkedCollections are its OWN photo collections - browse one with list_collection_images and cast a product image on that slide with set_slide_background."
}
}