Vitrine MCP Server
OfficialThe Vitrine MCP Server enables AI agents to manage 3D models, configure scenes, publish embeds, and save scene presets on the Vitrine platform.
Model Management
List all models with IDs, names, and publish status
Upload GLB/glTF files from disk
Get detailed model info (config, thumbnail, model URL)
Delete a model and its associated storage files
Scene Configuration
Get and apply full or partial scene configs (lighting, camera, background, bloom, shadows, tonemapping, auto-rotate, etc.)
List available HDRI environment presets
Retrieve the full SceneConfig JSON schema
Publishing & Embedding
Publish or unpublish a model
Generate ready-to-paste HTML embed code for published models
Looks (Scene Presets)
List, apply, and create named reusable scene presets ("Looks")
Account & Auth
View account info (plan tier, usage counts, limits)
Log in via browser, log out, and remove saved credentials
Submit bug reports or feature requests (auto-creates a GitHub issue)
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Vitrine MCP Server Upload this shoe model and get embed code"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Related MCP server: Wix MCP Server
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 |
| List all models with IDs, names, and publish status |
| Upload a GLB file from disk |
| Get model details, thumbnail, and merged config |
| Delete a model and its storage |
Configuration
Tool | Description |
| Get the full scene config for a model |
| Apply a config patch (lighting, camera, background, effects) |
| List available HDRI environment presets |
| Get the full config JSON schema |
Publishing
Tool | Description |
| Publish or unpublish a model |
| Get ready-to-paste embed HTML |
Looks
Tool | Description |
| List your saved Looks |
| Apply a Look to a model |
| Save a config as a named Look |
Account
Tool | Description |
| Current plan, usage, and limits |
| Connect your account via browser |
| Remove saved credentials |
| Submit a bug report or feature request |
Resources
Resource | Description |
| Full SceneConfig JSON schema |
| Available HDRI presets |
| 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
Available Tools
17 toolsvitrine_account_infoAccount InfoA
Get current account info: plan tier, usage counts, and limits.
Inputs: no named parameters.
vitrine_apply_lookApply LookB
Apply a Look preset to a model by setting its look_id.
Inputs: look_id (required), model_id (required).
vitrine_config_schemaConfig SchemaA
Get the full SceneConfig JSON schema — all fields, types, enums, and defaults.
Inputs: no named parameters.
vitrine_create_lookCreate LookB
Save a scene config as a named Look preset.
Inputs: name (required), config (required).
vitrine_delete_modelDelete ModelADestructive
Delete a model and all its associated storage files.
Inputs: model_id (required).
vitrine_feedbackSubmit FeedbackA
Submit a bug report or feature request. Creates a GitHub issue automatically.
Inputs: type (required), message (required), page.
vitrine_get_configGet ConfigA
Get the full merged scene config for a model (look + layout + overrides).
Inputs: model_id (required).
vitrine_get_embedGet Embed CodeA
Get ready-to-paste HTML embed code for a published model.
Inputs: model_id (required).
vitrine_list_hdrisList HDRIsA
List available HDRI environment presets with their slugs.
Inputs: no named parameters.
vitrine_list_looksList LooksA
List your saved Looks (reusable scene presets).
Inputs: no named parameters.
vitrine_list_modelsList ModelsA
List all your Vitrine 3D models with IDs, names, and publish status.
Inputs: no named parameters.
vitrine_loginLog InA
Connect your Vitrine account. Opens a browser to sign in or sign up. If you have anonymous models, they will be transferred to your account automatically.
Inputs: no named parameters.
vitrine_logoutLog OutA
Remove saved credentials. You'll start fresh as anonymous on next use.
Inputs: no named parameters.
vitrine_model_infoModel InfoA
Get detailed info about a model including config, thumbnail, and model URL.
Inputs: model_id (required).
vitrine_publishPublish / UnpublishC
Publish or unpublish a model. Published models are embeddable.
Inputs: model_id (required), published (required).
vitrine_set_configSet ConfigA
Apply a config patch to a model. Only include fields you want to change. Common fields: bg_mode, bg_color, hdri_name, hdri_exposure, bloom_enabled, bloom_intensity, auto_rotate, camera_fov, camera_pitch, camera_yaw, tonemapping_mode, shadow_catcher_enabled. Use vitrine_config_schema to see all available fields.
Inputs: config (required), model_id (required).
vitrine_upload_modelUpload ModelB
Upload a GLB/glTF file to Vitrine. Provide the absolute file path on disk.
Inputs: file_path (required), name.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Each tool targets a clearly distinct operation: model CRUD, config management, looks, auth, embedding, and feedback. Even closely related tools like set_config and apply_look are differentiated by whether you are patching config directly or using a preset.
All tools share the consistent vitrine_ prefix and snake_case, but the verb-noun pattern is not uniform. Some tools are verb-first (list_models, get_config), others are noun phrases (model_info, config_schema, account_info), and a few are bare verbs (publish, login, logout, feedback).
At 17 tools, the set is slightly above the ideal 3–15 range, but each tool serves a distinct purpose and covers the main workflows for a 3D model management server. No tool feels redundant or unnecessary, so the count is reasonable despite being a bit heavy.
The surface covers core model CRUD, configuration, publishing, embedding, looks, auth, and account info well. Minor gaps exist, such as no delete or update operation for looks and no explicit model metadata update, but these do not break the primary use cases.
Maintenance
Related MCP Connectors
MCP server for building and testing AI agents with multi-model experimentation and insights.
Hosted MCP for e-commerce: live product catalog, stock, and pricing for AI agents.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Hosted AgentLux MCP server for marketplace, identity, creator, services, and social flows.
Related MCP Servers
- AlicenseBqualityFmaintenanceA server that enables interaction with Square's API via Goose, supporting queries for locations, customers, and more with context preservation and MCP-compliant responses.124MIT
- -
- FlicenseNot gradedqualityDmaintenanceAn MCP server for managing and publishing 3D files using S3-compatible storage providers like Cloudflare R2 and AWS S3. It enables users to upload models, generate interactive 3D viewers, and manage temporary access via presigned URLs.-
- AlicenseAqualityNot gradedmaintenanceAutomate AliExpress/Alibaba/Accio dropshipping product import to Shopify & Wix via DSers. 13 tools + 4 prompts for bulk import, pricing rules, SEO optimization, pre-push safety checks, multi-store push, variant editing, product management, and automated supplier replacement with SKU-level variant matching. Zero-password browser login. v1.5.7.1359 npm26-