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

Prompt Spark

Turn a target model + (optional) idea into ready-to-run model calls with Scenario Prompt Spark v3, before calling mod...

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 Asset

Analyze a Scenario asset and/or text with Scenario LLM — flexible, instruction-driven analysis (caption, describe, cl...

Caption Asset

Generate a caption for a Scenario image asset. Fast, purpose-built captioning. Args: - asset_id: required — the im...

Describe Asset Style

Describe the visual style of a Scenario image asset (medium, palette, lighting, composition, mood) as a reusable refe...

Detect Structural Map

Extract a structural control-map from a Scenario image — canny edges, depth, pose, segmentation, normal, scribble, sk...

Upload Asset

Upload a local file to Scenario and return an asset_id for use in model_run, asset_analyze, asset_display, or other a...

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

Analyze (deprecated)

Deprecated — use asset_caption / asset_describe / asset_detect instead. Removed after 2026-07-06. Routes legacy acti...

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