# Vectreal

> Vectreal is a freemium MCP server for design and media. Upload, configure, publish and embed 3D models from your coding agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, macOS, Windows, Linux, Web
- **Website:** https://vectreal.com/docs/agents
- **Repository:** https://github.com/vectreal/vectreal-platform/tree/HEAD/packages/cli
- **MCP Registry name:** io.github.Vectreal/vectreal
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add vectreal -- npx -y @vctrl/cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vectreal": {
      "command": "npx",
      "args": [
        "-y",
        "@vctrl/cli"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vectreal": {
      "command": "npx",
      "args": [
        "-y",
        "@vctrl/cli"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vectreal": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@vctrl/cli"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vectreal": {
      "command": "npx",
      "args": [
        "-y",
        "@vctrl/cli"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vectreal": {
      "command": "npx",
      "args": [
        "-y",
        "@vctrl/cli"
      ]
    }
  }
}
```

## Tools

- `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.

## 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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/vectreal
