Skip to main content
Glama

overte-mcp

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.

Related MCP server: Learn MCP Server

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.

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

Requirements

License

MIT

Available Tools

4 tools
overte_domain_statusA

Retrieve connected-node telemetry and settings from an Overte Domain Server.

Real live path against /nodes.json and /settings.json. Falls back to clearly labeled simulated data if no domain-server is reachable.

Return Format

{"success": bool, "message": str, "data": {"source": str, "domain": {...}}}

Examples

overte_domain_status(host="localhost", port=40100) overte_domain_status(host="192.168.1.100", port=40100, username="admin", password="admin")

Inputs: ctx, host, port, password, +1 more. Returns: object

overte_entity_spawnA

Spawn a virtual object or 3D GLB model in-world at the specified coordinates.

Live when scripts/overte-mcp-bridge.js is connected to the FastAPI WS hub; otherwise returns a clearly labeled simulated confirmation.

Return Format

{"success": bool, "message": str, "data": {"source": str, "entity": {...}}}

Examples

overte_entity_spawn(name="MyBox") overte_entity_spawn(name="Tree", entity_type="Model", model_url="https://example.com/tree.glb", position=[10, 0, -5])

Inputs: name (required), ctx, type, scale, +4 more. Returns: object

overte_sampling_assistA

Get multi-step Overte operation guidance via MCP sampling (FastMCP 3.1+).

Uses ctx.sample when the host exposes sampling; returns structured error otherwise. Recommends tool calls and sequencing for complex goals.

Return Format

{"success": bool, "message": str, "data": {"plan": str, "sampling_used": bool}}

Examples

overte_sampling_assist(goal="Set up a domain-server and spawn a welcome entity")

Inputs: goal (required), ctx. Returns: object

overte_script_injectA

Inject a JavaScript script to govern behavior of an in-world entity.

Live when the Overte bridge WebSocket client is connected; otherwise returns a clearly labeled simulated confirmation.

Return Format

{"success": bool, "message": str, "data": {"source": str, "script": {...}}}

Examples

overte_script_inject(entity_id="abc-123-def", script_url="https://example.com/behavior.js") overte_script_inject(entity_id="abc-123-def", script_url="https://example.com/click.js", script_data={"color": "red"})

Inputs: entity_id (required), script_url (required), ctx, script_data. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a distinct concern: script injection, entity spawning, domain status, and sampling-based guidance. No two tools overlap in purpose.

    Naming Consistency4/5

    All tools share the overte_ prefix and mostly follow a noun_verb pattern (script_inject, entity_spawn, sampling_assist), with one exception (domain_status being noun_noun). This is a minor deviation from an otherwise consistent scheme.

    Tool Count5/5

    Four tools is a reasonable, focused scope for an Overte bridge server. Each tool serves a clear function without unnecessary bloat.

    Completeness2/5

    The domain is clearly Overte virtual world management, but the surface is notably incomplete: entity spawning exists but there are no tools to list, update, or delete entities, and script injection exists without corresponding script removal or listing. This leaves significant gaps in typical lifecycle workflows.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server designed for learning and experimentation. It provides a foundational setup for developers to build, run, and debug MCP server implementations using Node.js.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Open-source, engine-agnostic MCP server shared by Unity-MCP, Godot-MCP, and Unreal-MCP. Additionally you can use AI Game Dev app (https://ai-game.dev) to generate images, video, audio, 3D, rig, animation and much more.
      19
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that lets an LLM agent drive StableProjectorz, a 3D modeling app, by inspecting the loaded model, app state, viewport screenshots, and triggering UI actions via a loopback socket bridge.
      1
      1
      MIT