robloxstudio-mcp

Use only when replacing a script's entire source.

Get all instances with a specific tag

Get a build from the library by ID. Returns metadata, palette, and generator code (if the build was created with generate_build). IMPORTANT: When the user asks to modify an existing build, ALWAYS call get_build first to retrieve the original code, then make targeted edits to only the relevant lines, and call generate_build with the modified code. Never rewrite the entire code from scratch - only change what the user asked to change.

Undo the last change in Roblox Studio. Uses ChangeHistoryService to reverse the most recent operation.

Use to discover connected places and the roles available in each.

Use when you need the current place's identity or settings.

Get properties/methods for a class

Use to inspect a DataModel subtree and its hierarchy.

Get children and their class types

Set a property on an instance

Delete an instance

Use to add source after a known line in one script.

Delete an attribute

Use when the current Studio selection should define the objects to work on.

Use to inspect every attribute on one instance.

Add a tag

Remove a tag

Redo the last undone change in Roblox Studio. Uses ChangeHistoryService to reapply the most recently undone operation.

Search for MaterialVariant instances in MaterialService by name. Use this to find custom materials before using them in generate_build or create_build palettes. Returns material names and their base material types.

Use to inspect full catalog metadata for one shortlisted Creator Store asset.

Clone an instance to a new parent location. Creates a deep copy of the instance and all its descendants.

Diff two instances by comparing their properties. Useful for debugging why a duplicate behaves differently.

Use to read all or part of a script's source.

Use to inspect network and device simulator state before or after simulation tests.

Find objects with specific property values

Use when an asset thumbnail would help with visual review.

Get all descendants of an instance recursively with depth info. More efficient than repeated get_instance_children calls.

Create a new instance. Optionally set properties on creation.

Batch smart_duplicate operations

Set a property on multiple instances

Get all tags on an instance

Get a property from multiple instances

Use for custom edit work or plugin-context access to a live server or client.

Use when Luau must run in a live client LocalScript VM and share the game's require cache.

Use to read recent Studio output from edit, server, or client peers.

Use to run or inspect a StudioTestService playtest with multiple clients.

Use to locate text or Lua pattern matches across script sources.

Use to compare viewport screenshots across up to six device settings.

Use when Studio breakpoints or logpoints are needed to trace script execution.

Use to send key presses or text to a live playtest client.

Use to load a local, remote, or inline .rbxm under a chosen parent.

Use to find instances by name, class, or property value.

Search instances by name, class, or script content

Get available services and their children

Get instance hierarchy tree from Studio

Create multiple instances. Each can have optional properties.

Use to remove a known inclusive line range from one script.

Set an attribute. Supports primitives, Vector3, Color3, UDim2, BrickColor.

List available builds in the local build library. Returns build IDs, styles, bounds, and part counts. Optionally filter by style.

Create a new build model from scratch and save it to the library. Define parts using compact arrays [posX, posY, posZ, sizeX, sizeY, sizeZ, rotX, rotY, rotZ, paletteKey, shape?, transparency?]. Palette maps short keys to [BrickColor, Material] pairs. The build is saved and can be referenced by import_build or import_scene.

Use to click the live playtest viewport at known pixel coordinates.

Use to inspect an instance's current properties.

Use to clear network and device simulator settings between simulation tests.

Use to inspect active device simulation or list built-in device presets.

Use to sanitize and insert a Creator Store asset into a Studio place.

Use to start, change, or stop device simulation in edit mode or on playtest clients.

Use to save selected DataModel instances as a local .rbxm file.

Duplicate with naming, positioning, and property variations

Use when you need the current Studio viewport as an image or input coordinate map.

Set multiple attributes on an instance in a single call. More efficient than repeated set_attribute calls.

Use to update several properties on one instance in a single call.

Use to upload a local asset file to a Roblox user or group.

Use for an exact, localized replacement in one script.

Use to inspect an asset's hierarchy and media without inserting it.

Use when Luau must run in the live server Script VM and share the game's require cache.

Import a build into Roblox Studio. Accepts either a full build data object OR a library ID string (e.g. "medieval/church_01") to load from the build library. When using generate_build or create_build, pass the build ID string instead of the full data.

Use to start, stop, or inspect a single-player Studio playtest.

