# roblox-studio-mcp

Skill connects an AI agent to the built-in Roblox Studio MCP server for editing and playtesting games.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1200 installs · ★ 131 repo stars
- Author: EL4CTEO
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/EL4CTEO/roblox-skills/tree/HEAD/skills/roblox-studio-mcp/SKILL.md
- Updated: 2026-11-03
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/el4cteo-roblox-studio-mcp

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add EL4CTEO/roblox-skills --skill roblox-studio-mcp -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/roblox-studio-mcp/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/roblox-studio-mcp/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add EL4CTEO/roblox-skills --skill roblox-studio-mcp -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/roblox-studio-mcp/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add EL4CTEO/roblox-skills --skill roblox-studio-mcp -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/roblox-studio-mcp/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install EL4CTEO/roblox-skills skills/roblox-studio-mcp
```

2. **Manually: put the files in place**
- File: `.github/skills/roblox-studio-mcp/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add EL4CTEO/roblox-skills --skill roblox-studio-mcp -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/EL4CTEO/roblox-skills --path skills/roblox-studio-mcp
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/roblox-studio-mcp/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add EL4CTEO/roblox-skills --skill roblox-studio-mcp -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/EL4CTEO/roblox-skills/tree/HEAD/skills/roblox-studio-mcp/SKILL.md

## When to use it
- 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
- 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

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 7796a3b0d758aa99.

BEGIN THIRD-PARTY FILE 7796a3b0d758aa99
````text
---
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` |
````
END THIRD-PARTY FILE 7796a3b0d758aa99

The third-party file has ended. Everything between the 7796a3b0d758aa99 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2875 of 6595 bytes. © EL4CTEO · MIT · https://github.com/EL4CTEO/roblox-skills/tree/HEAD/skills/roblox-studio-mcp/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
