Vectreal: MCP server for 3D scenes on the web
Vectreal
MCP server from the Vectreal CLI: the agent uploads a GLB, tunes scene lighting and cameras, publishes it and returns embed code
- 27 ★ on the repository
- Last commit
- AGPL-3.0
Extended access
Why this level
- The agent publishes scenes at public addresses and creates embed keys with allowed domains
- The organization session sits in the system keychain and acts with your rights
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/vectrealDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The agent publishes scenes at public addresses and creates embed keys with allowed domains
- The organization session sits in the system keychain and acts with your rights
This is third-party code. Review the repository files before installing.
What it does
Vectreal is an open platform for preparing, managing and publishing 3D content for the web. The repository holds the app, React packages for viewing and embedding, an SDK for the agent API and the @vctrl/cli CLI. The CLI has a vectreal mcp command that serves tools to an agent over stdio. The tools read the docs (search_docs, read_doc, no sign-in needed), list your organization's projects and scenes, and create a project and a draft scene from a local GLB file. describe_model reports a model's size, meshes, materials and animation clips without rendering. get_scene_settings and update_scene_settings read and change lighting, environment, controls, bounds, shadows, presentation, cameras and hotspots. publish_scene compresses the GLB the way the publisher does (Draco, KTX2) and publishes the scene, and unpublish_scene takes it offline. get_embed_snippet returns the embed snippet and a preview link, and on request creates a key and allows domains. You run vectreal login first and the session lives in the system keychain. The server is also listed in the MCP Registry as io.github.Vectreal/vectreal.
Who it is for. Web developers and designers who embed 3D models on sites and want an agent in Claude Code, Cursor or VS Code to handle scene publishing.
Good fit when
- You have a GLB model and want it turned into a scene on the platform with a single request to the agent
- Before uploading you want to see the model's size, mesh and material counts without opening a viewer
- A scene's lighting, environment and cameras are tuned for a page and the agent should change them from a description
- A published scene must be embedded on a site and you need the snippet and allowed domains
- You need to find a section of the Vectreal docs without leaving the editor
Not a fit when
- You need to edit geometry and textures: the server tunes how a scene is shown and publishes the model, while modeling stays in Blender and similar editors
- The model format is not GLB: upload and publishing are built for local GLB files
- You need to work with no Vectreal account: every tool except docs reading requires vectreal login
Example request
Upload model.glb as a draft scene, set soft lighting and two cameras, publish it and give me an embed snippet for my domainMCP
- Transport
- stdio
- Authentication
- OAuth
Environment variables
VECTREAL_ORIGIN- Platform origin, https://vectreal.com by default; plain http is allowed on localhost only.
Limitations
The server is part of the @vctrl/cli package and uses the stored session, so vectreal login is needed before the first call. The session lives in the system keychain, and on Linux without Secret Service it goes to a credentials.json file in the home folder, which the CLI reports on stderr.
Work runs as the organization you chose at sign-in, with the rights and scopes vectreal whoami shows. vectreal init links a project to the current folder, and the server looks for that link in CLAUDE_PROJECT_DIR or the launch folder. The default origin is https://vectreal.com; set another with --origin or the VECTREAL_ORIGIN variable.
How to disable. Remove the vectreal entry from .mcp.json or with claude mcp remove vectreal and end the session with vectreal logout, which ends the sign-in on the server and clears local data.
FAQ
How do I connect the Vectreal MCP server to Claude Code?
After npx -y @vctrl/cli login run claude mcp add vectreal -- npx -y @vctrl/cli mcp. Or write the entry into .mcp.json with npx -y @vctrl/cli mcp install.
Which agents are supported?
The Vectreal CLI docs name Claude Code, Cursor and VS Code. The server uses standard stdio, so it suits any client with that support.
What does publish_scene do?
It compresses the local GLB the way the platform publisher does, using Draco and KTX2, and publishes the scene. unpublish_scene takes it offline.
How do I embed a scene on a site?
get_embed_snippet returns the code and a preview link. On request the tool creates an embed key and adds allowed domains.
Where is the session stored?
In the system keychain, one entry per server origin. If the keychain is unavailable, a restricted credentials.json file in ~/.config/vectreal.
Discussion
No questions or reviews yet.
Related
MCP serversA remote MCP server with 40 tools: a 3D model from text or a photo, rigging, animation, retexturing and GLB checks
An MCP server that turns phone video into a 3D scene and lets an agent measure it, plan paths and export data for robots
Blender MCP: an agent in Cursor, Cline, Windsurf or Claude Desktop builds and edits 3D scenes in Blender from a description; the server installs with uvx
A plugin that builds a 3D film, app, lesson, book or game on any subject, with the agent checking its own frames.
A local MCP server and CLI: the agent writes JavaScript for a 3D model, checks it on renders and exports a GLB with source
VidMoat MCP
Vidmoat MCP
Remote MCP server of a cloud video editor: an agent imports footage, edits the timeline, checks frames and renders MP4
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Vectreal: MCP server for 3D scenes on the web (this card) | yes | OAuth | 27 | |
| Blender MCP | no | not required | 34,267 | drives Blender for modeling, whereas Vectreal publishes finished GLBs on a web platform |
| Three.js Skills | no | 4,168 | teaches the agent to write Three.js code, while the Vectreal platform already ships a viewer and publishing |
README in short
The monorepo README shows the platform's parts, documentation, self-hosting and the npm package list. Details of the CLI and MCP server live in the @vctrl/cli package README: commands, the tool table, exit codes and where the session is kept.