Overte MCP

overte-mcp

What this wraps

An MCP server for [Overte](https://overte.org), 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-server on 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.

Tools — 12 MCP tools (verified live against Overte 2026.04.1 unless noted):

Dashboard pages:

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