Product Attributes & Customization

This guide explains how to use the Zid MCP tools for managing product attributes, variants, custom options, and product customization features in your Zid store. Each tool is callable from your MCP environment and supports flexible attribute management, localization, and integration into product workflows.

1. Get Product Attributes (mcp_Zid_GetProductAttributes)

Purpose:
Retrieve a list of all product attributes available in your Zid store.

Use Cases:

Display available attributes in your admin dashboard

Build attribute selection interfaces

Analyze your store's attribute structure

How to Use:
Call this tool to get all product attributes in your store.

Parameters:

language (string): Response language (en or ar)

Example Usage:

2. Get Product Attribute (mcp_Zid_GetProductAttribute)

Purpose:
Fetch detailed information about a specific product attribute.

Use Cases:

View complete attribute information in admin panel

Display attribute details to content managers

Analyze attribute usage and preset values

How to Use:
Provide the attributeId to retrieve the attribute details.

Parameters:

attributeId (string or number): The unique ID of the attribute

language (string): Response language (en or ar)

Example Usage:

3. Create Product Attribute (mcp_Zid_action_CreateProductAttribute)

Purpose:
Create a new product attribute to define product characteristics.

Use Cases:

Add new attributes like color, size, material, etc.

Create custom attributes specific to your product types

Set up attributes for product filtering and organization

How to Use:
Provide the required attribute information including names in both languages.

Parameters:

nameAr (string): Attribute name in Arabic

nameEn (string): Attribute name in English

language (string): Response language (en or ar)

Example Usage:

4. Update Product Attribute (mcp_Zid_action_UpdateProductAttribute)

Purpose:
Modify existing product attribute information.

Use Cases:

Update attribute names or translations

Correct attribute information

Rename attributes for better clarity

How to Use:
Provide the attributeId and the fields you want to update.

Parameters:

attributeId (string or number): The unique ID of the attribute

nameAr (string, optional): Updated attribute name in Arabic

nameEn (string, optional): Updated attribute name in English

language (string): Response language (en or ar)

Example Usage:

5. Delete Product Attribute (mcp_Zid_action_DeleteProductAttribute)

Purpose:
Remove a product attribute from your Zid store.

Use Cases:

Remove unused or obsolete attributes

Clean up attribute structure

Remove attributes that are no longer relevant

How to Use:
Provide the attributeId to delete the attribute.

Parameters:

attributeId (string or number): The unique ID of the attribute to delete

language (string): Response language (en or ar)

Example Usage:

6. Get Product Attribute Presets (mcp_Zid_GetProductAttributePresets)

Purpose:
Retrieve all preset values for a specific product attribute.

Use Cases:

Display available preset values for an attribute

Build dropdown menus for attribute values

Analyze attribute value usage

How to Use:
Provide the attributeId to get all preset values for that attribute.

Parameters:

attributeId (string or number): The unique ID of the attribute

language (string): Response language (en or ar)

Example Usage:

7. Create Product Attribute Preset (mcp_Zid_action_CreateProductAttributePreset)

Purpose:
Add a new preset value to an existing product attribute.

Use Cases:

Add new color options to a color attribute

Add new size options to a size attribute

Expand attribute value options for products

How to Use:
Provide the attributeId and the preset value information.

Parameters:

attributeId (string or number): The unique ID of the attribute

value (object): Preset value in both languages {ar: "القيمة", en: "Value"}

language (string): Response language (en or ar)

Example Usage:

8. Update Product Attribute Preset (mcp_Zid_action_UpdateProductAttributePreset)

Purpose:
Modify existing preset values for a product attribute.

Use Cases:

Update preset value names or translations

Correct preset value information

Rename preset values for better clarity

How to Use:
Provide the attributeId, presetId, and the updated value information.

Parameters:

attributeId (string or number): The unique ID of the attribute

presetId (string): The unique ID of the preset value

value (object): Updated preset value {ar: "القيمة", en: "Value"}

language (string): Response language (en or ar)

Example Usage:

9. Delete Product Attribute Preset (mcp_Zid_action_DeleteProductAttributePreset)

Purpose:
Remove a preset value from a product attribute.

Use Cases:

Remove unused or obsolete preset values

