Skip to content
Back to search

robloxstudio-mcp

MCP server for Roblox Studio runtime debugging, playtest control, screenshots/input, multiplayer testing, and per-peer server/client eval from AI agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Chrrxs/robloxstudio-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Chrrxs/robloxstudio-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/chrrxs--robloxstudio-mcp/badge.svg)](/listings/chrrxs--robloxstudio-mcp)

HTML

<a href="/listings/chrrxs--robloxstudio-mcp"><img src="/api/listings/chrrxs--robloxstudio-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Connect your client

Choose your MCP client below. Each setup installs the matching Studio plugin automatically.

<details> <summary>Codex CLI</summary>

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

</details>

<details> <summary>Claude Code</summary>

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

</details>

<details> <summary>Antigravity CLI</summary>

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

</details>

<details> <summary>Other clients (Cursor, Claude Desktop, etc..)</summary>

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

</details>

2. Restart Studio

Fully close and reopen Studio after installation or updates. When the plugin displays **Connected**, you're ready.

<details> <summary>Advanced setup</summary>

**Custom Plugins folder.** Set `MCP_PLUGINS_DIR` to use a custom location.

**Manual plugin installation.**

npx -y @chrrxs/robloxstudio-mcp@latest --install-plugin

Both editions prefer the bundled plugin. If it is missing, installation downloads the GitHub release matching the installed npm package version and validates the plugin's version and edition before replacing the installed file. This also applies to development versions; a missing matching release is an error.

