Crystallize MCP

Name: Crystallize MCP
Author: hayodev

by hayodevcommunityv0.2.0

The Crystallize MCP server provides AI agents with read and write access to a headless commerce platform's catalogue, products, orders, and customer data, while ensuring data privacy and safety during mutations.

From the registry: Crystallize headless commerce tools for AI agents via Model Context Protocol

GitHub Repository

Install & configure

Prerequisites

required
Crystallize tenant and tokens
Need a Crystallize tenant identifier. For PIM tools (shapes, orders, customers), also create an access token in Crystallize admin.
https://crystallize.com

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `crystallize-mcp` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Crystallize tenant and tokens** — Need a Crystallize tenant identifier. For PIM tools (shapes, orders, customers), also create an access token in Crystallize admin. (https://crystallize.com)

Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@hayodev/crystallize-mcp@latest"]
- required environment variables:
  - `CRYSTALLIZE_TENANT_IDENTIFIER`: Your Crystallize tenant identifier. (example: `<your-crystallize-tenant>`)
- optional environment variables:
  - `CRYSTALLIZE_ACCESS_TOKEN_ID`: Crystallize PIM access token ID (required for PIM tools). (example: `<your-token-id>`)
  - `CRYSTALLIZE_ACCESS_TOKEN_SECRET`: Crystallize PIM access token secret. (example: `<your-token-secret>`)

Note: Use 'npx @hayodev/crystallize-mcp --setup' for interactive setup with keychain storage.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: Use 'npx @hayodev/crystallize-mcp --setup' for interactive setup with keychain storage.

Tools (16)

browse_catalogue

Traverse the item tree by path

get_item

Fetch an item by path or ID with full component data

search_catalogue

Keyword search across all items

get_product_variants

List variants with pricing and stock

list_discovery_shapes

List all shapes with their queryable fields

browse_shape

Browse items of a shape with filters, pagination, and field selection

get_shape_fields

Detailed field info for a specific shape

list_shapes

All shapes with component summaries

get_shape

Full component definition for a shape

get_tenant_info

Tenant configuration and available languages

list_orders

List orders for a customer with pagination

get_order

Full order details — cart, payments, customer, totals

list_customers

Search and list customers with pagination

get_customer

Environment variables

CRYSTALLIZE_TENANT_IDENTIFIERrequiredYour tenant identifier from `app.crystallize.com/{tenant}`

Packages

@hayodev/crystallize-mcp

npmv0.2.0transport: stdio

Details

Language: TypeScript
License: MIT
Released: Apr 10, 2026
Last commit: Apr 13, 2026
Registry name: io.github.HayoDev/crystallize-mcp

Related Servers

Notfair Meta Ads

Meta Ads MCP (Facebook + Instagram) - analyze performance, manage budgets, pause campaigns.

3.4k

Mcp Clip

MCP server for Clip (PayClip) — Mexico's leading acquirer: payment links, card charges, refunds

261

Mcp Epayco

MCP server for ePayco — Colombian gateway: cards, PSE, Daviplata and cash networks

259