sbox-mcp-server 1.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sbox-Claude Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,90 @@
+# sbox-mcp-server
+
+MCP Server for the s&box game engine. Lets Claude Code build s&box games through conversation — 78 working tools for scenes, scripts, GameObjects, components, assets, materials, audio, physics, UI, networking, publishing, and more.
+
+## Quick Start
+
+### 1. Install the Bridge Addon in s&box
+
+The Bridge Addon runs inside the s&box editor and receives commands from this MCP server.
+
+**From source:**
+```bash
+git clone https://github.com/lousputthole/sbox-claude.git
+```
+
+Then in s&box:
+1. Open your project in the s&box editor
+2. Go to **Library Manager** and create a new library called **"claudebridge"**
+3. Copy `sbox-bridge-addon/Editor/MyEditorMenu.cs` into the library's `Editor/` folder
+4. Restart s&box
+
+### 2. Build the MCP Server
+
+```bash
+cd sbox-claude/sbox-mcp-server
+npm install
+npm run build
+```
+
+### 3. Connect to Claude Code
+
+```bash
+claude mcp add sbox -- node /path/to/sbox-mcp-server/dist/index.js
+```
+
+### 4. Open the Bridge Dock
+
+In s&box, go to **View > Claude Bridge** to open the dock panel. The dock **must be visible** for commands to be processed.
+
+That's it. Start Claude Code and start building.
+
+## How It Works
+
+```
+Claude Code --> (stdio) --> sbox-mcp-server --> (file IPC) --> Bridge Addon --> s&box Editor
+```
+
+Communication uses **file-based IPC** through `%TEMP%/sbox-bridge-ipc/`. The MCP server writes request JSON files, the Bridge Addon (running inside s&box) polls for them, processes on the main editor thread, and writes response files back.
+
+WebSocket is not used — s&box's sandboxed C# environment does not allow `System.Net`.
+
+## Tools (78 working, 89 defined)
+
+| Category | Tools |
+|----------|-------|
+| **Project** | get_project_info, list_project_files, read_file, write_file |
+| **Scripts** | create_script, edit_script, delete_script, trigger_hotload |
+| **Scenes** | list_scenes, load_scene, save_scene, create_scene |
+| **GameObjects** | create/delete/duplicate/rename, set_parent/enabled/transform |
+| **Components** | get/set_property, get_all_properties, list_available, add_component |
+| **Hierarchy** | get_scene_hierarchy, get/select/focus_object |
+| **Assets** | search_assets, list_asset_library, install_asset, get_asset_info |
+| **Materials** | assign_model, create/assign_material, set_material_property |
+| **Audio** | list_sounds, create_sound_event, assign_sound, play_sound_preview |
+| **Play Mode** | start/stop_play, is_playing |
+| **Runtime** | get/set_runtime_property, take_screenshot |
+| **Editor** | undo, redo |
+| **Prefabs** | create/instantiate_prefab, list_prefabs, get_prefab_info |
+| **Physics** | add_physics, add_collider, add_joint, raycast |
+| **UI** | create_razor_ui, add_screen_panel, add_world_panel |
+| **Templates** | create_player/npc_controller, create_game_manager, create_trigger_zone |
+| **Networking** | network_helper, configure/status, spawn, ownership, sync, RPCs, templates |
+| **Publishing** | project_config, validate, thumbnail, package_details, install_asset |
+| **Status** | get_bridge_status |
+
+### Not implementable (no s&box API)
+
+pause_play, resume_play, get_console_output, get_compile_errors, clear_console, build_project, get_build_status, clean_build, export_project, prepare_publish
+
+## Requirements
+
+- **Node.js 18+**
+- **s&box** with the Bridge Addon installed
+- **Claude Code**
+
+## License
+
+**GPL-3.0** — see [LICENSE](../LICENSE) for details.
+
+Copyright (c) 2026 [sboxskins.gg](https://sboxskins.gg)

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Entry point for the sbox-mcp MCP server.
+ *
+ * Creates an MCP server (stdio transport), connects to the s&box Bridge Addon
+ * via WebSocket, and registers all tool handlers. Each tool domain (project,
+ * scripts, console, scenes, etc.) has its own register function in src/tools/.
+ *
+ * CLI flags: --version / -v, --help / -h
+ * Environment: SBOX_BRIDGE_HOST, SBOX_BRIDGE_PORT
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+/**
+ * Entry point for the sbox-mcp MCP server.
+ *
+ * Creates an MCP server (stdio transport), connects to the s&box Bridge Addon
+ * via WebSocket, and registers all tool handlers. Each tool domain (project,
+ * scripts, console, scenes, etc.) has its own register function in src/tools/.
+ *
+ * CLI flags: --version / -v, --help / -h
+ * Environment: SBOX_BRIDGE_HOST, SBOX_BRIDGE_PORT
+ */
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { BridgeClient } from "./transport/bridge-client.js";
+import { registerProjectTools } from "./tools/project.js";
+import { registerScriptTools } from "./tools/scripts.js";
+import { registerConsoleTools } from "./tools/console.js";
+import { registerSceneTools } from "./tools/scenes.js";
+import { registerGameObjectTools } from "./tools/gameobjects.js";
+import { registerComponentTools } from "./tools/components.js";
+import { registerAssetTools } from "./tools/assets.js";
+import { registerMaterialTools } from "./tools/materials.js";
+import { registerAudioTools } from "./tools/audio.js";
+import { registerStatusTools } from "./tools/status.js";
+import { registerPlayModeTools } from "./tools/playmode.js";
+import { registerPrefabTools } from "./tools/prefabs.js";
+import { registerPhysicsTools } from "./tools/physics.js";
+import { registerUITools } from "./tools/ui.js";
+import { registerTemplateTools } from "./tools/templates.js";
+import { registerNetworkingTools } from "./tools/networking.js";
+import { registerPublishingTools } from "./tools/publishing.js";
+import { registerWorldTools } from "./tools/world.js";
+import { registerDiscoveryTools } from "./tools/discovery.js";
+// ── CLI flags ──────────────────────────────────────────────────────
+const args = process.argv.slice(2);
+/** Read the package version from package.json, or return "unknown" on failure. */
+function getVersion() {
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+        return pkg.version ?? "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+if (args.includes("--version") || args.includes("-v")) {
+    console.log(`sbox-mcp ${getVersion()}`);
+    process.exit(0);
+}
+if (args.includes("--help") || args.includes("-h")) {
+    console.log(`sbox-mcp ${getVersion()} — MCP Server for s&box game engine
+
+USAGE
+  node dist/index.js              Start the MCP server (stdio transport)
+  node dist/index.js --help       Show this help
+  node dist/index.js --version    Show version
+
+ENVIRONMENT VARIABLES
+  SBOX_BRIDGE_HOST    Bridge WebSocket host (default: 127.0.0.1)
+  SBOX_BRIDGE_PORT    Bridge WebSocket port (default: 29015)
+
+CONNECT TO CLAUDE CODE
+  claude mcp add sbox -- node /path/to/sbox-mcp-server/dist/index.js
+
+TOOLS (109 total)
+  Project:     get_project_info, list_project_files, read_file, write_file
+  Scripts:     create_script, edit_script, delete_script, trigger_hotload
+  Console:     get_console_output, get_compile_errors, clear_console
+  Scenes:      list_scenes, load_scene, save_scene, create_scene
+  GameObjects: create/delete/duplicate/rename_gameobject, set_parent/enabled/transform
+  Components:  get/set_property, get_all_properties, list_available_components, add_component_with_properties, set_prefab_ref
+  Hierarchy:   get_scene_hierarchy, get_selected_objects, select_object, focus_object
+  Assets:      search_assets, list_asset_library, install_asset, get_asset_info
+  Materials:   assign_model, create_material, assign_material, set_material_property
+  Audio:       list_sounds, create_sound_event, assign_sound, play_sound_preview
+  Play Mode:   start/stop/pause/resume_play, is_playing
+  Runtime:     get/set_runtime_property, take_screenshot
+  Editor:      undo, redo
+  Prefabs:     create_prefab, instantiate_prefab, list_prefabs, get_prefab_info
+  Physics:     add_physics, add_collider, add_joint, raycast
+  UI:          create_razor_ui, add_screen_panel, add_world_panel
+  Templates:   create_player_controller, create_npc_controller, create_game_manager, create_trigger_zone
+  Networking:  add_network_helper, configure_network, get_network_status, network_spawn, set_ownership
+  Net Scripts: add_sync_property, add_rpc_method, create_networked_player, create_lobby_manager, create_network_events
+  Publishing:  get_project_config, set_project_config, validate_project, build_project, get_build_status, clean_build
+  Export:      export_project, set_project_thumbnail, get_package_details, prepare_publish
+  World Gen:   invoke_button, list_component_buttons, raycast_terrain, build_terrain_mesh
+  Map Edit:    add_terrain_hill/clearing/trail, clear_terrain_features, sculpt_terrain
+  Caves:       add_cave_waypoint, clear_cave_path
+  Forest:      add_forest_poi/trail, set_forest_seed, clear_forest_pois, paint_forest_density
+  Placement:   place_along_path
+  Discovery:   describe_type, search_types, get_method_signature, find_in_project
+  Status:      get_bridge_status
+`);
+    process.exit(0);
+}
+// ── Server setup ───────────────────────────────────────────────────
+const server = new McpServer({
+    name: "sbox-mcp",
+    version: getVersion(),
+});
+// Bridge client connects to s&box editor via WebSocket
+const bridge = new BridgeClient(process.env.SBOX_BRIDGE_HOST ?? "127.0.0.1", parseInt(process.env.SBOX_BRIDGE_PORT ?? "29015", 10));
+// Register all tools
+registerProjectTools(server, bridge);
+registerScriptTools(server, bridge);
+registerConsoleTools(server, bridge);
+registerSceneTools(server, bridge);
+registerGameObjectTools(server, bridge);
+registerComponentTools(server, bridge);
+registerAssetTools(server, bridge);
+registerMaterialTools(server, bridge);
+registerAudioTools(server, bridge);
+registerStatusTools(server, bridge);
+registerPlayModeTools(server, bridge);
+registerPrefabTools(server, bridge);
+registerPhysicsTools(server, bridge);
+registerUITools(server, bridge);
+registerTemplateTools(server, bridge);
+registerNetworkingTools(server, bridge);
+registerPublishingTools(server, bridge);
+registerWorldTools(server, bridge);
+registerDiscoveryTools(server, bridge);
+/** Start the MCP server on stdio and attempt initial Bridge connection. */
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("");
+    console.error("  ╔═══════════════════════════════════════════════════╗");
+    console.error("  ║  s&box Claude Bridge — MCP Server                ║");
+    console.error("  ║  Build s&box games through conversation          ║");
+    console.error("  ║                                                   ║");
+    console.error("  ║  A project by sboxskins.gg                       ║");
+    console.error("  ║  https://sboxskins.gg                            ║");
+    console.error("  ╚═══════════════════════════════════════════════════╝");
+    console.error("");
+    // Attempt initial connection to s&box (non-fatal if it fails)
+    try {
+        await bridge.connect();
+        console.error("[sbox-mcp] Connected to s&box Bridge");
+    }
+    catch {
+        console.error("[sbox-mcp] Warning: Could not connect to s&box Bridge. Will retry on first tool call.");
+    }
+}
+main().catch((err) => {
+    console.error("[sbox-mcp] Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/tools/assets.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BridgeClient } from "../transport/bridge-client.js";
+/**
+ * Asset browser tools: search_assets, list_asset_library, install_asset, get_asset_info.
+ * Provides access to both project-local assets and the s&box community asset library.
+ */
+export declare function registerAssetTools(server: McpServer, bridge: BridgeClient): void;
+//# sourceMappingURL=assets.d.ts.map

package/dist/tools/assets.js

@@ -0,0 +1,80 @@
+import { z } from "zod";
+/**
+ * Asset browser tools: search_assets, list_asset_library, install_asset, get_asset_info.
+ * Provides access to both project-local assets and the s&box community asset library.
+ */
+export function registerAssetTools(server, bridge) {
+    // ── search_assets ────────────────────────────────────────────────
+    server.tool("search_assets", "Search for assets in the project by name, type, or keyword. Returns models, materials, sounds, textures, prefabs, etc.", {
+        query: z
+            .string()
+            .optional()
+            .describe("Search term to match against asset name or path"),
+        type: z
+            .string()
+            .optional()
+            .describe("Asset type filter (e.g. 'model', 'material', 'sound', 'texture', 'prefab')"),
+        maxResults: z
+            .number()
+            .optional()
+            .describe("Maximum results to return. Defaults to 50"),
+    }, async (params) => {
+        const res = await bridge.send("search_assets", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── list_asset_library ───────────────────────────────────────────
+    server.tool("list_asset_library", "Browse the s&box community asset library. Search for packages by name, description, or type to find models, maps, and tools to install", {
+        query: z
+            .string()
+            .optional()
+            .describe("Search term for packages"),
+        type: z
+            .string()
+            .optional()
+            .describe("Package type filter (e.g. 'model', 'map', 'library')"),
+        maxResults: z
+            .number()
+            .optional()
+            .describe("Maximum results. Defaults to 25"),
+    }, async (params) => {
+        const res = await bridge.send("list_asset_library", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── install_asset ────────────────────────────────────────────────
+    server.tool("install_asset", "Install a community asset package into the project by its ident (e.g. 'facepunch.flatgrass'). Adds it as a project dependency", {
+        ident: z
+            .string()
+            .describe("Package identifier (e.g. 'facepunch.flatgrass', 'author.package_name')"),
+    }, async (params) => {
+        const res = await bridge.send("install_asset", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── get_asset_info ───────────────────────────────────────────────
+    server.tool("get_asset_info", "Get detailed metadata about a specific asset — type, path, tags, package source", {
+        path: z.string().describe("Asset path (e.g. 'models/citizen/citizen.vmdl')"),
+    }, async (params) => {
+        const res = await bridge.send("get_asset_info", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=assets.js.map

package/dist/tools/audio.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BridgeClient } from "../transport/bridge-client.js";
+/**
+ * Audio tools: list_sounds, create_sound_event, assign_sound, play_sound_preview.
+ * Manages sound assets, .sound event files, and SoundPointComponent attachment.
+ */
+export declare function registerAudioTools(server: McpServer, bridge: BridgeClient): void;
+//# sourceMappingURL=audio.d.ts.map

package/dist/tools/audio.js

@@ -0,0 +1,101 @@
+import { z } from "zod";
+/**
+ * Audio tools: list_sounds, create_sound_event, assign_sound, play_sound_preview.
+ * Manages sound assets, .sound event files, and SoundPointComponent attachment.
+ */
+export function registerAudioTools(server, bridge) {
+    // ── list_sounds ──────────────────────────────────────────────────
+    server.tool("list_sounds", "List available sound assets in the project and installed packages. Filter by name", {
+        filter: z
+            .string()
+            .optional()
+            .describe("Search filter for sound name or path"),
+        maxResults: z
+            .number()
+            .optional()
+            .describe("Maximum results. Defaults to 50"),
+    }, async (params) => {
+        const res = await bridge.send("list_sounds", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── create_sound_event ───────────────────────────────────────────
+    server.tool("create_sound_event", "Create a new sound event file (.sound) with volume, pitch, distance falloff, and looping settings", {
+        path: z
+            .string()
+            .describe("Path for the sound event file (e.g. 'sounds/footstep.sound')"),
+        sound: z
+            .string()
+            .describe("Path to the source sound asset (.vsnd)"),
+        volume: z
+            .number()
+            .optional()
+            .describe("Volume multiplier (0-1). Defaults to 1.0"),
+        pitch: z
+            .number()
+            .optional()
+            .describe("Pitch multiplier. Defaults to 1.0"),
+        minDistance: z
+            .number()
+            .optional()
+            .describe("Minimum distance before falloff starts (units). Defaults to 100"),
+        maxDistance: z
+            .number()
+            .optional()
+            .describe("Maximum audible distance (units). Defaults to 2000"),
+        loop: z
+            .boolean()
+            .optional()
+            .describe("Whether the sound should loop. Defaults to false"),
+    }, async (params) => {
+        const res = await bridge.send("create_sound_event", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── assign_sound ─────────────────────────────────────────────────
+    server.tool("assign_sound", "Attach a sound event to a GameObject via SoundPointComponent. Creates the component if needed", {
+        id: z.string().describe("GUID of the GameObject"),
+        sound: z
+            .string()
+            .describe("Sound event path (e.g. 'sounds/ambient_wind.sound')"),
+        playOnStart: z
+            .boolean()
+            .optional()
+            .describe("Whether the sound plays automatically when the game starts"),
+    }, async (params) => {
+        const res = await bridge.send("assign_sound", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── play_sound_preview ───────────────────────────────────────────
+    server.tool("play_sound_preview", "Play a sound in the editor for testing without entering play mode", {
+        sound: z
+            .string()
+            .describe("Sound event or asset path to preview"),
+        volume: z
+            .number()
+            .optional()
+            .describe("Preview volume (0-1). Defaults to 1.0"),
+    }, async (params) => {
+        const res = await bridge.send("play_sound_preview", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=audio.js.map

package/dist/tools/components.d.ts

@@ -0,0 +1,11 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BridgeClient } from "../transport/bridge-client.js";
+/**
+ * Component inspection and manipulation tools.
+ *
+ * Registers: get_property, get_all_properties, list_available_components,
+ * add_component_with_properties. These tools read/write component data on
+ * GameObjects and discover available component types (both built-in and custom).
+ */
+export declare function registerComponentTools(server: McpServer, bridge: BridgeClient): void;
+//# sourceMappingURL=components.d.ts.map

package/dist/tools/components.js

@@ -0,0 +1,78 @@
+import { z } from "zod";
+/**
+ * Component inspection and manipulation tools.
+ *
+ * Registers: get_property, get_all_properties, list_available_components,
+ * add_component_with_properties. These tools read/write component data on
+ * GameObjects and discover available component types (both built-in and custom).
+ */
+export function registerComponentTools(server, bridge) {
+    // ── get_property ─────────────────────────────────────────────────
+    server.tool("get_property", "Read a single property value from a component on a GameObject", {
+        id: z.string().describe("GUID of the GameObject"),
+        component: z
+            .string()
+            .describe("Component type name (e.g. 'ModelRenderer', 'PlayerController')"),
+        property: z.string().describe("Property name to read"),
+    }, async (params) => {
+        const res = await bridge.send("get_property", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── get_all_properties ───────────────────────────────────────────
+    server.tool("get_all_properties", "Dump all public properties of a component as JSON — names, types, and current values", {
+        id: z.string().describe("GUID of the GameObject"),
+        component: z.string().describe("Component type name"),
+    }, async (params) => {
+        const res = await bridge.send("get_all_properties", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── list_available_components ────────────────────────────────────
+    server.tool("list_available_components", "List all component types available in s&box (built-in and custom). Search by name or filter by category", {
+        filter: z
+            .string()
+            .optional()
+            .describe("Search filter — matches against component name and title"),
+        category: z
+            .string()
+            .optional()
+            .describe("Filter by category/group (e.g. 'Rendering', 'Physics', 'Audio')"),
+    }, async (params) => {
+        const res = await bridge.send("list_available_components", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── add_component_with_properties ────────────────────────────────
+    server.tool("add_component_with_properties", "Add a component to a GameObject and configure its properties in one call. Use list_available_components to find valid types", {
+        id: z.string().describe("GUID of the GameObject"),
+        component: z
+            .string()
+            .describe("Component type name (e.g. 'ModelRenderer', 'Rigidbody', 'BoxCollider')"),
+        properties: z
+            .record(z.unknown())
+            .optional()
+            .describe("Key-value map of property names to values. Values are auto-converted to the correct type"),
+    }, async (params) => {
+        const res = await bridge.send("add_component_with_properties", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=components.js.map

package/dist/tools/console.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BridgeClient } from "../transport/bridge-client.js";
+/**
+ * Console and error feedback tools: get_console_output, get_compile_errors, clear_console.
+ * Reads from the Bridge's circular log buffer (LogCapture) to surface editor output.
+ */
+export declare function registerConsoleTools(server: McpServer, bridge: BridgeClient): void;
+//# sourceMappingURL=console.d.ts.map

package/dist/tools/console.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+/**
+ * Console and error feedback tools: get_console_output, get_compile_errors, clear_console.
+ * Reads from the Bridge's circular log buffer (LogCapture) to surface editor output.
+ */
+export function registerConsoleTools(server, bridge) {
+    // ── get_console_output ───────────────────────────────────────────
+    server.tool("get_console_output", "Read recent console log entries from s&box. Returns log messages, warnings, and errors with timestamps", {
+        count: z
+            .number()
+            .optional()
+            .describe("Maximum number of log entries to return. Defaults to 50"),
+        severity: z
+            .enum(["all", "info", "warning", "error"])
+            .optional()
+            .describe("Filter by severity level. Defaults to 'all'"),
+    }, async (params) => {
+        const res = await bridge.send("get_console_output", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [
+                { type: "text", text: JSON.stringify(res.data, null, 2) },
+            ],
+        };
+    });
+    // ── get_compile_errors ───────────────────────────────────────────
+    server.tool("get_compile_errors", "Get current C# compilation errors and warnings from s&box. Returns file path, line number, column, error code, and message for each diagnostic", {}, async () => {
+        const res = await bridge.send("get_compile_errors");
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        const data = res.data;
+        const errors = data?.errors ?? [];
+        const warnings = data?.warnings ?? [];
+        let text;
+        if (errors.length === 0 && warnings.length === 0) {
+            text = "No compilation errors or warnings. Code is clean!";
+        }
+        else {
+            text = JSON.stringify(res.data, null, 2);
+        }
+        return {
+            content: [{ type: "text", text }],
+        };
+    });
+    // ── clear_console ────────────────────────────────────────────────
+    server.tool("clear_console", "Clear all console log entries in the s&box editor", {}, async () => {
+        const res = await bridge.send("clear_console");
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: "Console cleared" }],
+        };
+    });
+}
+//# sourceMappingURL=console.js.map

package/dist/tools/discovery.d.ts

@@ -0,0 +1,13 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BridgeClient } from "../transport/bridge-client.js";
+/**
+ * Type discovery and code-search tools.
+ *
+ * These help Claude reference real s&box APIs instead of guessing. Use
+ * describe_type before writing code that touches an unfamiliar type — the
+ * Game.TypeLibrary reflection returns properties, methods, events, and
+ * attributes for any loaded type. Use search_types to find types matching
+ * a name pattern. find_in_project greps the user's project for usage examples.
+ */
+export declare function registerDiscoveryTools(server: McpServer, bridge: BridgeClient): void;
+//# sourceMappingURL=discovery.d.ts.map