Roblox MCP Tools
Provides real-time integration with Roblox Studio through a plugin bridge, enabling AI agents to inspect and edit instances and scripts, preview UI stories, capture viewport screenshots, control the camera and selection, and automate playtests and input.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Roblox MCP Tools
A FastMCP server and Roblox Studio plugin bridge that lets AI agents inspect, edit, preview UI stories, capture viewport screenshots, and playtest directly inside Roblox Studio in real time.
Architecture
MCP Client / Agent ──(MCP stdio)──▶ server.py ──(WebSocket :8000)──▶ Roblox Studio Plugin (MCPBridge)
│
└──(HTTP :8001)──▶ vision_bridge.py (Windows viewport capture)server.py— FastMCP server exposing Roblox Studio tools overstdioand hosting the WebSocket bridge onws://127.0.0.1:8000.plugin/— Rojo project for theMCPBridgeRoblox Studio plugin (src/init.server.luau).vision_bridge.py— Windows desktop HTTP server onhttp://127.0.0.1:8001for capturing the Roblox Studio 3D viewport (take_screenshot.py/run_vision_bridge.bat).
Related MCP server: Roblox Studio MCP
Repository Layout
roblox-mcp-tools/
├── server.py # FastMCP server + WebSocket bridge (:8000)
├── vision_bridge.py # Windows viewport screenshot HTTP bridge (:8001)
├── take_screenshot.py # Standalone manual screenshot test script
├── run_vision_bridge.bat # Launcher for vision_bridge.py
├── take_screenshot.bat # Launcher for take_screenshot.py
├── requirements.txt # Core Python dependencies
└── plugin/ # Rojo source project for the Studio plugin
├── default.project.json
├── rokit.toml
├── build.ps1 # Builds mcp.rbxmx to %LOCALAPPDATA%\Roblox\Plugins\
├── AGENTS.md
└── src/
└── init.server.luauPrerequisites
Python 3.10+
Roblox Studio (with HTTP Requests / WebSocket client enabled when running plugins)
Rokit (or Rojo 7.7.1+) to build the Studio plugin
Pillow (
pip install pillow) if usingvision_bridge.py/roblox_take_viewport_screenshoton Windows
Setup
1. Install Python Dependencies
pip install -r requirements.txt
pip install pillow2. Build the Roblox Studio Plugin
From the plugin/ directory:
cd plugin
.\build.ps1This builds mcp.rbxmx into %LOCALAPPDATA%\Roblox\Plugins\mcp.rbxmx. Restart Roblox Studio (or save as a local plugin in Studio) and click MCP Bridge in the Plugins toolbar to connect.
3. Configure Your MCP Client
Add server.py as an MCP stdio server in your client configuration:
{
"mcpServers": {
"roblox-studio": {
"command": "python",
"args": ["C:/path/to/roblox-mcp-tools/server.py"]
}
}
}4. Vision Bridge (Optional, Windows)
server.py automatically starts the Vision Bridge on port 8001 when needed, or you can run it explicitly in your interactive desktop session:
.\run_vision_bridge.batAvailable MCP Tools
Explorer & Inspection:
roblox_ls,roblox_ls_descendants,roblox_ls_summary,roblox_get_properties,roblox_get_by_tag,roblox_search,roblox_get_attributesScripts & Editing:
roblox_verify_script,roblox_create_script,roblox_execute_code,roblox_set_properties,roblox_set_attribute,roblox_get_output_logsUI & Story Preview:
roblox_get_ui_tree,roblox_get_ui_design_properties,roblox_inspect_ui_component,roblox_get_ui_palette,roblox_mount_story,roblox_unmount_story,roblox_list_mounted_stories,roblox_unmount_all_storiesViewport & Camera:
roblox_get_viewport_size,roblox_take_viewport_screenshot,roblox_get_selection,roblox_set_selection,focus_on_selection,roblox_focus_on_selection,roblox_world_to_screen,roblox_look_at,roblox_set_cameraPlaytest & Input Automation:
roblox_start_playtest,roblox_stop_playtest,roblox_get_playtest_mode,roblox_get_player_state,roblox_teleport,roblox_equip_tool,roblox_chat,roblox_get_active_proximity_prompts,roblox_trigger_prompt,roblox_simulate_input,roblox_input_sequence,roblox_click_ui_element,roblox_wait_for
Security Note
The Studio plugin connects only to ws://127.0.0.1:8000 and exposes roblox_execute_code for local development. Only run the bridge in trusted local Studio sessions.
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Build and inspect browser-based 3D games: projects, scenes, Lua scripts, assets and publishing.
Control Unreal Engine to browse assets, import content, and manage levels and sequences. Automate…
Blender-as-a-service for agents: search 3D assets, run Blender Python, or brief the studio agent.
Build, run, inspect, and continue AgentScript workflows on connected Super Chrome and Mac clients.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI coding tools to control Roblox Studio for workspace exploration, instance manipulation, and script management. It provides tools for playtesting, scene rendering, and integration with the Roblox Creator Store.610MIT
- AlicenseAqualityAmaintenanceEnables AI agents to inspect, create, edit, debug, and playtest projects inside the Roblox editor via 29 lean tools, with push-based SSE transport, editor-safe script edits, and batched undoable writes.35820 npm15MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to explore, edit, and automate Roblox Studio sessions locally, including browsing instance hierarchies, reading and modifying scripts, manipulating properties, creating instances, building terrain, and running playtests.1,057 npmMIT
- AlicenseAqualityBmaintenanceEnables AI agents to drive a running Roblox Studio in real time over a single WebSocket, executing whole Luau programs, installing in-engine controllers, hot-patching scripts during live playtests, and receiving errors, assertions and other events as pushes. It also reaches Roblox Open Cloud for the open place and answers visual questions via a vision sidecar, exposing all of this through nine MCP tools.92MIT