---
title: "get_storyboard: Get a storyboard"
description: "Read a film: its settings, its cast, every scene by number with its prompts and the state of its still and its clip, each derived video with how many clips it has and whether it can render, the computed still order, and the history depth."
canonical_url: "https://meetkuro.com/agents/tools/get_storyboard/"
updated: 2026-11-03
locale: "en"
tool: "get_storyboard"
scopes: ["media.read"]
---

# get_storyboard

**Get a storyboard**

Read a film: its settings, its cast, every scene by number with its prompts and the state of its still and its clip, each derived video with how many clips it has and whether it can render, the computed still order, and the history depth. This is also the poll — a render's progress and, once it lands, the finished file's URL are both on this answer, so a caller waiting on work calls this and nothing else. `show` attaches the current stills of the scenes you name, so a judgement about a picture is made by looking at it.

## Scope

- `media.read` — Reads the account: media, uploads, boards, runs, Subjects, models and the balance.

## Behaviour

- **Read-only**: Reads the caller's own account and changes nothing.
- **Stays in the account**: Stays inside the caller's private Kuro account: any media provider it calls acts on Kuro's account, and the result is visible to no one else.
- **Idempotent**: Calling it again with the same arguments has no further effect.

## Inputs

| Name | Type | Required | Details |
| --- | --- | --- | --- |
| `storyboard_id` | string | yes | uuid |
| `show` | array of integer | no | at most 10 items |

## Example call

A `tools/call` request with the required arguments only, each a placeholder read off the schema. Replace them before sending.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_storyboard",
    "arguments": {
      "storyboard_id": "00000000-0000-4000-8000-000000000000"
    }
  }
}
```

## Input schema

As the server sends it in `tools/list`:

```json
{
  "type": "object",
  "properties": {
    "storyboard_id": {
      "type": "string",
      "format": "uuid"
    },
    "show": {
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0
      },
      "maxItems": 10
    }
  },
  "required": [
    "storyboard_id"
  ],
  "additionalProperties": false
}
```

## Related tools

- [`generate_scene_images`](https://meetkuro.com/agents/tools/generate_scene_images.md): Make the still pictures of the scenes you name.
- [`animate_scenes`](https://meetkuro.com/agents/tools/animate_scenes.md): Film the scenes you name, or every scene whose still is ready and whose clip is not.
- [`render_storyboard`](https://meetkuro.com/agents/tools/render_storyboard.md): Assemble a film's derived videos into MP4s.
- [`continue_scene`](https://meetkuro.com/agents/tools/continue_scene.md): Give a scene a still that is the LAST frame of another scene's clip, so the next shot picks up exactly where the previous one ended.
- [`get_workflow_run`](https://meetkuro.com/agents/tools/get_workflow_run.md): Read a workflow run, its recorded steps, generations, and current checkpoint.

---

## About Kuro

Kuro is an AI picture studio: prompt-driven images, clips, voice-overs and music, and storyboard-backed films with consistent characters across every scene.

Agents connect over MCP and can generate directly:

```
claude mcp add kuro https://api.meetkuro.com/mcp --transport http
```

The app is at https://app.meetkuro.com and requires an account.

Each guide, model page, comparison and free tool page on this site (not a tool's variants, and not the index pages) has a Markdown twin at its own URL plus `.md`, and so do /benchmarks/, the English /agents/ page (as /agents.md) and the MCP tool reference. Every tool: https://meetkuro.com/agents/tools/