
Vectreal
Upload, configure, publish and embed 3D models from your coding agent
- Pricing
- Freemium
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 3.1.0
- Listing updated
- 2 days ago
About Vectreal
Vectreal is a freemium MCP server for design and media. It runs locally on your machine and is started by your AI client.
The server is part of the Vectreal CLI and runs locally over stdio. After a one-time browser login, each call acts as you, in the organization you chose and with only the permissions you approved. The session shows under Connected agents in the dashboard and can be revoked there.
The typical flow takes a local GLB file: inspect it, upload it as a draft scene, adjust lighting, cameras, shadows and hotspots, publish it compressed with Draco geometry and KTX2 textures, and fetch an iframe embed snippet. It can also unpublish a scene.
The docs are explicit about limits. Agents cannot delete anything, change billing or members, or edit interactions and animation. Thumbnails and baked shadows appear only after the scene is first opened in the publisher. It needs Node.js 22.22 or later.
Install
Run in a terminal
claude mcp add vectreal -- npx -y @vctrl/cliAdd to claude_desktop_config.json
{
"mcpServers": {
"vectreal": {
"command": "npx",
"args": [
"-y",
"@vctrl/cli"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"vectreal": {
"command": "npx",
"args": [
"-y",
"@vctrl/cli"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"vectreal": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@vctrl/cli"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"vectreal": {
"command": "npx",
"args": [
"-y",
"@vctrl/cli"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"vectreal": {
"command": "npx",
"args": [
"-y",
"@vctrl/cli"
]
}
}
}Tools this server provides (13)
Taken from the project documentation; the running server may differ.
- search_docs
- Search the Vectreal docs.
- read_doc
- Read a docs page.
- whoami
- Shows the signed-in user, organization, plan and scopes.
- list_projects
- Lists the organization's projects.
- create_project
- Creates a project.
- list_scenes
- Lists a project's scenes.
- create_scene_from_file
- Uploads a local GLB as a draft scene.
- describe_model
- Describes a local GLB.
- get_scene_settings
- Reads scene settings.
- update_scene_settings
- Changes scene settings.
- publish_scene
- Compresses and publishes a scene.
- unpublish_scene
- Takes a scene offline.
- get_embed_snippet
- Returns the embed snippet and preview URL.
What it does
- GLB inspection
- Reports a local GLB's size, meshes, materials and animation clips without uploading it.
- Draft scene upload
- Uploads a GLB as a draft scene, stored as is.
- Scene settings control
- Reads and changes lighting, environment, controls, bounds, shadows, cameras and hotspots.
- Compressed publishing
- Publishes with Draco geometry and KTX2 textures like the publisher does.
- Embed snippets
- Returns an iframe snippet and creates an embed key and allowed domains when needed.
- Scoped access
- Acts under the permissions you granted, revocable from the dashboard.
Good for
- Publish a product model from Claude Code or Cursor
- Add camera angles and hotspots to a 3D scene
- Embed a published model on a web page
- Take a scene offline
- Inspect a GLB before uploading
Pricing
Freemium
Free, Pro, Business and Enterprise plans; prices not published
Prices change. Check vectreal.com before you buy.
Vectreal FAQ
What do I need to run it?
Node.js 22.22 or later and a Vectreal account; sign in once with `npx -y @vctrl/cli login`.
Can an agent delete my scenes?
No. The docs say deletion, billing, members and organization settings are not open to agents.
Is there a free plan?
The pricing page says to start free and pay when scenes go live; plan prices are not listed there.
Which clients are covered?
The docs show Claude Code, Cursor, VS Code and any stdio MCP client.
Is Vectreal free?
Vectreal has a free plan, with paid plans for more usage or features.
How do I add Vectreal to Claude Code?
Run this command in your terminal: claude mcp add vectreal -- npx -y @vctrl/cli
What are the best alternatives to Vectreal?
The closest alternatives to Vectreal are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.
Alternatives to Vectreal

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media