flockbay 0.10.32 → 0.10.33

package/bin/flockbay.mjs

@@ -38,6 +38,13 @@ const entrypoint = (() => {
 const useTsx = entrypoint.endsWith('.ts');
 const invokedCwd = process.cwd();
 
+function rewriteTopLevelAliases(args) {
+  const cmd = args[0];
+  if (cmd === 'install') return ['daemon', 'install', ...args.slice(1)];
+  if (cmd === 'uninstall') return ['daemon', 'uninstall', ...args.slice(1)];
+  return args;
+}
+
 function resolveTsxImportArgs() {
   if (!useTsx) return [];
   const candidates = [
@@ -50,6 +57,8 @@ function resolveTsxImportArgs() {
   return resolved ? ['--import', resolved] : ['--import', 'tsx'];
 }
 
+const rewrittenArgs = rewriteTopLevelAliases(process.argv.slice(2));
+
 if (!hasNoWarnings || !hasNoDeprecation || useTsx) {
   try {
     execFileSync(
@@ -59,7 +68,7 @@ if (!hasNoWarnings || !hasNoDeprecation || useTsx) {
         '--no-deprecation',
         ...resolveTsxImportArgs(),
         entrypoint,
-        ...process.argv.slice(2),
+        ...rewrittenArgs,
       ],
       {
         stdio: 'inherit',
@@ -74,5 +83,7 @@ if (!hasNoWarnings || !hasNoDeprecation || useTsx) {
     process.exit(error?.status || 1);
   }
 } else {
+  // When running via direct import, mutate argv so the entrypoint sees the same aliases.
+  process.argv.splice(2, process.argv.length - 2, ...rewrittenArgs);
   await import('../dist/index.mjs');
 }

package/dist/codex/flockbayMcpStdioBridge.cjs

@@ -42,7 +42,7 @@ async function main() {
     return client;
   }
   const server = new mcp_js.McpServer({
-    name: "Flockbay MCP Bridge",
+    name: "MCP Local Connector",
     version: "1.0.0"
   });
   function forwardTool(name, inputSchema, title, description) {
@@ -112,6 +112,25 @@ async function main() {
     "Evidence Get",
     "Fetch one server-stored evidence manifest by id."
   );
+  forwardTool(
+    "tool_result_read",
+    {
+      toolName: z.z.string().optional().describe("Tool name (folder under .flockbay/artifacts/tool-results)."),
+      toolResultId: z.z.string().describe("toolResultId from a prior tool observation.")
+    },
+    "Tool Result Read",
+    "Read a previously-stored MCP tool result artifact (full tool input/output JSON)."
+  );
+  forwardTool(
+    "tool_result_query",
+    {
+      toolName: z.z.string().optional().describe("Tool name (folder under .flockbay/artifacts/tool-results)."),
+      toolResultId: z.z.string().describe("toolResultId from a prior tool observation."),
+      paths: z.z.array(z.z.string()).min(1).describe('JSON pointer paths ("/output/result/location") or dot-paths ("output.result.location").')
+    },
+    "Tool Result Query",
+    "Query one or more JSON paths from a stored tool result artifact (small slices)."
+  );
   forwardTool(
     "ask_user_question",
     {
@@ -221,6 +240,16 @@ async function main() {
     "Docs Get",
     "Fetch a single Documentation document node (includes markdown body)."
   );
+  forwardTool(
+    "docs_read",
+    {
+      nodeId: z.z.string().describe("Document node id."),
+      offset: z.z.number().int().nonnegative().optional().describe("Character offset into bodyMarkdown (default 0)."),
+      maxChars: z.z.number().int().positive().optional().describe("Max characters to return (default 4000; max 8000).")
+    },
+    "Docs Read (chunked)",
+    "Read a Documentation document body in small chunks to avoid token blowups."
+  );
   forwardTool(
     "docs_search",
     {
@@ -327,12 +356,12 @@ async function main() {
   forwardTool(
     "unreal_mcp_command",
     {
-      type: z.z.string().describe('UnrealMCP command type (e.g. "get_actors_in_level", "spawn_actor").'),
+      type: z.z.string().describe('Unreal MCP command type (e.g. "get_actors_in_level", "spawn_actor").'),
       params: z.z.record(z.z.any()).optional().describe("Optional params object for the command."),
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Editor Command (UnrealMCP)",
-    "Send a single UnrealMCP command to the running Unreal Editor (engine plugin) and return the JSON response."
+    "Unreal Editor Command (Unreal MCP)",
+    "Send a single Unreal MCP command to the running Unreal Editor (engine plugin) and return the JSON response."
   );
   forwardTool(
     "unreal_mcp_search_assets",
@@ -343,8 +372,8 @@ async function main() {
       limit: z.z.number().int().positive().optional().describe("Max results (default 25, max 200)."),
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Search Assets (UnrealMCP)",
-    "Search for assets in the current Unreal project via the UnrealMCP engine plugin (AssetRegistry-backed)."
+    "Unreal Search Assets (Unreal MCP)",
+    "Search for assets in the current Unreal project via the Unreal MCP engine plugin (AssetRegistry-backed)."
   );
   forwardTool(
     "unreal_mcp_get_asset_info",
@@ -353,8 +382,8 @@ async function main() {
       includeDependencies: z.z.boolean().optional().describe("Include package dependencies (default false)."),
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Asset Info (UnrealMCP)",
-    "Get metadata for a single Unreal asset (class/path + optional dependencies) via the UnrealMCP engine plugin."
+    "Unreal Asset Info (Unreal MCP)",
+    "Get metadata for a single Unreal asset (class/path + optional dependencies) via the Unreal MCP engine plugin."
   );
   forwardTool(
     "unreal_mcp_list_asset_packs",
@@ -362,8 +391,8 @@ async function main() {
       limit: z.z.number().int().positive().optional().describe("Max number of packs (default 200)."),
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal List Asset Packs (UnrealMCP)",
-    'List top-level /Game content folders (best-effort "asset packs") via the UnrealMCP engine plugin.'
+    "Unreal List Asset Packs (Unreal MCP)",
+    'List top-level /Game content folders (best-effort "asset packs") via the Unreal MCP engine plugin.'
   );
   forwardTool(
     "unreal_mcp_place_asset",
@@ -375,7 +404,7 @@ async function main() {
       scale: z.z.array(z.z.number()).length(3).optional().describe("Spawn scale [X,Y,Z]."),
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Place Asset (UnrealMCP)",
+    "Unreal Place Asset (Unreal MCP)",
     "Place an asset into the current Unreal level by object path (StaticMesh/Blueprint). Fails if PIE is running."
   );
   forwardTool(
@@ -383,7 +412,7 @@ async function main() {
     {
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Editor Context (UnrealMCP)",
+    "Unreal Editor Context (Unreal MCP)",
     "Return a compact snapshot of editor context: map, selection, and active viewport camera."
   );
   forwardTool(
@@ -423,7 +452,7 @@ async function main() {
       source: z.z.enum(["editor", "pie"]).optional().describe("World source (default editor)."),
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Actor Transform (UnrealMCP)",
+    "Unreal Actor Transform (Unreal MCP)",
     "Get a single actor transform (location/rotation/scale) by actor name or label."
   );
   forwardTool(
@@ -433,7 +462,7 @@ async function main() {
       source: z.z.enum(["editor", "pie"]).optional().describe("World source (default editor)."),
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Actor Bounds (UnrealMCP)",
+    "Unreal Actor Bounds (Unreal MCP)",
     "Get a single actor bounds (origin/extent + min/max) by actor name or label."
   );
   forwardTool(
@@ -443,7 +472,7 @@ async function main() {
       limit: z.z.number().int().positive().optional().describe("Max number of issues to return (default 200, max 1000)."),
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 15000).")
     },
-    "Unreal Map Check (UnrealMCP)",
+    "Unreal Map Check (Unreal MCP)",
     "Run Unreal Map Check and return structured issues. Fails if PIE is running."
   );
   forwardTool(
@@ -454,7 +483,7 @@ async function main() {
       limit: z.z.number().int().positive().optional().describe("Max number of blueprints to compile (default 500, max 10000)."),
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 60000).")
     },
-    "Unreal Compile All Blueprints (UnrealMCP)",
+    "Unreal Compile All Blueprints (Unreal MCP)",
     "Compile all Blueprints and return a structured list of compile messages. Fails if PIE is running."
   );
   forwardTool(
@@ -462,7 +491,7 @@ async function main() {
     {
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 60000).")
     },
-    "Unreal Save All (UnrealMCP)",
+    "Unreal Save All (Unreal MCP)",
     "Save all dirty packages (maps + content) in the running Unreal Editor without prompting. Fails if PIE is running."
   );
   forwardTool(
@@ -479,8 +508,8 @@ async function main() {
       materialPath: z.z.string().optional().describe('Optional landscape material object path (e.g. "/Game/\u2026/M_Landscape.M_Landscape").'),
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 30000).")
     },
-    "Unreal Create Landscape (UnrealMCP)",
-    "Create a new Landscape in the current editor level via the UnrealMCP engine plugin. Fails if PIE is running."
+    "Unreal Create Landscape (Unreal MCP)",
+    "Create a new Landscape in the current editor level via the Unreal MCP engine plugin. Fails if PIE is running."
   );
   forwardTool(
     "unreal_mcp_list_capabilities",
@@ -488,7 +517,7 @@ async function main() {
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 2000).")
     },
     "Unreal MCP: Capabilities",
-    "Query the running UnrealMCP plugin for build info, supported commands, and capability flags."
+    "Query the running Unreal MCP Plugin for build info, supported commands, and capability flags."
   );
   forwardTool(
     "unreal_mcp_get_command_schema",
@@ -497,7 +526,7 @@ async function main() {
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 2000).")
     },
     "Unreal MCP: Command Schema",
-    "Fetch per-command schema (required params, aliases, examples) from the running UnrealMCP plugin."
+    "Fetch per-command schema (required params, aliases, examples) from the running Unreal MCP Plugin."
   );
   forwardTool(
     "unreal_mcp_search_blueprint_functions",
@@ -559,8 +588,8 @@ async function main() {
     {
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Actors In Level (UnrealMCP)",
-    "List all actors in the current Unreal Editor level via the UnrealMCP engine plugin."
+    "Unreal Actors In Level (Unreal MCP)",
+    "List all actors in the current Unreal Editor level via the Unreal MCP engine plugin."
   );
   forwardTool(
     "unreal_mcp_get_play_in_editor_status",
@@ -568,15 +597,24 @@ async function main() {
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
     "Unreal Play Status (PIE)",
-    "Get Play-In-Editor status from the UnrealMCP engine plugin."
+    "Get Play-In-Editor status from the Unreal MCP engine plugin."
+  );
+  forwardTool(
+    "unreal_mcp_plugin_status",
+    {
+      uprojectPath: z.z.string().optional().describe("Optional absolute path to the .uproject file (enables config check)."),
+      timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 1500).")
+    },
+    "Unreal Plugin Status (Unreal MCP)",
+    "Deterministically detect whether Unreal Editor is running and the Unreal MCP Plugin is enabled/reachable."
   );
   forwardTool(
     "unreal_mcp_editor_health",
     {
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 1500).")
     },
-    "Unreal Editor Health (UnrealMCP)",
-    "Best-effort health check for Unreal Editor + UnrealMCP (detects if the editor is reachable)."
+    "Unreal Editor Health (Unreal MCP)",
+    "Best-effort health check for Unreal Editor + Unreal MCP (detects if the editor is reachable)."
   );
   forwardTool(
     "unreal_mcp_play_in_editor",
@@ -584,7 +622,7 @@ async function main() {
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
     "Unreal Play In Editor (Viewport)",
-    "Start Play-In-Editor (PIE) in the active editor viewport via the UnrealMCP engine plugin."
+    "Start Play-In-Editor (PIE) in the active editor viewport via the Unreal MCP engine plugin."
   );
   forwardTool(
     "unreal_mcp_play_in_editor_windowed",
@@ -592,7 +630,7 @@ async function main() {
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
     "Unreal Play In Editor (New Window)",
-    "Start Play-In-Editor (PIE) in a new editor window via the UnrealMCP engine plugin."
+    "Start Play-In-Editor (PIE) in a new editor window via the Unreal MCP engine plugin."
   );
   forwardTool(
     "unreal_mcp_stop_play_in_editor",
@@ -600,7 +638,7 @@ async function main() {
       timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
     "Unreal Stop Play In Editor",
-    "Stop a running Play-In-Editor session via the UnrealMCP engine plugin."
+    "Stop a running Play-In-Editor session via the Unreal MCP engine plugin."
   );
   forwardTool(
     "unreal_editor_launch",

package/dist/codex/flockbayMcpStdioBridge.mjs

@@ -40,7 +40,7 @@ async function main() {
     return client;
   }
   const server = new McpServer({
-    name: "Flockbay MCP Bridge",
+    name: "MCP Local Connector",
     version: "1.0.0"
   });
   function forwardTool(name, inputSchema, title, description) {
@@ -110,6 +110,25 @@ async function main() {
     "Evidence Get",
     "Fetch one server-stored evidence manifest by id."
   );
+  forwardTool(
+    "tool_result_read",
+    {
+      toolName: z.string().optional().describe("Tool name (folder under .flockbay/artifacts/tool-results)."),
+      toolResultId: z.string().describe("toolResultId from a prior tool observation.")
+    },
+    "Tool Result Read",
+    "Read a previously-stored MCP tool result artifact (full tool input/output JSON)."
+  );
+  forwardTool(
+    "tool_result_query",
+    {
+      toolName: z.string().optional().describe("Tool name (folder under .flockbay/artifacts/tool-results)."),
+      toolResultId: z.string().describe("toolResultId from a prior tool observation."),
+      paths: z.array(z.string()).min(1).describe('JSON pointer paths ("/output/result/location") or dot-paths ("output.result.location").')
+    },
+    "Tool Result Query",
+    "Query one or more JSON paths from a stored tool result artifact (small slices)."
+  );
   forwardTool(
     "ask_user_question",
     {
@@ -219,6 +238,16 @@ async function main() {
     "Docs Get",
     "Fetch a single Documentation document node (includes markdown body)."
   );
+  forwardTool(
+    "docs_read",
+    {
+      nodeId: z.string().describe("Document node id."),
+      offset: z.number().int().nonnegative().optional().describe("Character offset into bodyMarkdown (default 0)."),
+      maxChars: z.number().int().positive().optional().describe("Max characters to return (default 4000; max 8000).")
+    },
+    "Docs Read (chunked)",
+    "Read a Documentation document body in small chunks to avoid token blowups."
+  );
   forwardTool(
     "docs_search",
     {
@@ -325,12 +354,12 @@ async function main() {
   forwardTool(
     "unreal_mcp_command",
     {
-      type: z.string().describe('UnrealMCP command type (e.g. "get_actors_in_level", "spawn_actor").'),
+      type: z.string().describe('Unreal MCP command type (e.g. "get_actors_in_level", "spawn_actor").'),
       params: z.record(z.any()).optional().describe("Optional params object for the command."),
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Editor Command (UnrealMCP)",
-    "Send a single UnrealMCP command to the running Unreal Editor (engine plugin) and return the JSON response."
+    "Unreal Editor Command (Unreal MCP)",
+    "Send a single Unreal MCP command to the running Unreal Editor (engine plugin) and return the JSON response."
   );
   forwardTool(
     "unreal_mcp_search_assets",
@@ -341,8 +370,8 @@ async function main() {
       limit: z.number().int().positive().optional().describe("Max results (default 25, max 200)."),
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Search Assets (UnrealMCP)",
-    "Search for assets in the current Unreal project via the UnrealMCP engine plugin (AssetRegistry-backed)."
+    "Unreal Search Assets (Unreal MCP)",
+    "Search for assets in the current Unreal project via the Unreal MCP engine plugin (AssetRegistry-backed)."
   );
   forwardTool(
     "unreal_mcp_get_asset_info",
@@ -351,8 +380,8 @@ async function main() {
       includeDependencies: z.boolean().optional().describe("Include package dependencies (default false)."),
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Asset Info (UnrealMCP)",
-    "Get metadata for a single Unreal asset (class/path + optional dependencies) via the UnrealMCP engine plugin."
+    "Unreal Asset Info (Unreal MCP)",
+    "Get metadata for a single Unreal asset (class/path + optional dependencies) via the Unreal MCP engine plugin."
   );
   forwardTool(
     "unreal_mcp_list_asset_packs",
@@ -360,8 +389,8 @@ async function main() {
       limit: z.number().int().positive().optional().describe("Max number of packs (default 200)."),
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal List Asset Packs (UnrealMCP)",
-    'List top-level /Game content folders (best-effort "asset packs") via the UnrealMCP engine plugin.'
+    "Unreal List Asset Packs (Unreal MCP)",
+    'List top-level /Game content folders (best-effort "asset packs") via the Unreal MCP engine plugin.'
   );
   forwardTool(
     "unreal_mcp_place_asset",
@@ -373,7 +402,7 @@ async function main() {
       scale: z.array(z.number()).length(3).optional().describe("Spawn scale [X,Y,Z]."),
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Place Asset (UnrealMCP)",
+    "Unreal Place Asset (Unreal MCP)",
     "Place an asset into the current Unreal level by object path (StaticMesh/Blueprint). Fails if PIE is running."
   );
   forwardTool(
@@ -381,7 +410,7 @@ async function main() {
     {
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Editor Context (UnrealMCP)",
+    "Unreal Editor Context (Unreal MCP)",
     "Return a compact snapshot of editor context: map, selection, and active viewport camera."
   );
   forwardTool(
@@ -421,7 +450,7 @@ async function main() {
       source: z.enum(["editor", "pie"]).optional().describe("World source (default editor)."),
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Actor Transform (UnrealMCP)",
+    "Unreal Actor Transform (Unreal MCP)",
     "Get a single actor transform (location/rotation/scale) by actor name or label."
   );
   forwardTool(
@@ -431,7 +460,7 @@ async function main() {
       source: z.enum(["editor", "pie"]).optional().describe("World source (default editor)."),
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Actor Bounds (UnrealMCP)",
+    "Unreal Actor Bounds (Unreal MCP)",
     "Get a single actor bounds (origin/extent + min/max) by actor name or label."
   );
   forwardTool(
@@ -441,7 +470,7 @@ async function main() {
       limit: z.number().int().positive().optional().describe("Max number of issues to return (default 200, max 1000)."),
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 15000).")
     },
-    "Unreal Map Check (UnrealMCP)",
+    "Unreal Map Check (Unreal MCP)",
     "Run Unreal Map Check and return structured issues. Fails if PIE is running."
   );
   forwardTool(
@@ -452,7 +481,7 @@ async function main() {
       limit: z.number().int().positive().optional().describe("Max number of blueprints to compile (default 500, max 10000)."),
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 60000).")
     },
-    "Unreal Compile All Blueprints (UnrealMCP)",
+    "Unreal Compile All Blueprints (Unreal MCP)",
     "Compile all Blueprints and return a structured list of compile messages. Fails if PIE is running."
   );
   forwardTool(
@@ -460,7 +489,7 @@ async function main() {
     {
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 60000).")
     },
-    "Unreal Save All (UnrealMCP)",
+    "Unreal Save All (Unreal MCP)",
     "Save all dirty packages (maps + content) in the running Unreal Editor without prompting. Fails if PIE is running."
   );
   forwardTool(
@@ -477,8 +506,8 @@ async function main() {
       materialPath: z.string().optional().describe('Optional landscape material object path (e.g. "/Game/\u2026/M_Landscape.M_Landscape").'),
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 30000).")
     },
-    "Unreal Create Landscape (UnrealMCP)",
-    "Create a new Landscape in the current editor level via the UnrealMCP engine plugin. Fails if PIE is running."
+    "Unreal Create Landscape (Unreal MCP)",
+    "Create a new Landscape in the current editor level via the Unreal MCP engine plugin. Fails if PIE is running."
   );
   forwardTool(
     "unreal_mcp_list_capabilities",
@@ -486,7 +515,7 @@ async function main() {
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 2000).")
     },
     "Unreal MCP: Capabilities",
-    "Query the running UnrealMCP plugin for build info, supported commands, and capability flags."
+    "Query the running Unreal MCP Plugin for build info, supported commands, and capability flags."
   );
   forwardTool(
     "unreal_mcp_get_command_schema",
@@ -495,7 +524,7 @@ async function main() {
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 2000).")
     },
     "Unreal MCP: Command Schema",
-    "Fetch per-command schema (required params, aliases, examples) from the running UnrealMCP plugin."
+    "Fetch per-command schema (required params, aliases, examples) from the running Unreal MCP Plugin."
   );
   forwardTool(
     "unreal_mcp_search_blueprint_functions",
@@ -557,8 +586,8 @@ async function main() {
     {
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Actors In Level (UnrealMCP)",
-    "List all actors in the current Unreal Editor level via the UnrealMCP engine plugin."
+    "Unreal Actors In Level (Unreal MCP)",
+    "List all actors in the current Unreal Editor level via the Unreal MCP engine plugin."
   );
   forwardTool(
     "unreal_mcp_get_play_in_editor_status",
@@ -566,15 +595,24 @@ async function main() {
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
     "Unreal Play Status (PIE)",
-    "Get Play-In-Editor status from the UnrealMCP engine plugin."
+    "Get Play-In-Editor status from the Unreal MCP engine plugin."
+  );
+  forwardTool(
+    "unreal_mcp_plugin_status",
+    {
+      uprojectPath: z.string().optional().describe("Optional absolute path to the .uproject file (enables config check)."),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 1500).")
+    },
+    "Unreal Plugin Status (Unreal MCP)",
+    "Deterministically detect whether Unreal Editor is running and the Unreal MCP Plugin is enabled/reachable."
   );
   forwardTool(
     "unreal_mcp_editor_health",
     {
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 1500).")
     },
-    "Unreal Editor Health (UnrealMCP)",
-    "Best-effort health check for Unreal Editor + UnrealMCP (detects if the editor is reachable)."
+    "Unreal Editor Health (Unreal MCP)",
+    "Best-effort health check for Unreal Editor + Unreal MCP (detects if the editor is reachable)."
   );
   forwardTool(
     "unreal_mcp_play_in_editor",
@@ -582,7 +620,7 @@ async function main() {
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
     "Unreal Play In Editor (Viewport)",
-    "Start Play-In-Editor (PIE) in the active editor viewport via the UnrealMCP engine plugin."
+    "Start Play-In-Editor (PIE) in the active editor viewport via the Unreal MCP engine plugin."
   );
   forwardTool(
     "unreal_mcp_play_in_editor_windowed",
@@ -590,7 +628,7 @@ async function main() {
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
     "Unreal Play In Editor (New Window)",
-    "Start Play-In-Editor (PIE) in a new editor window via the UnrealMCP engine plugin."
+    "Start Play-In-Editor (PIE) in a new editor window via the Unreal MCP engine plugin."
   );
   forwardTool(
     "unreal_mcp_stop_play_in_editor",
@@ -598,7 +636,7 @@ async function main() {
       timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
     "Unreal Stop Play In Editor",
-    "Stop a running Play-In-Editor session via the UnrealMCP engine plugin."
+    "Stop a running Play-In-Editor session via the Unreal MCP engine plugin."
   );
   forwardTool(
     "unreal_editor_launch",