Clean up attribute value options

Remove preset values that are no longer relevant

How to Use:
Provide the attributeId and presetId to delete the preset value.

Parameters:

attributeId (string or number): The unique ID of the attribute

presetId (string): The unique ID of the preset value to delete

language (string): Response language (en or ar)

Example Usage:

10. Add Product Variants (mcp_Zid_action_AddProductVariants)

Purpose:
Add product variants with different attribute combinations to a product.

Use Cases:

Create products with multiple options (e.g., shirts in different sizes and colors)

Set different prices for different variants

Manage inventory for each variant separately

How to Use:
Provide the productId and an array of variant objects with their attributes.

Parameters:

productId (string): The unique ID of the product

variants (array): Array of variant objects with:

sku (string): Variant SKU

price (number): Variant price

quantity (number): Available quantity

is_infinite (boolean): Whether stock is infinite

attributes (array): Array of attribute objects {slug: "color", value: {ar: "أحمر", en: "Red"}}

images (array, optional): Array of image URLs

weight (object, optional): Variant weight {value: number, unit: "kg"}

sale_price (number, optional): Sale price for the variant

language (string): Response language (en or ar)

Example Usage:

11. Add Product Custom Options (mcp_Zid_action_AddProductCustomOptions)

Purpose:
Add custom options (like dropdowns) to products for additional customization.

Use Cases:

Add engraving options to jewelry

Create dropdown options for product customization

Allow customers to select additional features

How to Use:
Provide the productId and custom option information.

Parameters:

productId (string): The unique ID of the product

label (object): Option label {ar: "التسمية", en: "Label"}

choices (array): Array of choice objects {ar: "الخيار", en: "Choice", price: "10"}

hint (object, optional): Hint text {ar: "تلميح", en: "Hint"}

language (string): Response language (en or ar)

Example Usage:

12. Add Product Custom Input Field (mcp_Zid_action_AddProductCustomInputField)

Purpose:
Add custom input fields to products for personalized text or data entry.

Use Cases:

Allow customers to specify custom text for engraving

Create personalized product options

Add custom requirements or specifications

How to Use:
Provide the productId and input field information.

Parameters:

productId (string): The unique ID of the product

type (string): Input field type (text, number, dropdown)

price (string): Additional price for the option

label (object): Field label {ar: "التسمية", en: "Label"}

hint (object, optional): Hint text {ar: "تلميح", en: "Hint"}

language (string): Response language (en or ar)

Example Usage:

13. Set Manual Products Sorting (mcp_Zid_action_SetManualProductsSorting)

Purpose:
Set a custom sorting order for products within a category.

Use Cases:

Control the display order of products in category pages

Prioritize featured or best-selling products

Create custom product arrangements

How to Use:
Provide an array of product IDs in the desired order.

Parameters:

products (array): Array of product IDs in desired order

category (number, optional): Category ID for sorting within a specific category

language (string): Response language (en or ar)

Example Usage:

14. Reset Manual Products Sorting (mcp_Zid_action_ResetManualProductsSorting)

Purpose:
Reset product sorting back to the default order.

Use Cases:

Remove custom sorting and return to default order

Reset sorting after promotional periods

Clean up manual sorting arrangements

How to Use:
No parameters required, just specify the language.

Parameters:

language (string): Response language (en or ar)

Example Usage:

15. List Product Metafields (mcp_Zid_ListProductMetafields)

Purpose:
Retrieve a list of all product metafields in your Zid store.

Use Cases:

Display available metafields in your admin dashboard

Build metafield management interfaces

Analyze your store's metafield structure

How to Use:
Call this tool to get all product metafields in your store.

Parameters:

language (string): Response language (en or ar)

Example Usage:

Summary Table

