Crystallize MCP
Gives Claude direct access to your Crystallize headless commerce backend through 16 tools spanning catalogue browsing, product search, order management, and customer data. You get read access out of the box with just a tenant ID, while authenticated tokens unlock PIM operations like shape inspection, order lookup, and content mutations. The server includes dry-run mode for testing writes, PII masking for customer data, and deep links back to the Crystallize UI for every operation. Particularly useful if you're building with Crystallize and want Claude to query product variants, update component values via dot notation, or pull order details without writing integration code. Write mode requires explicit opt-in and supports safe previews before committing changes.
- tools
- 16
- transport
- STDIO
- env vars
- 5
- last updated
- Apr 10, 2026
Tools
16 toolsPublic tool metadata for what this MCP can expose to an agent.
browse_catalogueTraverse the item tree by path
Traverse the item tree by path
No parameter schema in public metadata yet.
get_itemFetch an item by path or ID with full component data
Fetch an item by path or ID with full component data
No parameter schema in public metadata yet.
search_catalogueKeyword search across all items
Keyword search across all items
No parameter schema in public metadata yet.
get_product_variantsList variants with pricing and stock
List variants with pricing and stock
No parameter schema in public metadata yet.
list_discovery_shapesList all shapes with their queryable fields
List all shapes with their queryable fields
No parameter schema in public metadata yet.
browse_shapeBrowse items of a shape with filters, pagination, and field selection
Browse items of a shape with filters, pagination, and field selection
No parameter schema in public metadata yet.
get_shape_fieldsDetailed field info for a specific shape
Detailed field info for a specific shape
No parameter schema in public metadata yet.
list_shapesAll shapes with component summaries
All shapes with component summaries
No parameter schema in public metadata yet.
get_shapeFull component definition for a shape
Full component definition for a shape
No parameter schema in public metadata yet.
get_tenant_infoTenant configuration and available languages
Tenant configuration and available languages
No parameter schema in public metadata yet.
list_ordersList orders for a customer with pagination
List orders for a customer with pagination
No parameter schema in public metadata yet.
get_orderFull order details — cart, payments, customer, totals
Full order details — cart, payments, customer, totals
No parameter schema in public metadata yet.
list_customersSearch and list customers with pagination
Search and list customers with pagination
No parameter schema in public metadata yet.
get_customerFull customer profile — addresses, meta, external references
Full customer profile — addresses, meta, external references
No parameter schema in public metadata yet.
create_itemCreate a new item (product, document, or folder) with components
Create a new item (product, document, or folder) with components
No parameter schema in public metadata yet.
update_componentUpdate a single component value — supports nested content chunks via dot notation (e.g. `hero.title`)
Update a single component value — supports nested content chunks via dot notation (e.g. `hero.title`)
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
CRYSTALLIZE_TENANT_IDENTIFIERYour Crystallize tenant identifier (e.g. 'my-store'). Find it in your Crystallize dashboard URL: app.crystallize.com/{tenant}
CRYSTALLIZE_ACCESS_TOKEN_IDAccess 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_SECRETAccess Token Secret (paired with Access Token ID).
CRYSTALLIZE_STATIC_AUTH_TOKENStatic auth token (alternative to token ID/secret pair). Read-only.
CRYSTALLIZE_ACCESS_MODEControls which tools are available: 'read' (default, safe), 'write' (can create/update items), 'admin' (full access including webhooks).
Readme
Crystallize MCP
MCP server for Crystallize headless commerce. Gives AI agents read and write access to your catalogue, products, shapes, orders, customers, and tenant config — with deep links back to the Crystallize UI, dry-run safety for mutations, and PII masking for customer data.
Works with Claude Code, Claude Desktop, Cursor, Windsurf, Copilot, and any MCP-compatible client.
Getting started
Setup wizard
The interactive wizard handles config, auth tokens, keychain storage, and PII mode in one step:
# Project-level — writes .mcp.json in the current directory (shared with your team)
npx @hayodev/crystallize-mcp --setup
Details
- Repository
- github.com/hayodev/crystallize-mcp
- Categories
- Web & Browser Automation, Finance & Commerce
- Package
@hayodev/crystallize-mcp- Transport
- STDIO
- Registry
- MCP registry, active
More from hayodev
Related Web & Browser Automation MCP servers
View all
Draw Flow Mcp Serverhj1003862396/draw-flow-mcp-serverMCP server for Next AI Draw.io - AI-powered diagram generation with real-time browser preview0stars
User Agent Parser APIbr0ski777/user-agent-parser-x402Parse user agents — browser, OS, device, bot detection. x402 micropayment.0stars
MiOffice — AI-Powered Workspace Studioio.github.jsvvsolsllc/mioffice125+ browser tools for PDF, Image, Video, Audio, AI, Scanner. Files never leave your device.0stars
Html To Markdown Mcpmukundakatta/mcp-stackConvert HTML to Markdown or strip to plain text. For web-scraping agents.0stars