vitrine MCP server

MCP server for vitrine — the 3D product viewer platform. Upload GLB models, configure scenes, publish embeds, and manage Looks from any AI agent.

Setup

Add to your MCP client config (Claude Code, Cursor, Windsurf, etc.):

config.json

{
  "mcpServers": {
    "vitrine": {
      "command": "npx",
      "args": ["@vitrine3d/mcp"]
    }
  }
}

Works immediately with no API key — anonymous uploads expire after 48 hours.

Keep your models

Say "log me in" to your AI agent. A browser window opens, you sign in (or sign up for free), and your models become permanent. No manual key copying needed.

Or set an API key manually:

config.json

{
  "mcpServers": {
    "vitrine": {
      "command": "npx",
      "args": ["@vitrine3d/mcp"],
      "env": {
        "VITRINE_API_KEY": "vt_..."
      }
    }
  }
}

Generate keys at app.vitrine3d.com → Account → API Keys.

What you can do

Ask your AI agent things like:

"Upload this shoe model and give me an embed code"
"Make the lighting warmer and add bloom"
"List my models and publish the chair"
"Create a Look called 'Noir' with dark background and dramatic lighting"

Tools

Models

Tool	Description
`vitrine_list_models`	List all models with IDs, names, and publish status
`vitrine_upload_model`	Upload a GLB file from disk
`vitrine_model_info`	Get model details, thumbnail, and merged config
`vitrine_delete_model`	Delete a model and its storage

Configuration

Tool	Description
`vitrine_get_config`	Get the full scene config for a model
`vitrine_set_config`	Apply a config patch (lighting, camera, background, effects)
`vitrine_list_hdris`	List available HDRI environment presets
`vitrine_config_schema`	Get the full config JSON schema

Publishing

Tool	Description
`vitrine_publish`	Publish or unpublish a model
`vitrine_get_embed`	Get ready-to-paste embed HTML

Looks

Tool	Description
`vitrine_list_looks`	List your saved Looks
`vitrine_apply_look`	Apply a Look to a model
`vitrine_create_look`	Save a config as a named Look

Account

Tool	Description
`vitrine_account_info`	Current plan, usage, and limits
`vitrine_login`	Connect your account via browser
`vitrine_logout`	Remove saved credentials
`vitrine_feedback`	Submit a bug report or feature request

Resources

Resource	Description
`vitrine://config-schema`	Full SceneConfig JSON schema
`vitrine://hdri-presets`	Available HDRI presets
`vitrine://embed-template`	Embed code template

HTTP transport

Run as a hosted HTTP server instead of stdio:

Terminal

npx @vitrine3d/mcp --http          # default port 3000
PORT=8080 npx @vitrine3d/mcp --http # custom port

The server exposes a Streamable HTTP endpoint at /mcp, compatible with Smithery, Glama connectors, and any MCP client that supports HTTP transport.

How it works

Code

You -> AI Agent (Claude, Cursor, etc.)
        | MCP protocol (stdio or HTTP)
      vitrine MCP server
        | HTTPS
      api.vitrine3d.com
        |
      Supabase (database, storage, auth)

Documentation

License

MIT