</details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 199 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Roblox Studio MCP
  2. Connect your coding agent directly to Roblox Studio. It can edit places, run Luau
  3. in live server and client contexts, start and stop playtests, and collect logs,
  4. screenshots, memory reports, and profiler captures from each peer.
  5. [![NPM Version](https://img.shields.io/npm/v/@chrrxs/robloxstudio-mcp)](https://www.npmjs.com/package/@chrrxs/robloxstudio-mcp)
  6. ## What it can do
  7. ### Debug a running game
  8. - 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.
  9. - Instrument live code with `breakpoints`. It records each hit without pausing the playtest.
  10. - Read output from edit mode, the server, or a specific client with `get_runtime_logs`, including messages logged during startup.
  11. ### Automate playtests
  12. - Start, inspect, and stop solo or multi-client sessions with `solo_playtest` and `multiplayer_playtest`.
  13. - 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.
  14. ### Find performance problems
  15. - 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.
  16. - Break down memory use with `get_memory_breakdown` or attribute scene cost with `get_scene_analysis`.
  17. ### Work in edit mode
  18. - Run Luau in Studio's edit context with `execute_luau`.
  19. - Use `set_properties` for instance properties and `find_and_replace_in_scripts` for script text. For project-specific bulk edits, use `execute_luau`.
  20. - 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.
  21. - Use `selection` to inspect or update Studio selection and frame a part or model before capturing the viewport.
  22. - Capture the viewport with `capture_screenshot`, then send mouse or keyboard input. See [Configuration](docs/configuration.md#host-window-capture).
  23. - Record the viewport to MP4 with `capture_video` to review cutscenes, tweens, or animations. Each recording returns a storyboard image of evenly spaced frames. Requires Windows or WSL, plus FFmpeg 8+; see [Video recording](docs/configuration.md#video-recording).
  24. ### Inspect Creator Store assets
  25. - Find public assets with `search_assets`, then read the full catalog metadata with `get_asset_details`.
  26. - Check an asset's hierarchy, media metadata, and security scan with `preview_asset` before adding it to the place.
  27. - Add an asset with `insert_asset`. The tool removes scripts and package links, verifies the cleaned result, and then parents it in Studio.
  28. ### Manage monetization
  29. - 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).
  30. ### Manage experience settings
  31. - 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 need `confirm`, 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](docs/configuration.md#environment-variables).
  32. ### Look up Roblox APIs
  33. - Fetch official engine API documentation as Markdown with `get_roblox_docs`.
  34. - List and retrieve Roblox-authored skills with `get_roblox_skills`.
  35. See the [complete tool list](packages/core/src/tools/definitions.ts).
  36. ## Setup
  37. ### 1. Connect your client
  38. Choose your MCP client below. Each setup installs the matching Studio plugin automatically.
  39. <details>
  40. <summary>Codex CLI</summary>
  41. ```bash
  42. codex mcp add robloxstudio -- npx -y @chrrxs/robloxstudio-mcp@latest --auto-install-plugin
  43. ```
  44. </details>
  45. <details>
  46. <summary>Claude Code</summary>
  47. ```bash
  48. claude mcp add robloxstudio -- npx -y @chrrxs/robloxstudio-mcp@latest --auto-install-plugin
  49. ```
  50. </details>
  51. <details>
  52. <summary>Antigravity CLI</summary>
  53. ```bash
  54. agy mcp add robloxstudio -- npx -y @chrrxs/robloxstudio-mcp@latest --auto-install-plugin
  55. ```
  56. </details>
  57. <details>
  58. <summary>Other clients (Cursor, Claude Desktop, etc..)</summary>
  59. ```json
  60. {
  61. "mcpServers": {
  62. "robloxstudio-mcp": {
  63. "command": "npx",
  64. "args": ["-y", "@chrrxs/robloxstudio-mcp@latest", "--auto-install-plugin"]
  65. }
  66. }
  67. }
  68. ```
  69. </details>
  70. ### 2. Restart Studio
  71. Fully close and reopen Studio after installation or updates.
  72. When the plugin displays **Connected**, you're ready.
  73. <details>
  74. <summary>Advanced setup</summary>
  75. **Custom Plugins folder.** Set `MCP_PLUGINS_DIR` to use a custom location.
  76. **Manual plugin installation.**
  77. ```bash
  78. npx -y @chrrxs/robloxstudio-mcp@latest --install-plugin
  79. ```
  80. Both editions prefer the bundled plugin. If it is missing, installation downloads
  81. the GitHub release matching the installed npm package version and validates the
  82. plugin's version and edition before replacing the installed file. This also
  83. applies to development versions; a missing matching release is an error.
  84. </details>
  85. <details>
  86. <summary>Native Linux (Wine)</summary>
  87. On native Linux, Studio runs under Wine. To let the server launch and close it,
  88. set `ROBLOX_STUDIO_WINE_LAUNCHER` to an executable script and `ROBLOX_STUDIO_EXE`
  89. to `RobloxStudioBeta.exe` inside your Wine prefix. The server runs
  90. `<launcher> <RobloxStudioBeta.exe path> <Studio arguments...>`; the launcher sets
  91. up the prefix and display, then must `exec wine "$@"` so Studio keeps its PID.
  92. See [Native Linux with Wine](docs/configuration.md#native-linux-with-wine).
  93. </details>
  94. ## Inspector edition
  95. Read-only access to the DataModel.
  96. [![NPM Version](https://img.shields.io/npm/v/@chrrxs/robloxstudio-mcp-inspector)](https://www.npmjs.com/package/@chrrxs/robloxstudio-mcp-inspector)
  97. <details>
  98. <summary>Installation and permissions</summary>
  99. No DataModel or script edits. The selection tool can change editor selection and
  100. camera framing; export and profiler tools can write files only to explicit local
  101. paths, except that `capture_micro_profiler` keeps its 10 most recent captures in
  102. the system temp directory.
  103. Install only one variant at a time (the installers remove the other automatically):
  104. **Codex CLI**
  105. ```bash
  106. codex mcp add robloxstudio-inspector -- npx -y @chrrxs/robloxstudio-mcp-inspector@latest --auto-install-plugin
  107. ```
  108. **Claude Code**
  109. ```bash
  110. claude mcp add robloxstudio-inspector -- npx -y @chrrxs/robloxstudio-mcp-inspector@latest --auto-install-plugin
  111. ```
  112. **Antigravity CLI**
  113. ```bash
  114. agy mcp add robloxstudio-inspector -- npx -y @chrrxs/robloxstudio-mcp-inspector@latest --auto-install-plugin
  115. ```
  116. **Other clients (Cursor, Claude Desktop, etc.)**
  117. ```json
  118. {
  119. "mcpServers": {
  120. "robloxstudio-inspector": {
  121. "command": "npx",
  122. "args": ["-y", "@chrrxs/robloxstudio-mcp-inspector@latest", "--auto-install-plugin"]
  123. }
  124. }
  125. }
  126. ```
  127. </details>
  128. ## Documentation
  129. | Topic | Guides |
  130. | --- | --- |
  131. | **Setup & usage** | [Configuration and HTTP bridge](docs/configuration.md) · [Large inputs & recovery](docs/large-inputs.md) · [Creator Store assets](docs/creator-store-assets.md) |
  132. | **Development** | [Building from source](docs/building-from-source.md) · [API migration](docs/deprecated-api.md) · [Token budgets](docs/token-efficiency.md) |
  133. ---
  134. [Report issues](https://github.com/chrrxs/robloxstudio-mcp/issues) · [Report a security vulnerability](SECURITY.md) · MIT Licensed · Based on [boshyxd/robloxstudio-mcp](https://github.com/boshyxd/robloxstudio-mcp) v2.7.0

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.