Roblox Studio MCP Server

MCP server for AI-powered Roblox Studio integration. 18 specialized tools for exploring projects, analyzing scripts, and performing bulk operations.

Quick Start

For Claude Code users:

claude mcp add robloxstudio -- npx -y robloxstudio-mcp

For other MCP clients (Claude Desktop, etc.):

{
  "mcpServers": {
    "robloxstudio-mcp": {
      "command": "npx",
      "args": ["-y", "robloxstudio-mcp"],
      "description": "Advanced Roblox Studio integration for AI assistants"
    }
  }
}

Studio Plugin Setup (Required)

The MCP server requires a companion Roblox Studio plugin:

Roblox Creator Store:
- Install from: https://create.roblox.com/store/asset/75577477776988
- Click "Install" - Opens in Studio automatically
Manual download:
- Download MCPPlugin.rbxmx
- Save to your %LOCALAPPDATA%/Roblox/Plugins folder
Advanced setup:
- See studio-plugin/INSTALLATION.md for other methods

After installation:

Enable "Allow HTTP Requests" in Game Settings > Security
Click the "MCP Server" button in the Plugins toolbar
Status should show "Connected" when working

Architecture Overview

Dual-component system bridging Roblox Studio with AI assistants:

Key Components:

MCP Server (Node.js/TypeScript) - Exposes 18 tools via stdio
HTTP Bridge - Request/response queue on localhost:3002
Studio Plugin (Luau) - Polls server and executes API calls
Smart Caching - Efficient data transfer

18 AI Tools

File System Tools

get_file_tree - Complete project hierarchy with scripts, models, folders
search_files - Find files by name, type, or content patterns

Studio Context Tools

get_place_info - Place ID, name, game settings, workspace info
get_services - All Roblox services and their child counts
search_objects - Find instances by name, class, or properties

Instance & Property Tools

get_instance_properties - Complete property dump for any object
get_instance_children - Child objects with metadata
search_by_property - Find objects with specific property values
get_class_info - Available properties/methods for Roblox classes

Property Modification Tools

set_property - Set a property on any Roblox instance
mass_set_property - Set the same property on multiple instances
mass_get_property - Get the same property from multiple instances

Object Creation Tools

create_object - Create a new Roblox object instance
create_object_with_properties - Create objects with initial properties
mass_create_objects - Create multiple objects at once
mass_create_objects_with_properties - Create multiple objects with properties
delete_object - Delete a Roblox object instance

Project Analysis Tools

get_project_structure - Smart hierarchy with depth control (recommended: 5-10)

Note: Previous tools removed: get_file_content, get_file_properties, get_selection, get_dependencies, validate_references. Use Rojo/Argon workflows instead.

AI-Optimized Features

Mass Operations (v1.3.0)

Bulk property editing
Mass object creation
Batch property reading
Atomic undo/redo operations

// Example: Set multiple parts to red
mass_set_property(["game.Workspace.Part1", "game.Workspace.Part2"], "BrickColor", "Really red")

Smart Project Structure

Service overview with child counts
Path-based exploration: get_project_structure("game.ServerStorage", maxDepth=5)
Script-only filtering for code analysis
Intelligent grouping for large folders
Recommended maxDepth=5-10

Rich Metadata

Script status tracking
GUI intelligence
Performance optimized

Development & Testing

Commands

npm run dev         # Development server with hot reload  
npm run build       # Production build
npm start           # Run built server
npm run lint        # ESLint code quality
npm run typecheck   # TypeScript validation

Plugin Development

Live reload
Robust error handling
Debug logging
Visual status indicators

Communication Protocol

Features:

30-second timeouts with exponential backoff
Automatic retries
Response limiting
Request deduplication

Example Usage

// Get service overview
get_project_structure()

// Explore weapons folder
get_project_structure("game.ServerStorage.Weapons", maxDepth=2)

// Find all Sound objects  
search_by_property("ClassName", "Sound")

// Check script dependencies
get_dependencies("game.ServerScriptService.MainScript")

// Find broken references
validate_references()

// Get UI component details
get_instance_properties("game.StarterGui.MainMenu.SettingsFrame")

Configuration

Environment Variables:

MCP_SERVER_PORT - MCP server port (default: stdio)
HTTP_SERVER_PORT - HTTP bridge port (default: 3002)
PLUGIN_POLL_INTERVAL - Plugin poll frequency (default: 500ms)
REQUEST_TIMEOUT - Request timeout (default: 30000ms)

Studio Settings:

Allow HTTP Requests (Game Settings > Security)
HttpService.HttpEnabled = true
Plugin activated via toolbar button

License

MIT License - Feel free to use in commercial and personal projects!

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

View all tools

An AI-powered server that provides access to Roblox Studio data through a plugin architecture, enabling AI tools to interact with file systems, studio context, properties, and project structure.

Related MCP Servers

Roam Research
2b3pro
A
security
A
license
A
quality
Provides comprehensive access to Roam Research's API functionality. This server enables AI assistants like Claude to interact with your Roam Research graph through a standardized interface.
Last updated -
18
32
58
TypeScript
MIT License
Loxo MCP Server
tbensonwest
A
security
F
license
A
quality
Enables interaction with the Loxo recruitment platform API, facilitating tasks such as candidate and job management, activity logging, and call queue management through AI assistants.
Last updated -
12
JavaScript
Hex API MCP Server
franccesco
-
security
A
license
-
quality
A server that allows AI assistants to access, view, run, and manage Hex projects through a standardized interface.
Last updated -
1
Python
AGPL 3.0
Unity MCP Integration
quazaai
-
security
A
license
-
quality
A server that enables AI assistants to understand and interact with Unity projects in real-time, providing access to scene hierarchy, project settings, and the ability to execute code directly in the Unity Editor.
Last updated -
77
MIT License

View all related MCP servers

Roblox Studio MCP Server