Skip to main content
Studio registers its own capabilities as WebMCP tools, so an AI agent running in your browser can read what Studio knows and make the same edits you can.
This is not the same as creating through an AI chat. That page covers the hosted HyperFrames MCP connector, which builds and renders a video from a conversation. This page is about an agent working inside Studio, on a composition already open in front of you.

​
What it looks like

With the tools available, an agent can inspect the source-backed scene, make one targeted edit, and check the result:
The last one matters most. It is what lets an agent judge a change instead of guessing at it.

​
Turning it on

The tools register automatically when Studio loads. Whether an agent can reach them depends on the browser. For local development in Chrome, enable the flag and restart:
chrome://flags
Then confirm the tools are there from Studio’s console:
Registration is asynchronous, so a caller that reads getTools() the instant Studio loads can see a partial list. Wait for the toolchange event, or poll until the count settles at twelve.
The API is document.modelContext, not navigator.modelContext. Many published examples use the second one. It is a compatibility shim some polyfills add, not part of the specification, so feature-detecting it will mislead you.
On browsers without native support, Studio loads a bundled polyfill so a WebMCP bridge extension can still connect. Nothing is downloaded on a browser that has the API already. When the Studio preference is disabled, it registers no tools.

​
What an agent can do

​
Read

Each element returned by studio_look has a handle. It also reports sourceFile, parentHandle, depth, and childCount, so an agent can distinguish the same authored ID in two nested scene files. Pass a handle back unchanged to every element write. Handles are source-safe addresses, not CSS selectors.

​
Change

Element writes run through the same commit actors Studio uses. When that actor forwards versioned durability evidence, the receipt names the source file and content version, and the edit enters the same undo history. Actors without that evidence stay at dispatched.

​
Two rules worth knowing

Show intent, then address every write explicitly. Before the first write to a target, call studio_select so the person in Studio sees the same selection box and inspector as the agent. Selection communicates intent; it does not grant write authority. studio_set_text, studio_set_style, studio_transform, and the animation tools still require that target’s handle from studio_look, so a later human click cannot redirect an already-addressed write. Read the receipt stage. A write result separates acceptance from proof: changed is separate from the stage. A saved no-op is still truthful: the file accepted the request, but the value was already present. Style writes include a receipt per property and can be partial. Animation handlers currently report dispatched after their persistence and live-preview sync settle; they do not claim versioned durability or independent readback when the underlying handler cannot provide that evidence. A late cancellation request also does not undo an edit that was already dispatched or saved.

​
Working alongside an agent

This is built for you and an agent looking at the same composition. Studio shows selection normally and adds a Topology Lens around the addressed element while a transaction is resolving. A new target is acquired, repeated edits localize more quickly, and a durable result seals. The lens is Studio-only transaction feedback: it is not added to authored HTML, the preview iframe, captured frames, or thumbnails. When a write tool finishes successfully, the open Studio preview has already synchronized that edit. The person watching does not need to scrub the timeline or refresh the browser to see it. After an accepted source-file change, Studio advances the project thumbnail revision and regenerates visible composition thumbnails. This lets the sidebar converge on the saved project instead of continuing to show cached pre-edit pixels.
Studio refuses agent writes while auto-save is paused or an external change to the file is waiting for your decision, and tells the agent why. Resolve the banner and it can continue.

​
Turning it off

There is no settings toggle yet. The switch is a Studio preference, so set it from the console and reload:
Read the existing object and spread it, as above. Writing {agentToolsEnabled: false} on its own replaces the whole preferences blob and loses your panel sizes, zoom and timeline settings. Set it back to true, or delete the key, to re-enable. The browser gates tool access behind its own permission prompt, so registering a tool is not the same as granting access to it. How often you are asked, once per site or every call, is up to the browser and is still changing while the API is in origin trial.