Skip to main content
Glama
Roblox Executor MCP Server

Roblox Executor MCP Server

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 tools
block-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.

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

    A3.9/5.0

    Scored across 22 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Debug 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.
      14
      14 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Debug 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.
      14
      1
      MIT