Saleor MCP server
Saleor's official MCP server gives agents read-only access to a Saleor Commerce store: products, orders, customers, channels, and stock.
The Saleor MCP server is the official Model Context Protocol integration for Saleor Commerce, the API-first, GraphQL-native commerce platform. It lets an AI assistant read live store data so it can answer commerce questions and surface insights: it can fetch the list of products, list and count orders, list customers, list sales channels, and inspect inventory through stock listings and warehouse details. The server is deliberately read-only — it never triggers mutations against the Saleor API — so you can hand a store to an agent for reporting, support lookups, and catalog or order exploration without any risk of it changing live commerce data.
The easiest way to use it is the production instance hosted by Saleor at https://mcp.saleor.app/mcp, reached over Streamable HTTP; it is configured for stores on the saleor.cloud domain and is compatible with Saleor 3.21 and later. Authentication is supplied through request headers — X-Saleor-Auth-Token (a Saleor app or staff token with the MANAGE_PRODUCTS and MANAGE_ORDERS permissions) and X-Saleor-API-URL (your store's GraphQL endpoint). The server is open source (written in Python with uv), so you can also run it locally with uv run saleor-mcp and point an ALLOWED_DOMAIN_PATTERN at your own Saleor instances for self-hosted control.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Available tools
| Tool | Description |
|---|---|
| products | Fetches the list of products from the Saleor GraphQL API. |
| orders | Fetches the list of orders, with information for each order. |
| order_count | Fetches the total count of orders matching the given filter criteria. |
| customers | Fetches the list of customers from the Saleor GraphQL API. |
| channels | Fetches the list of sales channels from the Saleor store. |
| stocks | Fetches the list of stock (inventory) records from the Saleor GraphQL API. |
| warehouse_details | Fetches details about warehouses from the Saleor GraphQL API. |
Required configuration
- X-Saleor-Auth-TokenRequired
Saleor app or staff token (header) with MANAGE_PRODUCTS and MANAGE_ORDERS permissions. Required.
- X-Saleor-API-URLRequired
Your store's Saleor GraphQL API URL (header). Required.
- ALLOWED_DOMAIN_PATTERNOptional
Regex restricting which Saleor API domains are allowed, for self-hosted deployments. Optional.
What you can do with it
Answer store reporting questions
Let an agent count orders, list recent ones, and pull product and channel data to answer "how many orders this week?" or "which products are in this channel?" without anyone opening the Saleor dashboard.
Safe commerce data exploration
Because the server is strictly read-only, you can connect it to a production Saleor store for support lookups and inventory checks (stocks and warehouse details) with no chance of an agent mutating orders or catalog data.
FAQ
- Is it free?
- The MCP server is open source under the AGPL-3.0 license and free to run, including the hosted instance at https://mcp.saleor.app/mcp. You pay only for your Saleor Cloud plan or self-hosted infrastructure.
- Does it support remote/OAuth?
- The canonical deployment is the remote Streamable HTTP endpoint at https://mcp.saleor.app/mcp. Authentication is via headers — X-Saleor-Auth-Token (an app or staff token with MANAGE_PRODUCTS and MANAGE_ORDERS) and X-Saleor-API-URL — rather than an OAuth flow. You can also self-host it with uv.
- Can the agent change orders or products?
- No. The Saleor MCP server is read-only by design and never triggers mutations against the Saleor API, so it can fetch products, orders, customers, channels, and stock but cannot modify any of them.