Read-Only Inspector Edition for Safe Roblox Studio Review

The Inspector Edition (@chrrxs/robloxstudio-mcp-inspector) is a read-only variant of Roblox Studio MCP that gives AI agents visibility into a live Studio session without granting any write access. It has no tools that create, delete, or modify instances, scripts, properties, attributes, or tags — and no runtime eval or playtest control. What you get is a safe window into the structure and state of your place that an agent can browse, analyze, and explain without any risk of accidental changes.

When to use Inspector vs full edition

Scenario	Recommended edition
Reviewing inherited or unfamiliar code	Inspector
Architecture walk-throughs and documentation	Inspector
Security or dependency audits	Inspector
Pair-reviewing a PR in a live Studio session	Inspector
Debugging a live playtest	Full
Scripting, bulk editing, or place automation	Full
Starting / stopping playtests	Full
Runtime Luau eval	Full

The Inspector Edition is a good default for anyone who wants AI assistance without worrying about an agent accidentally overwriting a script or deleting a model. You can always switch to the full edition later by swapping the package name and reinstalling the plugin.

Install commands

The Inspector Edition uses the same --auto-install-plugin and --install-plugin flags as the full edition, with the package name @chrrxs/robloxstudio-mcp-inspector. The CLI installers automatically remove MCPPlugin.rbxmx from the Plugins folder before copying MCPInspectorPlugin.rbxmx.

Standalone plugin install

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

Register with your AI client

Claude Code
Codex CLI
Gemini CLI
Claude Desktop / Cursor

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

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

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

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

Windows — cmd wrapper variant:

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

After running the install command or updating the client config, fully close and reopen Roblox Studio so it picks up the new MCPInspectorPlugin.rbxmx from the Plugins folder.

Plugin variant conflict

Never leave both plugin files in the Plugins folder at the same time. If both MCPPlugin.rbxmx and MCPInspectorPlugin.rbxmx are present, Studio loads both on startup and they register as duplicate runtime peers. Tool calls will route unpredictably between the two plugins.The CLI installers (--install-plugin and --auto-install-plugin) handle this automatically — they remove the other variant before writing the new file. If you installed either plugin via the Creator Store or a direct file download, check the Plugins folder manually and remove the unwanted file before restarting Studio.

Plugins folder locations:

Platform	Path
Windows	`%LOCALAPPDATA%\Roblox\Plugins\`
macOS	`~/Documents/Roblox/Plugins/`

To use a custom path, set MCP_PLUGINS_DIR before running the install command:

MCP_PLUGINS_DIR="/path/to/custom/Plugins" npx -y @chrrxs/robloxstudio-mcp-inspector@latest --install-plugin

Available tools (36 read-only)

The Inspector Edition exposes 36 tools covering all read and inspection categories — none of which modify the place:

File tree inspection — browse the full instance hierarchy of the open place
Script reads — read source code from any Script, LocalScript, or ModuleScript
Script search — find scripts by name or content pattern across the entire place
Property reads — read instance properties, attributes, and tags
Log capture — read buffered Studio output logs
Memory stats — read per-peer memory usage via the Stats service
Scene Analysis — read Scene Analysis attribution data per connected peer
Viewport screenshot — capture a screenshot of the current Studio viewport
Instance discovery — list connected Studio instances and their metadata via get_connected_instances
Place version listing — list available published versions of the open place

No tools in the Inspector Edition write, create, delete, evaluate scripts, or control playtests.

Switching from Inspector to full edition

To upgrade from the Inspector Edition to the full edition, update your client configuration to use @chrrxs/robloxstudio-mcp instead of @chrrxs/robloxstudio-mcp-inspector, then run --install-plugin (or use --auto-install-plugin and restart the server). The CLI will remove MCPInspectorPlugin.rbxmx and copy MCPPlugin.rbxmx in its place. Fully close and reopen Studio to finish the swap.

Overview

Installation

Core Concepts

Read-Only Inspector Edition for Safe Roblox Studio Review

When to use Inspector vs full edition

Install commands

Standalone plugin install

Register with your AI client

Plugin variant conflict

Available tools (36 read-only)

Switching from Inspector to full edition

Build docs developers (and LLMs) love

Overview

Installation

Core Concepts

Documentation Index

​When to use Inspector vs full edition

​Install commands

​Standalone plugin install

​Register with your AI client

​Plugin variant conflict

​Available tools (36 read-only)

​Switching from Inspector to full edition

Build docs developers (and LLMs) love

When to use Inspector vs full edition

Install commands

Standalone plugin install

Register with your AI client

Plugin variant conflict

Available tools (36 read-only)

Switching from Inspector to full edition