get_generation_status
Get a slideshow's progress with Wavegrain's MCP server: the get_generation_status tool needs the read permission. Inputs, outputs and an example call.
Get a slideshow's progress. Permission: read. Read-only: changes nothing.
Where a generate_slideshow or copy_post run stands: writing, making_images, ready or failed, with slideshowId and cost. Poll every 20 seconds or so.
Inputs
| Input | Type | Required | Notes |
|---|---|---|---|
jobId | string | yes | The jobId generate_slideshow or copy_post answered. up to 100 characters |
The fields inside an object or a list are in the JSON Schema at /developers/mcp-tools.json.
Returns
| Field | Type | Notes |
|---|---|---|
jobId | string | The job. |
kind | "canvas" | "tailored" | tailored: a copy_post slideshow; read it with get_tailored_slideshow and change it with edit_tailored_slideshow. |
state | "writing" | "making_images" | "needs_images" | "ready" | "failed" | needs_images: the slides are made, but those in emptySlides have no image yet, so it does not export until they get one. |
slideshowId | string | null | The slideshow, once it exists. |
creditsCharged | number | null | Credits charged, set when the job ends and not updated after; null while it waits or runs, or if the job crashed. |
emptySlides | number[] | Slides with no image right now, read from the slideshow itself. |
styleId | string | copy_post only: the look, for another post in it (copy_post with styleId and a topic). |
queuePosition | number | null | While it waits to start: its place in line (1 starts next). |
message | string | null | Why it failed; null unless state is failed. |
note | string | What to do next. |
Example call
Send it to POST https://wavegrain.com/api/mcp with an access key that has the read permission; Authentication shows how to make one.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_generation_status",
"arguments": {
"jobId": "<jobId>"
}
}
}
The call shows only the required inputs, with placeholder values: put your own in.
Related tools
search_inspiration: Search the Inspiration libraryget_playbook: Get the slideshow playbookestimate_cost: Estimate creditsget_checkout_link: Get a link to buy creditslist_review_links: List client review linkslist_automations: List automations- All 79 tools
Something wrong or missing? Write to support@wavegrain.com.