Skip to main content
Glama
Vitrine MCP Server

Vitrine MCP Server

Official
by vitrine3d

vitrine MCP server

npm Glama License: MIT

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

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

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 tools
vitrine_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 ModelA
Destructive

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

    A3.6/5.0

    Scored across 17 tools

    Disambiguation5/5

    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.

    Naming Consistency3/5

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

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      F
      maintenance
      A server that enables interaction with Square's API via Goose, supporting queries for locations, customers, and more with context preservation and MCP-compliant responses.
      12
      4
      MIT
    • A
      license
      A
      quality
      Not graded
      maintenance
      Automate 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.
      13
      59 npm
      26
      -