Overte
FreeNot checkedAn MCP server for the Overte social-VR platform, enabling real-time querying of domain status, spawning in-world entities, and injecting JavaScript scripts thro
About
An MCP server for the Overte social-VR platform, enabling real-time querying of domain status, spawning in-world entities, and injecting JavaScript scripts through a WebSocket bridge.
README
License: MIT Python 3.12+ Status: beta, core tools verified live
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.
Local sandbox or join a domain
Two ways to be in a world — the dashboard keeps them separate on purpose:
- Local sandbox (default): your own
domain-serveron this machine (localhost:40100). Private, free, and the only setup where the dashboard's Start/Stop buttons can launch things for you. - Join a domain: point the dashboard's Watching switcher at someone else's domain-server (host + admin port) to monitor it, and join it in Interface with Connect to Domain…. You get admin/scripting power there only if they gave you credentials.
One rule for both: spawning, injecting, and animating always act through the
bridge, which lives in whatever domain your assignment-client or Interface
joined. The Watching switcher changes which domain you look at; your spawns
land where you stand. To flip it around — host a domain others can join,
gate it to specific people, and send hifi:// invites — see
docs/ONBOARDING.md ("Hosting a domain others can join")
and the Help Hub in the dashboard.
What You Can Do
How it runs: Overte (domain-server + assignment-client, optionally Interface) is a
separate application you install yourself, never bundled. Entity work runs through a
bridge script inside Overte's script engine. Since 2026-10-31 the bridge runs headless
as a domain persistent script on an assignment-client: no GUI, no logged-in user
(overte_bridge_install sets it up). Loading it in the desktop Interface client still
works when you want to watch. See docs/ONBOARDING.md.
| 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 | Real result or an error saying why (bridge_not_connected, domain_unreachable, ...); no simulated mode |
Tools — 12 MCP tools (verified live against Overte 2026.04.1 unless noted):
| Tool | Status |
|---|---|
overte_domain_status |
Verified live (2026-07-30): domain-server /nodes.json + /settings.json on port 40100 |
overte_bridge_status / overte_bridge_install |
New 2026-10-31: bridge mode (agent/interface) and headless install as a persistent script. See STATUS.md for live verification state. |
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_entity_update / delete / animate |
Live-only entity lifecycle (move/resize, delete, spin/bob/bounce) |
overte_nearby_entities / fixture_spawn |
Live world search + gripper test fixtures (box/cup/ball/table/chair) |
overte_sampling_assist |
Multi-step planning via ctx.sample() when host supports it |
overte_shutdown |
Orderly self-termination (confirm=True) + POST /api/shutdown |
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 |
| Inbox | /inbox |
Server events needing attention (search/filter/sort/paginate) |
| Help | /help |
Domain setup, hosting + invites, JS API reference |
Quick Install
Claude Desktop (.mcpb) — Claude-only one-liner
irm https://github.com/sandraschi/overte-mcp/releases/latest/download/install.ps1 | iex
One command: downloads the latest .mcpb, installs Python/uv if missing, and registers the bundle. Claude Desktop only.
Other clients (Cursor / VS Code / Codex / Opencode) — no bundle needed:
{
"mcpServers": {
"overte-mcp": {
"command": "uvx",
"args": ["--from", "git+https://github.com/sandraschi/overte-mcp.git", "overte-mcp"]
}
}
}
From source: just mcpb-pack → dist/overte-mcp.mcpb, then drag the .mcpb into Claude Desktop. Full install paths: INSTALL.md.
Full stack (dashboard + bridge)
./start.ps1
Syncs deps, starts FastAPI backend (11110) and Vite dashboard (11111),
opens the browser. Then start Overte domain-server.exe and
assignment-client.exe -n 9, and run overte_bridge_install once. Or let
just e2e-headless do it all and report pass/fail. 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
- docs/WRAPPEE.md — what Overte is, disambiguation from Vircadia, official links
- docs/ARCHITECTURE.md — data flow, ports, WebSocket bridge
- INSTALL.md — Overte setup, MCPB, Claude Desktop config
- STATUS.md — current verification status, remaining work
- ASSESSMENT.md — fleet audit findings and improvement plan
- PROJECT_PAGE.md — roadmap and task tracker
- CHANGELOG.md — release notes
- docs/ONBOARDING.md — first-time Overte + bridge setup
- docs/CONFIGURATION.md — env vars, ports
- docs/DEVELOPMENT.md — dev setup, contributing
- docs/TOOLS.md — full MCP tool reference
- docs/TROUBLESHOOTING.md — common issues
- llms.txt / llms-full.txt — LLM index + full corpus
- mcpb/README.md — Claude Desktop bundle layout
Requirements
- Python 3.12+ with
uv - Bun (webapp + Biome)
- Overte Client + Server installed separately for live domain + bridge features
License
MIT
Installing Overte
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/sandraschi/overte-mcpFAQ
Is Overte MCP free?
Yes, Overte MCP is free — one-click install via Unyly at no cost.
Does Overte need an API key?
No, Overte runs without API keys or environment variables.
Is Overte hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Overte in Claude Desktop, Claude Code or Cursor?
Open Overte on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectServer Sequential Thinking
MCP server for sequential thinking and problem solving
by GitHub ActionsUnyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
by UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
by duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
by blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
by Mitsubishi-FusoGpt Image 2 Mcp
RunAPI GPT Image 2 MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
by runapi-aiCompare Overte with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs
