
chrrxs/robloxstudio-mcp
Developer toolsConnect 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...
Overview
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...
README
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.
What it can do
Debug a running game
- Run Luau with
eval_server_runtimeoreval_client_runtime. Both tools execute in a live server or client context and use the samerequirecache 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_playtestandmultiplayer_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_profilerandcapture_micro_profiler. MicroProfiler captures are saved for re-analysis, andcapture_micro_profileralso analyzes.gprxdumps from Studio’s MicroProfiler. - Break down memory use with
get_memory_breakdownor attribute scene cost withget_scene_analysis.
Work in edit mode
- Run Luau in Studio’s edit context with
execute_luau. - Use
set_propertiesfor instance properties andfind_and_replace_in_scriptsfor script text. For project-specific bulk edits, useexecute_luau. - For large generated Luau, use the verified chunk-staging workflow: explicit instance routing, UTF-8 byte/hash readback, ownership-checked cleanup, and bounded recovery without blindly replaying mutations.
- Use
selectionto 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.
Inspect Creator Store assets
- Find public assets with
search_assets, then read the full catalog metadata withget_asset_details. - Check an asset’s hierarchy, media metadata, and security scan with
preview_assetbefore 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.
Manage experience settings
- Read and change the experience title, description, server size, devices, voice chat, private server price, and social links with
manage_experience. Private server price changes needconfirm, which the agent sets itself, so it is not a human approval step. It cannot make an experience public or private: Open Cloud ignores visibility changes, and Roblox can refuse to make an experience public through an API key, so change visibility in Creator Hub. The agent can use every permission the key grants, so give the key only the scopes you want an agent to use. Requires an Open Cloud API key; see Configuration.
Look up Roblox APIs
- Fetch official engine API documentation as Markdown with
get_roblox_docs. - List and retrieve Roblox-authored skills with
get_roblox_skills.
See the complete tool list.
Setup
1. Connect your client
Choose your MCP client below. Each setup installs the matching Studio plugin automatically.
2. Restart Studio
Fully close and reopen Studio after installation or updates. When the plugin displays Connected, you’re ready.
Inspector edition
Read-only access to the DataModel.
Documentation
| Topic | Guides |
|---|---|
| Setup & usage | Configuration and HTTP bridge · Large inputs & recovery · Creator Store assets |
| Development | Building from source · API migration · Token budgets |
Report issues · Report a security vulnerability · MIT Licensed · Based on boshyxd/robloxstudio-mcp v2.7.0
Install
npx -y @chrrxs/robloxstudio-mcp@latest --auto-install-pluginConfiguration
{
"mcpServers": {
"robloxstudio-mcp": {
"command": "npx",
"args": ["-y", "@chrrxs/robloxstudio-mcp@latest", "--auto-install-plugin"]
}
}
}