Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.
Inventory & Locations
1. List Store Locations (mcp_Zid_ListStoreLocations)
Retrieve a list of all store locations in your Zid store.
Call this tool to get all store locations in your store.
language (string): Response language (en or ar)2. Get Store Location (mcp_Zid_GetStoreLocation)
Fetch detailed information about a specific store location.
Provide the locationId to retrieve the location details.
locationId (string): The unique ID of the store locationlanguage (string): Response language (en or ar)3. Add Store Location (mcp_Zid_action_AddStoreLocation)
Create a new store location with coordinates, address, and settings.
Provide the required location information including coordinates and address details.
name (object): Location name in both languages {ar: "اسم الموقع", en: "Location Name"}coordinates (object): GPS coordinates {longitude: number, latitude: number}fullAddress (string): Complete address of the locationcity (number): City ID for the locationisDefault (boolean): Whether this is the default locationisPrivate (boolean): Whether this location is privateisEnabled (boolean): Whether this location is enabledlanguage (string): Response language (en or ar)4. Update Store Location (mcp_Zid_action_UpdateStoreLocation)
Modify existing store location information and settings.
Provide the locationId and the fields you want to update.
locationId (string): The unique ID of the store locationname (string, optional): Updated location namedescription (string, optional): Updated location descriptionisActive (boolean, optional): Updated active statuslanguage (string): Response language (en or ar)5. Update Location Stock (mcp_Zid_action_UpdateLocationStock)
Update stock levels for multiple products at a specific location.
Provide the locationId and an array of products with their stock information.
locationId (string): The unique ID of the store locationproducts (array): Array of product objects with:productId (string): The unique ID of the productavailableQuantity (number): Available quantity (minimum: 0)isInfinite (boolean): Whether stock is infinite (default: false)language (string): Response language (en or ar)6. List Product Stocks (mcp_Zid_ListProductStocks)
Retrieve a list of all stock entries for a specific product across all locations.
Provide the productId to get all stock entries for that product.
productId (string): The unique ID of the productlanguage (string): Response language (en or ar)7. Get Product Stock (mcp_Zid_GetProductStock)
Fetch detailed information about a specific stock entry for a product.
Provide the productId and stockId to retrieve the stock details.
productId (string): The unique ID of the productstockId (string): The unique ID of the stock entrylanguage (string): Response language (en or ar)8. Update Product Stock (mcp_Zid_action_UpdateProductStock)
Update stock levels for a specific product at a specific location.
Provide the productId, stockId, and the new stock information.
productId (string): The unique ID of the productstockId (string): The unique ID of the stock entryavailableQuantity (number or null): Available quantity (null for infinite)isInfinite (boolean): Whether stock is infinitelanguage (string): Response language (en or ar)9. Add Product Stock (mcp_Zid_action_AddProductStock)
Add a new stock entry for a product at a specific location.
Provide the productId and stock information for the new location.
productId (string): The unique ID of the productlocation (string): Location name for the stockavailableQuantity (number): Available quantityisInfinite (boolean): Whether stock is infinitelanguage (string): Response language (en or ar)10. Bulk Update Product Stocks (mcp_Zid_action_BulkUpdateProductStocks)
Update stock levels for multiple products at once.
Provide the productId and an array of stock updates.
productId (string): The unique ID of the productstocks (array): Array of stock objects with:location (string): Location nameavailableQuantity (number or null): Available quantity (null for infinite)isInfinite (boolean): Whether stock is infinitelanguage (string): Response language (en or ar)11. List Delivery Options (mcp_Zid_ListDeliveryOptions)
Retrieve a list of all delivery options available in your Zid store.
Call this tool to get all delivery options in your store.
language (string): Response language (en or ar)12. Add Shipping Option (mcp_Zid_action_AddShippingOption)
Create a new shipping option with cost, cities, and delivery estimates.
Provide the required shipping option information.
name (string): Shipping option namecost (string): Shipping costcodEnabled (string): Whether Cash on Delivery is enabledcodFee (string): Cash on Delivery feecities (array): Array of city IDs where this option is availabledeliveryEstimatedTimeAr (string): Estimated delivery time in ArabicdeliveryEstimatedTimeEn (string): Estimated delivery time in Englishlanguage (string): Response language (en or ar)Summary Table
| Tool Name | Purpose/Use Case | Key Parameters |
|---|---|---|
| List Store Locations | Display all store locations | (none required) |
| Get Store Location | Fetch details for specific location | locationId |
| Add Store Location | Create new store location | name, coordinates, fullAddress, city, isDefault, isPrivate, isEnabled |
| Update Store Location | Modify existing location | locationId, name, description, isActive |
| Update Location Stock | Update stock for multiple products at location | locationId, products array |
| List Product Stocks | List all stock entries for a product | productId |
| Get Product Stock | Fetch details for specific stock entry | productId, stockId |
| Update Product Stock | Update stock for specific product | productId, stockId, availableQuantity, isInfinite |
| Add Product Stock | Add new stock entry for product | productId, location, availableQuantity, isInfinite |
| Bulk Update Product Stocks | Update stock for multiple products | productId, stocks array |
| List Delivery Options | List all delivery options | (none required) |
| Add Shipping Option | Create new shipping option | name, cost, codEnabled, codFee, cities, deliveryEstimatedTimeAr, deliveryEstimatedTimeEn |
Best Practices for Inventory & Locations Management
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
Modified at 2025-08-25 16:58:20