MCP Server

Library

AI coding MCP server with 48 tools

jtc updated 5mo ago 35 MB engine 25
thumb_up 11 open_in_new View on sbox.game
MCP Server
In-editor MCP server for s&box — drive the editor in natural language with Claude Code (or any MCP client). Editor open = MCP up, close = gone. No subprocess, no WebSocket bridge, no reconnect dance.

What it can do (48 tools)

Scene graph (12) — scene_list_objects, scene_get_object, scene_create_object, scene_delete_object, scene_clone_object, scene_reparent_object, scene_set_transform, scene_get_hierarchy, scene_load, scene_find_objects (wildcards), scene_find_by_component, scene_find_by_tag

Components (5) — component_list, component_get, component_set (typed: Model, Material, Color, Vector3, Angles, cloud-asset idents), component_add, component_remove

Tags (3) — tag_add, tag_remove, tag_list

Cloud assets (4) — asset_search (s&box library), asset_fetch, asset_mount (auto-pins into .sbproj PackageReferences), asset_browse_local

Editor (11) — editor_get_selection, editor_select_object, editor_undo/editor_redo, editor_save_scene, editor_take_screenshot (CameraComponent → PNG), editor_play/editor_stop/editor_is_playing, editor_scene_info, editor_console_output

Files & execution (7) — file_read, file_write (.cs → code/, else Assets/), file_list (glob), project_info, console_run, execute_csharp (Roslyn scripting when available), get_server_status

Docs & API search (6) — built-in crawler over docs.facepunch.com (180+ pages) and the Facepunch API schema (1,800+ types):
  • sbox_search_docs (fuzzy search, optional category filter)
  • sbox_get_doc_page (Markdown, chunked output)
  • sbox_list_doc_categories
  • sbox_search_api (types + members)
  • sbox_get_api_type (full type details — methods, properties, fields, XML docs)
  • sbox_cache_status
Features under the hood
  • HTTP/SSE transport on localhost:29015 — no external processes
  • Reflection-based tool discovery via [McpToolGroup] + [McpTool] attributes — new tool = new method with an attribute
  • Main-thread dispatch — all editor-API calls land safely on the editor's main thread (no Qt crash)
  • Dirty tracking via FullUndoSnapshot + OnEdited + reflection setters — close-without-save prompt works
  • Process singleton — survives hot-reloads, no bind-conflict loop
  • Dock UI with live status, request counter, uptime, activity log
  • Graceful degradation — Roslyn-scripting fallback, multi-stage schema-URL resolver, doc-crawl cold-start retry
Setup in 30 seconds
  1. Clone the repo
  2. s&box: File → Open Project → src/SboxMcp/.sbproj
  3. claude mcp add --transport http -s user sbox http://localhost:29015/mcp
  4. Done — Claude sees all 48 tools
Architecture
Claude / MCP client  ── HTTP :29015 ──>  s&box editor
                                          ├── McpHttpServer (HttpListener)
                                          ├── ToolRegistry (reflection)
                                          ├── HandlerDispatcher (main-thread)
                                          ├── Handlers/ (editor APIs)
                                          └── DocsService (crawler + fuzzy index)

One process. 48 tools. Direct access to every editor API. Ask Claude what you want.

6
Total Users
27
Total Sessions
1.2 hours
Total Playtime
0 recorded entries
Rank Player Score Recorded
refresh
Discovering package leaderboards...
Package ID: jtc.mcp-server
Created: 2026-05-01 20:27 UTC
Updated: 2026-05-01 20:32 UTC
Type: library
Public: Yes
Version: 225138
files: 212
Size: 34.8 MB
Engine Version: 25
Asset Version ID: 225138
Version Created: 2026-05-01 20:32 UTC
Hash: 8773671502832119214
Manifest: Open manifest

more_horiz Additional Properties

Summary: In-editor Model Context Protocol server for s&box. Drive the editor in natural language with Claude Code or any MCP client — 48 tools spanning scene graph, components, cloud assets, files, Roslyn scripting, and built-in s&box docs/API search.
Compiler: {"RootNamespace":"SboxMcp","DefineConstants":"SANDBOX","NoWarn":"1701;1702;1591;","WarningsAsErrors":"","TreatWarningsAsErrors":false,"Nullables":false,"ReleaseMode":"Release","AssemblyReferences":[],"IgnoreFolders":[],"DistinctAssemblyReferences":[]}
new_releases Latest Update May 1, 2026
Changes on 2026-05-01
225138 May 1, 2026
Changes on 2026-05-01
info Live API Passthrough & Removal Notice

This file manifest and asset metadata are retrieved live directly from the official Facepunch s&box public API. s&box Explorer does not host, store, or redistribute any package files. All download links route directly to Facepunch CDN servers.