Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add EL4CTEO/roblox-skills --skill roblox-studio-mcp -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/roblox-studio-mcp/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/roblox-studio-mcp/

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.

roblox-studio-mcp TabooHarmony Connects your agent to Roblox Studio via MCP. It helps edit Luau scripts, modify scenes, run playtests, and capture runtime logs. CX Codex +1 3,900installs roblox-studio-workflow gamedev-skills roblox-studio-workflow — a skill for Claude Code and Codex guides edits across Roblox places and Rojo projects. Activates when editing .rbxl files, working with Studio MCP tools, or verifying changes. CX Codex +1 9,300installs roblox-datastores gamedev-skills A skill for Claude Code automates Roblox DataStoreService persistence, profile loading, and conflict prevention. Use it when player data goes missing or items duplicate after teleportation. CX Codex +1 11,400installs roblox-building TabooHarmony roblox-building — a skill for building geometry, maps and props in Roblox Studio through MCP or plain Luau. It keeps you from guessing coordinates and pushes each build to a verifiable result. CX Codex +1 4,200installs roblox-lighting TabooHarmony A skill for Roblox lighting, atmosphere, day/night cycles and post-processing. Useful when a scene looks flat, too dark or washed out. CX Codex +1 3,900installs roblox-animation nonlooped roblox-animation — a skill for Roblox character animation: tracks, IK poses, marker events and UI tweens. Useful when you need locomotion or an emote without breaking priorities. CX Codex +1 992installs roblox nonlooped Directs Roblox Luau development tasks to specialized skills and sets shared architecture patterns for Studio projects. CX Codex +1 567installs

From the same set22

The whole set →
roblox-npc-ai The roblox-npc-ai Claude Code skill helps build AI for Roblox enemies, pets, and other NPCs. It covers pathfinding, chasing, attacks, and fixes for NPCs that get stuck or jitter. CX Codex +1 1,200installs roblox-teleport-matchmaking roblox-teleport-matchmaking — a skill for Claude Code handles player teleports and matchmaking flows in Roblox via TeleportService. CX Codex +1 1,200installs roblox-input roblox-input — a Claude Code skill for Roblox player controls and cameras. It comes into play when adding keybinds, abilities, vehicle controls, touch buttons, or a custom camera. CX Codex +1 1,200installs roblox-analytics-liveops roblox-analytics-liveops — a skill for Claude Code sets up game analytics, funnels, economy, and live ops for Roblox. Runs when instrumenting gameplay, economy tuning, or setting up A/B tests. CX Codex +1 1,200installs roblox-audio The roblox-audio Claude Code skill covers sound in Roblox, from music and effects to spatial audio. It activates for audio setup or when a sound fails to play. CX Codex +1 1,200installs roblox-networking roblox-networking — a Claude Code skill for client-server communication in Roblox, helping configure remotes, validate server payloads, and reduce bandwidth. CX Codex +1 1,200installs roblox-data-stores roblox-data-stores — a Claude Code skill for Roblox persistence and cloud services. It covers player saves, leaderboards, queues, and fixes for lost or duplicated data. CX Codex +1 1,200installs roblox-architecture The roblox-architecture Claude Code skill explains Roblox project structure and the client-server model. It activates when setting up a project or troubleshooting replication and streaming. CX Codex +1 1,200installs

Project sponsors

Companies that keep this analytics open