Skip to content
MCP server

Vectreal

Upload, configure, publish and embed 3D models from your coding agent

Runs locallyStatus and history
Install
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/cli

Add to claude_desktop_config.json

{
  "mcpServers": {
    "vectreal": {
      "command": "npx",
      "args": [
        "-y",
        "@vctrl/cli"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "vectreal": {
      "command": "npx",
      "args": [
        "-y",
        "@vctrl/cli"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media