# Saleor MCP for AI Agents AI Agent Connect

> Saleor MCP lets you connect your AI agent directly to your headless e-commerce store. You can manage your product catalog, audit recent orders, and pull customer details instantly. It's the fast way to give your agent real-time access to your retail data without manual exports.

## Overview
- **Category:** loved-by-devs
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_j3mvi8fKyIAr5EgXcsZ9lrEBlO8tzq58pj2vOi5H/ai-agent-connect
- **Tags:** graphql-api, product-catalog, inventory-management, digital-commerce, order-processing, storefront-management

## Description

If you're running a store, you know the pain of jumping between tabs just to see if an order shipped or if a specific SKU is out of stock. This Connector gives your AI agent a direct line to your Saleor backend. You can ask your agent to pull up a receipt, check a category list, or find a customer's profile in seconds. Instead of you doing the manual digging, your agent does the work. It handles the work of checking your inventory and order history so you can stay focused on actually running the business. Since Vinkius hosts this, you can get it connected and ready to go in minutes. It's about giving your AI the data it needs to be a useful part of your daily retail operations.

## Tools

### list_collections
Pulls a list of all product collections in your directory. This helps you see how you've grouped your merchandise.

### list_orders
Shows a list of the most recent orders placed on your platform. It's perfect for a quick pulse check on daily sales.

### get_customer
Pulls a specific customer's profile and their full order history. Use this to check past purchases during a support call.

### get_order
Grabs every detail for a single order, including line items and billing info. Use this to verify shipping addresses or fulfillment status.

### get_product
Fetches specific details like variants and stock for a single product ID. This helps you check exact inventory counts for specific items.

### get_shop_info
Retrieves your global store configuration and high-level settings. Use it to see your active regions and default currencies.

### list_categories
Shows you every category in your store to see how items are organized. It's a quick way to browse your catalog structure.

### list_channels
Lists all active sales channels and their configurations. Use this to see where your products are currently being sold.

### list_customers
Finds all registered customers in your store's database. Use this to get a broad view of your user base.

### list_products
Returns a list of all products currently in your Saleor store. Use this to get a high-level view of your entire catalog.

## Prompt Examples

**Prompt:** 
```
List all products in my store.
```

**Response:** 
```
I've pulled the current product list from your Saleor store. Here are the top items:

| Product Name | Status | Price |
| :--- | :--- | :--- |
| Classic Fedora | In Stock | $85.00 |
| Wool Overcoat | Low Stock | $240.00 |
| Leather Gloves | Out of Stock | $45.00 |

Would you like more details on any of these?
```

**Prompt:** 
```
Find out order specifics and shipping details for order number '334'.
```

**Response:** 
```
I've retrieved the details for **Order #334**:

*   **Status:** Unfulfilled
*   **Customer:** customer@example.com
*   **Shipping Address:** 123 Maple St, CA
*   **Items:** 1x Classic Fedora
*   **Total:** $85.00

It looks like this is still awaiting fulfillment.
```

**Prompt:** 
```
What currencies does the store utilize in the available sales channels?
```

**Response:** 
```
I checked your high-level store configuration. You currently have three active pipelines:

*   **US Store:** USD
*   **UK Store:** GBP
*   **Continental Node:** EUR

All three channels are functioning correctly.
```

## Capabilities

### Pull full product details
Get specific info like pricing and stock levels for any item in your store.

### Audit recent orders
See a list of the latest purchases and grab full receipt details instantly.

### Search customer profiles
Find registered users and their specific order histories in your database.

### Manage store categories
Browse how your products are organized without opening a dashboard.

### Check store configuration
Access global settings like currencies and active sales channels.

## Use Cases

### Checking an order's location
A customer asks 'Where is my package?' The agent uses get_order to find the shipping status and billing address.

### Stock verification
A shopper asks 'Is the red dress available in size medium?' The agent uses get_product to check the specific variant's stock.

### Customer lookup
A support agent asks 'Who is customer 502?' The agent uses get_customer to pull their full profile and history.

### Catalog browsing
A user asks 'What categories do you have?' The agent uses list_categories to show the store's organization.

## Benefits

- Faster order auditing: Use list_orders and get_order to see exactly what customers bought and where it's headed without manual searching.
- Real-time inventory checks: Use get_product to see precise stock configurations for any item instantly.
- Better customer service: Use get_customer to pull up a shopper's history the moment they message you.
- Easy catalog management: Use list_categories and list_collections to see how your store is organized at a glance.
- Rapid store setup: Use list_channels and get_shop_info to verify your global settings and active sales pipelines.
- Customer list access: Use list_customers to see a full list of everyone registered in your shop.

## How It Works

The bottom line is you get a live bridge between your AI agent and your e-commerce backend.

1. Create an internal App Token in your Saleor backend with the right permissions.
2. Add the Saleor Cloud GraphQL API Endpoint and your token to the connection.
3. Ask your agent to find an order, check stock, or list your products.

## Frequently Asked Questions

**Can the Saleor MCP help me manage my inventory?**
Yes, it allows your AI agent to check live stock levels and pull specific product details for any item in your store.

**How does the Saleor MCP handle customer order history?**
Your agent can pull up a specific customer's full profile and every order they've ever placed in your shop.

**Can I use Saleor MCP to check my store's global settings?**
Yes, it can retrieve your global configuration, including active regions and default currencies.

**Does Saleor MCP work with my existing headless setup?**
It is designed specifically for Saleor's headless GraphQL backend, making it a perfect fit for your existing architecture.

**How can I use Saleor MCP to help with customer support?**
It lets your agent quickly find order statuses and customer information so you can provide faster, more accurate help.

**Can I see my sales channels using Saleor MCP?**
Yes, it can list all your configured sales channels and their specific settings.

**Can the AI forcefully complete, modify, or delete existing customer orders in my Saleor shop?**
No. The integration focuses securely on read-only queries. It fetches critical information such as stock numbers, recent sales, and product characteristics without actively overwriting, resolving, or destroying records to protect e-commerce transactional integrity.

**Does it require a specific Saleor Cloud paid plan to use this integration?**
A specific plan is not heavily mandated by the tool itself as long as your environment successfully exposes the standard backend GraphQL endpoint and permits the creation of standard administrative App Tokens within your environment policies.

**Why do some commands ask for a 'GraphQL ID' specifically?**
Saleor’s core architecture uses unique Base64-encoded strings (like 'UHJvZHVjdDoxMjM=') as identifiers natively, rather than typical numeric database IDs. Always use the `list_orders` or `list_products` tools first to discover these exact encoded IDs natively, then seamlessly pass them to the exact fetching tools to pull their full snapshots.