Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.
Geographic Data & Shipping
1. List Countries (mcp_Zid_ListCountries)
Retrieve a list of all countries available in the Zid system.
Call this tool to get all available countries.
language (string): Response language (en or ar)2. Get Cities by Country (mcp_Zid_GetCitiesByCountry)
Retrieve a list of cities for a specific country.
Provide the countryId to get all cities in that country.
countryId (number): The unique ID of the countrylanguage (string): Response language (en or ar)3. Get All Countries (mcp_Zid_GetAllCountries)
Retrieve a comprehensive list of all countries with pagination support.
Call this tool with optional pagination parameters.
pageSize (number): Number of countries per page (default: 100, max: 100)page (number): Page number for pagination (default: 1)language (string): Response language (en or ar)4. List Delivery Options (mcp_Zid_ListDeliveryOptions)
Retrieve a list of all delivery options configured in your Zid store.
Call this tool to get all delivery options in your store.
language (string): Response language (en or ar)5. 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 Countries | Display all available countries | (none required) |
| Get Cities by Country | List cities for specific country | countryId |
| Get All Countries | Get countries with pagination | pageSize, page |
| List Delivery Options | Display all delivery options | (none required) |
| Add Shipping Option | Create new shipping option | name, cost, codEnabled, codFee, cities, deliveryEstimatedTimeAr, deliveryEstimatedTimeEn |
Best Practices for Geographic Data & Shipping
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
Geographic Data Workflow Example
Shipping Configuration Examples
Regional Shipping Setup
City-Specific Shipping
International Shipping
Modified at 2025-08-25 17:03:15