BeatBandit MCP

Tools

/

Shot / Media / Export

/

shot_list_query

shot_list_query

read
beta
auth: project:read
approval: never
status: v1

Read shot-list scope summaries, shots, recurring elements, and linked shot assets.

When to use

Use for read-only shot-list inspection by stable project id and scope.

Use when the caller wants a scope snapshot or linked shot assets without mutating anything.

When not to use

Do not use for generation or mutations.

Examples

“Show me the shots in this scene scope.”

“Read the recurring elements and linked assets for this shot-list scope.”

Anti-examples

  • Generate a new image for this shot.

Backend capabilities

shot_list.query

Linked resources

Tool calls may return resource_links pointing at these resource families.

shot_list_scope

Input schema

shot_list_query input
{
  "$ref": "./shot_list.query.input.json"
}

Output schema

shot_list_query output
{
  "$ref": "./shot_list.query.output.json"
}

← All toolsv1 · query_tool