Tools Reference

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

Rewrite an idea or draft prompt into on-model prompts with Scenario Prompt Spark v3, plus schema-valid parameters — r...

Train Models

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

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

Display Asset

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

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

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 (deprecated capabilities filtered). The long markdown description is NOT in the base r...

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

Get Job

Get one Scenario job — compact status row (status, progress, result asset ids). Args: - job_id: required - verbo...

Wait For Jobs

Wait for Scenario jobs to finish — blocks server-side until every job completes or the server wait budget (~180s) exp...

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 Team Members

List a team's members and pending invitations. Args: - team_id: required — team to list members for - response_f...

Invite Team Members

Invite people to a team by email (bulk). Each address receives an invitation email — members join when they accept. ...

Update Team Member Roles

Change the team role of one or more members (bulk). Requires a team admin (OAuth) or a team-scoped API key with the ...

Remove Team Members

Remove members from a team (bulk), and/or withdraw pending invitations. DESTRUCTIVE: removed members immediately lose...

List Project Members

List a project's members with their project roles. Args: - project_id: required — project to list members for - ...

Add Project Members

Add existing team members to a project (bulk). People must already be on the team — to bring in someone new, use team...

Update Project Member Roles

Change the project role of one or more members (bulk). Requires a project admin or team admin; other credentials get...

Remove Project Members

Remove members from a project (bulk). Their team membership and other projects are untouched. IMPORTANT: call projec...

List Project API Keys

List a project's API keys. Args: - project_id: required — project to list keys for - team_id: optional — require...

Get Project API Key

Get one project API key by id. Args: - project_id: required - key_id: required — the key's id (apiu_...) or api_...

Update Project API Key Role

Change a project API key's role or scopes. Args: - project_id: required - key_id: required — the key's id (apiu_...

Delete Project API Key

Delete a project API key. DESTRUCTIVE: the key stops working everywhere it is used — this cannot be undone. List keys...

Get API Key Creation Link

Get the Scenario portal link to create a new project API key. Creation is deliberately not performed via MCP — the se...

Usage

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

Run Diagnostics

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

Check Job (deprecated)

DEPRECATED: renamed to job_get. Will be removed on 2026-07-27. Same arguments; returns the compact row (verbose=true ...