Export a Model/Folder into a compact, token-efficient build JSON format and auto-save it to the local build library. The output contains a palette (unique BrickColor+Material combos mapped to short keys) and compact part arrays with positions normalized relative to the bounding box center. The file is saved to build-library/{style}/{id}.json automatically.

Procedurally generate a build via JS code. ALWAYS generate the entire scene in ONE call - never split into multiple small builds. PREFER high-level primitives over manual loops. No comments. No unnecessary variables. Maximize build detail per line. EDITING: When modifying an existing build, call get_build first to retrieve the original code. Then make ONLY the targeted changes the user requested - do not rewrite unchanged code. Pass the modified code to generate_build. HIGH-LEVEL (use these first - each replaces 5-20 lines): room(x,y,z, w,h,d, wallKey, floorKey?, ceilKey?, wallThickness?) - Complete enclosed room (floor+ceiling+4 walls) roof(x,y,z, w,d, style, key, overhang?) - style: "flat"|"gable"|"hip" stairs(x1,y1,z1, x2,y2,z2, width, key) - Auto-generates steps between two points column(x,y,z, height, radius, key, capKey?) - Cylinder with base+capital pew(x,y,z, w,d, seatKey, legKey?) - Bench with seat+backrest+legs arch(x,y,z, w,h, thickness, key, segments?) - Curved archway fence(x1,z1, x2,z2, y, key, postSpacing?) - Fence with posts+rails BASIC: part(x,y,z, sx,sy,sz, key, shape?, transparency?) rpart(x,y,z, sx,sy,sz, rx,ry,rz, key, shape?, transparency?) wall(x1,z1, x2,z2, height, thickness, key) - vertical plane from (x1,z1) to (x2,z2) floor(x1,z1, x2,z2, y, thickness, key) - horizontal plane at height y, corners (x1,z1)-(x2,z2). NOT fill - only takes 2D corners+y, not 3D points fill(x1,y1,z1, x2,y2,z2, key, [ux,uy,uz]?) - 3D volume between two 3D points beam(x1,y1,z1, x2,y2,z2, thickness, key) IMPORTANT: Palette keys must match exactly. Use only keys defined in your palette object, not color names. CUSTOM MATERIALS: Use search_materials to find MaterialVariant names, then reference them as the 3rd palette element: {"a": ["Color", "BaseMaterial", "VariantName"]}. REPETITION: row(x,y,z, count, spacingX, spacingZ, fn(i,cx,cy,cz)) grid(x,y,z, countX, countZ, spacingX, spacingZ, fn(ix,iz,cx,cy,cz)) Shapes: Block(default), Wedge, Cylinder, Ball, CornerWedge. Max 10000 parts. Math and rng() available. CYLINDER AXIS: Roblox cylinders extend along the X axis. For upright cylinders, use size (height, diameter, diameter) with rz=90. The column() primitive handles this automatically. EXAMPLE - compact cabin (17 lines): room(0,0,0,8,4,6,"a","b","a") roof(0,4,0,8,6,"gable","c") wall(-4,-2,4,-2,4,1,"a") part(0,2,3,3,3,0.3,"a","Block",0.4) row(-2,0,-1,3,0,2,(i,cx,cy,cz)=>{pew(cx,0,cz,3,2,"d")}) column(-3,0,-2,4,0.5,"a","b") column(3,0,-2,4,0.5,"a","b") part(0,2,0,2,1,1,"b")

Import a full scene layout. Provide a scene with model references (resolved from library) and placement data. Each model is placed at the specified position/rotation. Can also include inline custom builds.

Use to find public Creator Store assets by type or keyword.

Use to compare Roblox memory categories across edit, server, or client peers.

Use to preview or apply the same text replacement across multiple scripts.

Use to look up official Roblox engine or Luau reference documentation.

Use to attribute scene cost to instances, scripts, triangles, animation, or audio.

Use to launch, inspect, authorize, or close Studio processes and list place revisions.

Use to list or read Roblox-authored Studio Assistant skills on demand.

Use to attribute frame time across engine and game work on a running server or client.

Use to generate and stage a Roblox model from text or an image reference.

Use to apply simulated latency, jitter, or packet loss to playtest clients.

Use to find Luau CPU hotspots on a running server or client.