Tool Name	Purpose/Use Case	Key Parameters
Get Product Attributes	List all product attributes	(none required)
Get Product Attribute	Fetch details for specific attribute	attributeId
Create Product Attribute	Add new product attribute	nameAr, nameEn
Update Product Attribute	Modify existing attribute	attributeId, nameAr, nameEn
Delete Product Attribute	Remove product attribute	attributeId
Get Product Attribute Presets	List preset values for attribute	attributeId
Create Product Attribute Preset	Add new preset value	attributeId, value
Update Product Attribute Preset	Modify existing preset value	attributeId, presetId, value
Delete Product Attribute Preset	Remove preset value	attributeId, presetId
Add Product Variants	Add product variants with attributes	productId, variants array
Add Product Custom Options	Add dropdown customization options	productId, label, choices
Add Product Custom Input Field	Add text/number input fields	productId, type, price, label
Set Manual Products Sorting	Set custom product order	products array, category
Reset Manual Products Sorting	Reset to default sorting	(none required)
List Product Metafields	List all product metafields	(none required)

Best Practices for Product Attributes & Customization

Consistent Naming: Use consistent naming conventions for attributes and their values

Bilingual Support: Always provide both Arabic and English translations

Logical Organization: Group related attributes together and use clear, descriptive names

Preset Management: Regularly review and clean up unused preset values

Variant Planning: Plan your variant structure carefully to avoid creating too many combinations

Custom Options: Use custom options sparingly and ensure they add real value to the customer experience

Performance Considerations: Limit the number of variants per product to maintain good performance

SEO Optimization: Use descriptive attribute names that customers would search for

Inventory Management: Keep track of inventory for each variant separately

10.

Testing: Test your attribute and customization setup thoroughly before going live

This comprehensive attribute and customization system allows you to create highly configurable products that meet your customers' specific needs while maintaining a well-organized and manageable product catalog.

Product Attributes & Customization

1. Get Product Attributes (mcp_Zid_GetProductAttributes)#

2. Get Product Attribute (mcp_Zid_GetProductAttribute)#

3. Create Product Attribute (mcp_Zid_action_CreateProductAttribute)#

4. Update Product Attribute (mcp_Zid_action_UpdateProductAttribute)#

5. Delete Product Attribute (mcp_Zid_action_DeleteProductAttribute)#

6. Get Product Attribute Presets (mcp_Zid_GetProductAttributePresets)#

7. Create Product Attribute Preset (mcp_Zid_action_CreateProductAttributePreset)#

8. Update Product Attribute Preset (mcp_Zid_action_UpdateProductAttributePreset)#

9. Delete Product Attribute Preset (mcp_Zid_action_DeleteProductAttributePreset)#

10. Add Product Variants (mcp_Zid_action_AddProductVariants)#

11. Add Product Custom Options (mcp_Zid_action_AddProductCustomOptions)#

12. Add Product Custom Input Field (mcp_Zid_action_AddProductCustomInputField)#

13. Set Manual Products Sorting (mcp_Zid_action_SetManualProductsSorting)#

14. Reset Manual Products Sorting (mcp_Zid_action_ResetManualProductsSorting)#

15. List Product Metafields (mcp_Zid_ListProductMetafields)#

Summary Table#

Best Practices for Product Attributes & Customization#

1. Get Product Attributes (mcp_Zid_GetProductAttributes)

2. Get Product Attribute (mcp_Zid_GetProductAttribute)

3. Create Product Attribute (mcp_Zid_action_CreateProductAttribute)

4. Update Product Attribute (mcp_Zid_action_UpdateProductAttribute)

5. Delete Product Attribute (mcp_Zid_action_DeleteProductAttribute)

6. Get Product Attribute Presets (mcp_Zid_GetProductAttributePresets)

7. Create Product Attribute Preset (mcp_Zid_action_CreateProductAttributePreset)

8. Update Product Attribute Preset (mcp_Zid_action_UpdateProductAttributePreset)

9. Delete Product Attribute Preset (mcp_Zid_action_DeleteProductAttributePreset)

10. Add Product Variants (mcp_Zid_action_AddProductVariants)

11. Add Product Custom Options (mcp_Zid_action_AddProductCustomOptions)

12. Add Product Custom Input Field (mcp_Zid_action_AddProductCustomInputField)

13. Set Manual Products Sorting (mcp_Zid_action_SetManualProductsSorting)

14. Reset Manual Products Sorting (mcp_Zid_action_ResetManualProductsSorting)

15. List Product Metafields (mcp_Zid_ListProductMetafields)

Summary Table

Best Practices for Product Attributes & Customization