# Zid MCP > Zid MCP connects your AI client directly to your e-commerce store data. You get full, programmatic control over everything—from product catalog details and live inventory counts to customer purchase history and order fulfillment status. It turns manually checking dashboards into a simple conversation with your agent. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** retail-orchestration, catalog-management, order-fulfillment, saudi-ecommerce, inventory-sync, api-integration ## Description Your agent can now handle the core operational tasks for your online shop without you ever needing to log into the Zid dashboard. You get instant access to everything: current stock levels across all warehouse locations, full customer profiles including purchase history, and complete order records that show exactly where fulfillment stands. Instead of spending hours clicking through tabs or exporting CSVs just to check on sales performance, you simply ask your AI client. It pulls the live data, giving you a clear picture of everything from product listings to payment statuses in real-time. This access transforms routine retail management into natural dialogue, making it one of the most useful integrations available in the Vinkius catalog. ## Tools ### get_zid_order Gets the specific details for one store order, including payment and fulfillment status. ### get_zid_customer Retrieves detailed information about a single shop customer. ### get_zid_product Fetches detailed metadata for a single product listing in your catalog. ### list_zid_customers Lists all registered customers associated with your shop account. ### list_zid_inventories Provides a directory and status check for all active inventory locations. ### list_zid_orders Retrieves a list of recent store orders, useful for checking fulfillment queues. ### list_zid_products Lists all available products in your online catalog. ### get_zid_shop_profile Retrieves the core metadata and current operational settings for your shop account. ### check_zid_status Verifies the connection status of the API, ensuring all data channels are active. ## Prompt Examples **Prompt:** ``` List all products and show their status. ``` **Response:** ``` I've retrieved your products. You currently have 12 active high-fidelity profiles, including 'Premium Coffee' (Active) and 'Arabic Dates'. Would you like to see the detailed inventory metadata for any of them? ``` **Prompt:** ``` Show the last 5 orders and their fulfillment status. ``` **Response:** ``` Retail orchestrated! I've identified 5 recent high-fidelity order profiles, including order #12345 (Ready for Shipping). I've retrieved the technical fulfillment metadata for your review. Shall I summarize the sales progress? ``` **Prompt:** ``` Check the available inventories for the 'Main Warehouse'. ``` **Response:** ``` Inventory directory orchestrated! Your store currently has 3 high-fidelity inventory locations active. Your API connection is healthy. Shall I retrieve the detailed resource distribution metadata for these sites? ``` ## Capabilities ### Get Customer and Order Details Retrieve specific customer profiles or full order histories using key identifiers. ### List All Shop Products Pull the complete list of products in your catalog, along with detailed metadata for each item. ### Monitor Inventory Levels Access and review current stock counts across multiple physical warehouse locations. ### Review Store Operations Status Check the health and operational status of your shop profile and API connection. ## Use Cases ### The fulfillment bottleneck An Operations Manager needs to confirm if 50 units of a specific item are ready for shipping. Instead of logging into the dashboard and filtering by SKU, they simply ask their agent: 'What is the current stock level for SKU X?' The agent uses `list_zid_inventories` to give them an immediate answer. ### The returning customer query A Support Lead needs to know why a customer suddenly can't find their order. They ask the agent to look up the account using `get_zid_customer`, which provides the full purchase history and links directly to related orders via `get_zid_order`. ### The end-of-day sales summary An E-commerce Owner wants a snapshot of yesterday's activity. They ask the agent to list recent orders using `list_zid_orders`, getting immediate insight into payment status and fulfillment volume. ### Product data audit A Product Manager needs to ensure all new product variants are correctly listed. They use `list_zid_products` for a comprehensive list, then select key items to confirm technical details with `get_zid_product`. ## Benefits - Instantly check stock levels. Use the `list_zid_inventories` tool to see your full resource distribution across all locations, eliminating manual warehouse checks. - Understand customer history fast. By using `get_zid_customer`, you can pull complete profiles and purchase records in seconds to personalize support interactions. - Track fulfillment progress effortlessly. Running a query with `list_zid_orders` gives you an immediate overview of pending shipments, no dashboard required. - Audit your catalog instantly. You can list all products via `list_zid_products` and get detailed metadata on specific items using `get_zid_product` for compliance checks. - Verify system health quickly. The `check_zid_status` tool confirms the API connection is healthy, letting you know immediately if data retrieval is restricted. ## How It Works The bottom line is you authorize your AI client with two tokens, giving it permission to read all the necessary e-commerce data directly. 1. Subscribe to this Zid MCP on Vinkius. 2. Retrieve your Manager Token and Authorization Token from your own Zid dashboard. 3. Connect the MCP credentials to any MCP-compatible client, then ask your agent for data. ## Frequently Asked Questions **How do I use Zid MCP to check my inventory status?** You ask your agent to list inventories. It uses `list_zid_inventories` to give you a full overview of stock counts across all warehouse locations. **Can I find out a customer's purchase history using Zid MCP?** Yes. You can use the `get_zid_customer` tool and ask your agent to pull up the full profile, which includes their complete purchasing record. **What if I need details on a specific order? Do I use Zid MCP?** Yes. You request the order details by asking for the order ID. The agent runs `get_zid_order` and gives you everything from payment to fulfillment status. **Is Zid MCP only for Saudi e-commerce stores?** It is specifically designed for Zid, which serves the Saudi and Gulf markets. The data it retrieves is tied directly to your regional store account. **How do I find my Zid API Tokens?** Log in to your Zid Partner dashboard, navigate to your App settings, and locate your unique **X-MANAGER-TOKEN** and **Authorization** Bearer token. **Can I check product stock levels via AI?** Yes! The `list_zid_inventories` tool allows your agent to retrieve high-fidelity stock metadata across all defined inventory locations. **How do I list my shop's orders?** Use the `list_zid_orders` tool to retrieve the complete high-fidelity directory of customer orders along with their current fulfillment status.