Categories Management

This guide explains how to use the Zid MCP tools for managing product categories, organizing your catalog, and controlling category publishing in your Zid store. Each tool is callable from your MCP environment and supports flexible management, localization, and integration into dashboards or workflows.

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

Use Cases:

Display category navigation in your admin dashboard

Build category selection dropdowns

Analyze your store's category structure

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

Parameters:

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

Example Usage:

2. Get Category Details (mcp_Zid_GetCategoryDetails)

Purpose:
Fetch detailed information about a specific category, including its products and settings.

Use Cases:

View complete category information in admin panel

Display category details to content managers

Analyze category performance and product count

How to Use:
Provide the categoryId to retrieve the category details.

Parameters:

categoryId (string or number): The unique ID of the category

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

Example Usage:

3. Create Category (mcp_Zid_action_CreateCategory)

Purpose:
Create a new category in your Zid store to organize products.

Use Cases:

Add new product categories to organize your catalog

Create subcategories for better product organization

Set up seasonal or promotional categories

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

Parameters:

nameAr (string): Category name in Arabic

nameEn (string): Category name in English

descriptionAr (string, optional): Category description in Arabic

descriptionEn (string, optional): Category description in English

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

Example Usage:

4. Update Category (mcp_Zid_action_UpdateCategory)

Purpose:
Modify existing category information, descriptions, or settings.

Use Cases:

Update category names or descriptions

Change category information for seasonal updates

Correct category details or translations

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

Parameters:

categoryId (string or number): The unique ID of the category

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

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

descriptionAr (string, optional): Updated description in Arabic

descriptionEn (string, optional): Updated description in English

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

Example Usage:

5. Add Product to Category (mcp_Zid_action_AddProductToCategory)

Purpose:
Assign a product to a specific category for better organization.

Use Cases:

Organize products into appropriate categories

Add products to multiple categories

Manage product categorization for better discoverability

How to Use:
Provide the productId and categoryId to assign the product to the category.

Parameters:

productId (string): The unique ID of the product

categoryId (number): The unique ID of the category

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

Example Usage:

6. Remove Product from Category (mcp_Zid_action_RemoveProductFromCategory)

Purpose:
Remove a product from a specific category.

Use Cases:

Remove products from inappropriate categories

Reorganize product categorization

Clean up category assignments

How to Use:
Provide the productId and categoryId to remove the product from the category.

Parameters:

productId (string): The unique ID of the product

categoryId (string or number): The unique ID of the category

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

Example Usage:

7. Update Category Publishing (mcp_Zid_action_UpdateCategoryPublishing)

Purpose:
Control whether a category is published and visible to customers.

Use Cases:

Hide categories that are not ready for customers

Temporarily disable categories during maintenance

Control category visibility for seasonal or promotional purposes

How to Use:
Provide the categoryId and the desired publishing status.

Parameters:

categoryId (string or number): The unique ID of the category

isPublished (boolean): Whether the category should be published (true) or unpublished (false)

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

Example Usage:

8. Remove Category from Products (mcp_Zid_action_RemoveCategoryFromProducts)

Purpose:
Remove a category from all products that are currently assigned to it.

Use Cases:

Clean up category assignments when removing a category

Reorganize product categorization on a large scale

Remove outdated or incorrect category assignments

How to Use:
Provide the categoryId to remove it from all associated products.

Parameters:

categoryId (string or number): The unique ID of the category to remove from all products

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

Example Usage:

Summary Table

Tool Name	Purpose/Use Case	Key Parameters
List Categories	Display all categories in store	(none required)
Get Category Details	Fetch full details for a specific category	categoryId
Create Category	Add new category to organize products	nameAr, nameEn, descriptionAr, descriptionEn
Update Category	Modify existing category information	categoryId, fields to update
Add Product to Category	Assign product to category for organization	productId, categoryId
Remove Product from Category	Remove product from specific category	productId, categoryId
Update Category Publishing	Control category visibility to customers	categoryId, isPublished
Remove Category from Products	Remove category from all associated products	categoryId

Best Practices for Category Management

Hierarchical Organization: Create main categories and subcategories for better product organization

Consistent Naming: Use consistent naming conventions in both Arabic and English

Descriptive Content: Provide clear descriptions to help customers understand what products belong in each category

Publishing Control: Use publishing status to control which categories are visible to customers

Regular Maintenance: Periodically review and clean up category assignments to ensure products are properly organized

SEO Considerations: Use descriptive category names that customers would search for

Product Assignment: Ensure products are assigned to the most appropriate categories for better discoverability

This category management system allows you to create a well-organized product catalog that helps customers easily find the products they're looking for while providing you with the tools to maintain and optimize your category structure.

Categories Management

1. List Categories (mcp_Zid_ListCategories)#

2. Get Category Details (mcp_Zid_GetCategoryDetails)#

3. Create Category (mcp_Zid_action_CreateCategory)#

4. Update Category (mcp_Zid_action_UpdateCategory)#

5. Add Product to Category (mcp_Zid_action_AddProductToCategory)#

6. Remove Product from Category (mcp_Zid_action_RemoveProductFromCategory)#

7. Update Category Publishing (mcp_Zid_action_UpdateCategoryPublishing)#

8. Remove Category from Products (mcp_Zid_action_RemoveCategoryFromProducts)#

Summary Table#

Best Practices for Category Management#

1. List Categories (mcp_Zid_ListCategories)

2. Get Category Details (mcp_Zid_GetCategoryDetails)

3. Create Category (mcp_Zid_action_CreateCategory)

4. Update Category (mcp_Zid_action_UpdateCategory)

5. Add Product to Category (mcp_Zid_action_AddProductToCategory)

6. Remove Product from Category (mcp_Zid_action_RemoveProductFromCategory)

7. Update Category Publishing (mcp_Zid_action_UpdateCategoryPublishing)

8. Remove Category from Products (mcp_Zid_action_RemoveCategoryFromProducts)

Summary Table

Best Practices for Category Management