Experimental. Bring Scenario image, video, 3D, PBR material and audio generation into Blender. Use scene captures and selected meshes as inputs, explore camera moves, and turn a written scene description into a greybox layout with Blockout. A compact composer, sidebar and local MCP server provide access from your scene. This is a Python extension with pinned SDK dependency wheels, licensed GPL-3.0-or-later. Read the known limitations before relying on a workflow; shared runtime and interface adoption remain in progress.
- Blender 5.0 or later, as declared in the extension manifest.
- A Scenario account with API access, an API key and its secret. See Obtain your API key and Scenario help for current account requirements.
- An internet connection and Blender's Allow Online Access setting enabled under Edit > Preferences > System > Network before contacting Scenario.
- Scenario generations and prompt helpers consume Creative Units (CU). Review the displayed estimate before Generate; models, parameters and references affect the cost. See costs and the limitations above.
- Download
scenario-<version>.zipfrom the releases page. Keep it zipped. Verify the download when checksums and attestations are supplied with that release. - Drag the ZIP onto a Blender window, or use Edit > Preferences > Get Extensions
Install from Disk. The extension appears as "Scenario" in Blender's Add-ons list.
- In Scenario, open Organization settings > API Keys > Add API Key and follow the instructions to obtain the key and secret.
- Open Edit > Preferences > Add-ons > Scenario. Leave Credentials set to Saved in Blender, paste the key and secret, then press Test connection. Choose an Output Folder for generated files.
Open Preferences > Add-ons > Scenario > Updates for repository setup,
update checks and Blender's native Get Extensions manager. The official repository
address is https://blender.scenario.com/repo/index.json; it becomes available after
the first verified adopted-package release. Enable Allow Online Access before
checking. Updates are installed only when you choose them in Blender.
A ZIP installed into Blender's local repository can still be updated with Install from Disk, followed by a restart. Adding the official repository does not migrate that installation's preferences or storage. See the update guide for fresh installs, compatibility and manual fallback.
The Blender Extensions terms restrict extensions whose functionality depends on external registration, keys or payments, including access to external services. Scenario requires an account and API credentials, so this extension is distributed through GitHub releases. Its manifest declares the permissions it uses and their reasons.
In the 3D viewport, press N and open Scenario, or use the Scenario button in the viewport header. Pick a lane and model, enter a prompt, add any required reference and inspect the estimate before Generate. Results appear in Generations and your Output Folder, with actions for viewing or importing supported media. The user guide describes each lane and its controls.
- Image: generate from text or reference images and use results as textures or references.
- Video: generate from prompts, images or scene playblasts.
- 3D: generate meshes or apply provider edit tasks to an exported selection. Safe in-place editing remains incomplete.
- Materials: generate PBR maps for selected meshes.
- Audio: generate speech, music or sound effects and add results to the sequencer.
- Render Image: use a scene capture and look references to produce a still.
- Render Video: work with timeline captures, a camera path planner and style references.
- Blockout: turn a scene description into a greybox layout, then refine or rebuild it.
- Prompt tools and model picker: browse models and prepare prompts; prompt helpers can spend credits.
- Floating composer: access the current lane from the viewport.
- Generations: inspect local results and available project history.
The local scenario-blender server connects an authorized agent to the open
scene and generation into it. The hosted mcp.scenario.com
server provides platform-wide collections, training, workflows and usage without
requiring Blender; connect both when needed.
The default local endpoint is http://127.0.0.1:9876/mcp. Agents (MCP) shows
its status and bearer token and provides client setup for Claude Code, Cursor,
Claude Desktop and Codex under the name scenario-blender. Treat the token and
copied setup as secrets. Connected agents can read the scene and request paid
work; arbitrary Python execution is a separate opt-in permission, disabled by default.
Use the MCP reference for complete client setup, tool contracts, security controls and headless configuration. The headless entry point is:
blender --background scene.blend --command scenario_blenderScenario API requests use an API key and secret. Saved Blender credentials are the default; Credentials > Environment explicitly selects an environment pair instead. The extension does not provide browser OAuth sign-in. The hosted Scenario MCP service has its own authentication, described in its linked docs. Blender stores saved credentials in its preferences, not an OS keychain.
Cost previews send prompts and parameters to https://api.cloud.scenario.com
while you edit, before Generate. Generation and prompt tools can upload files,
scene captures or exported meshes and spend credits. Catalogs and thumbnails
load from Scenario; cloud history loads when requested. Saved keys, prompts,
job state and media remain in Blender preferences, extension storage or output
files. Connected local agents can read your scene and request paid work using
your account. Read Privacy and data handling for destinations,
storage, clipboard use and current limits.
Start with the user guide, known limitations
and changelog. The documentation index links
architecture, integration status and developer references. The public HTML handbook address is
blender.scenario.com. Build HTML from the maintained
Markdown with make docs; see documentation builds
for website and single-file outputs.
Follow releases, or choose Watch > Custom > Releases on GitHub for release notifications.
Use Support for bug reports, feature requests and the information to include. Account, billing and API-key questions go to support@scenario.com or Scenario's in-app support. Never post credentials, bearer tokens or signed asset URLs in a public issue.
Report vulnerabilities privately through Security > Report a vulnerability or the contact in Security; do not open a public issue.
Read Contributing for the pinned environment, local checks,
portable tools and isolated Blender test loop. AGENTS.md is the
canonical conventions contract for humans and agents; agent tools
describes the shared commands. Follow the Code of Conduct.
Optional local hooks are installed with make hooks; see installation and scope.
Offline tests need no Scenario account. Live smoke tests spend credits and
require explicit authorization; they are outside the default checks.
Discover repository maintenance commands with
uv run --locked --no-env-file python -m tools --help from the repository root.
The assets check and assets optimize commands share the
documentation image policy with the unit suite.
Native CI covers Blender 5.0.1, 5.1.2 and 5.2.1 on Linux and Windows for pull requests. A separate informational workflow schedules Blender 5.1.2 checks on macOS Apple silicon and Windows x64 weekly; see run evidence and maintenance for its first hosted acceptance and failure tracking.
Scenario for Blender is one of several Scenario integrations. The plugins share
the Scenario name, the id scenario inside each host's namespace and the support
channel (support@scenario.com), not necessarily the same licence.
- Scenario for Unity, Unity package
com.scenarioinc.scenario. Scenario for Unity is MIT-licensed; this extension is GPL-3.0-or-later because Blender add-ons that import bpy must be GPL-compatible. - Scenario skills for agents (MIT).
- The Scenario MCP server provides Scenario tools outside Blender. The MCP guide explains how it relates to this extension's local server.
Copyright 2026 Scenario Inc. First-party extension code is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. It is distributed WITHOUT ANY WARRANTY; see LICENSE for the full text. First-party source headers and the extension manifest declare GPL-3.0-or-later, and the extension ZIP includes the same GPL text. Bundled dependencies, adopted sources and assets retain their original licences and notices; see the SDK bundle and source adoption. The bundled icon notice records the generator, font option and outstanding design-provenance review.
Blender's licence guidance requires a GPL-compatible licence for published add-ons using its Python API. The Blender Extensions Platform requires GPL-3.0-or-later for add-ons it hosts. This project distributes outside that platform and uses GPL-3.0-or-later for its first-party extension code.
The GPL grants no trademark rights: "Scenario" and the Scenario logo belong to Scenario Inc., and Blender is a registered trademark of the Blender Foundation; this extension is not affiliated with or endorsed by the Blender Foundation. See TRADEMARKS.md.
The local MCP design acknowledges Blender Lab's blender_mcp project (GPL-3.0-or-later, Blender Authors) as a design reference. Its project page describes the upstream implementation, which uses a separate stdio MCP server and TCP connection to its Blender add-on. This extension implements authenticated loopback HTTP, main-thread tool dispatch and an opt-in Python gate.
The SPZ reader reads Niantic's SPZ Gaussian splat format. The MCP protocol module supports protocol revisions 2025-06-18, 2025-03-26 and 2024-11-05.
The Scenario logo comes from the official skills repository; its original source licence is retained.
