Roblox Executor MCP Server
Allows executing Lua code, inspecting scripts, spying on remotes, and interacting with a running Roblox game client.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Roblox Executor MCP Server Run Lua code: print(game.Players.LocalPlayer.Name)"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Roblox Executor MCP Server
An MCP server that allows Agents to interact with a running Roblox game client — execute code, inspect scripts, spy on remotes, and more.
Credit: This project is based on roblox-executor-mcp by notpoiu. Full credit to the original authors for the foundational work.
Features
Code Execution
Script Inspection
Bytecode Disassembly
Instance Search
Instance Explorer
GC Search
Property Read & Write
Remote Spy
Reverse Mode
Anti-Cheat Scan
Console
Semantic Search
Persistent Memory
GUI Interaction
Screenshot
Web Dashboard
Multi-Client
Related MCP server: dex-mcp
Dashboard
Roblox Executor MCP includes a local web dashboard at:
http://localhost:16384/Use it to see connected Roblox clients, browse the instance explorer, inspect and edit scripts, spy on remotes, run a Luau console, view live server logs, manage relay peers, and configure semantic search.
Available Tools
22 toolsblock-remoteBlock or unblock a remoteA
Block or unblock a Roblox remote by exact name and direction. Requires ensure-remote-spy first; use get-remote-spy-logs to discover candidates.
Inputs: direction (required), remoteName (required), shouldBlock.
clear-remote-spy-logsClear all remote spy logsA
Clear all captured Cobalt remote spy logs. Requires ensure-remote-spy first.
Inputs: no named parameters.
click-buttonClick a GuiButtonA
Click a Roblox TextButton or ImageButton by firing its GUI signals. Use when direct UI activation is needed inside the active client.
Inputs: path (required), action.
ensure-remote-spyEnsure the Cobalt remote spy is loadedA
Load or verify the Cobalt remote spy in the active Roblox client. Call before reading, clearing, blocking, or ignoring remote spy logs.
Inputs: no named parameters.
executeExecute Code in the Roblox Game ClientA
Execute Luau in the active Roblox client without returning output. Use get-data-by-code instead when you need returned values.
Inputs: code (required), threadContext.
execute-fileExecute a Luau file in the Roblox Game ClientA
Execute a local .luau or .lua file in the active Roblox client without returning output. Use get-data-by-code instead when you need returned values.
Inputs: filePath (required), threadContext.
gc-searchSearch the Luau garbage collector (getgc)A
Scan live functions and tables in the Roblox client's garbage collector. Use to locate in-memory functions by name or defining script, or tables by their key/value contents, when the value isn't reachable through the instance tree. Requires an executor that supports getgc.
Inputs: limit, query, filterType, includeValues.
get-console-outputGet the roblox developer console output from the Roblox Game ClientC
Read recent Roblox developer console logs from the active client. Use limit and logsOrder to control volume and ordering.
Inputs: limit, filter, logsOrder.
get-data-by-codeGet data by codeB
Execute Luau in the active Roblox client and return serialized raw Lua values. The code must return values; do not manually JSON-encode them.
Inputs: code (required), timeout, threadContext.
get-descendants-treeGet the descendants tree of a Roblox instanceA
Get a depth-limited hierarchy of descendants under a Roblox instance. Use for broad structure exploration; use search-instances for selector-based filtering.
Inputs: root (required), maxDepth, classFilter, maxChildren.
get-game-infoGet information about the current Roblox gameA
Get current Roblox place and universe metadata such as PlaceId, GameId, and PlaceVersion.
Inputs: no named parameters.
get-remote-spy-logsGet captured remote spy logs from CobaltA
List captured Cobalt remote and bindable call logs. Requires ensure-remote-spy first; supports direction and name filters to narrow noisy logs.
Inputs: limit, direction, remoteNameFilter, maxCallsPerRemote.
get-script-contentGet the content of a script in the Roblox Game ClientA
Get decompiled source for a Roblox script by path, script proxy, or getter code. Use startLine/endLine for a focused range when the full script is large.
Inputs: endLine, startLine, scriptPath, scriptGetterSource.
ignore-remoteIgnore or unignore a remoteA
Ignore or unignore logging for a Roblox remote by exact name and direction. Requires ensure-remote-spy first; ignored remotes still fire.
Inputs: direction (required), remoteName (required), shouldIgnore.
list-clientsList connected Roblox clientsA
List connected Roblox game clients with clientId and session metadata. Use before set-active-client when multiple clients are connected or the target client is unknown.
Inputs: no named parameters.
list-roblox-windowsList visible Roblox windowsA
List visible Roblox OS windows with PIDs. Use before screenshot-window when multiple Roblox windows may be open.
Inputs: no named parameters.
screenshot-windowTake a screenshot of a Roblox windowA
Capture an actual OS screenshot of a Roblox window via Windows APIs. Provide pid when multiple windows are open; secondary servers relay capture to the primary host.
Inputs: pid.
script-grepGrep across all scripts in the gameA
Search decompiled Roblox scripts with JavaScript regex or literal string matching. Use for exact identifiers or code patterns; use semantic-search-scripts when behavior is known but names are not.
Inputs: query (required), limit, literal, maxResults, +3 more.
search-instancesSearch for instances in the gameB
Search Roblox instances with QueryDescendants selector syntax. Use for class, name, tag, property, and attribute queries against a chosen root.
Inputs: selector (required), root, limit.
semantic-search-scriptsSemantically search scripts in the gameA
Find decompiled Roblox scripts by behavior using semantic embeddings. Use when exact identifiers are unknown; use script-grep for exact text or regex.
Inputs: query (required), limit, minScore.
set-active-clientSet active Roblox clientA
Route future Roblox tool calls to the specified connected client. Use list-clients first if you need available clientIds.
Inputs: clientId (required).
type-text-boxType into a TextBoxA
Enter text into a Roblox TextBox by path. Can simulate keystrokes or set Text directly based on useKeyPress.
Inputs: path (required), text (required), enter, useKeyPress.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 22 tools
Most tools have distinct purposes, e.g., remote spy management vs. execution vs. UI interaction. Potential confusion between execute, execute-file, and get-data-by-code is mitigated by clear descriptions explaining return value differences.
All tool names follow a consistent kebab-case verb-object pattern (e.g., block-remote, clear-remote-spy-logs, ensure-remote-spy). No mixing of conventions.
With 22 tools covering spy, execution, UI, searching, scripts, and client management, the count is well-scoped for a Roblox executor server. Not excessive nor too sparse.
Core workflows like remote spy, code execution, instance searching, and client management are well-covered. Minor omissions (e.g., no tool to modify instance properties) but not critical for the server's purpose.
Related MCP Connectors
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
Make games with AI: one MCP server that connects your agent to Unity, Unreal and Godot editors.
Connect AI agents to Flato's editable canvas runtime through a hosted MCP server.
Secure and manage MCP servers through the Speakeasy AI Control Plane from your agent.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceBridges MCP-capable LLM agents to the Serotonin Lua runtime, enabling live Roblox game interaction including instance tree navigation, memory access, and script execution.2MIT
- AlicenseAqualityBmaintenanceDebug and inspection tooling for Roblox projects, exposed as an MCP server so an AI agent can explore the instance tree, read/write properties, call remotes, and run Luau in a Roblox client driven by an executor.1414 npmMIT
- AlicenseAqualityDmaintenanceDebug and inspection tooling for Roblox projects, exposed as an MCP server so an AI agent can explore the instance tree, read/write properties, call remotes, and run Luau in a Roblox client driven by an executor.141MIT
- AlicenseAqualityBmaintenanceEnables agents to interact with a running Roblox game client, execute Lua code, inspect scripts, spy on remotes, and more.2166 npmMIT