Crystallize headless commerce tools for AI agents via Model Context Protocol
Crystallize headless commerce tools for AI agents via Model Context Protocol
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.
Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| 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 | Full customer profile — addresses, meta, external references |
{
"mcpServers": {
"crystallize": {
"command": "npx",
"args": ["-y", "@hayodev/crystallize-mcp"],
"env": {
"CRYSTALLIZE_TENANT_IDENTIFIER": "your-value",
"CRYSTALLIZE_ACCESS_TOKEN_ID": "your-value",
"CRYSTALLIZE_ACCESS_TOKEN_SECRET": "your-value",
"CRYSTALLIZE_ACCESS_MODE": "your-value",
"CRYSTALLIZE_DRY_RUN": "your-value",
"CRYSTALLIZE_STATIC_AUTH_TOKEN": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| CRYSTALLIZE_TENANT_IDENTIFIER | Configuration value read at startup. | Optional |
| CRYSTALLIZE_ACCESS_TOKEN_ID | Credential the server authenticates with. | Yes |
| CRYSTALLIZE_ACCESS_TOKEN_SECRET | Credential the server authenticates with. | Yes |
| CRYSTALLIZE_ACCESS_MODE | Configuration value read at startup. | Optional |
| CRYSTALLIZE_DRY_RUN | Configuration value read at startup. | Optional |
| CRYSTALLIZE_STATIC_AUTH_TOKEN | Credential the server authenticates with. | Yes |
Access Stripe billing and payment tools through its MCP server. Connect with OAuth or a supported agent API key and choose the intended account.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Bridge ISO 8583 card-payment messages to ONE OS — parse, map, govern (PCI-DSS / scheme rules).
Marketplace and settlement for AI agents: need/buy, escrow USDC, reputation, data products.
Read a Finero workspace and issue payment links, as the person who approved it.
Statements, invoices, tables, ledgers — every result carries its own arithmetic proof.