Integrates with the Roblox Creator Store (Toolbox) to search for and insert models, decals, and audio assets into the development environment.
Provides comprehensive control over Roblox Studio, enabling workspace exploration, instance creation and manipulation, script management, viewport rendering, and playtest session control.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Roblox Studio MCPCreate a red neon part at the origin and name it 'PowerCore'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Roblox Studio MCP
Experimental. This is an active work-in-progress. APIs will change, features may break, and the rendered screenshots are blocky approximations — not pixel-accurate previews. Use at your own risk. Contributions and bug reports welcome.
An MCP (Model Context Protocol) server for controlling Roblox Studio from AI coding tools like OpenCode. Provides workspace exploration, instance manipulation, script management, toolbox integration, playtest controls, and viewport rendering.
Architecture
The MCP server runs a small HTTP server on 127.0.0.1:28821. The Roblox Studio plugin polls this server every 250ms for pending commands, executes them inside Studio, and posts results back.
Setup
1. Install dependencies and build
2. Install the Studio plugin
Automatic:
Manual:
Copy plugin/RobloxStudioMCP.server.lua to your Roblox Studio plugins folder:
Platform | Path |
macOS |
|
Windows |
|
3. Activate the plugin
In Studio, click the MCP Bridge button in the toolbar. A status widget will appear showing connection state.
Note: Plugin HTTP requests are not gated by the "Allow HTTP Requests" game setting. That setting only applies to game scripts — plugins can make HTTP calls freely.
4. Configure OpenCode
The included opencode.json works when you run OpenCode from the project root:
If you want to use this from a different project, use the absolute path to dist/index.js in the command array.
Tools (6 consolidated)
All tools use an action parameter to select the specific operation.
roblox_get — Read-only queries
Action | Description |
| Check plugin connection status and get place info |
| ASCII tree view of the instance hierarchy |
| Search by name substring and/or class name |
| Get detailed info about a specific instance |
| Read all common properties of an instance |
| Class breakdown with counts for descendants |
| Get currently selected instances |
| Read recent Output window entries |
| Get texture/decal asset IDs for an instance and descendants |
roblox_manage — Instance mutations
Action | Description |
| Create Part, Model, Folder, etc. with properties |
| Batch create multiple instances at once |
| Update properties (Position, Size, Color, etc.) |
| Reset a Model's WorldPivot to bounding box center |
| Destroy an instance (undoable) |
| Clone with optional rename/reparent |
| Move an instance to a new parent |
| Select specific instances |
| Undo last action |
| Redo last undone action |
roblox_script — Script CRUD & execution
Action | Description |
| Create Script/LocalScript/ModuleScript |
| Read script source and metadata |
| Update source code (works with open editors) |
| Execute a Lua snippet in Studio context |
roblox_scene — Camera & screenshots
Action | Description |
| Render a PNG of the current viewport (geometry + color + materials, no textures) |
| Position camera explicitly or auto-frame on an instance |
roblox_toolbox — Creator Store
Action | Description |
| Search for free models/decals/audio |
| Insert a toolbox asset by ID |
| Remove all scripts from an inserted model |
roblox_playtest — Test sessions
Action | Description |
| Begin a playtest session |
| Stop the current playtest |
| Get current state (Edit/Run/Play) |
| Move camera during playtest |
| Fire a ClickDetector |
| Trigger a ProximityPrompt |
| Read game state (players, leaderstats) |
| Run Lua in the live game context |
Instance Paths
Instances are referenced by dot-separated paths from game:
Agent
An OpenCode agent definition is included at .opencode/agents/studio.md. It configures the AI with Roblox Studio domain knowledge and tool usage patterns. The opencode.json sets it as the default agent.
Environment Variables
Variable | Default | Description |
|
| HTTP bridge port |
Known Limitations
Screenshots are software-rendered from geometry data — no textures, lighting, or post-processing. They show shapes, colors, and spatial relationships, not what Studio's viewport actually looks like.
Playtest control uses
RunService:Run()/:Stop()which works for server-side testing but doesn't fully replicate Play Solo (no local player character).Toolbox search hits the public Roblox API and may be rate-limited.
Script execution runs via
require()on a temporary ModuleScript. Some APIs may not be available in this context.Instance paths use dot-separated names, so instances with
.in their name will not resolve correctly.
License
MIT