---
title: "Connect to the Roblox Studio MCP server"
url: /docs/en-us/studio/mcp
last_updated: 2026-06-11T17:05:20Z
description: "Learn how to connect your AI coding tools to Roblox Studio, enabling them to read your game structure, edit scripts, insert models, execute code, and control play mode."
---

# Connect to the Roblox Studio MCP server

The Roblox Studio MCP server is built into Roblox Studio. It implements the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro), an open standard that lets AI tools securely communicate with external applications. Once connected, your AI client can interact directly with your open Studio session, exploring the data model, writing scripts, running Luau code, and testing your experience in play mode.

This guide shows you how to connect the Studio MCP server to popular AI clients. While the setup varies by client, the core idea is the same: you configure your client to connect to the MCP server and then send commands from the client to your active Studio session.

## Prerequisites

Before you can connect to the server, make sure you have the **latest version of Roblox Studio** and your **preferred MCP client** installed on your computer.

## How the Studio MCP server works

The server runs as a local process on your machine and communicates with the AI client using **`stdio` transport**, which uses standard input/output streams. All actions are initiated through your AI client, which then sends a request through this channel to perform actions inside your Studio session.

The server provides the following tools:

| **Scripts** | |
| --- | --- |
| `script_read` | Reads a scripts from the game using dot-notation paths (for example, `game.ServerScriptService.MyScript`). Supports reading entire scripts or specific line ranges. |
| `multi_edit` | Applies multiple edits to a script. If the target path doesn't exist, it creates a new script. |
| `script_search` | Searches for scripts by name using fuzzy matching. Returns up to 10 results. |
| `script_grep` | Searches for a string pattern across all script in the game. Returns up to 50 matches. |
| **Asset and content generation** | |
| `generate_mesh` | Generates a textured 3D mesh. |
| `generate_material` | Generates custom material or texture. |
| `generate_procedural_model` | Generates custom procedural models that scale and adapt automatically. |
| `insert_from_creator_store` | Inserts assets, plugins, and models from the Creator Store. |
| **Data model exploration** | |
| `explore_subagent` | Investigates your place in parallel and return a compact summary without cluttering the main conversation. |
| `search_game_tree` | Explores the instance hierarchy as a flat JSON array. Supports filtering by path, instance type, and keywords. |
| `inspect_instance` | Returns detailed information about a specific instance, including readable properties, custom attributes, and a summary of its children and descendants. |
| **Luau execution** | |
| `execute_luau` | Runs Luau code in Studio. Returns either the result or an error. |
| **Playtesting** | |
| `start_stop_play` | Starts or stops playtesting. |
| `console_output` | Retrieves output logs while the game is running. |
| `screen_capture` | Captures the current Studio viewport in Play mode and returns the image data. |
| `playtest_subagent` | Spawns a test character that runs through gameplay scenarios. |
| **Player input simulation** | |
| `character_navigation` | Moves the player character to a position or instance. |
| `keyboard_input` | Simulates key presses, key holds, and text input. |
| `mouse_input` | Simulates mouse clicks, movement, and scrolling. |
| **Session management** | |
| `list_roblox_studios` | Lists all connected Studio instances, including their name, ID, and active status. This is useful when multiple Studio windows are open. |
| `set_active_studio` | Sets a Studio instance as active so that all subsequent tool calls target that instance. |

## Enable the MCP server in Studio

To enable the MCP server in Studio:

1. Open **Assistant**.
2. Click **…** ⟩ **Manage MCP Servers**.
3. Turn on **Enable Studio as MCP server**.

Once enabled, the settings panel displays the quick connect option and setup instructions for different clients. When a client connects successfully, a green indicator shows the number of connected clients.

## Connect your client

You can connect your client to the Studio MCP server using quick connect, a JSON configuration, or a CLI command.

- Use **quick connect** if your client is supported.
- If not, use a **JSON configuration** if your client supports MCP config files.
- Otherwise, use a **CLI command**.

The Studio MCP server works with any client that supports `stdio` transport. After adding the configuration, follow your client's documentation to complete setup, then restart the client to apply your changes.

> **Warning:** MCP clients can read and modify content in your open Roblox places. Make sure to only connect clients you trust.
### Quick connect

Quick connect supports the following clients:

- Antigravity
- Codex CLI
- Claude Code
- Claude Desktop
- Cursor
- Gemini CLI
- Visual Studio Code

To connect using quick connect:

1. Go to **Assistant Settings** ⟩ **MCP Servers**.
2. Expand the **Quick connect** dropdown to view supported clients installed on your computer.
3. Turn on your chosen client.

If the client you want doesn't appear in the **Quick connect** list, install it and restart Roblox Studio.

### JSON configuration

Most MCP clients support JSON configuration files. The following examples show complete configurations you can use.

If Roblox Studio is your only MCP server, use these configurations as-is. If you're using multiple MCP servers, copy the `Roblox_Studio` entry and add it to your existing `mcpServers` dictionary.

> **Info:** Your `mcp.json` file might already contain other entries. When adding the `Roblox_Studio` configuration, make sure each entry is separated by a comma. Missing commas will result in invalid JSON and prevent the configuration from loading.

Configurations vary by operating system:

```json
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "%LOCALAPPDATA%\\Roblox\\mcp.bat"
      ]
    }
  }
}
```

```json
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
    }
  }
}
```

### CLI command

Some MCP clients require a CLI command instead of a JSON configuration. Use the appropriate command for your operating system:

```bash
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat
```

```bash
/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
```

## Use multiple Studio instances

You can connect a single MCP client to multiple running instances of Studio at the same time. The server automatically determines which instance to use based on context (for example, if you reference a specific experience or an object that exists only in that instance).

You can manually switch instances using `list_roblox_studios` and `set_active_studio`.

## Verify your connection

After setting up your client, verify that the connection is working in Roblox Studio:

1. Open **Assistant**.
2. Click **…** ⟩ **Manage MCP Servers**.
3. Under **Enable Studio as MCP server**, check for the green indicator to confirm that the client has connected successfully.

## Troubleshooting

If the server is not showing up, or the tools aren't available:

- Restart both Roblox Studio and your MCP client.
- Verify that the command or binary path is correct and the file exists.
- Check your JSON syntax. Even a missing comma or bracket can prevent the configuration from loading.