robloxstudio-mcp

# Roblox Studio MCP

Connect your coding agent directly to Roblox Studio. It can edit places, run Luau
in live server and client contexts, start and stop playtests, and collect logs,
screenshots, memory reports, and profiler captures from each peer.

[![NPM Version](https://img.shields.io/npm/v/@chrrxs/robloxstudio-mcp)](https://www.npmjs.com/package/@chrrxs/robloxstudio-mcp)

## What it can do

### Debug a running game

- Run Luau with `eval_server_runtime` or `eval_client_runtime`. Both tools execute in a live server or client context and use the same `require` cache as your game scripts.
- Instrument live code with `breakpoints`. It records each hit without pausing the playtest.
- Read output from edit mode, the server, or a specific client with `get_runtime_logs`, including messages logged during startup.

### Automate playtests

- Start, inspect, and stop solo or multi-client sessions with `solo_playtest` and `multiplayer_playtest`.
- Open or close Studio windows with `manage_instance`. It can launch a baseplate, a local place file, a published place, or an older place revision.

### Find performance problems

- Record server or client CPU timings with `capture_script_profiler` and `capture_micro_profiler`. MicroProfiler captures are saved for re-analysis, and `capture_micro_profiler` also analyzes `.gprx` dumps from Studio's MicroProfiler.
- Break down memory use with `get_memory_breakdown` or attribute scene cost with `get_scene_analysis`.

### Work in edit mode

- Run Luau in Studio's edit context with `execute_luau`.
- Use `set_properties` for instance properties and `find_and_replace_in_scripts` for script text. For project-specific bulk edits, use `execute_luau`.
- For large generated Luau, use the [verified chunk-staging workflow](docs/large-inputs.md): explicit instance routing, UTF-8 byte/hash readback, ownership-checked cleanup, and bounded recovery without blindly replaying mutations.
- Use `selection` to inspect or update Studio selection and frame a part or model before capturing the viewport.
- Capture the viewport with `capture_screenshot`, then send mouse or keyboard input. See [Configuration](docs/configuration.md#host-window-capture).

### Inspect Creator Store assets

- Find public assets with `search_assets`, then read the full catalog metadata with `get_asset_details`.
- Check an asset's hierarchy, media metadata, and security scan with `preview_asset` before adding it to the place.
- Add an asset with `insert_asset`. The tool removes scripts and package links, verifies the cleaned result, and then parents it in Studio.

### Manage monetization

- List, create, and update developer products and game passes with `manage_monetization`. New items stay off sale unless you ask, and a name that already exists is refused because Roblox cannot delete these items. Requires an Open Cloud API key; see [Configuration](docs/configuration.md#environment-variables).

### Manage experience settings

- Read and change the experience titl