Connect your AI Agent to Scenario's creative engine

List Teams

List all teams available to the authenticated user. Call this first before tools that need team_id or project_id. Ar...

List Projects

List projects within a specific team. Use this after teams_list when an OAuth workflow needs a project_id. Args: -...

Search Assets & Models

Search for assets, models, or workflows by text, visual similarity, or filters. Args: - target: required — "assets...

Recommend a Model

Find the best Scenario platform/public model for a single generation task. Returns ranked models with real performanc...

Recommend Training Base

Recommend a Scenario base architecture for training a custom model (LoRA or voice clone) — NOT for picking a generati...

Plan a Generation Pipeline

Plan a multi-step generation pipeline for complex media requests (e.g. "product video with voiceover", "concept → 3D ...

Get Model Schema

Get the input parameter schema for any Scenario model. Call this before model_run to discover accepted fields, types,...

Run Model

Run any Scenario model to generate, edit, upscale, segment, post-process, or transform content. Across all assets kin...

Train Models

Manage the custom model training lifecycle. Actions cover dataset upload, training-image updates, pair mapping, confi...

Display Asset

Display a Scenario asset inline. ALWAYS use this tool to show images, videos, audio, and 3D models to the user instea...

Analyze Images

Run analysis tools on images or text. Actions include caption, describe_style, detect, embed, prompt_gen, and transla...

Upload Asset

Upload a local file to Scenario and return an asset_id for use in model_run, analyze, asset_display, or other asset-b...

Complete Upload

Finalize a multipart upload started by upload_asset. Call this only after every file part has been uploaded to the pr...

List Assets

List assets in the current project with heavy fields stripped. Args: - filters: optional — model_id, tags, type (s...

Get Asset

Get full details for one asset (all fields, including embedding and metadata). Args: - asset_id: required - team...

Update Asset

Update an asset's name, description, or tags. Args: - asset_id: required - metadata.name: optional new name - ...

Copy Asset

Duplicate an asset (creates a copy in the same project). Args: - asset_id: required - team_id, project_id: requi...

Download Asset

Request a download URL for an asset, optionally converting to a target format. Args: - asset_id: required - form...

Delete Assets

Delete one or many assets. Accepts a single ID or an array of IDs. Args: - asset_ids: required — array of one or m...

Get Assets (Bulk)

Fetch full details for multiple assets in a single request. Args: - asset_ids: required — array of asset IDs to fe...

List Asset Tags

List tags in the global tag namespace. The tag namespace is shared with models (same endpoint as model_list_tags). A...

Add Asset Tags

Add tags to an asset (additive — does not replace the existing tag set). Args: - asset_id: required - tags: requ...

Remove Asset Tags

Remove specific tags from an asset. Args: - asset_id: required - tags: required — array of tag names to remove ...

Usage

View Scenario API usage statistics for a date range. Default response is summarized (~1–3 KB regardless of activity ...

Capture 3D View

App-only tool. Capture the current 3D viewer canvas and upload it as a new image asset. Args: - image_base64: requ...

Proxy Asset Fetch

App-only tool. Fetch an asset binary by ID server-side for MCP App viewer rendering inside sandboxed hosts. Args: ...

Run Diagnostics

Diagnose Scenario MCP problems. Runs a live self-test with the caller's own credentials to identify the failing layer...

Check Job

Check one Scenario job — full status, progress, and result asset ids. Args: - job_id: required - team_id, projec...

List Jobs

List recent Scenario jobs (summarized for compact context). Args: - filters: optional {status, type} — e.g. {"stat...

Cancel Job

Cancel a queued or running Scenario job. Args: - job_id: required - team_id, project_id: required for OAuth call...

List Collections

List collections in the current project. Args: - limit: results per page (default 20, max 100) - page_token: pag...

Get Collection

Get full details for one collection. Args: - collection_id: required - team_id, project_id: required for OAuth c...

Create Collection

Create a new collection. (No description field — the API doesn't accept one.) Args: - name: required — name for th...

Update Collection

Update a collection's name or thumbnail. Args: - collection_id: required - name: optional new name - thumbnail...

Delete Collection

Delete a collection by ID. Args: - collection_id: required - team_id, project_id: required for OAuth callers Re...

Add Assets to Collection

Add assets to a collection. Args: - collection_id: required - asset_ids: required — array of asset IDs to add ...

Remove Assets from Collection

Remove assets from a collection. Args: - collection_id: required - asset_ids: required — array of asset IDs to r...

Add Models to Collection

Add models to a collection. Args: - collection_id: required - model_ids: required — array of model IDs to add ...

Remove Models from Collection

Remove models from a collection. Args: - collection_id: required - model_ids: required — array of model IDs to r...

List Models

List models with heavy fields stripped and deprecated capabilities filtered. Args: - filters: optional — privacy (...

Get Model

Get full details for one model (all fields, deprecated capabilities filtered). Args: - model_id: required - team...

Create Model

Create a new model. Args: - data: required — model payload. Common fields: name, shortDescription, tags, thumbnail...

Update Model

Update an existing model's metadata. Args: - model_id: required - data: fields to update. Common fields: name, s...

Delete Model

Delete a model. Args: - model_id: required - team_id, project_id: required for OAuth callers Returns: { deleted...

Copy Model

Duplicate a model (creates a copy). Args: - model_id: required - team_id, project_id: required for OAuth callers...

Transfer Model

Transfer a model to a different project. Args: - model_id: required - target_project_id: required — destination ...

Download Model

Request a download for a model's weights. Args: - model_id: required - team_id, project_id: required for OAuth c...

List Model Tags

List tags in the global tag namespace. The tag namespace is shared with assets (same endpoint as asset_list_tags). A...

Add Model Tags

Add tags to a model (additive — does not replace the existing tag set). Args: - model_id: required - tags: requi...

Remove Model Tags

Remove specific tags from a model. Args: - model_id: required - tags: required — array of tag names to remove ...

List Workflows

List visual workflows. Terminology: In Scenario, when a user says "apps" (e.g. "list my apps"), they usually mean wo...

Get Workflow

Get full details for one workflow. The response carries the workflow's definition fields named inputs_definition / e...

Create Workflow

Create a new visual workflow. Lifecycle: create / update persist editor_info + inputs as a DRAFT; they do NOT make t...

Update Workflow

Update an existing workflow's metadata or definition. Args: - workflow_id: required - name, description: optiona...

Delete Workflow

Delete a workflow. Args: - workflow_id: required - team_id, project_id: required for OAuth callers Returns: { d...

Run Workflow

Run a workflow. Args: - workflow_id: required - inputs: input values for the run (the request body). For array-t...

Approve Workflow Node

Approve a pending human-approval node in a running workflow. Args: - workflow_id: required - workflow_job_id: re...

Reject Workflow Node

Reject a pending human-approval node in a running workflow. Args: - workflow_id: required - workflow_job_id: req...

Publish Workflow

Publish a workflow: compile its stored editor_info into a runnable flow and flip status to "ready". Mirrors the weba...

Copy Workflow

Copy a workflow — retrieves the source and creates a new workflow carrying its description, flow, input definitions, ...

Manage Jobs (deprecated)

Deprecated — use job_check / jobs_list / job_cancel instead. Removed after 2026-07-06. Inspect or cancel Scenario jo...

Manage Collections (deprecated)

Deprecated — use collections_list / collection_get / collection_create / collection_update / collection_delete / coll...

Manage Assets (deprecated)

Deprecated — use assets_list / asset_get / asset_update / asset_copy / asset_download / asset_delete / assets_get_bul...

Manage Models (deprecated)

Deprecated — use models_list / model_get / model_create / model_update / model_delete / model_copy / model_transfer /...

Manage Workflows (deprecated)

Deprecated — use workflows_list / workflow_get / workflow_create / workflow_update / workflow_delete / workflow_run /...

get_model_schema (deprecated)

Deprecated — use `model_schema_get` instead. Removed after 2026-07-06. Returns the input parameter schema for a model.

run_model (deprecated)

Deprecated — use `model_run` instead. Removed after 2026-07-06. Runs any Scenario model to generate or transform cont...

list_teams (deprecated)

Deprecated — use `teams_list` instead. Removed after 2026-07-06. Lists teams available to the authenticated user.

list_projects (deprecated)

Deprecated — use `projects_list` instead. Removed after 2026-07-06. Lists projects within a team.

display_asset (deprecated)

Deprecated — use `asset_display` instead. Removed after 2026-07-06. Displays a Scenario asset inline.

complete_upload (deprecated)

Deprecated — use `upload_asset_complete` instead. Removed after 2026-07-06. Finalizes a multipart upload started by u...