Saleor MCP. Audit inventory, orders, and customers from chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Saleor MCP Server connects your AI agent directly to a headless e-commerce store, allowing it to manage product data, audit live orders, and access customer histories via GraphQL queries.
Use `list_products` to pull catalog listings or `get_order` to check specific shipment details instantly from chat.
What your AI agents can do
Get customer
Retrieves profile information and order history for a specific customer.
Get order
Pulls detailed records for one specific purchase/order number.
Get product
Gets full product details (variants, pricing) using a unique product ID.
The agent retrieves a full list of products (list_products) or pulls granular details (like stock and pricing) for one specific product ID using get_product.
You can pull detailed records for any single order number, including line items, billing addresses, and fulfillment status, using get_order.
The agent pulls a list of all registered users (list_customers) or gets the complete profile and purchase history for one specific user via get_customer.
You can pull the hierarchy of collections and categories to map out how your entire product catalog is organized without leaving the chat window (list_collections, list_categories).
The tool fetches store-wide configuration details, like active sales channels or default currencies, using get_shop_info.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Saleor MCP Server: 10 Tools for E-commerce Ops
These ten tools give your AI agent direct access to every major operational area of your Saleor store: inventory, orders, customers, and global settings.
019d7601get customer
Retrieves profile information and order history for a specific customer.
019d7601get order
Pulls detailed records for one specific purchase/order number.
019d7601get product
Gets full product details (variants, pricing) using a unique product ID.
019d7601get shop info
Retrieves global store configuration data like default currencies and regions.
019d7601list categories
Lists every available product category in the store's catalog.
019d7601list channels
Shows all configured sales channels (e.g., web, mobile) for the shop.
019d7601list collections
Outputs a list of curated product collections within the catalog.
019d7601list customers
Retrieves a list of all user accounts registered in the shop.
019d7601list orders
Shows a list of recent customer orders placed on the platform.
019d7601list products
Lists every product available for sale in the entire Saleor store directory.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Saleor, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You're connecting your AI agent straight into a headless e-commerce backend via Saleor. This server lets you run daily retail operations right from your chat window. You don't need to jump through five different dashboards; your agent handles it.
Auditing Products and Inventory Details
You can start by pulling a complete list of everything the store sells using list_products. Need details on just one item? Use get_product with its unique ID, and you'll get the full scoop—variants, current pricing, stock levels, that whole nine yards. You map out the entire catalog structure by listing all available categories with list_categories, or checking out curated groupings using list_collections.
If you need to see what kind of product organization exists overall, run list_products first.
Managing Orders and Customer Records
Checking on sales is quick. You can pull a list of recent customer purchases with list_orders. For the deep dive—the specifics on one order—you use get_order by giving it an order number. That tool spits out everything: line items, who paid for it, and where they want it shipped. When you need to check customer details, you can list every user account registered in the shop using list_customers.
Want a profile deep dive? Use get_customer; it pulls not just contact info but also that person's entire purchase history.
Understanding Shop Scope and Settings
Your agent doesn't forget context. You can pull all configured sales channels—whether it’s the web store or a mobile app—by running list_channels. To get the big picture of the shop, use get_shop_info. This tool fetches essential global settings like what default currencies are active or which regions you're selling into.
If you need to know how the entire catalog is organized by product groups, run list_categories and then list_collections to map out the hierarchy.
The Workflow in Action
Your agent processes requests directly against these tools. It uses get_customer if you ask about a user's history, or it runs get_order when you need status on shipment 'XYZ-901'. When you want to confirm the price for product ID 55B, it hits get_product. If someone asks what products are available in the 'Electronics' category, your agent executes list_products and filters by the data structure provided by list_categories.
It’s all done through GraphQL queries. You don't write messy API calls; you just ask your agent a question, and it gives you an accurate answer based on live e-commerce data.
How Saleor MCP Works
- 1 You authorize the Saleor mapping tools within your workspace integrations.
- 2 You provide the Saleor Cloud GraphQL API Endpoint and a generated access token into the connection securely.
- 3 Your agent runs specific commands, such as 'Find out order specifics for number X,' which triggers
get_order.
The bottom line is: your AI client uses these tools to query Saleor's backend and gives you structured data about your store operations.
Who Is Saleor MCP For?
This is for the e-commerce ops engineer who spends too much time jumping between dashboards just to check an order status. It's also for support leads who need immediate access to a customer’s full purchase history, and product managers auditing catalog consistency.
Uses get_customer and get_order to instantly pull a user's profile and check if an order is marked as fulfilled or pending.
Runs tools like list_channels or get_shop_info to confirm the correct global API settings before deploying new features.
Uses list_products and list_categories to audit catalog gaps or check if a newly added product adheres to existing naming conventions.
What Changes When You Connect
- Check real-time stock levels for any item. Instead of guessing, run
get_productto get the precise count and variant details instantly. - Quickly resolve support tickets by checking order status. Use
get_orderwith an ID to see exactly when it was placed and who bought it. - Map out your entire catalog structure in minutes. Running
list_collectionsandlist_categoriesshows you how everything is grouped without clicking through web dashboards. - See all active sales pipelines at a glance. Use
list_channelsto confirm which currencies (USD, EUR, etc.) are live across different selling points. - Pull customer data on demand. Need to know what a user bought six months ago? Run
get_customerand get their full history right away.
Real-World Use Cases
The Missing Order Audit
A customer calls, 'Where's my package?' You don't have time to log into the CRM. Your agent runs get_order using the order number they provide. The response immediately tells you if it was fulfilled and what the billing address is, solving the problem in three seconds.
Inventory Gap Analysis
The Product Manager needs to know which categories are missing specific products. They run list_categories first, then use get_product on key SKUs across those categories to verify if the correct variant pricing is attached.
Checking Multi-Region Compliance
A developer needs to know which currencies are active for international sales. They run list_channels and check the output, confirming that both GBP (UK) and EUR (EU) channels are correctly configured before a major product launch.
Bulk Catalog Sync Prep
You need to build an external report of every item name. You run list_products to get the full list, then use get_product on a sample set to verify which specific fields (like weight or dimensions) are available for export.
The Tradeoffs
Listing everything with one call
Asking the agent, 'Tell me about all products, collections, and customers.' This fails because it's too vague; the API doesn't know what you prioritize.
→
Break it down. Start by listing the product list: list_products. Then, if needed, drill into a specific group using list_collections before asking about inventory.
Assuming universal IDs
Telling the agent, 'Get me the details for order 123.' If that order number is invalid or belongs to a different region, the call fails with an ambiguous error.
→
Always confirm context. Before running get_order, check if you have all necessary parameters (like customer ID or shop ID) to ensure the tool can execute correctly.
Mixing up data sources
Trying to use a customer's name from their profile (get_customer) to query product details directly. These are two separate operations.
→
You have to run the tools sequentially. First, get the customer ID via list_customers, then use that ID in conjunction with an order number to execute get_order.
When It Fits, When It Doesn't
Use this server if your core workflow involves auditing e-commerce state: checking inventory counts, pulling specific sales data (orders/customers), or verifying global store settings. It's perfect for support and operations teams who need to run background checks on the store's operational health.
Don't use it if you just need simple content tasks, like drafting marketing copy or generating images—those are separate tools. If your goal is pure data visualization (e.g., 'Show me a graph of sales trends'), you might be better off connecting to a dedicated analytics service instead. However, if the core data source for that visualization is Saleor, this server provides all the necessary endpoints (list_orders, get_product) to feed your data pipeline.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Saleor Headless API. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Auditing e-commerce state shouldn't require jumping between five different tabs.
Today, if you need to know an order's status and the customer’s full history, you click into your CRM. Then you copy the order ID, jump over to the fulfillment dashboard, paste it in, and then open a third tab just for product lookups to check stock levels. It takes five minutes of clicking, copying, and context-switching.
With this MCP server, you just ask: "Check status and history for order '334'." The agent runs `get_order` and `get_customer`, pulling all the required data into one response packet. You get the full picture without leaving your chat window.
Saleor MCP Server: Pulling product, order, and customer details from chat.
Manual auditing requires you to manually cross-reference IDs. You pull the list of recent orders using `list_orders`, copy an ID, then go into the inventory system to check if that item is still stocked—a process prone to human error and slowdowns.
Now, ask the agent: "What's the stock level for items in order '334'?" The agent runs `get_order` first, extracts all SKUs, then uses `get_product` on each one. It delivers a single, consolidated report of status and inventory counts.
Common Questions About Saleor MCP
How do I check the stock count for a product using get_product? +
You must provide the specific product ID when calling get_product. The response details include current variants, pricing, and the precise available stock configuration.
Can list_orders show me more than just the order number? +
Yes. Running list_orders gives you a list of recent purchases, which includes key data points like the customer ID and the total amount, letting you know who placed it and when.
Do I need to use get_customer every time I check an order? +
No. You can run get_order standalone if you have the order number. However, running get_customer first gives you a full view of that user's purchase history, which is useful for support.
What information does get_shop_info provide? +
It retrieves global settings for your entire store instance. This includes crucial details like the default currencies and active sales regions configured in Saleor.
How do I authenticate to use `list_products` and other tools? +
You must provide a dedicated App Token generated within your Saleor backend. This token is used for authorization, granting your AI client the necessary read/write access before any tool can execute.
When I run `list_products`, how does the system handle thousands of items? +
The server manages pagination automatically. It returns product listings in defined chunks, allowing your agent to request subsequent pages until it has retrieved all available products in the catalog.
If I know a category name, how do I find a product ID using `list_categories` and `get_product`? +
Run list_categories first to map the collection name to its specific ID. You then pass that resulting ID or filter criteria into get_product to locate the desired item.
What happens if I try to run `get_order` with an incorrect order number? +
The server returns a structured error response, typically including an HTTP status code and a clear message. Your agent can then read this failure state to handle missing data without crashing.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
UUID & ULID Generator
Stop LLMs from hallucinating fake or repeated IDs. Generate mathematically guaranteed v4 UUIDs and time-sortable ULIDs natively.
Typesense Vector Search
Automate vector similarity searches via Typesense — index documents, manage collections, and execute semantic queries directly from your AI agent.
Convex
Interact with your Convex backend directly—execute queries, mutations, and actions from any AI agent.
You might also like
Evernote
Manage personal notes via Evernote — create and search notes, handle notebooks and tags, and monitor account quotas directly from any AI agent.
Corpay One
Simplify business payments with automated AP processing, virtual cards, and vendor management that saves your finance team hours.
Asian Development Bank
Access comprehensive macroeconomic indicators for 49 Asia-Pacific economies — GDP, inflation, trade, population, and more — directly from the ADB.