roblox-studio-mcp · el4cteo — Claude Code skill: what it does, how to install
Skill connects an AI agent to the built-in Roblox Studio MCP server for editing and playtesting games.
MIT 1,200 installs ★ 131 updated 2026-11-03
npx skills add EL4CTEO/roblox-skills --skill roblox-studio-mcp -a claude-codeWhat roblox-studio-mcp does
The skill links an AI agent to the built-in Roblox Studio MCP server via stdio. The agent explores the DataModel tree, reads and modifies scripts, executes Luau code in edit, server, or client contexts, runs playtests, and captures console output. It requires a running Roblox Studio instance with the MCP server enabled in the Assistant menu.
The toolset supports viewport screenshots, input simulation, asset search, and subagent delegation. Query depth should be kept narrow to prevent performance drops in large places. In Rojo-based setups, files on disk remain the source of truth.
To establish the connection, enable the server in Studio settings and configure the client path. Always stop playtest sessions after verification and inspect inserted marketplace assets for backdoor scripts.
What it helps with
- explore the DataModel tree in Roblox Studio
- read and modify scripts from the AI agent
- execute Luau code in server and client contexts
- run playtests and inspect console output
- search and insert Creator Store assets
Example prompts for the agent
- Connect to Roblox Studio via MCP and locate player scripts
- Run a playtest and check the console output for script errors
- Execute Luau on the server to assert coin values
How to install roblox-studio-mcp
1Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-studio-mcp -a claude-code2Manually: put the files in place
~/.claude/skills/roblox-studio-mcp/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/roblox-studio-mcp/
1Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-studio-mcp -a codex2Manually: put the files in place
.agents/skills/roblox-studio-mcp/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-studio-mcp -a cursor2Manually: put the files in place
.cursor/skills/roblox-studio-mcp/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install EL4CTEO/roblox-skills skills/roblox-studio-mcp2Manually: put the files in place
.github/skills/roblox-studio-mcp/SKILL.md1Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-studio-mcp -a gemini-cli2Platform CLI
gemini skills install https://github.com/EL4CTEO/roblox-skills --path skills/roblox-studio-mcpManually: put the files in place
.devin/skills/roblox-studio-mcp/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-studio-mcp -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about roblox-studio-mcp
How to install roblox-studio-mcp in Claude Code?
Run npx skills add EL4CTEO/roblox-skills --skill roblox-studio-mcp -a claude-code, then refer to ~/.claude/skills/roblox-studio-mcp/SKILL.md.
What does roblox-studio-mcp do?
It bridges AI agents with Roblox Studio through a built-in MCP server to inspect DataModels, edit scripts, run Luau code, and automate playtests.
What is required to run roblox-studio-mcp?
A running Roblox Studio instance with the built-in MCP server enabled via the Assistant menu.
Source text
SKILL.md · MIT
---
name: roblox-studio-mcp
description: Drive Roblox Studio from an AI agent via the built-in Studio MCP server - connecting Claude Code, Codex, Cursor, OpenCode, Gemini CLI; tools to explore the DataModel, read/edit scripts, run Luau in edit/server/client, playtest, read output, capture screenshots, simulate input, insert assets. Use when an agent should inspect, modify, or playtest an open Studio place, or to set up the connection.
---
# Working in Roblox Studio through MCP
Roblox Studio ships a **built-in MCP server** (stdio). With it, an agent can explore the open place,
edit scripts, run Luau in edit/server/client contexts, playtest, read the Output, capture the viewport,
and simulate player input. It is the fastest way to **verify** Roblox changes instead of guessing.
## Setup
1. Latest Studio → open **Assistant** → **…** → **Manage MCP Servers** → enable **Enable Studio as MCP server**.
2. Use **Quick connect** (Claude Code, Claude Desktop, Codex CLI, Cursor, Gemini CLI, VS Code, Antigravity)
or configure the client manually:
| OS | Command |
| --- | --- |
| macOS | `/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP` |
| Windows | `cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat` |
```bash
# Claude Code
claude mcp add Roblox_Studio -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
claude mcp add Roblox_Studio -- cmd.exe /c "%LOCALAPPDATA%\Roblox\mcp.bat" # Windows
```
```json
{ "mcpServers": { "Roblox_Studio": { "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP" } } }
```
Client-specific config (Codex `config.toml`, OpenCode `opencode.json`, Cursor/VS Code `mcp.json`):
[references/client-setup.md](references/client-setup.md). A green indicator in **Manage MCP Servers**
confirms the connection. Only connect clients you trust: they can read and modify your places.
## Tools
| Group | Tools |
| --- | --- |
| Session | `list_roblox_studios` (every call takes a `studio_id`), `get_studio_state` (play state, available DataModels) |
| Explore | `search_game_tree` (filter by path/class/keyword, depth), `inspect_instance` (properties, attributes, children), `script_search` (fuzzy by name), `script_grep` (text across scripts, ≤ 50 hits), `script_read` (dot path like `game.ServerScriptService.Main`, line ranges) |
| Edit | `multi_edit` (several edits to one script, creates it if missing; `datamodel_type = Edit`) |
| Run | `execute_luau` (`datamodel_type` = `Edit`, `Server`, or `Client`; returns the result or error) |
| Playtest | `start_stop_play`, `get_console_output`, `screen_capture` (optional camera position/look-at), `character_navigation`, `user_keyboard_input`, `user_mouse_input` |
| Assets | `search_asset` (Creator Store / inventory), `insert_asset`, `upload_image`, `store_image`, `generate_mesh`, `generate_material`, `generate_procedural_model` + `wait_job_finished` |
| Delegation | `subagent` (`explore` or `playtest` types for multi-step investigations) |
| Knowledge | `http_get` (Roblox docs, API reference, Cloud docs), `skill` (Roblox-authored skills: debugging, device simulation, docs search, profiling, scene analysis, unit tests) |
## The working loop
1. **Orient**: `list_roblox_studios` → pick `studio_id`; `get_studio_state`. Map the project with
`search_game_tree` (depth-limited: services first), then `script_grep`/`script_search` for the feature.
2. **Read before writing**: `script_read` every script you'll touch and its requirers. Check for a
Rojo/Script Sync setup (see below) before editing in Studio.
3. **Edit** with `multi_edit` (exact, minimal edits; keep existing style). Create instances/attributes/
tags with `execute_luau` in `Edit` context — changes made this way are **real edits to the place**.
4. **Verify statically**: re-read the script; for pure modules, `execute_luau` a quick check
(`require` the module in `Edit` and call functions).
5. **Playtest**: `start_stop_play` (start) → wait → `get_console_output` for errors → drive the scenario
with `character_navigation` / input tools → `execute_luau` in `Server`/`Client` to assert state →
`screen_capture` for visual checks → `start_stop_play` (stop). Always stop play when done.
6. **Report** what changed and what was verified (and what wasn't).
```luau
-- Example execute_luau (Server context during play): assert game state instead of eyeballing.
local Players = game:GetService("Players")
local results = {}
for _, player in Players:GetPlayers() do
local leaderstats = player:FindFirstChild("leaderstats")
local coins = leaderstats and leaderstats:FindFirstChild("Coins")
table.insert(results, `{player.Name}: {if coins and coins:IsA("IntValue") then coins.Value else "missing"}`)
end
return table.concat(results, "\n")
```
## Rules of thumb
- `execute_luau` in `Edit` mutates the place: prefer read-only queries while exploring, and batch
intentional changes into one clear script. Use `ChangeHistoryService` recording (`TryBeginRecording`/
`FinishRecording`) so the user can undo your edit as one step.
- Changes made during play (Server/Client contexts) are discarded when play stops — edit in `Edit`.
- **Rojo projects**: the file system is the source of truth — edit files on disk, let Rojo sync, and use
MCP to playtest/inspect. Editing synced scripts via `multi_edit` gets overwritten. **Script Sync**
projects sync both ways, so either side works, but don't edit the same script in both at once.
- Keep `search_game_tree` queries narrow (path + depth); large places produce huge outputs.
- Multiple Studio windows: always pass the right `studio_id`; tell the user which place you touched.
- Inserted assets from the Creator Store can contain scripts: inspect them (`search_game_tree` +
`script_read`) before keeping them; remove unexpected scripts (backdoors are common in free models).
- Don't claim success without evidence: cite console output, assertion results, or screenshots.
## Roblox-authored skills and conversions
Studio exposes Roblox-authored skills through the `skill` tool (e.g. `rbx-debug`, `rbx-perf-profiling`,
`rbx-scene-analysis`, `rbx-unit-test`, `rbx-docs-search`, `rbx-device-simulator-lua`). Roblox also
publishes an official **streaming conversion** skill (`/rbx-convert-to-streaming`, downloadable from the
"Techniques and conversion" streaming docs) that runs through this MCP server; back up the place first.
## Related skills
`roblox-testing` (test runners), `roblox-performance` (profiling), `roblox-tooling` (Rojo/Script Sync),
`roblox-architecture` (where things belong), `roblox-code-review`.
© EL4CTEO · MIT · EL4CTEO/roblox-skills
Similar skills
All skills for Agent setup: memory, context, orchestration →roblox-studio-mcp by other authors comes first.