Agent

MCP agent

Give a compatible external agent authenticated project, knowledge, and live runtime tools.

What MCP can do

Build projects

Read project files and create, update, or fork simulations in the authenticated workspace.

read_file: Read a simulation project file. Supports cross-simulation reads with simulationId.
update_simulation: Update the recursive project files of a simulation owned by the caller.
create_simulation: Create a simulation from a recursive project map.
fork_simulation: Fork an existing simulation into a new owned project.

Discover and plan

Search public work, inspect references and configuration, discover engines, plan execution, and validate projects.

search_public_simulations: Search public simulations by text and tags.
get_platform_documentation: Get the canonical simulation authoring, architecture, optimization, and validation guidance.
list_simulation_capabilities: Discover registered engines, renderers, runtimes, bridges, asset loaders, and templates.
plan_simulation_execution: Build a machine-readable engine-to-renderer execution plan.
get_simulation_reference: Fetch a complete simulation project as a reusable reference.
get_simulation_config: Read config.json for a simulation, including broken simulations.
validate_simulation: Validate simulation configuration and browser-executed source before deployment.

Control live simulations

Open a simulation, inspect state and logs, control playback, set parameters, find bodies, and manipulate Rapier bodies.

get_simulation_state: Read state, globals, tick, entity count, and recent events from the active runtime.
find_simulation_bodies: Find worker-local Rapier bodies by stable ID, type, group, tag, body type, or shape. Optional position filters are evaluated on demand.
manipulate_simulation_body: Manipulate one exact worker-local Rapier body by stable entity ID.
rapier_command: Dispatch an advanced portable or native command inside the active Rapier worker. Bodies are addressed by stable entity ID and native objects remain worker-local.
dispatch_command: Start, pause, reset, or advance the active simulation session.
set_parameter: Set a declared runtime parameter on the active simulation.
open_simulation: Navigate the connected browser to a simulation.
get_simulation_logs: Read recent errors and logs from the active simulation runtime.

Connect a client

1. Create credentials
Create an MCP connection from settings.
2. Configure the client
Add the Streamable HTTP endpoint and bearer token.
3. Open a runtime
Live runtime tools become useful when a connected browser has an active simulation.

MCP access is limited to the published tool contracts. Project mutations use the authenticated account; runtime tools act on the simulation open in the connected browser.

Open MCP settings