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

InputTypeRequiredNotes
jobIdstringyesThe 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

FieldTypeNotes
jobIdstringThe 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.
slideshowIdstring | nullThe slideshow, once it exists.
creditsChargednumber | nullCredits charged, set when the job ends and not updated after; null while it waits or runs, or if the job crashed.
emptySlidesnumber[]Slides with no image right now, read from the slideshow itself.
styleIdstringcopy_post only: the look, for another post in it (copy_post with styleId and a topic).
queuePositionnumber | nullWhile it waits to start: its place in line (1 starts next).
messagestring | nullWhy it failed; null unless state is failed.
notestringWhat 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.

Something wrong or missing? Write to support@wavegrain.com.