io.github.sandraschi/overte-mcp — MCP Server for Overte

An MCP server that wraps Overte, an open-source social-VR platform with a C++ desktop client (“Interface”) plus domain-server and entity-server, descended from High Fidelity’s codebase. The repository description indicates it supports Overte “domain administ…” (truncated in source data).

🛠️ Key Features

MCP server for Overte (open-source Vircadia-lineage social-VR platform)
Includes references to Overte components: “Interface”, domain-server, and entity-server
License: MIT
Runtime requirement: Python 3.12+
Status: beta, “core tools verified live”

🚀 Use Cases

Enable Model Context Protocol integration for Overte-related tooling and administration (based on the provided, truncated description)
Interact with or automate tasks involving Overte’s domain-server and entity-server

⚡ Developer Benefits

MIT-licensed project
Tested/verified “core tools” in beta status

⚠️ Limitations

Server behavior beyond “what this wraps” is not fully described in the provided excerpt
Tooling scope is partially truncated (“domain administ…”), so exact administration capabilities cannot be confirmed

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)

powershell

./start.ps1

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.

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

io.github.sandraschi/overte-mcp