Skip to main content
Glama

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 over stdio and hosting the WebSocket bridge on ws://127.0.0.1:8000.

  • plugin/ — Rojo project for the MCPBridge Roblox Studio plugin (src/init.server.luau).

  • vision_bridge.py — Windows desktop HTTP server on http://127.0.0.1:8001 for 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.luau

Prerequisites

  • 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 using vision_bridge.py / roblox_take_viewport_screenshot on Windows

Setup

1. Install Python Dependencies

pip install -r requirements.txt
pip install pillow

2. Build the Roblox Studio Plugin

From the plugin/ directory:

cd plugin
.\build.ps1

This 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.bat

Available MCP Tools

  • Explorer & Inspection: roblox_ls, roblox_ls_descendants, roblox_ls_summary, roblox_get_properties, roblox_get_by_tag, roblox_search, roblox_get_attributes

  • Scripts & Editing: roblox_verify_script, roblox_create_script, roblox_execute_code, roblox_set_properties, roblox_set_attribute, roblox_get_output_logs

  • UI & 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_stories

  • Viewport & 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_camera

  • Playtest & 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

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      6
      10
      MIT
    • A
      license
      A
      quality
      A
      maintenance
      Enables 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.
      35
      820 npm
      15
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      9
      2
      MIT