Roblox Studio MCP is an open-source Model Context Protocol server that gives AI coding agents — Claude, Codex, Cursor, Gemini, or any MCP-compatible tool — direct, live access to a running Roblox Studio session. Instead of copy-pasting scripts and manually checking output, your agent can evaluate Luau on the server VM, capture profiler samples, control playtests, read logs, take viewport screenshots, and make bulk edits to your place — all without you switching windows.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Chrrxs/robloxstudio-mcp/llms.txt
Use this file to discover all available pages before exploring further.
Why this server
Most AI-assisted game development stops at static file analysis. Roblox Studio MCP closes that gap by bridging the agent to a live Studio session through a lightweight HTTP plugin. Once connected, the agent can do things that are impossible with file reads alone:- Runtime eval — Execute Luau on the server VM or a specific client peer, sharing the same
requirecache as your running scripts. Inspect live state, call service methods, and read DataStore values mid-playtest. - Playtest control — Start, inspect, and end solo or multiplayer playtests through
solo_playtestandmultiplayer_playtestlifecycle tools. No hidden companion-tool discovery required. - Log breakpoints — Instrument live code with log breakpoints that fire during a running playtest, without pausing execution or restarting the session.
- Script Profiler captures — Trigger server or client CPU profiler samples on demand and get ranked hotspot summaries with microsecond timing and debug labels.
- Bulk editing — Apply mass property changes, script search-and-replace, attribute and tag operations across an entire place in a single agent turn.
- Viewport screenshots — Capture the current Studio viewport and send it to the agent for visual inspection, plus virtual mouse, keyboard, and UI interaction.
- Multiplayer testing — Spin up multi-client playtests, route eval calls to individual clients by
instance_id, and read per-peer memory stats and Scene Analysis attribution. - Instance management — Launch new Studio windows, close specific connected instances, and list or restore place versions for revision launches.
Two editions
The project ships two npm packages. Choose based on how much write access you want the agent to have:| Full Edition | Inspector Edition | |
|---|---|---|
| Package | @chrrxs/robloxstudio-mcp | @chrrxs/robloxstudio-mcp-inspector |
| Plugin file | MCPPlugin.rbxmx | MCPInspectorPlugin.rbxmx |
| Tool count | 77 | 36 |
| Writes / edits | ✅ | ❌ |
| Runtime eval | ✅ | ❌ |
| Playtest control | ✅ | ❌ |
| Read / inspect | ✅ | ✅ |
| Best for | Active development, debugging, automation | Code review, architecture exploration, safe auditing |
Install only one plugin variant at a time. Do not leave both
MCPPlugin.rbxmx and MCPInspectorPlugin.rbxmx in Studio’s Plugins folder — Studio will load both and can register duplicate runtime peers. The CLI installers remove the other variant automatically before installing.Feature highlights
Runtime Eval
Execute Luau on the server VM or any connected client peer, sharing the live
require cache. Read DataStore values, inspect service state, and call game logic mid-playtest.Playtest Lifecycle
Start solo or multi-client playtests, add players, inspect state, and end sessions through unified
solo_playtest and multiplayer_playtest tools.Log Breakpoints
Instrument running code with log breakpoints that capture output at a specific call site without halting the playtest or restarting Studio.
Script Profiler
Trigger CPU profiler captures for server or client peers on demand. Get ranked hotspot summaries with debug labels and microsecond timing.
Bulk Operations
Apply mass property writes, script search-and-replace, attribute updates, and tag operations across an entire large place in a single agent call.
Viewport Screenshots
Capture the live Studio viewport for visual inspection. Combine with virtual mouse and keyboard input to interact with in-game UI.
Instance Management
Launch and close Studio windows, list place versions, and reopen a specific revision in a managed Studio instance for safe historical inspection.
Multi-Place Routing
Connect multiple open Studio places to the same MCP server. Use
get_connected_instances and instance_id to route tool calls to the right game.