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.):
{
"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:
{
"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:
npx @vitrine3d/mcp --http # default port 3000
PORT=8080 npx @vitrine3d/mcp --http # custom portThe server exposes a Streamable HTTP endpoint at /mcp, compatible with Smithery, Glama connectors, and any MCP client that supports HTTP transport.
How it works
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