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_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.
• 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.
• Capture the viewport with capture_screenshot, then send mouse or keyboard input.

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.

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. Add the server to your MCP client. --auto-install-plugin also installs the matching Studio plugin:

# Claude Code
claude mcp add robloxstudio -- npx -y @chrrxs/robloxstudio-mcp@latest --auto-install-plugin

# Codex CLI
codex mcp add robloxstudio -- npx -y @chrrxs/robloxstudio-mcp@latest --auto-install-plugin

# Gemini CLI
gemini mcp add robloxstudio npx --trust -- -y @chrrxs/robloxstudio-mcp@latest --auto-install-plugin

2. After the plugin is installed or updated, fully close and reopen Studio. The plugin shows Connected when it is ready.

Multiple open places can connect to the same server. Call get_connected_instances, then pass the returned place's id as instance_id with later tool calls.

Set MCP_PLUGINS_DIR to use a custom Plugins folder. For a manual plugin install, run npx -y @chrrxs/robloxstudio-mcp@latest --install-plugin.

Other MCP clients (Claude Desktop, Cursor, etc.)

{
  "mcpServers": {
    "robloxstudio-mcp": {
      "command": "npx",
      "args": ["-y", "@chrrxs/robloxstudio-mcp@latest", "--auto-install-plugin"]
    }
  }
}

On Windows, wrap with cmd /c if npx doesn't resolve:

{
  "mcpServers": {
    "robloxstudio-mcp": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@chrrxs/robloxstudio-mcp@latest", "--auto-install-plugin"]
    }
  }
}

Inspector edition (DataModel read-only)

24 Studio-safe inspection tools: no DataModel or script edits. Export and profiler tools can still write files only to explicit local paths. Install only one variant at a time (the installers remove the other automatically):

claude mcp add robloxstudio-inspector -- npx -y @chrrxs/robloxstudio-mcp-inspector@latest --auto-install-plugin

More

• Configuration and HTTP bridge
• Creator Store asset workflow
• Report a security vulnerability
• Building from source
• 3.0 tool removals and replacements
• Token-efficiency contract and budget

---

v3.0.0

Report Issues · MIT Licensed · Based on boshyxd/robloxstudio-mcp v2.7.0