# Zoho Inventory MCP MCP > Zoho Inventory MCP lets your agent manage everything from stock levels to customer orders and purchasing documents through natural language commands. Need to check if you have enough widgets or create a full sales order? Your agent handles it, listing items, creating new records, and tracking multiple organizations—all in one connection. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** stock-control, order-fulfillment, warehouse-management, purchase-orders, sales-orders, real-time-inventory ## Description Think of this MCP as your central operations desk for Zoho Inventory. Instead of jumping between tabs or running manual API scripts, you talk to your AI client and it executes the entire workflow. You can ask it to check current stock levels across all your locations, generate a list of recent sales orders, or even create a new item record if something is missing. This MCP handles full order lifecycle management. It lets you track everything from listing purchase orders and managing multiple organizations to creating brand-new sales orders. The whole process happens inside Vinkius; specifically, Vinkius AI Analytics gives you a clear audit trail of every tool call—which items were checked, what data flowed through, and where the request came from. It means nothing happens in the dark. You run complex processes spanning inventory control, purchasing, and sales without ever having to open the admin dashboard. ## Tools ### create_new_item Adds a completely new product record to your inventory list. ### create_sales_order Builds and submits a new official sales order to the system. ### get_item_details Pulls specific information for one single product by its ID. ### get_sales_order_details Retrieves full details for one specific sales order, including line items and customer info. ### list_composite_items Lists all products that are assemblies or bundles, showing their component parts. ### list_inventory_items Retrieves a full list of every item tracked in the system. ### list_organizations Gets a list of every separate business entity ID within your account. ### list_purchase_orders Provides a list of all purchase orders created against your vendors. ### list_sales_orders Lists recent or historical sales orders completed through the system. ## Prompt Examples **Prompt:** ``` List all organizations in my Zoho Inventory account. ``` **Response:** ``` I've retrieved your organizations. You have 2 entities: 'Main Store (ID: 123456)' and 'Secondary Warehouse (ID: 789012)'. Which one would you like to access? ``` **Prompt:** ``` Show the stock level for 'Professional Camera'. ``` **Response:** ``` For 'Professional Camera' (ID: 101) in organization 123456, there are currently 45 units available in stock. ``` **Prompt:** ``` List my 5 most recent sales orders in organization '123456'. ``` **Response:** ``` I've fetched your latest sales orders. Recent transactions include Order #SO-001 for 'Alice Smith' ($1,500.00) and Order #SO-002 for 'Bob Jones' ($850.50). ``` ## Capabilities ### Check real-time stock status List all items currently stocked in your inventory and get their up-to-the-minute availability. ### Generate sales documentation Create new customer orders or list past transactions by providing necessary customer details. ### Manage purchasing needs List all open purchase orders and track incoming stock from vendors. ### Identify product kits View composite items, helping you understand how your finished goods are assembled from multiple raw parts. ### Scale across business units Manage inventory and orders for multiple separate organizations using a single connection. ## Use Cases ### Handling an unexpected stockout. A customer asks about a widget order. Instead of checking the dashboard, you ask your agent to `get_item_details` for 'Widget X'. The agent instantly replies with the current count and flags it as low. ### Fulfilling a large batch sale. You need to process five orders. You first list all organizations using `list_organizations`, then use `create_sales_order` repeatedly, specifying the correct organization ID each time. ### Reconciling purchase vs. sales data. The finance team asks for a report on items sold but not yet paid for. You run `list_sales_orders`, get the list of IDs, and then use `get_sales_order_details` on key orders to verify payment status. ### Creating an entirely new product line. The sales team pitches a bundle. You run `list_composite_items` to see existing kits, then use `create_new_item` to define the new SKU and its components in one go. ## Benefits - Need to check a single item's status? Use `get_item_details` to pull specific data instantly, without navigating deep into menus. It’s fast. - When a customer places an order, you can use `create_sales_order` immediately. Your agent handles the required JSON body and submits it right away. - Keep track of vendor shipments by running `list_purchase_orders`. You get to see exactly what's on its way before it hits your stock count. - `list_composite_items` is critical for understanding product kits. It shows you the raw parts needed to build a final product, keeping your BOM accurate. - You can scale operations across multiple branches by first calling `list_organizations` to grab every necessary ID, then passing those IDs into subsequent calls. - If you need to add a brand-new SKU that doesn't exist yet, simply use `create_new_item`. It adds the item record and sets up its initial details. ## How It Works The bottom line is you stop working in the app and start talking to your agent, which does the backend work for you. 1. First, use the `list_organizations` tool to identify the specific organizational ID you need to work with. 2. Next, tell your agent what task you're running (e.g., 'Create an order for John Doe'). The agent then calls the appropriate tool (like `create_sales_order`), passing the necessary IDs and data. 3. The system returns the confirmation or the requested data set—be it a list of current stock levels or newly generated order details. ## Frequently Asked Questions **How do I check stock levels with the list_inventory_items tool?** You run `list_inventory_items` and your agent returns a comprehensive list of every tracked SKU, along with its current quantity. This is the fastest way to get an overall picture of what you have available. **Can I create a sales order using the create_sales_order tool?** Yes, this tool takes customer and line item details and generates a new, formal sales order record. It handles all the necessary data structure required for submission. **What is the purpose of list_organizations in Zoho Inventory MCP?** You use `list_organizations` to identify every distinct business unit ID within your account. You must run this first so you can accurately target which company's inventory or order books you want to interact with. **Does get_item_details show me all stock history?** No, `get_item_details` shows the item's current metadata and available stock level. For historical movement tracking, you’ll need to combine this with other listing tools. **When I use list_purchase_orders, how does Vinkius handle my secure connection details?** Vinkius manages your credentials through a zero-trust proxy. Your keys never sit on disk; they only pass through in transit when the agent makes a call to the MCP. This keeps your Zoho access entirely protected. **If I try to run create_sales_order with incomplete data, what happens?** The tool call fails safely before touching live records. Your AI client receives an immediate error message detailing exactly which fields are missing or invalid, allowing you to fix the input and retry. **What is the difference between list_inventory_items and list_composite_items?** List inventory items pulls basic stock levels for individual products. List composite items only shows your product kits or bundles, helping you understand how multiple parts are packaged together. **If I run many calls to list_inventory_items in a short time, will there be rate limit issues?** The MCP wrapper handles throttling and manages API rate limits for you. It processes requests efficiently to prevent hitting Zoho's service caps while maintaining high throughput. **How do I find my Organization ID?** Use the `list_organizations` tool to retrieve all businesses registered in your account along with their unique IDs. **Which Data Center domains are supported?** You can use Zoho domains such as `com` (US), `eu` (Europe), `in` (India), `com.au` (Australia), or `jp` (Japan). **Can I create a sales order directly via the agent?** Yes, use the `create_sales_order` tool by providing the Organization ID and a JSON object containing the customer and line item details.