# 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.

> Index of these docs: https://wavegrain.com/developers/llms.txt

**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](/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](/developers/authentication) shows how to make one.

```json
{
  "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`](/developers/mcp-tools/search_inspiration): Search the Inspiration library
- [`get_playbook`](/developers/mcp-tools/get_playbook): Get the slideshow playbook
- [`estimate_cost`](/developers/mcp-tools/estimate_cost): Estimate credits
- [`get_checkout_link`](/developers/mcp-tools/get_checkout_link): Get a link to buy credits
- [`list_review_links`](/developers/mcp-tools/list_review_links): List client review links
- [`list_automations`](/developers/mcp-tools/list_automations): List automations
- [All 79 tools](/developers/mcp-tools)
