robloxstudio-mcp

Add a tag

Use to trace script execution with breakpoints or logpoints.

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

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

Use to profile engine and game frame time on a live peer.

Use to capture the Studio viewport or map input coordinates.

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

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.

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.

Create a new instance. Optionally set properties on creation.

Delete an attribute

Delete an instance

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

Use for an exact, localized replacement in one script.

Use to run Luau in a live client VM with its require cache.

Use to run Luau in the live server VM with its require cache.

Use for custom Studio traversal, edits, or peer execution.

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.

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

Use to preview or apply one replacement across scripts.

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")

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

Use to inspect a shortlisted Creator Store asset.

Use when an asset thumbnail would help with visual review.

Use to inspect every attribute on one instance.

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.

Get properties/methods for a class

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

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

Use to inspect device simulation or list device presets.

Get instance hierarchy tree from Studio

Get children and their class types

Use to inspect an instance's current properties.

Use to compare memory categories across Studio peers.

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

Use to inspect a DataModel subtree and its hierarchy.

Use to read official Roblox engine or Luau references.

Use to read installed Roblox Studio Assistant skills.

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

Use to attribute scene cost across instances and content.

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

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

Get available services and their children

Use to inspect current network and device simulation.

Get all instances with a specific tag

Get all tags on an instance

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

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 load a local, remote, or inline .rbxm under a chosen parent.

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 sanitize and insert a Creator Store asset into a Studio place.

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

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

Use to manage Studio processes or list place revisions.

Create multiple instances. Each can have optional properties.

Batch smart_duplicate operations

Get a property from multiple instances

Set a property on multiple instances

Use to run or inspect a multi-client Studio playtest.

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

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

Remove a tag

Use to clear network and device simulation state.

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

Find objects with specific property values

Search instances by name, class, or script content

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 find instances by name, class, or property value.

Use to get, set, or frame selection.

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

Use to manage device simulation in edit or a playtest client.

Use to simulate client latency, jitter, or packet loss.

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

Set a property on an instance

Use only when replacing a script's entire source.

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

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

Duplicate with naming, positioning, and property variations

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

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

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