sbox-api

sbox-api-mcp

MCP server for S&box game engine — API reference, wiki documentation, and Workshop assets. Indexes 1800+ types, 15,000+ members, and 8,000+ documentation entries from the S&box API, plus 200+ wiki pages (guides, tutorials, concepts) and community Workshop assets, all searchable directly from Claude Code.

Installation

Claude Code Plugin (recommended)

claude plugin add sofianebel/sbox-api-mcp

Manual MCP Setup

claude mcp add sbox-api -- npx -y sbox-api-mcp

npx (direct)

npx sbox-api-mcp

Tools

Tool	Description	Example
API Reference
search_types	Fuzzy search types (classes, structs, enums, interfaces)	search_types({ query: "GameObject" })
get_type	Full details of a specific type (methods, properties, fields)	get_type({ name: "Sandbox.GameObject" })
search_members	Search methods/properties across all types	search_members({ query: "Position", kind: "property" })
list_namespaces	List all API namespaces with type counts	list_namespaces({ filter: "Audio" })
search_docs	Full-text search in documentation summaries	search_docs({ query: "play sound" })
update_api_source	Update API data URL when S&box releases a new version	update_api_source({ url: "https://cdn.sbox.game/releases/..." })
Wiki Documentation
search_wiki	Search s&box wiki pages (guides, tutorials, concepts)	search_wiki({ query: "networking" })
get_wiki_page	Get the full content of a wiki page as markdown	get_wiki_page({ path: "scene/components" })
Workshop (UGC)
search_packages	Search community Workshop assets (models, sounds, maps, etc.)	search_packages({ query: "zombie" })
get_package	Get details of a specific Workshop package	get_package({ ident: "facepunch.zombiemale" })

Configuration

Environment variables (optional):

Variable	Description	Default
SBOX_API_URL	Override the S&box API JSON URL	Latest known release
SBOX_CACHE_DIR	Override cache directory	~/.sbox-api-mcp/

Updating API Data

When S&box releases a new version, the API JSON URL changes. You can update it in two ways:

1. From Claude Code: Use the update_api_source tool with the new URL
2. Environment variable: Set SBOX_API_URL to the new URL

The URL format is: https://cdn.sbox.game/releases/YYYY-MM-DD-HH-MM-SS.zip.json

How It Works

API Reference: On first startup, the server downloads the S&box API JSON (~9 MB) and caches it locally in ~/.sbox-api-mcp/. Subsequent startups use an ETag check to skip re-downloading if the data hasn't changed. The API data is indexed in-memory using Fuse.js for fast fuzzy search across type names, member names, and documentation summaries.

Wiki Documentation: Leverages S&box's LLM-optimized endpoints (llms.txt index + .md raw markdown pages). The wiki index is fetched on first use and cached in-memory for 1 hour. Individual pages are fetched live from sbox.game/dev/doc/ as raw markdown.

Workshop (UGC): Queries the Facepunch services API live for community-made assets.

License

MIT