Crystallize MCP Server

by hayodevio.github.HayoDev/crystallize-mcpv0.2.0

Crystallize MCP — headless commerce tools for AI agents. Browse catalogue, search products, inspect shapes, manage orders via Model Context Protocol.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Stale6mo ago

Install Crystallize MCP server

claude mcp add crystallize -- npx -y @hayodev/crystallize-mcp

{
  "mcpServers": {
    "crystallize": {
      "command": "npx",
      "args": [
        "-y",
        "@hayodev/crystallize-mcp"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "crystallize": {
      "command": "npx",
      "args": [
        "-y",
        "@hayodev/crystallize-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "crystallize": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@hayodev/crystallize-mcp"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "crystallize": {
      "command": "npx",
      "args": [
        "-y",
        "@hayodev/crystallize-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
CRYSTALLIZE_TENANT_IDENTIFIER	—	—	Your Crystallize tenant identifier (e.g. 'my-store'). Find it in your Crystallize dashboard URL: app.crystallize.com/{tenant}
CRYSTALLIZE_ACCESS_TOKEN_ID	—	—	Access Token ID for authenticated API access. Create one at Settings > Access Tokens in your Crystallize dashboard. Optional — public catalogue and Discovery API work without auth.
CRYSTALLIZE_ACCESS_TOKEN_SECRET	—	—	Access Token Secret (paired with Access Token ID).
CRYSTALLIZE_STATIC_AUTH_TOKEN	—	—	Static auth token (alternative to token ID/secret pair). Read-only.
CRYSTALLIZE_ACCESS_MODE	—	—	Controls which tools are available: 'read' (default, safe), 'write' (can create/update items), 'admin' (full access including webhooks).