Saleor

The Saleor MCP Server provides a read-only interface that lets AI assistants query your Saleor instance for up-to-date data about products, customers, and orders without making changes to the Saleor backend. It exposes a Streamable HTTP endpoint you can connect to from MCP clients and AI tools to retrieve structured Saleor data efficiently.

How to use

You connect your MCP client or AI assistant to the remote or local Saleor MCP server to fetch information from your Saleor instance. Use the Streamable HTTP endpoint at the configured URL to query data such as products, customers, and orders. When you connect, your client should provide the necessary authentication and API URL so the MCP server can reach your Saleor API. The MCP server is read-only, so it only retrieves data and does not perform mutations.

How to install

Prerequisites: Python 3.12 or higher and the uv package manager.

1. Clone the repository.

2. Install dependencies.

3. Run the MCP server locally.

Additional deployment details

Production access is available at https://mcp.saleor.app/mcp. The production instance is configured to connect to Saleor instances hosted on the saleor.cloud domain and supports Saleor 3.21+.

Configuration and environment

To connect to a Saleor API, provide the following headers in your requests to the MCP server:

• X-Saleor-API-URL — The URL of the Saleor GraphQL API.

• X-Saleor-Auth-Token — An authentication token with the required permissions (MANAGE_PRODUCTS and MANAGE_ORDERS).

Example client configuration for MCP integration

{
  "servers": {
    "saleor-mcp": {
      "type": "http",
      "url": "https://mcp.saleor.app/mcp",
      "headers": {
        "X-Saleor-Auth-Token": "YOUR_TOKEN",
        "X-Saleor-API-URL": "https://example.saleor.cloud/graphql/"
      }
    }
  }
}

Development and tooling

This project uses ariadne-codegen to generate the Saleor API client code from the GraphQL schema. To refresh the client locally, run the code generation tool as shown below.

ariadne-codegen