# Saleor MCP > Saleor MCP connects your AI client directly to your headless e-commerce backend. You can manage product details, audit recent customer orders, and retrieve specific account information—all from a natural chat conversation. It gives your agent deep visibility into everything happening in your store. ## Overview - **Category:** loved-by-devs - **Price:** Free - **Tags:** graphql-api, product-catalog, inventory-management, digital-commerce, order-processing, storefront-management ## Description Managing an online store usually means jumping between inventory dashboards, order tracking pages, and customer profile screens. This MCP changes that. Instead of copying data or navigating complex web interfaces, you simply ask your AI client a question about the saleor backend, and it gets the answer instantly. You can check product availability by calling `get_product`, list all registered users using `list_customers`, or pull up full details for any order with `get_order`. If your current platform uses an alternative method of data access, you'll spend hours compiling reports. Here, everything is exposed through a single chat interface. This makes it easier to manage day-to-day retail operations right where you work, and Vinkius hosts this connection so you can access Saleor alongside thousands of other services. ## Tools ### get_customer Retrieves a specific customer's profile information and order history. ### get_order Pulls detailed information for a single, specific order number. ### get_product Gets deep details about one product using its unique ID. ### get_shop_info Retrieves general, high-level configuration data for the entire shop. ### list_categories Provides a list of all product categories defined in the store. ### list_channels Shows which sales channels are currently set up and active. ### list_collections Retrieves a list of all product collections available in the store. ### list_customers Lists every customer or user who is registered in your shop's system. ### list_orders Presents a list of the most recent orders that have been placed. ### list_products Retrieves a comprehensive list of all products available in your Saleor store. ## Prompt Examples **Prompt:** ``` List all products in my store. ``` **Response:** ``` I've carefully queried the Saleor GraphQL endpoint and successfully retrieved the top 20 verified product listings natively currently published within the e-commerce directory mapped accurately here. ``` **Prompt:** ``` Find out order specifics and shipping details for order number '334'. ``` **Response:** ``` I checked order '334'. It was placed cleanly by 'customer@example.com'. The exact billing address covers CA, and unfortunately the fulfillment standing reveals it's listed strictly as unfulfilled currently. ``` **Prompt:** ``` What currencies does the store utilize in the available sales channels? ``` **Response:** ``` I queried the high-level Sales Channels settings securely. You maintain three active pipelines functioning flawlessly: USD for the primary US store, GBP representing the UK environment, and EUR cleanly implemented on the continental node. ``` ## Capabilities ### View all available products List the entire catalog or check specific item details by ID. ### Audit customer accounts Find profiles and view order history for any registered shopper. ### Track recent sales activity Get a list of the latest orders placed on the platform, or dive into one specific receipt. ### Check store configuration Retrieve high-level data like default currencies and active selling regions. ## Use Cases ### Customer needs shipping status on a weekend. A customer contacts support asking about order #512. Instead of typing the number into three separate portals, the agent asks your AI client to run `get_order`. The client immediately confirms the billing address and reports if it's unfulfilled. ### Merchandiser needs a catalog audit. The merchandiser wants to see how many unique product lines exist across all sections. They ask your AI client to run `list_products`, which returns the total count, and then use `list_collections` to map out related groups. ### Team needs to identify new clients. A sales team member wants to know how many unique users have signed up this month. They ask your AI client to run `list_customers`, which provides a list of all registered profiles for review. ## Benefits - Instead of viewing product data through multiple tabs, you can use `get_product` to get specific details—like variant pricing or stock levels—in a single conversation. This saves time when troubleshooting listings. - When a customer calls about their purchase, asking for order specifics and shipping status is simple. Just input the number and let your agent run `get_order` to give them an immediate answer. - You don't have to manually browse categories; you can ask your AI client to list all product collections using `list_collections`. It gives you a structured overview of your catalog instantly. - Managing customer accounts is much faster. You can use `list_customers` to find a user by name, then use `get_customer` to see their full purchase history and profile details in one step. - Checking the store's global setup used to mean finding specific API documentation. Now, you just ask for the shop info using `get_shop_info`, and your agent tells you what currencies or regions are active. ## How It Works The bottom line is you get a unified chat interface that lets your agent talk directly to your store's database. 1. First, you authorize the Saleor mapping tools within your workspace integrations. 2. Next, you access your main Saleor backend dashboard and generate a dedicated internal App Token with read/manage permissions. 3. Finally, enter the Saleor Cloud GraphQL API Endpoint and that generated token into the connection. Then, just ask the AI: "Find out order specifics for order number '334'." ## Frequently Asked Questions **How do I check product stock levels with Saleor MCP?** You use `get_product` to pull specific item details. This tool retrieves real-time information like available variants and current stock configurations for a given product ID. **Can the Saleor MCP help me find customer order history?** Yes. You first use `list_customers` to identify the user, and then use `get_customer` to pull their entire profile and associated order history in one go. **What is the difference between list_orders and get_order?** `list_orders` shows a summary of the most recent purchases on your platform. `get_order`, however, gives you comprehensive details for just one specific receipt or order ID. **How do I list all product categories using Saleor MCP?** You run the `list_categories` tool. This immediately displays a structured list of every category your store uses, letting you audit the catalog structure without touching any web dashboards. **Does the Saleor MCP support multiple sales channels?** Yes, it does. You can use `list_channels` to see all configured selling environments and determine which markets your store is currently active in.