justice219 avatar

Roblox Studio Mcp

justice219/roblox-studio-mcp

This bridges Claude directly to Roblox Studio's DataModel through a localhost HTTP server and polling plugin. You get 14 tools covering reads (get_descendants, find_instances, get_properties) and writes (create_instance, set_properties, delete_instance, execute_luau). All changes flow through ChangeHistoryService so you can undo with Ctrl+Z. The serializer handles Vector3, CFrame, Color3, BrickColor, and a dozen other Roblox types bidirectionally. Reach for this when you want an AI assistant to scaffold game objects, refactor hierarchies, or manipulate instances without leaving your terminal. Requires HttpService enabled in Studio and Node.js 18+. The execute_luau tool runs arbitrary code in the plugin context, so trust your prompts.

GitHub stars
2
tools
14
transport
STDIO
env var
1
last updated
Feb 11, 2026

Tools

14 tools

Public tool metadata for what this MCP can expose to an agent.

get_descendantsGet all descendants with paths, optional `maxDepth`

Get all descendants with paths, optional `maxDepth`

No parameter schema in public metadata yet.

get_childrenGet immediate children of an instance

Get immediate children of an instance

No parameter schema in public metadata yet.

get_propertiesGet serialized properties of an instance

Get serialized properties of an instance

No parameter schema in public metadata yet.

find_instancesSearch by `className` and/or `namePattern`

Search by `className` and/or `namePattern`

No parameter schema in public metadata yet.

get_servicesList all DataModel services

List all DataModel services

No parameter schema in public metadata yet.

get_selectionGet currently selected instances in Studio

Get currently selected instances in Studio

No parameter schema in public metadata yet.

create_instanceCreate a new Instance with properties

Create a new Instance with properties

No parameter schema in public metadata yet.

set_propertiesModify properties on an existing instance

Modify properties on an existing instance

No parameter schema in public metadata yet.

delete_instanceDestroy an instance (undo-supported)

Destroy an instance (undo-supported)

No parameter schema in public metadata yet.

clone_instanceClone an instance to a new parent

Clone an instance to a new parent

No parameter schema in public metadata yet.

move_instanceReparent an instance

Reparent an instance

No parameter schema in public metadata yet.

set_selectionSet the Studio selection

Set the Studio selection

No parameter schema in public metadata yet.

insert_serviceInsert a service via `game:GetService()`

Insert a service via `game:GetService()`

No parameter schema in public metadata yet.

execute_luauExecute arbitrary Luau code in the plugin context

Execute arbitrary Luau code in the plugin context

No parameter schema in public metadata yet.

Sponsors

Configuration

MCP_BRIDGE_PORT

HTTP bridge port for Studio plugin communication

Readme

Roblox Studio MCP Bridge

A Model Context Protocol (MCP) server that connects AI coding assistants like Claude Code directly to Roblox Studio. Read, create, modify, and delete instances in the DataModel — all from your terminal.

How It Works

Claude Code (MCP Client)
        |
   MCP Server (stdio)
        |
   HTTP Bridge (localhost:3001)
        |
   Studio Plugin (polls every 200ms)
        |
   Roblox Studio DataModel

The bridge has two halves:

  1. MCP Server (TypeScript) — Runs locally, exposes 14 tools via MCP over stdio, and serves an HTTP API on localhost:3001
  2. Studio Plugin (Luau) — Polls the HTTP API for commands, executes them against the DataModel, and returns results

All write operations are wrapped in ChangeHistoryService, so every change can be undone with Ctrl+Z in Studio.

Available Tools


View the full README on GitHub

Details

Repository
github.com/justice219/roblox-studio-mcp
Package
@jamesworkbenchcrm/roblox-studio-mcp
Transport
STDIO
Registry
MCP registry, active