overte-mcp
What this wraps
An MCP server for Overte, the open-source social-VR
platform — a C++ desktop client ("Interface") + domain-server + entity-server,
descended from High Fidelity's codebase. Not the same thing as current
"Vircadia" — see docs/WRAPPEE.md for the full
disambiguation and official links (site, docs, community). Complements the
fleet's other virtual-world servers: resonite-mcp, vrchat-mcp,
godot-mcp, unity3d-mcp, gazebo-mcp.
Plus a companion React web dashboard.
What You Can Do
How it runs: Overte (domain-server + Interface) is a separate
application you install yourself — never bundled. overte_domain_status
works against just the domain-server (no GUI needed). overte_entity_spawn
and overte_script_inject need a running Interface client with
scripts/overte-mcp-bridge.js loaded, because Overte's entity-server has no
plain HTTP "create entity" endpoint — only Interface's JavaScript API can do
that. See docs/ONBOARDING.md for first-time setup.
| Direction | Artifacts | Notes |
|---|
| Hands-in | Entity properties (position, scale, type), JS behavior scripts, GLB/FBX/OBJ model URLs | Via MCP tool calls or the dashboard's Entities/Scripting pages |
| Hands-out | Live domain-server telemetry, spawned in-world entities, animated/scripted entities | Every response labeled source: "live" or source: "simulated" — never a silent fake success |
Tools — all three core tools verified live against Overte 2026.04.1 (2026-07-30):
| Tool | Status |
|---|
overte_domain_status | Verified live — real domain-server /nodes.json + /settings.json admin API on port 40100 |
overte_entity_spawn | Verified live — in-world entity spawning via WebSocket bridge; permanent=True for cross-restart persistence |
overte_script_inject | Verified live — in-world JS behavior injection via WebSocket bridge |
overte_sampling_assist | Multi-step planning via ctx.sample() when host supports it |
Dashboard pages:
| Page | Route | Features |
|---|
| Dashboard | / | Domain status, node list, settings viewer |
| Avatars | /avatars | Connected avatar-mixer/agent nodes |
| Entities | /entities | Spawn form + entity explorer |
| Scripting | /scripting | JS code editor + script injection |
| Chat | /chat | Skill-first LLM chat with 4 personalities |
| Settings | /settings | Backend health + LLM provider detection |
| Tools | /tools | Dynamic tool discovery + search |
| Skills | /skills | Skill content viewer (markdown) |
| Logs | /logs | Ring-buffer log viewer with level filter |
| Help | /help | Domain setup + JS API reference |
Quick Install
Claude Desktop (.mcpb)
- Build:
just mcpb-pack → dist/overte-mcp.mcpb
- Drag the
.mcpb into Claude Desktop (needs Python 3.12+ and uv on PATH).
Stdio without MCPB: uv run overte-mcp. Full install paths: INSTALL.md.
Full stack (dashboard + bridge)
Syncs deps, starts FastAPI backend (11110) and Vite dashboard (11111),
opens the browser. Then start Overte domain-server.exe, open Interface,
load scripts/overte-mcp-bridge.js for live spawn/inject — see
docs/ONBOARDING.md.
Example Prompts
- "What's the status of my Overte domain?"
- "Spawn a permanent box entity at the origin"
- "Attach the dance script to that entity"
Lint / test
just lint # Ruff + Biome
just test # unit + e2e
just mcpb-pack # validate + pack Claude Desktop bundle
Documentation
Requirements
License
MIT