# Kibo Commerce MCP > Kibo Commerce MCP connects your AI agent directly to enterprise e-commerce backend systems. Manage product catalogs, check real-time inventory across every store or warehouse, track customer accounts, and pull detailed order history using natural language queries. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** unified-commerce, catalog-management, omnichannel, inventory-visibility, order-fulfillment, enterprise-retail ## Description Need to run deep reports on sales without logging into the admin dashboard? This connector gives your agent direct access to your core e-commerce data. You can ask it to list products by category, check how many units of a specific item are sitting in multiple locations, or look up a customer's entire purchase history—all instantly. It handles everything from catalog metadata retrieval to order fulfillment status updates. When you connect this MCP via Vinkius, your agent gains a single point of control over every major commerce operation, letting you interact with product data and inventory details as if they were simple conversations. No more switching between tabs or running complex SQL queries just to check stock levels. ## Tools ### list_categories Retrieves a complete list of every product category defined in the catalog. ### list_customers Pulls a directory listing of all active customer accounts within your system. ### get_location_details Fetches specific configuration and operational details for one selected store or warehouse location. ### get_order_details Retrieves the full transactional breakdown and status of a single identified commerce order. ### get_product_details Pulls all available metadata, descriptions, and attributes for one specific product code. ### get_inventory_status Checks the real-time stock count of a given item across multiple physical locations. ### list_locations Provides an overview and list of all active inventory holding sites (stores or warehouses). ### list_orders Generates a list of recent commerce orders, showing high-level details for multiple transactions. ### list_products Searches and lists all items in the Kibo catalog to explore inventory metadata. ### get_site_settings Retrieves general platform site settings, such as operational hours or key identifiers. ## Prompt Examples **Prompt:** ``` Show me the details for product with code 'TSHIRT-RED-XL' in Kibo. ``` **Response:** ``` I've retrieved the details for 'TSHIRT-RED-XL'. It's a 'Classic Red V-Neck T-Shirt' in size XL. Current status is 'ACTIVE' and it has 5 associated attributes. ``` **Prompt:** ``` What is the inventory status for product 'LAPTOP-PRO-15'? ``` **Response:** ``` For 'LAPTOP-PRO-15', I found 120 units on hand across 3 locations: Warehouse-A (80 units), Store-Downtown (25 units), and Store-Westside (15 units). ``` **Prompt:** ``` List my 5 most recent orders in Kibo Commerce. ``` **Response:** ``` I've fetched your latest orders. Notable recent ones include Order #1005 from 'Alice Smith' ($150.00) and Order #1004 from 'Bob Jones' ($85.50). ``` ## Capabilities ### Check real-time stock availability Ask for the current quantity of any specific item across all physical stores and warehouses. ### Review catalog structure List all product categories or retrieve detailed metadata for an entire range of items in your inventory. ### Track customer profiles Look up specific customer accounts and pull their registered profile information instantly. ### Get comprehensive order reports List recent commerce orders or fetch the full details of a single transaction, including its status. ### Locate physical sites Retrieve a list of all connected stores and warehouses, or get specific settings for one location. ## Use Cases ### Checking stock during a peak sales period An Inventory Analyst needs to know if they have enough 'Laptop Pro 15' units in the Westside store and Warehouse A. Instead of logging into three different systems, they ask their agent: 'What is the inventory status for Laptop-Pro-15?' The MCP runs `get_inventory_status` and returns a precise breakdown across all required locations. ### Assisting a customer with an old order A Customer Support Specialist needs to track down Order #9001 for Alice Smith. They prompt the agent, 'Find details for Order 9001.' The MCP runs `get_order_details` and immediately provides the status, items purchased, and shipping information. ### Planning a seasonal catalog update An E-commerce Manager needs to see if all new 'Summer Collection' products fit into existing categories. They ask their agent to first run `list_categories` and then check product details using `get_product_details`, ensuring proper metadata tagging before launch. ### Auditing store location requirements The Operations Manager needs a list of all physical sites for an audit. They ask the agent to run `list_locations` and then use `get_location_details` on each site to verify required hardware or operational settings. ## Benefits - Stop running manual reports. You can ask your agent to list all products and categories using `list_products` or `list_categories`, getting a full catalog overview instantly. - Get immediate visibility into stock levels anywhere. Use `get_inventory_status` to know exactly how many units of an item are on hand across multiple locations, eliminating guesswork. - Improve support speed by having your agent query customer data via `list_customers` and retrieve specific order information using `get_order_details` in one interaction. - Understand your physical footprint quickly. Use `list_locations` to see all connected warehouses or stores at a glance, saving time when planning fulfillment routes. - Eliminate dashboard hopping. Your agent can cross-reference product metadata (`get_product_details`) with store settings (`get_site_settings`), providing holistic data points for decision-making. ## How It Works The bottom line is that you talk to your AI client, and it translates that request into direct calls against your live commerce system. 1. Subscribe to this MCP using your required Tenant ID, Client ID, and Client Secret credentials. 2. Connect the MCP to your preferred AI client (like Claude or Cursor) within the Vinkius catalog. 3. Use natural language prompts in your agent to ask for specific e-commerce data points, like 'What is the inventory status for Product X?' ## Frequently Asked Questions **How do I check inventory status using Kibo Commerce MCP?** You ask your agent, 'What is the inventory status for product X?' The MCP uses `get_inventory_status` to provide a real-time breakdown of stock across all connected locations. **Can I list all customer accounts with Kibo Commerce MCP?** Yes, simply ask the agent to use the `list_customers` tool. This pulls a comprehensive directory listing of every active user account in your system. **Does Kibo Commerce MCP handle order history queries?** Yes. You can list recent orders using `list_orders`, or get the full transactional breakdown for one specific purchase with `get_order_details`. **What is the difference between listing products and getting product details in Kibo Commerce MCP?** The `list_products` tool gives you a broad overview of all items, while `get_product_details` fetches the deep metadata, attributes, and descriptions for one specific item. **How do I find out what locations Kibo Commerce MCP supports?** You use the `list_locations` tool. This provides a list of every physical site—whether it's a store or a warehouse—that can be monitored by your agent.