@chrrxs/robloxstudio-mcp-inspector 2.8.1 → 2.9.0

package/dist/index.js

@@ -335,6 +335,8 @@ var init_http_server = __esm({
       get_tagged: (tools, body) => tools.getTagged(body.tagName),
       get_selection: (tools) => tools.getSelection(),
       execute_luau: (tools, body) => tools.executeLuau(body.code, body.target),
+      eval_server_runtime: (tools, body) => tools.evalServerRuntime(body.code),
+      eval_client_runtime: (tools, body) => tools.evalClientRuntime(body.code, body.target),
       start_playtest: (tools, body) => tools.startPlaytest(body.mode, body.numPlayers),
       stop_playtest: (tools) => tools.stopPlaytest(),
       get_playtest_output: (tools, body) => tools.getPlaytestOutput(body.target),
@@ -1195,7 +1197,16 @@ function encodePngFromRgbaResponse(response) {
   const rgbaBuffer = Buffer.from(response.data, "base64");
   return rgbaToPng(rgbaBuffer, response.width, response.height);
 }
-var RobloxStudioTools;
+function luaLongQuote(s) {
+  let level = 0;
+  while (s.includes(`]${"=".repeat(level)}]`))
+    level++;
+  const eq = "=".repeat(level);
+  return `[${eq}[
+${s}
+]${eq}]`;
+}
+var SERVER_LOCAL_NAME, CLIENT_LOCAL_NAME, RobloxStudioTools;
 var init_tools = __esm({
   "../core/dist/tools/index.js"() {
     "use strict";
@@ -1204,6 +1215,8 @@ var init_tools = __esm({
     init_opencloud_client();
     init_roblox_cookie_client();
     init_png_encoder();
+    SERVER_LOCAL_NAME = "__MCP_ServerEvalLocal";
+    CLIENT_LOCAL_NAME = "__MCP_ClientEvalBridge";
     RobloxStudioTools = class _RobloxStudioTools {
       client;
       bridge;
@@ -1737,6 +1750,79 @@ ${code}`
           ]
         };
       }
+      async evalServerRuntime(code) {
+        if (!code) {
+          throw new Error("Code is required for eval_server_runtime");
+        }
+        const wrapper = `
+local bf = game:GetService("ServerScriptService"):FindFirstChild("${SERVER_LOCAL_NAME}")
+if not bf then
+	return {
+		bridge = "missing",
+		error = "ServerEvalBridge not installed. Bridges are auto-installed at start_playtest and removed at stop_playtest. Start a playtest before calling eval_server_runtime.",
+	}
+end
+local USER_CODE = ${luaLongQuote(code)}
+local ok, result = bf:Invoke(USER_CODE)
+return {
+	bridge = "ok",
+	ok = ok,
+	result = if result == nil then nil else tostring(result),
+}
+`;
+        const response = await this.client.request("/api/execute-luau", { code: wrapper }, "server");
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(response)
+            }
+          ]
+        };
+      }
+      async evalClientRuntime(code, target) {
+        if (!code) {
+          throw new Error("Code is required for eval_client_runtime");
+        }
+        const clientTarget = target || "client-1";
+        if (!clientTarget.startsWith("client-")) {
+          throw new Error(`eval_client_runtime requires target=client-N (got: ${clientTarget})`);
+        }
+        const wrapper = `
+local bf = game:GetService("ReplicatedStorage"):FindFirstChild("${CLIENT_LOCAL_NAME}")
+if not bf then
+	return {
+		bridge = "missing",
+		error = "ClientEvalBridge not installed. Bridges are auto-installed at start_playtest and removed at stop_playtest. Start a playtest before calling eval_client_runtime.",
+	}
+end
+local USER_CODE = ${luaLongQuote(code)}
+local m = Instance.new("ModuleScript")
+m.Name = "__MCPEvalPayload"
+local okSet, setErr = pcall(function() m.Source = USER_CODE end)
+if not okSet then
+	m:Destroy()
+	return { bridge = "ok", ok = false, result = "ModuleScript Source set failed: " .. tostring(setErr) }
+end
+m.Parent = workspace
+local ok, result = bf:Invoke(m)
+m:Destroy()
+return {
+	bridge = "ok",
+	ok = ok,
+	result = if result == nil then nil else tostring(result),
+}
+`;
+        const response = await this.client.request("/api/execute-luau", { code: wrapper }, clientTarget);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(response)
+            }
+          ]
+        };
+      }
       async startPlaytest(mode, numPlayers) {
         if (mode !== "play" && mode !== "run") {
           throw new Error('mode must be "play" or "run"');
@@ -3730,6 +3816,40 @@ var init_definitions = __esm({
           required: ["code"]
         }
       },
+      {
+        name: "eval_server_runtime",
+        category: "write",
+        description: "Execute Luau on the server peer in the running game's Script VM (shares require cache with user game scripts). Use this instead of execute_luau target=server when you need to see runtime-mutated module state. Auto-installed at start_playtest, removed at stop_playtest. Requires ServerScriptService.LoadStringEnabled=true.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            code: {
+              type: "string",
+              description: "Luau code to execute. Use return ... to get a value back."
+            }
+          },
+          required: ["code"]
+        }
+      },
+      {
+        name: "eval_client_runtime",
+        category: "write",
+        description: "Execute Luau on a client peer in the running game's LocalScript VM (shares require cache with user game scripts). Use this instead of execute_luau target=client-N when you need to see runtime-mutated module state. Auto-installed at start_playtest, removed at stop_playtest. Does not require LoadStringEnabled.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            code: {
+              type: "string",
+              description: "Luau code to execute. Use return ... to get a value back."
+            },
+            target: {
+              type: "string",
+              description: 'Client target: "client-1" (default), "client-2", etc.'
+            }
+          },
+          required: ["code"]
+        }
+      },
       // === Script Search ===
       {
         name: "grep_scripts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrrxs/robloxstudio-mcp-inspector",
-  "version": "2.8.1",
+  "version": "2.9.0",
   "description": "Read-only MCP Server for Roblox Studio (fork of boshyxd/robloxstudio-mcp-inspector with per-peer execute_luau fixes baked in)",
   "main": "dist/index.js",
   "type": "module",

package/studio-plugin/MCPInspectorPlugin.rbxmx

@@ -770,11 +770,227 @@ return {
 ]]></string>
         </Properties>
       </Item>
-      <Item class="Folder" referent="4">
+      <Item class="ModuleScript" referent="4">
+        <Properties>
+          <string name="Name">EvalBridges</string>
+          <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
+local TS = require(script.Parent.Parent.include.RuntimeLib)
+-- Game-VM eval bridges, ported from chrrxs/roblox-mcp-primitives.
+--
+-- Our standard `execute_luau target=server/client-N` runs in the plugin VM
+-- with a fresh ModuleScript per call. That gives a clean sandbox but means
+-- `require(SomeModule)` returns a fresh copy, not the one the running game
+-- scripts hold. So runtime-mutated module state is invisible to probes.
+--
+-- These bridges fix that by living inside the user's game scripts:
+--   - Server: a Script in ServerScriptService that creates a BindableFunction
+--     (for our server-peer plugin to invoke directly) plus a RemoteFunction
+--     (kept for parity with the upstream primitive's client-callable shape).
+--   - Client: a LocalScript in StarterPlayer.StarterPlayerScripts that
+--     creates a BindableFunction. Plugin invokes it with a fresh ModuleScript
+--     payload; require() runs inside the LocalScript VM so it shares the
+--     game's require cache.
+--
+-- Lifecycle: TestHandlers.startPlaytest inserts both scripts into the EDIT
+-- DM right before ExecutePlayModeAsync. ExecutePlayModeAsync clones the
+-- DataModel into the play DMs, so the scripts come along and run there.
+-- TestHandlers cleans them up from the edit DM when ExecutePlayModeAsync
+-- returns (test ended for any reason: stop_playtest, manual close, EndTest).
+-- Both scripts have Archivable=false so a user save doesn't persist them.
+local _services = TS.import(script, script.Parent.Parent, "node_modules", "@rbxts", "services")
+local ServerScriptService = _services.ServerScriptService
+local StarterPlayer = _services.StarterPlayer
+local ScriptEditorService = game:GetService("ScriptEditorService")
+local function getStarterPlayerScripts()
+	return StarterPlayer:FindFirstChild("StarterPlayerScripts")
+end
+local SERVER_SCRIPT_NAME = "__MCP_ServerEvalBridge"
+local CLIENT_SCRIPT_NAME = "__MCP_ClientEvalBridge"
+-- Public so the eval_*_runtime tool wrappers can reference the same names.
+local BRIDGE_NAMES = {
+	serverScript = SERVER_SCRIPT_NAME,
+	clientScript = CLIENT_SCRIPT_NAME,
+	serverRemote = "__MCP_ServerEvalRemote",
+	serverLocal = "__MCP_ServerEvalLocal",
+	clientLocal = "__MCP_ClientEvalBridge",
+}
+-- Embedded Luau. The double `${...}` references our exported names so a
+-- rename here propagates to both the script source and the tool wrappers.
+local SERVER_BRIDGE_SOURCE = `\
+-- Auto-installed by @chrrxs/robloxstudio-mcp at start_playtest, removed at\
+-- stop_playtest. Provides shared-require-cache eval on the server peer for\
+-- the eval_server_runtime MCP tool.\
+\
+local ReplicatedStorage = game:GetService("ReplicatedStorage")\
+local ServerScriptService = game:GetService("ServerScriptService")\
+local RunService = game:GetService("RunService")\
+\
+if not RunService:IsStudio() then\
+	return\
+end\
+\
+local function evalCode(source)\
+	if type(source) ~= "string" then\
+		return false, "source must be a string"\
+	end\
+	local fn, compileErr = loadstring(source, "MCPServerEval")\
+	if not fn then\
+		local errStr = tostring(compileErr or "loadstring returned nil")\
+		-- Roblox returns nil from loadstring when LoadStringEnabled=false.\
+		-- Surface a clear, actionable error.\
+		if string.find(errStr, "not enabled", 1, true)\
+			or string.find(errStr, "disabled", 1, true)\
+			or errStr == "loadstring returned nil"\
+		then\
+			return false,\
+				"ServerScriptService.LoadStringEnabled is false. eval_server_runtime requires it. "\
+				.. "Enable it in Studio (ServerScriptService > Properties > LoadStringEnabled = true) "\
+				.. "and restart the playtest."\
+		end\
+		return false, errStr\
+	end\
+	return pcall(fn)\
+end\
+\
+-- Defensive cleanup of stale instances from a prior session.\
+local prevRf = ReplicatedStorage:FindFirstChild("{BRIDGE_NAMES.serverRemote}")\
+if prevRf then prevRf:Destroy() end\
+local prevBf = ServerScriptService:FindFirstChild("{BRIDGE_NAMES.serverLocal}")\
+if prevBf then prevBf:Destroy() end\
+\
+local rf = Instance.new("RemoteFunction")\
+rf.Name = "{BRIDGE_NAMES.serverRemote}"\
+rf.Archivable = false\
+rf.Parent = ReplicatedStorage\
+rf.OnServerInvoke = function(_player, source)\
+	return evalCode(source)\
+end\
+\
+local bf = Instance.new("BindableFunction")\
+bf.Name = "{BRIDGE_NAMES.serverLocal}"\
+bf.Archivable = false\
+bf.Parent = ServerScriptService\
+bf.OnInvoke = function(source)\
+	return evalCode(source)\
+end\
+`
+local CLIENT_BRIDGE_SOURCE = `\
+-- Auto-installed by @chrrxs/robloxstudio-mcp at start_playtest, removed at\
+-- stop_playtest. Provides shared-require-cache eval on the client peer for\
+-- the eval_client_runtime MCP tool.\
+\
+local ReplicatedStorage = game:GetService("ReplicatedStorage")\
+local RunService = game:GetService("RunService")\
+\
+if not RunService:IsStudio() then\
+	return\
+end\
+\
+local prevBf = ReplicatedStorage:FindFirstChild("{BRIDGE_NAMES.clientLocal}")\
+if prevBf then prevBf:Destroy() end\
+\
+local bf = Instance.new("BindableFunction")\
+bf.Name = "{BRIDGE_NAMES.clientLocal}"\
+bf.Archivable = false\
+bf.Parent = ReplicatedStorage\
+bf.OnInvoke = function(payload)\
+	if typeof(payload) ~= "Instance" or not payload:IsA("ModuleScript") then\
+		return false, "payload must be a ModuleScript instance"\
+	end\
+	return pcall(require, payload)\
+end\
+`
+local function setSource(scriptInst, source)
+	-- ScriptEditorService is the cleaner API and integrates with Studio's
+	-- edit history; fall back to direct Source mutation (allowed in plugin
+	-- context with PluginSecurity) if the edit service rejects the call.
+	local seOk = pcall(function()
+		ScriptEditorService:UpdateSourceAsync(scriptInst, function()
+			return source
+		end)
+	end)
+	if not seOk then
+		scriptInst.Source = source
+	end
+end
+local function findBridges()
+	local sps = getStarterPlayerScripts()
+	return {
+		server = ServerScriptService:FindFirstChild(SERVER_SCRIPT_NAME),
+		client = if sps then sps:FindFirstChild(CLIENT_SCRIPT_NAME) else nil,
+	}
+end
+local function cleanupBridges()
+	local _binding = findBridges()
+	local server = _binding.server
+	local client = _binding.client
+	if server then
+		pcall(function()
+			return server:Destroy()
+		end)
+	end
+	if client then
+		pcall(function()
+			return client:Destroy()
+		end)
+	end
+end
+local function installBridges()
+	-- Defensive: clear any stale bridges from a prior unclean exit before
+	-- inserting fresh. The injected script also self-cleans its
+	-- ReplicatedStorage/ServerScriptService children at startup, but the
+	-- containing Script/LocalScript objects themselves we must clear here.
+	cleanupBridges()
+	local ok, err = pcall(function()
+		local serverScript = Instance.new("Script")
+		serverScript.Name = SERVER_SCRIPT_NAME
+		serverScript.Archivable = false
+		setSource(serverScript, SERVER_BRIDGE_SOURCE)
+		serverScript.Parent = ServerScriptService
+		local sps = getStarterPlayerScripts()
+		if not sps then
+			error("StarterPlayer.StarterPlayerScripts not found - cannot install client eval bridge")
+		end
+		local clientScript = Instance.new("LocalScript")
+		clientScript.Name = CLIENT_SCRIPT_NAME
+		clientScript.Archivable = false
+		setSource(clientScript, CLIENT_BRIDGE_SOURCE)
+		clientScript.Parent = sps
+	end)
+	if not ok then
+		return {
+			installed = false,
+			error = tostring(err),
+		}
+	end
+	return {
+		installed = true,
+	}
+end
+-- Heuristic check so start_playtest can surface a warning when
+-- LoadStringEnabled is false (eval_server_runtime won't work in that mode).
+-- We can't import the runtime LoadStringEnabled value cleanly without
+-- pulling in the type — read defensively.
+local function loadStringEnabled()
+	local ok, value = pcall(function()
+		return ServerScriptService.LoadStringEnabled
+	end)
+	return ok and value == true
+end
+return {
+	cleanupBridges = cleanupBridges,
+	installBridges = installBridges,
+	loadStringEnabled = loadStringEnabled,
+	BRIDGE_NAMES = BRIDGE_NAMES,
+}
+]]></string>
+        </Properties>
+      </Item>
+      <Item class="Folder" referent="5">
         <Properties>
           <string name="Name">handlers</string>
         </Properties>
-        <Item class="ModuleScript" referent="5">
+        <Item class="ModuleScript" referent="6">
           <Properties>
             <string name="Name">AssetHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -1060,7 +1276,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="6">
+        <Item class="ModuleScript" referent="7">
           <Properties>
             <string name="Name">BuildHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -1625,7 +1841,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="7">
+        <Item class="ModuleScript" referent="8">
           <Properties>
             <string name="Name">CaptureHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -1791,7 +2007,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="8">
+        <Item class="ModuleScript" referent="9">
           <Properties>
             <string name="Name">InputHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -1945,7 +2161,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="9">
+        <Item class="ModuleScript" referent="10">
           <Properties>
             <string name="Name">InstanceHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -2452,7 +2668,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="10">
+        <Item class="ModuleScript" referent="11">
           <Properties>
             <string name="Name">MetadataHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -3035,7 +3251,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="11">
+        <Item class="ModuleScript" referent="12">
           <Properties>
             <string name="Name">PropertyHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -3287,7 +3503,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="12">
+        <Item class="ModuleScript" referent="13">
           <Properties>
             <string name="Name">QueryHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -4314,7 +4530,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="13">
+        <Item class="ModuleScript" referent="14">
           <Properties>
             <string name="Name">ScriptHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -5010,7 +5226,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="14">
+        <Item class="ModuleScript" referent="15">
           <Properties>
             <string name="Name">TestHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -5018,6 +5234,10 @@ local TS = require(script.Parent.Parent.Parent.include.RuntimeLib)
 local _services = TS.import(script, script.Parent.Parent.Parent, "node_modules", "@rbxts", "services")
 local HttpService = _services.HttpService
 local LogService = _services.LogService
+local _EvalBridges = TS.import(script, script.Parent.Parent, "EvalBridges")
+local installBridges = _EvalBridges.installBridges
+local cleanupBridges = _EvalBridges.cleanupBridges
+local loadStringEnabled = _EvalBridges.loadStringEnabled
 local StudioTestService = game:GetService("StudioTestService")
 local ServerScriptService = game:GetService("ServerScriptService")
 local ScriptEditorService = game:GetService("ScriptEditorService")
@@ -5174,6 +5394,14 @@ local function startPlaytest(requestData)
 	if not injected then
 		warn(`[MCP] Failed to inject stop listener: {injErr}`)
 	end
+	-- Auto-install the game-VM eval bridges (ServerEvalBridge + ClientEvalBridge)
+	-- so eval_server_runtime / eval_client_runtime work without manual setup.
+	-- Bridges are cleaned up from the edit DM after the play DMs tear down.
+	local bridgeInstall = installBridges()
+	local hasLoadString = loadStringEnabled()
+	if not bridgeInstall.installed then
+		warn(`[MCP] Eval bridge install failed: {bridgeInstall.error}`)
+	end
 	if numPlayers ~= nil and mode == "run" then
 		local TestService = game:GetService("TestService")
 		TestService.NumberOfPlayers = math.clamp(numPlayers, 1, 8)
@@ -5196,12 +5424,22 @@ local function startPlaytest(requestData)
 		end
 		testRunning = false
 		cleanupStopListener()
+		cleanupBridges()
 	end)
 	local msg = if numPlayers ~= nil then `Playtest started in {mode} mode with {numPlayers} player(s)` else `Playtest started in {mode} mode`
-	return {
+	local response = {
 		success = true,
 		message = msg,
+		evalBridges = if bridgeInstall.installed then "installed" else `failed: {bridgeInstall.error}`,
 	}
+	-- Surface loadstring availability up-front so callers know whether
+	-- eval_server_runtime will work before they try it. eval_client_runtime
+	-- doesn't need loadstring (it uses ModuleScript+require), so this only
+	-- affects the server bridge.
+	if not hasLoadString then
+		response.serverEvalNote = "ServerScriptService.LoadStringEnabled is false. eval_server_runtime will not work " .. "until you enable it (ServerScriptService > Properties > LoadStringEnabled = true) " .. "and restart the playtest. eval_client_runtime is unaffected."
+	end
+	return response
 end
 local function stopPlaytest(_requestData)
 	-- Server-side routing (tools/index.ts:stopPlaytest) sends /api/stop-playtest
@@ -5307,7 +5545,7 @@ return {
           </Properties>
         </Item>
       </Item>
-      <Item class="ModuleScript" referent="15">
+      <Item class="ModuleScript" referent="16">
         <Properties>
           <string name="Name">Recording</string>
           <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -5337,11 +5575,11 @@ return {
 ]]></string>
         </Properties>
       </Item>
-      <Item class="ModuleScript" referent="16">
+      <Item class="ModuleScript" referent="17">
         <Properties>
           <string name="Name">State</string>
           <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
-local CURRENT_VERSION = "2.8.1"
+local CURRENT_VERSION = "2.9.0"
 local MAX_CONNECTIONS = 5
 local BASE_PORT = 58741
 local activeTabIndex = 0
@@ -5433,7 +5671,7 @@ return {
 ]]></string>
         </Properties>
       </Item>
-      <Item class="ModuleScript" referent="17">
+      <Item class="ModuleScript" referent="18">
         <Properties>
           <string name="Name">UI</string>
           <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -6153,7 +6391,7 @@ return {
 ]]></string>
         </Properties>
       </Item>
-      <Item class="ModuleScript" referent="18">
+      <Item class="ModuleScript" referent="19">
         <Properties>
           <string name="Name">Utils</string>
           <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -6683,11 +6921,11 @@ return {
         </Properties>
       </Item>
     </Item>
-    <Item class="Folder" referent="22">
+    <Item class="Folder" referent="23">
       <Properties>
         <string name="Name">include</string>
       </Properties>
-      <Item class="ModuleScript" referent="19">
+      <Item class="ModuleScript" referent="20">
         <Properties>
           <string name="Name">Promise</string>
           <string name="Source"><![CDATA[--[[
@@ -8761,7 +8999,7 @@ return Promise
 ]]></string>
         </Properties>
       </Item>
-      <Item class="ModuleScript" referent="20">
+      <Item class="ModuleScript" referent="21">
         <Properties>
           <string name="Name">RuntimeLib</string>
           <string name="Source"><![CDATA[local Promise = require(script.Parent.Promise)
@@ -9028,15 +9266,15 @@ return TS
         </Properties>
       </Item>
     </Item>
-    <Item class="Folder" referent="23">
+    <Item class="Folder" referent="24">
       <Properties>
         <string name="Name">node_modules</string>
       </Properties>
-      <Item class="Folder" referent="24">
+      <Item class="Folder" referent="25">
         <Properties>
           <string name="Name">@rbxts</string>
         </Properties>
-      <Item class="ModuleScript" referent="21">
+      <Item class="ModuleScript" referent="22">
         <Properties>
           <string name="Name">services</string>
           <string name="Source"><![CDATA[return setmetatable({}, {

package/studio-plugin/MCPPlugin.rbxmx

@@ -770,11 +770,227 @@ return {
 ]]></string>
         </Properties>
       </Item>
-      <Item class="Folder" referent="4">
+      <Item class="ModuleScript" referent="4">
+        <Properties>
+          <string name="Name">EvalBridges</string>
+          <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
+local TS = require(script.Parent.Parent.include.RuntimeLib)
+-- Game-VM eval bridges, ported from chrrxs/roblox-mcp-primitives.
+--
+-- Our standard `execute_luau target=server/client-N` runs in the plugin VM
+-- with a fresh ModuleScript per call. That gives a clean sandbox but means
+-- `require(SomeModule)` returns a fresh copy, not the one the running game
+-- scripts hold. So runtime-mutated module state is invisible to probes.
+--
+-- These bridges fix that by living inside the user's game scripts:
+--   - Server: a Script in ServerScriptService that creates a BindableFunction
+--     (for our server-peer plugin to invoke directly) plus a RemoteFunction
+--     (kept for parity with the upstream primitive's client-callable shape).
+--   - Client: a LocalScript in StarterPlayer.StarterPlayerScripts that
+--     creates a BindableFunction. Plugin invokes it with a fresh ModuleScript
+--     payload; require() runs inside the LocalScript VM so it shares the
+--     game's require cache.
+--
+-- Lifecycle: TestHandlers.startPlaytest inserts both scripts into the EDIT
+-- DM right before ExecutePlayModeAsync. ExecutePlayModeAsync clones the
+-- DataModel into the play DMs, so the scripts come along and run there.
+-- TestHandlers cleans them up from the edit DM when ExecutePlayModeAsync
+-- returns (test ended for any reason: stop_playtest, manual close, EndTest).
+-- Both scripts have Archivable=false so a user save doesn't persist them.
+local _services = TS.import(script, script.Parent.Parent, "node_modules", "@rbxts", "services")
+local ServerScriptService = _services.ServerScriptService
+local StarterPlayer = _services.StarterPlayer
+local ScriptEditorService = game:GetService("ScriptEditorService")
+local function getStarterPlayerScripts()
+	return StarterPlayer:FindFirstChild("StarterPlayerScripts")
+end
+local SERVER_SCRIPT_NAME = "__MCP_ServerEvalBridge"
+local CLIENT_SCRIPT_NAME = "__MCP_ClientEvalBridge"
+-- Public so the eval_*_runtime tool wrappers can reference the same names.
+local BRIDGE_NAMES = {
+	serverScript = SERVER_SCRIPT_NAME,
+	clientScript = CLIENT_SCRIPT_NAME,
+	serverRemote = "__MCP_ServerEvalRemote",
+	serverLocal = "__MCP_ServerEvalLocal",
+	clientLocal = "__MCP_ClientEvalBridge",
+}
+-- Embedded Luau. The double `${...}` references our exported names so a
+-- rename here propagates to both the script source and the tool wrappers.
+local SERVER_BRIDGE_SOURCE = `\
+-- Auto-installed by @chrrxs/robloxstudio-mcp at start_playtest, removed at\
+-- stop_playtest. Provides shared-require-cache eval on the server peer for\
+-- the eval_server_runtime MCP tool.\
+\
+local ReplicatedStorage = game:GetService("ReplicatedStorage")\
+local ServerScriptService = game:GetService("ServerScriptService")\
+local RunService = game:GetService("RunService")\
+\
+if not RunService:IsStudio() then\
+	return\
+end\
+\
+local function evalCode(source)\
+	if type(source) ~= "string" then\
+		return false, "source must be a string"\
+	end\
+	local fn, compileErr = loadstring(source, "MCPServerEval")\
+	if not fn then\
+		local errStr = tostring(compileErr or "loadstring returned nil")\
+		-- Roblox returns nil from loadstring when LoadStringEnabled=false.\
+		-- Surface a clear, actionable error.\
+		if string.find(errStr, "not enabled", 1, true)\
+			or string.find(errStr, "disabled", 1, true)\
+			or errStr == "loadstring returned nil"\
+		then\
+			return false,\
+				"ServerScriptService.LoadStringEnabled is false. eval_server_runtime requires it. "\
+				.. "Enable it in Studio (ServerScriptService > Properties > LoadStringEnabled = true) "\
+				.. "and restart the playtest."\
+		end\
+		return false, errStr\
+	end\
+	return pcall(fn)\
+end\
+\
+-- Defensive cleanup of stale instances from a prior session.\
+local prevRf = ReplicatedStorage:FindFirstChild("{BRIDGE_NAMES.serverRemote}")\
+if prevRf then prevRf:Destroy() end\
+local prevBf = ServerScriptService:FindFirstChild("{BRIDGE_NAMES.serverLocal}")\
+if prevBf then prevBf:Destroy() end\
+\
+local rf = Instance.new("RemoteFunction")\
+rf.Name = "{BRIDGE_NAMES.serverRemote}"\
+rf.Archivable = false\
+rf.Parent = ReplicatedStorage\
+rf.OnServerInvoke = function(_player, source)\
+	return evalCode(source)\
+end\
+\
+local bf = Instance.new("BindableFunction")\
+bf.Name = "{BRIDGE_NAMES.serverLocal}"\
+bf.Archivable = false\
+bf.Parent = ServerScriptService\
+bf.OnInvoke = function(source)\
+	return evalCode(source)\
+end\
+`
+local CLIENT_BRIDGE_SOURCE = `\
+-- Auto-installed by @chrrxs/robloxstudio-mcp at start_playtest, removed at\
+-- stop_playtest. Provides shared-require-cache eval on the client peer for\
+-- the eval_client_runtime MCP tool.\
+\
+local ReplicatedStorage = game:GetService("ReplicatedStorage")\
+local RunService = game:GetService("RunService")\
+\
+if not RunService:IsStudio() then\
+	return\
+end\
+\
+local prevBf = ReplicatedStorage:FindFirstChild("{BRIDGE_NAMES.clientLocal}")\
+if prevBf then prevBf:Destroy() end\
+\
+local bf = Instance.new("BindableFunction")\
+bf.Name = "{BRIDGE_NAMES.clientLocal}"\
+bf.Archivable = false\
+bf.Parent = ReplicatedStorage\
+bf.OnInvoke = function(payload)\
+	if typeof(payload) ~= "Instance" or not payload:IsA("ModuleScript") then\
+		return false, "payload must be a ModuleScript instance"\
+	end\
+	return pcall(require, payload)\
+end\
+`
+local function setSource(scriptInst, source)
+	-- ScriptEditorService is the cleaner API and integrates with Studio's
+	-- edit history; fall back to direct Source mutation (allowed in plugin
+	-- context with PluginSecurity) if the edit service rejects the call.
+	local seOk = pcall(function()
+		ScriptEditorService:UpdateSourceAsync(scriptInst, function()
+			return source
+		end)
+	end)
+	if not seOk then
+		scriptInst.Source = source
+	end
+end
+local function findBridges()
+	local sps = getStarterPlayerScripts()
+	return {
+		server = ServerScriptService:FindFirstChild(SERVER_SCRIPT_NAME),
+		client = if sps then sps:FindFirstChild(CLIENT_SCRIPT_NAME) else nil,
+	}
+end
+local function cleanupBridges()
+	local _binding = findBridges()
+	local server = _binding.server
+	local client = _binding.client
+	if server then
+		pcall(function()
+			return server:Destroy()
+		end)
+	end
+	if client then
+		pcall(function()
+			return client:Destroy()
+		end)
+	end
+end
+local function installBridges()
+	-- Defensive: clear any stale bridges from a prior unclean exit before
+	-- inserting fresh. The injected script also self-cleans its
+	-- ReplicatedStorage/ServerScriptService children at startup, but the
+	-- containing Script/LocalScript objects themselves we must clear here.
+	cleanupBridges()
+	local ok, err = pcall(function()
+		local serverScript = Instance.new("Script")
+		serverScript.Name = SERVER_SCRIPT_NAME
+		serverScript.Archivable = false
+		setSource(serverScript, SERVER_BRIDGE_SOURCE)
+		serverScript.Parent = ServerScriptService
+		local sps = getStarterPlayerScripts()
+		if not sps then
+			error("StarterPlayer.StarterPlayerScripts not found - cannot install client eval bridge")
+		end
+		local clientScript = Instance.new("LocalScript")
+		clientScript.Name = CLIENT_SCRIPT_NAME
+		clientScript.Archivable = false
+		setSource(clientScript, CLIENT_BRIDGE_SOURCE)
+		clientScript.Parent = sps
+	end)
+	if not ok then
+		return {
+			installed = false,
+			error = tostring(err),
+		}
+	end
+	return {
+		installed = true,
+	}
+end
+-- Heuristic check so start_playtest can surface a warning when
+-- LoadStringEnabled is false (eval_server_runtime won't work in that mode).
+-- We can't import the runtime LoadStringEnabled value cleanly without
+-- pulling in the type — read defensively.
+local function loadStringEnabled()
+	local ok, value = pcall(function()
+		return ServerScriptService.LoadStringEnabled
+	end)
+	return ok and value == true
+end
+return {
+	cleanupBridges = cleanupBridges,
+	installBridges = installBridges,
+	loadStringEnabled = loadStringEnabled,
+	BRIDGE_NAMES = BRIDGE_NAMES,
+}
+]]></string>
+        </Properties>
+      </Item>
+      <Item class="Folder" referent="5">
         <Properties>
           <string name="Name">handlers</string>
         </Properties>
-        <Item class="ModuleScript" referent="5">
+        <Item class="ModuleScript" referent="6">
           <Properties>
             <string name="Name">AssetHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -1060,7 +1276,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="6">
+        <Item class="ModuleScript" referent="7">
           <Properties>
             <string name="Name">BuildHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -1625,7 +1841,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="7">
+        <Item class="ModuleScript" referent="8">
           <Properties>
             <string name="Name">CaptureHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -1791,7 +2007,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="8">
+        <Item class="ModuleScript" referent="9">
           <Properties>
             <string name="Name">InputHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -1945,7 +2161,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="9">
+        <Item class="ModuleScript" referent="10">
           <Properties>
             <string name="Name">InstanceHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -2452,7 +2668,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="10">
+        <Item class="ModuleScript" referent="11">
           <Properties>
             <string name="Name">MetadataHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -3035,7 +3251,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="11">
+        <Item class="ModuleScript" referent="12">
           <Properties>
             <string name="Name">PropertyHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -3287,7 +3503,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="12">
+        <Item class="ModuleScript" referent="13">
           <Properties>
             <string name="Name">QueryHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -4314,7 +4530,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="13">
+        <Item class="ModuleScript" referent="14">
           <Properties>
             <string name="Name">ScriptHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -5010,7 +5226,7 @@ return {
 ]]></string>
           </Properties>
         </Item>
-        <Item class="ModuleScript" referent="14">
+        <Item class="ModuleScript" referent="15">
           <Properties>
             <string name="Name">TestHandlers</string>
             <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -5018,6 +5234,10 @@ local TS = require(script.Parent.Parent.Parent.include.RuntimeLib)
 local _services = TS.import(script, script.Parent.Parent.Parent, "node_modules", "@rbxts", "services")
 local HttpService = _services.HttpService
 local LogService = _services.LogService
+local _EvalBridges = TS.import(script, script.Parent.Parent, "EvalBridges")
+local installBridges = _EvalBridges.installBridges
+local cleanupBridges = _EvalBridges.cleanupBridges
+local loadStringEnabled = _EvalBridges.loadStringEnabled
 local StudioTestService = game:GetService("StudioTestService")
 local ServerScriptService = game:GetService("ServerScriptService")
 local ScriptEditorService = game:GetService("ScriptEditorService")
@@ -5174,6 +5394,14 @@ local function startPlaytest(requestData)
 	if not injected then
 		warn(`[MCP] Failed to inject stop listener: {injErr}`)
 	end
+	-- Auto-install the game-VM eval bridges (ServerEvalBridge + ClientEvalBridge)
+	-- so eval_server_runtime / eval_client_runtime work without manual setup.
+	-- Bridges are cleaned up from the edit DM after the play DMs tear down.
+	local bridgeInstall = installBridges()
+	local hasLoadString = loadStringEnabled()
+	if not bridgeInstall.installed then
+		warn(`[MCP] Eval bridge install failed: {bridgeInstall.error}`)
+	end
 	if numPlayers ~= nil and mode == "run" then
 		local TestService = game:GetService("TestService")
 		TestService.NumberOfPlayers = math.clamp(numPlayers, 1, 8)
@@ -5196,12 +5424,22 @@ local function startPlaytest(requestData)
 		end
 		testRunning = false
 		cleanupStopListener()
+		cleanupBridges()
 	end)
 	local msg = if numPlayers ~= nil then `Playtest started in {mode} mode with {numPlayers} player(s)` else `Playtest started in {mode} mode`
-	return {
+	local response = {
 		success = true,
 		message = msg,
+		evalBridges = if bridgeInstall.installed then "installed" else `failed: {bridgeInstall.error}`,
 	}
+	-- Surface loadstring availability up-front so callers know whether
+	-- eval_server_runtime will work before they try it. eval_client_runtime
+	-- doesn't need loadstring (it uses ModuleScript+require), so this only
+	-- affects the server bridge.
+	if not hasLoadString then
+		response.serverEvalNote = "ServerScriptService.LoadStringEnabled is false. eval_server_runtime will not work " .. "until you enable it (ServerScriptService > Properties > LoadStringEnabled = true) " .. "and restart the playtest. eval_client_runtime is unaffected."
+	end
+	return response
 end
 local function stopPlaytest(_requestData)
 	-- Server-side routing (tools/index.ts:stopPlaytest) sends /api/stop-playtest
@@ -5307,7 +5545,7 @@ return {
           </Properties>
         </Item>
       </Item>
-      <Item class="ModuleScript" referent="15">
+      <Item class="ModuleScript" referent="16">
         <Properties>
           <string name="Name">Recording</string>
           <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -5337,11 +5575,11 @@ return {
 ]]></string>
         </Properties>
       </Item>
-      <Item class="ModuleScript" referent="16">
+      <Item class="ModuleScript" referent="17">
         <Properties>
           <string name="Name">State</string>
           <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
-local CURRENT_VERSION = "2.8.1"
+local CURRENT_VERSION = "2.9.0"
 local MAX_CONNECTIONS = 5
 local BASE_PORT = 58741
 local activeTabIndex = 0
@@ -5433,7 +5671,7 @@ return {
 ]]></string>
         </Properties>
       </Item>
-      <Item class="ModuleScript" referent="17">
+      <Item class="ModuleScript" referent="18">
         <Properties>
           <string name="Name">UI</string>
           <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -6153,7 +6391,7 @@ return {
 ]]></string>
         </Properties>
       </Item>
-      <Item class="ModuleScript" referent="18">
+      <Item class="ModuleScript" referent="19">
         <Properties>
           <string name="Name">Utils</string>
           <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
@@ -6683,11 +6921,11 @@ return {
         </Properties>
       </Item>
     </Item>
-    <Item class="Folder" referent="22">
+    <Item class="Folder" referent="23">
       <Properties>
         <string name="Name">include</string>
       </Properties>
-      <Item class="ModuleScript" referent="19">
+      <Item class="ModuleScript" referent="20">
         <Properties>
           <string name="Name">Promise</string>
           <string name="Source"><![CDATA[--[[
@@ -8761,7 +8999,7 @@ return Promise
 ]]></string>
         </Properties>
       </Item>
-      <Item class="ModuleScript" referent="20">
+      <Item class="ModuleScript" referent="21">
         <Properties>
           <string name="Name">RuntimeLib</string>
           <string name="Source"><![CDATA[local Promise = require(script.Parent.Promise)
@@ -9028,15 +9266,15 @@ return TS
         </Properties>
       </Item>
     </Item>
-    <Item class="Folder" referent="23">
+    <Item class="Folder" referent="24">
       <Properties>
         <string name="Name">node_modules</string>
       </Properties>
-      <Item class="Folder" referent="24">
+      <Item class="Folder" referent="25">
         <Properties>
           <string name="Name">@rbxts</string>
         </Properties>
-      <Item class="ModuleScript" referent="21">
+      <Item class="ModuleScript" referent="22">
         <Properties>
           <string name="Name">services</string>
           <string name="Source"><![CDATA[return setmetatable({}, {

package/studio-plugin/src/modules/EvalBridges.ts

@@ -0,0 +1,203 @@
+// Game-VM eval bridges, ported from chrrxs/roblox-mcp-primitives.
+//
+// Our standard `execute_luau target=server/client-N` runs in the plugin VM
+// with a fresh ModuleScript per call. That gives a clean sandbox but means
+// `require(SomeModule)` returns a fresh copy, not the one the running game
+// scripts hold. So runtime-mutated module state is invisible to probes.
+//
+// These bridges fix that by living inside the user's game scripts:
+//   - Server: a Script in ServerScriptService that creates a BindableFunction
+//     (for our server-peer plugin to invoke directly) plus a RemoteFunction
+//     (kept for parity with the upstream primitive's client-callable shape).
+//   - Client: a LocalScript in StarterPlayer.StarterPlayerScripts that
+//     creates a BindableFunction. Plugin invokes it with a fresh ModuleScript
+//     payload; require() runs inside the LocalScript VM so it shares the
+//     game's require cache.
+//
+// Lifecycle: TestHandlers.startPlaytest inserts both scripts into the EDIT
+// DM right before ExecutePlayModeAsync. ExecutePlayModeAsync clones the
+// DataModel into the play DMs, so the scripts come along and run there.
+// TestHandlers cleans them up from the edit DM when ExecutePlayModeAsync
+// returns (test ended for any reason: stop_playtest, manual close, EndTest).
+// Both scripts have Archivable=false so a user save doesn't persist them.
+
+import { ServerScriptService, StarterPlayer } from "@rbxts/services";
+
+const ScriptEditorService = game.GetService("ScriptEditorService");
+
+function getStarterPlayerScripts(): Instance | undefined {
+	return StarterPlayer.FindFirstChild("StarterPlayerScripts");
+}
+
+const SERVER_SCRIPT_NAME = "__MCP_ServerEvalBridge";
+const CLIENT_SCRIPT_NAME = "__MCP_ClientEvalBridge";
+
+// Public so the eval_*_runtime tool wrappers can reference the same names.
+export const BRIDGE_NAMES = {
+	serverScript: SERVER_SCRIPT_NAME,
+	clientScript: CLIENT_SCRIPT_NAME,
+	serverRemote: "__MCP_ServerEvalRemote",
+	serverLocal: "__MCP_ServerEvalLocal",
+	clientLocal: "__MCP_ClientEvalBridge",
+} as const;
+
+// Embedded Luau. The double `${...}` references our exported names so a
+// rename here propagates to both the script source and the tool wrappers.
+const SERVER_BRIDGE_SOURCE = `
+-- Auto-installed by @chrrxs/robloxstudio-mcp at start_playtest, removed at
+-- stop_playtest. Provides shared-require-cache eval on the server peer for
+-- the eval_server_runtime MCP tool.
+
+local ReplicatedStorage = game:GetService("ReplicatedStorage")
+local ServerScriptService = game:GetService("ServerScriptService")
+local RunService = game:GetService("RunService")
+
+if not RunService:IsStudio() then
+	return
+end
+
+local function evalCode(source)
+	if type(source) ~= "string" then
+		return false, "source must be a string"
+	end
+	local fn, compileErr = loadstring(source, "MCPServerEval")
+	if not fn then
+		local errStr = tostring(compileErr or "loadstring returned nil")
+		-- Roblox returns nil from loadstring when LoadStringEnabled=false.
+		-- Surface a clear, actionable error.
+		if string.find(errStr, "not enabled", 1, true)
+			or string.find(errStr, "disabled", 1, true)
+			or errStr == "loadstring returned nil"
+		then
+			return false,
+				"ServerScriptService.LoadStringEnabled is false. eval_server_runtime requires it. "
+				.. "Enable it in Studio (ServerScriptService > Properties > LoadStringEnabled = true) "
+				.. "and restart the playtest."
+		end
+		return false, errStr
+	end
+	return pcall(fn)
+end
+
+-- Defensive cleanup of stale instances from a prior session.
+local prevRf = ReplicatedStorage:FindFirstChild("${BRIDGE_NAMES.serverRemote}")
+if prevRf then prevRf:Destroy() end
+local prevBf = ServerScriptService:FindFirstChild("${BRIDGE_NAMES.serverLocal}")
+if prevBf then prevBf:Destroy() end
+
+local rf = Instance.new("RemoteFunction")
+rf.Name = "${BRIDGE_NAMES.serverRemote}"
+rf.Archivable = false
+rf.Parent = ReplicatedStorage
+rf.OnServerInvoke = function(_player, source)
+	return evalCode(source)
+end
+
+local bf = Instance.new("BindableFunction")
+bf.Name = "${BRIDGE_NAMES.serverLocal}"
+bf.Archivable = false
+bf.Parent = ServerScriptService
+bf.OnInvoke = function(source)
+	return evalCode(source)
+end
+`;
+
+const CLIENT_BRIDGE_SOURCE = `
+-- Auto-installed by @chrrxs/robloxstudio-mcp at start_playtest, removed at
+-- stop_playtest. Provides shared-require-cache eval on the client peer for
+-- the eval_client_runtime MCP tool.
+
+local ReplicatedStorage = game:GetService("ReplicatedStorage")
+local RunService = game:GetService("RunService")
+
+if not RunService:IsStudio() then
+	return
+end
+
+local prevBf = ReplicatedStorage:FindFirstChild("${BRIDGE_NAMES.clientLocal}")
+if prevBf then prevBf:Destroy() end
+
+local bf = Instance.new("BindableFunction")
+bf.Name = "${BRIDGE_NAMES.clientLocal}"
+bf.Archivable = false
+bf.Parent = ReplicatedStorage
+bf.OnInvoke = function(payload)
+	if typeof(payload) ~= "Instance" or not payload:IsA("ModuleScript") then
+		return false, "payload must be a ModuleScript instance"
+	end
+	return pcall(require, payload)
+end
+`;
+
+function setSource(scriptInst: Script | LocalScript, source: string): void {
+	// ScriptEditorService is the cleaner API and integrates with Studio's
+	// edit history; fall back to direct Source mutation (allowed in plugin
+	// context with PluginSecurity) if the edit service rejects the call.
+	const [seOk] = pcall(() => {
+		ScriptEditorService.UpdateSourceAsync(scriptInst, () => source);
+	});
+	if (!seOk) {
+		(scriptInst as unknown as { Source: string }).Source = source;
+	}
+}
+
+function findBridges(): { server?: Instance; client?: Instance } {
+	const sps = getStarterPlayerScripts();
+	return {
+		server: ServerScriptService.FindFirstChild(SERVER_SCRIPT_NAME),
+		client: sps ? sps.FindFirstChild(CLIENT_SCRIPT_NAME) : undefined,
+	};
+}
+
+export function cleanupBridges(): void {
+	const { server, client } = findBridges();
+	if (server) {
+		pcall(() => server.Destroy());
+	}
+	if (client) {
+		pcall(() => client.Destroy());
+	}
+}
+
+export function installBridges(): { installed: boolean; error?: string } {
+	// Defensive: clear any stale bridges from a prior unclean exit before
+	// inserting fresh. The injected script also self-cleans its
+	// ReplicatedStorage/ServerScriptService children at startup, but the
+	// containing Script/LocalScript objects themselves we must clear here.
+	cleanupBridges();
+
+	const [ok, err] = pcall(() => {
+		const serverScript = new Instance("Script");
+		serverScript.Name = SERVER_SCRIPT_NAME;
+		serverScript.Archivable = false;
+		setSource(serverScript, SERVER_BRIDGE_SOURCE);
+		serverScript.Parent = ServerScriptService;
+
+		const sps = getStarterPlayerScripts();
+		if (!sps) {
+			error("StarterPlayer.StarterPlayerScripts not found - cannot install client eval bridge");
+		}
+		const clientScript = new Instance("LocalScript");
+		clientScript.Name = CLIENT_SCRIPT_NAME;
+		clientScript.Archivable = false;
+		setSource(clientScript, CLIENT_BRIDGE_SOURCE);
+		clientScript.Parent = sps;
+	});
+
+	if (!ok) {
+		return { installed: false, error: tostring(err) };
+	}
+	return { installed: true };
+}
+
+// Heuristic check so start_playtest can surface a warning when
+// LoadStringEnabled is false (eval_server_runtime won't work in that mode).
+// We can't import the runtime LoadStringEnabled value cleanly without
+// pulling in the type — read defensively.
+export function loadStringEnabled(): boolean {
+	const [ok, value] = pcall(
+		() => (ServerScriptService as unknown as { LoadStringEnabled: boolean }).LoadStringEnabled,
+	);
+	return ok && value === true;
+}
+

package/studio-plugin/src/modules/handlers/TestHandlers.ts

@@ -1,4 +1,5 @@
 import { HttpService, LogService } from "@rbxts/services";
+import { installBridges, cleanupBridges, loadStringEnabled } from "../EvalBridges";
 
 const StudioTestService = game.GetService("StudioTestService");
 const ServerScriptService = game.GetService("ServerScriptService");
@@ -154,6 +155,15 @@ function startPlaytest(requestData: Record<string, unknown>) {
 		warn(`[MCP] Failed to inject stop listener: ${injErr}`);
 	}
 
+	// Auto-install the game-VM eval bridges (ServerEvalBridge + ClientEvalBridge)
+	// so eval_server_runtime / eval_client_runtime work without manual setup.
+	// Bridges are cleaned up from the edit DM after the play DMs tear down.
+	const bridgeInstall = installBridges();
+	const hasLoadString = loadStringEnabled();
+	if (!bridgeInstall.installed) {
+		warn(`[MCP] Eval bridge install failed: ${bridgeInstall.error}`);
+	}
+
 	if (numPlayers !== undefined && mode === "run") {
 		const TestService = game.GetService("TestService") as TestService & { NumberOfPlayers: number };
 		TestService.NumberOfPlayers = math.clamp(numPlayers, 1, 8);
@@ -180,12 +190,31 @@ function startPlaytest(requestData: Record<string, unknown>) {
 		testRunning = false;
 
 		cleanupStopListener();
+		cleanupBridges();
 	});
 
 	const msg = numPlayers !== undefined
 		? `Playtest started in ${mode} mode with ${numPlayers} player(s)`
 		: `Playtest started in ${mode} mode`;
-	return { success: true, message: msg };
+
+	const response: Record<string, unknown> = {
+		success: true,
+		message: msg,
+		evalBridges: bridgeInstall.installed ? "installed" : `failed: ${bridgeInstall.error}`,
+	};
+
+	// Surface loadstring availability up-front so callers know whether
+	// eval_server_runtime will work before they try it. eval_client_runtime
+	// doesn't need loadstring (it uses ModuleScript+require), so this only
+	// affects the server bridge.
+	if (!hasLoadString) {
+		response.serverEvalNote =
+			"ServerScriptService.LoadStringEnabled is false. eval_server_runtime will not work " +
+			"until you enable it (ServerScriptService > Properties > LoadStringEnabled = true) " +
+			"and restart the playtest. eval_client_runtime is unaffected.";
+	}
+
+	return response;
 }
 
 function stopPlaytest(_requestData: Record<string, unknown>) {